שימוש ב-Database Migration Service API

ב-Database Migration Service יש ממשק API בארכיטקטורת REST לניהול פרופילי החיבור ומשימות ההעברה באופן פרוגרמטי. ‫API בארכיטקטורת REST מוגדר על ידי משאבים שמשויכים ליצירה ולניהול של פרופילי חיבור ומשימות העברה. פרטים על כל המשאבים והשיטות שלהם זמינים ב מאמרי העזרה של Database Migration Service API.

כששולחים בקשות ישירות ל-API בארכיטקטורת REST של Database Migration Service, צריך ליצור את הבקשה בפורמט הנכון, לאשר את הבקשה כמשתמש מאומת ולעבד את התגובות שמוחזרות. בהרבה מהמשימות במסמכי התיעוד האלה יש דוגמאות ל-API באמצעות curl.

דוגמאות נוספות לשימוש בממשקי ה-API מופיעות בדף הבקשה ב מאמרי העזרה של Database Migration Service API. בכל דף יש דוגמאות לקריאה ל-API בכמה שפות תכנות, וגם כלי Explorer ספציפי לבקשה, שעוזר לכם לראות מה נכלל בבקשה תקינה ולמה לצפות בתגובה.

אתם משתמשים ב-Database Migration Service API גם באופן עקיף, כשאתם משתמשים באחת מהדרכים הבאות לניהול מכונות:

היתרון בשימוש בשיטות האלה, במיוחד במסוףGoogle Cloud , הוא שהן יכולות לפשט מאוד את ניהול פרופילי החיבור ומשימות ההעברה (בהתאם לתרחיש לדוגמה). אם אתם רק מתחילים להשתמש ב-Database Migration Service, מומלץ להתחיל עם אחד מהכלים האלה לפני שתעבדו ישירות עם ה-API בארכיטקטורת REST.

הפעלת ה-API

כדי להשתמש ב-Database Migration Service API, צריך להפעיל אותו:

המסוף

  1. מפעילים את Database Migration Service API.
  2. בוחרים את הפרויקט הרצוי.
  3. לוחצים על המשך.

gcloud

  1. מזינים את הפקודה הבאה כדי להציג את מזהי הפרויקטים ב- Google Cloud: 
    gcloud projects list
  2. מגדירים את פרויקט ברירת המחדל: 
    gcloud config set project YOUR_PROJECT_ID
  3. מפעילים את Cloud SQL Admin API: 
    gcloud services enable datamigration.googleapis.com

הרשאות

כדי להשתמש ב-Database Migration Service API, צריך את ההרשאות הנדרשות. ההרשאות האלה כוללות:

  • אדמין של Database Migration: הרשאה שנותנת למשתמש גישה לכל המשאבים של Database Migration Service שמשמשים לניהול פרופילי קישור ומשימות העברה.
  • צפייה בהעברת מסדי נתונים: ההרשאה הזו נותנת למשתמש גישה לקריאה בלבד לפרופילי החיבור ולמשימות ההעברה ב-Database Migration Service.
  • אדמין ב-Cloud SQL: עם ההרשאה הזו, המשתמש יכול ליצור ולנהל פרופילי חיבור ומשימות העברה ל-Cloud SQL ב-Database Migration Service.