שימוש ב-Database Migration Service API

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

כששולחים בקשות ישירות ל-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.