Database Migration Service מספק API בארכיטקטורת REST לניהול פרופילי החיבור ועבודות המיגרציה באופן פרוגרמטי. API בארכיטקטורת REST מוגדר על ידי משאבים שמשויכים ליצירה ולניהול של פרופילי חיבור ועבודות העברה. פרטים על כל המשאבים והשיטות שלהם זמינים במאמר Database Migration Service API Reference.
כששולחים בקשות ישירות אל Database Migration Service API בארכיטקטורת REST, צריך ליצור את הבקשה בפורמט הנכון, לאשר את הבקשה כמשתמש מאומת ולעבד את התשובות שמתקבלות. במסמכי התיעוד האלה יש דוגמאות רבות ל-API שמשתמשות ב- cURL.
דוגמאות נוספות לשימוש בממשקי ה-API זמינות בדף הבקשה ב הפניית API של Database Migration Service. בכל דף יש דוגמאות לקריאה ל-API בכמה שפות תכנות, וגם כלי Explorer ספציפי לבקשה שיעזור לכם להבין מה נדרש כדי ליצור בקשה תקינה ומה צפוי בתגובה.
אתם משתמשים ב-Database Migration Service API גם באופן עקיף, כשאתם משתמשים באחת מהדרכים הבאות לניהול מופעים:
Google Cloud CLI: ממשק שורת פקודה (CLI) שבעזרתו אפשר לעבוד עם המכונות הווירטואליות.
Google Cloud מסוף: ממשק גרפי מבוסס-אינטרנט.
היתרון בשימוש בשיטות האלה, במיוחד בGoogle Cloud מסוף, הוא שהן יכולות לפשט מאוד את הניהול של פרופילי החיבור ומשימות ההעברה (בהתאם לתרחיש השימוש). אם אתם רק מתחילים להשתמש ב-Database Migration Service, מומלץ להתחיל עם אחד מהכלים האלה לפני שתתחילו לעבוד ישירות עם API בארכיטקטורת REST.
הפעלת ה-API
כדי להשתמש ב-Database Migration Service API, צריך להפעיל אותו:
המסוף
- מפעילים את Database Migration Service API.
- בוחרים את הפרויקט הרצוי.
- לוחצים על המשך.
gcloud
- מזינים את הפקודה הבאה כדי להציג את מזהי הפרויקטים של Google Cloudהפרויקטים שלכם:
gcloud projects list
- מגדירים את פרויקט ברירת המחדל:
gcloud config set project YOUR_PROJECT_ID
- מפעילים את Cloud SQL Admin API:
gcloud services enable datamigration.googleapis.com
הרשאות
כדי להשתמש ב-Database Migration Service API, צריכות להיות לכם ההרשאות הנדרשות. ההרשאות האלה כוללות:
- אדמין של Database Migration Service: עם ההרשאה הזו, המשתמש מקבל גישה לכל המשאבים של Database Migration Service שמשמשים לניהול פרופילי חיבור ועבודות העברה.
- Database Migration Viewer: עם ההרשאה הזו, למשתמש יש גישת קריאה בלבד לפרופילי חיבור ולמשימות העברה ב-Database Migration Service.
- אדמין Cloud SQL: עם ההרשאה הזו, משתמש יכול ליצור ולנהל פרופילים של חיבורים ועבודות העברה ל-Cloud SQL ב-Database Migration Service.
Google Cloud כולל את הפתרון 'ניהול זהויות והרשאות גישה (IAM)', שמאפשר לתת גישה פרטנית יותר למשאבים ספציפיים ב- Google Cloud ולמנוע גישה לא רצויה למשאבים אחרים. אפשר לקבל ולהגדיר הרשאות ל-Database Migration Service באמצעות Google Cloud המסוף, שיטות ה-IAM של ה-API או Google Cloud CLI. מידע נוסף זמין במאמר הענקה, שינוי וביטול גישה למשאבים.
העברת נתוני JSON מקובץ
כשמשתמשים ב-API עם cURL, צריך לספק ערכי מאפיינים באמצעות שורת הפקודה. אם אתם עובדים עם ערכים רגישים כמו סיסמאות או מפתחות אבטחה, מסירתם בשורת הפקודה מהווה סיכון אבטחתי. כדי לשפר את האבטחה, אתם יכולים ליצור קובץ שמכיל את נתוני ה-JSON לקריאה ל-API, ולציין את הנתיב לקובץ בשורת הפקודה.
כדי לספק נתוני JSON לקריאה ל-API של cURL מקובץ:
יוצרים קובץ שמכיל את כל מה שמוקף במירכאות בודדות בשדה
--data.צריך לכלול את הסוגריים המסולסלים, אבל לא את המירכאות הבודדות.
בשורת הפקודה, מציינים את הנתיב לקובץ, עם התו
@לפניו, כפרמטר--data:--data @<path-to-file>/<filename>
עבודה עם קריאות ל-API שפועלות לאורך זמן
חלק מקריאות ה-API, כמו יצירת אובייקט, יכולות להימשך זמן מה. מכיוון שה-API הוא אסינכרוני, הקריאה חוזרת באופן מיידי, גם אם הפעולה עדיין מתבצעת. אם קריאה עוקבת ל-API משתמשת באובייקט שנוצר, צריך להמתין עד שהפעולה הראשונה תושלם לפני שממשיכים.
אתם יכולים להשתמש ב-Database Migration Service API כדי לנהל פעולות. למשל:
Database Migration Service ו-Google APIs Discovery Service
Google APIs Discovery Service הוא שירות שמאפשר לכם לגלות Google APIs. לדוגמה, כשמשתמשים בכלי Google APIs Explorer, משתמשים ב-Discovery Service.ב-Discovery Service, Database Migration Service מיוצג כ-datamigration (לדוגמה: https://datamigration.googleapis.com/$discovery/rest?version=v1).