סקירה כללית
בדף הזה מוסבר איך להשתמש ב-Database Migration Service API כדי לנהל משימות העברה של מסד נתונים של MySQL כמקור.
יש שתי דרכים להשתמש ב-API של Database Migration Service. אפשר לבצע קריאות ל-API בארכיטקטורת REST או להשתמש ב-Google Cloud CLI (CLI).
כדי לראות מידע כללי על השימוש ב-gcloud לניהול משימות העברה של Database Migration Service, לוחצים כאן.
יצירת טיוטה של משימת העברה
בדוגמה הבאה מוצגת בקשה ליצירת משימת העברה במצב טיוטה. כך לא צריך ליצור את משימת ההעברה בבת אחת. אפשר ליצור חלק ממנו ואז לעדכן אותו באמצעות הפעולה PATCH.
לדוגמה, אם רוצים ליצור משימת העברה, אבל אין מסד נתונים של יעד או שיטה לחיבור לרשת, אפשר להשתמש בקוד הבא:
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- project-id: מזהה הפרויקט
- region: האזור של הפרויקט
- migration-job-id: מזהה משימת ההעברה
- migration-job-name: השם של משימת ההעברה
- source-connection-profile-id: מזהה פרופיל החיבור למקור
- destination-connection-profile-id: מזהה פרופיל החיבור של היעד
- provider: הספק שמשויך לסוג הסיווג של מסד הנתונים של המקור.
- במקרה של מופע עצמאי של MySQL, צריך להשתמש בערך
DATABASE_PROVIDER_UNSPECIFIEDכי הוא משויך למסד נתונים מקומי. - במקרה של מכונת Cloud SQL ל-MySQL, משתמשים ב-
CLOUDSQL. - לכל שירות מסד נתונים מנוהל, משתמשים בערך
ENUMהמתאים. פרטים נוספים מופיעים בחומר העזר על אובייקטDatabaseProvider.
- במקרה של מופע עצמאי של MySQL, צריך להשתמש בערך
- cloud-storage-bucket (אופציונלי): הקטגוריה ב-Cloud Storage שבה מאחסנים את קובץ ה-dump.
dump-file (אופציונלי): קובץ ה-dump שמאחסנים בקטגוריה ב-Cloud Storage.
flag-name ו-flag-value (אופציונלי): השם והערך של דגל שמוסיפים לכלי
mysqldump. כלי השירות הזה יוצר את קובץ ה-dump.
ה-method של ה-HTTP וכתובת ה-URL:
POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs?migrationJobId=migration-job-id
תוכן בקשת JSON:
{
"displayName": "migration-job-name",
"state": "DRAFT",
"type": "CONTINUOUS",
"source": "projects/project-id/locations/region/connectionProfiles/source-connection-profile-id",
//"destination":"projects/project-id/locations/region/connectionProfiles/destination-connection-profile-id",
"sourceDatabase": {
"engine": "MYSQL",
"provider": "provider"
},
//"vpcPeeringConnectivity": {
//"vpc": "default"
//},
"dump_path": "gs://cloud-storage-bucket/dump-file"
"dump_flags": {"dump_flags":[{"name": "flag-name", "value": "flag-value"}]}
}
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"name": "projects/project-id/locations/region/operations/operation-1591975557292-5a7e4b195623c-e350e3da-713dee7d",
"metadata": {
"@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
"createTime": "2020-06-12T15:25:57.430715421Z",
"target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
"verb": "create",
"requestedCancellation": false,
"apiVersion": "v1"
},
"done": false
}
יצירת משימת מיגרציה רציפה עם קישוריות של VPC Peering
בדוגמה הבאה מוצגת בקשה ליצירת משימת העברה רציפה להעברת מסד נתונים של MySQL (שפועל במכונה וירטואלית של Google Compute Engine) אל Cloud SQL ל-MySQL, באמצעות קישור VPC.
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- project-id: מזהה הפרויקט
- region: האזור של הפרויקט
- migration-job-id: מזהה משימת ההעברה
- migration-job-name: השם של משימת ההעברה
- source-connection-profile-id: מזהה פרופיל החיבור למקור
- destination-connection-profile-id: מזהה פרופיל החיבור של היעד
- provider: הספק שמשויך לסוג הסיווג של מסד הנתונים של המקור.
- במקרה של מופע עצמאי של MySQL, צריך להשתמש בערך
DATABASE_PROVIDER_UNSPECIFIEDכי הוא משויך למסד נתונים מקומי. - במקרה של מכונת Cloud SQL ל-MySQL, משתמשים ב-
CLOUDSQL. - לכל שירות מסד נתונים מנוהל, משתמשים בערך
ENUMהמתאים. פרטים נוספים מופיעים בחומר העזר על אובייקטDatabaseProvider.
- במקרה של מופע עצמאי של MySQL, צריך להשתמש בערך
- cloud-storage-bucket (אופציונלי): הקטגוריה ב-Cloud Storage שבה מאחסנים את קובץ ה-dump.
dump-file (אופציונלי): קובץ ה-dump שמאחסנים בקטגוריה ב-Cloud Storage.
flag-name ו-flag-value (אופציונלי): השם והערך של דגל שמוסיפים לכלי
mysqldump. כלי השירות הזה יוצר את קובץ ה-dump.
ה-method של ה-HTTP וכתובת ה-URL:
POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs?migrationJobId=migration-job-id
תוכן בקשת JSON:
{
"displayName": "migration-job-name",
"state": "NOT_STARTED",
"type": "CONTINUOUS",
"source": "projects/project-id/locations/region/connectionProfiles/source-connection-profile-id",
"destination":"projects/project-id/locations/region/connectionProfiles/destination-connection-profile-id",
"sourceDatabase": {
"engine": "MYSQL",
"provider": "provider"
},
"vpcPeeringConnectivity": {
"vpc": "default"
},
"dump_path": "gs://cloud-storage-bucket/dump-file"
"dump_flags": {"dump_flags":[{"name": "flag-name", "value": "flag-value"}]}
}
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"name": "projects/project-id/locations/region/operations/operation-1591975557292-5a7e4b195623c-e350e3da-713dee7d",
"metadata": {
"@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
"createTime": "2020-06-12T15:25:57.430715421Z",
"target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
"verb": "create",
"requestedCancellation": false,
"apiVersion": "v1"
},
"done": false
}
gcloud
כאן אפשר לקרוא מידע נוסף על שימוש ב-gcloud ליצירת משימות העברה ב-Database Migration Service.
יצירת משימת העברה רציפה עם קישוריות SSH הפוכה
בדוגמה הבאה מוצגת בקשה ליצירת משימת העברה שפועלת באופן רציף להעברת מסד נתונים של Amazon RDS MySQL ל-Cloud SQL ל-MySQL, באמצעות קישוריות SSH הפוכה.
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- project-id: מזהה הפרויקט
- region: האזור של הפרויקט
- migration-job-id: מזהה משימת ההעברה
- migration-job-name: השם של משימת ההעברה
- source-connection-profile-id: מזהה פרופיל החיבור למקור
- destination-connection-profile-id: מזהה פרופיל החיבור של היעד
- vm-name: השם של המכונה הווירטואלית של SSH. לדוגמה, dms-ssh-bastion.
- vm-ip-address: כתובת ה-IP של ה-VM של SSH. לדוגמה, 11.22.33.44.
- vm-port: יציאת החיבור של מכונת ה-SSH. לדוגמה, 3306.
- vpc-name: השם של רשת ה-VPC. לדוגמה, projects/project-id/global/networks/test-network.
- provider: הספק שמשויך לסוג הסיווג של מסד הנתונים של המקור.
- במקרה של מופע עצמאי של MySQL, צריך להשתמש בערך
DATABASE_PROVIDER_UNSPECIFIEDכי הוא משויך למסד נתונים מקומי. - במקרה של מכונת Cloud SQL ל-MySQL, משתמשים ב-
CLOUDSQL. - לכל שירות מסד נתונים מנוהל, משתמשים בערך
ENUMהמתאים. פרטים נוספים מופיעים בחומר העזר על אובייקטDatabaseProvider.
- במקרה של מופע עצמאי של MySQL, צריך להשתמש בערך
- cloud-storage-bucket (אופציונלי): הקטגוריה ב-Cloud Storage שבה מאחסנים את קובץ ה-dump.
dump-file (אופציונלי): קובץ ה-dump שמאחסנים בקטגוריה ב-Cloud Storage.
flag-name ו-flag-value (אופציונלי): השם והערך של דגל שמוסיפים לכלי
mysqldump. כלי השירות הזה יוצר את קובץ ה-dump.
ה-method של ה-HTTP וכתובת ה-URL:
POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs?migrationJobId=migration-job-id
תוכן בקשת JSON:
{
"displayName": "migration-job-name",
"state": "NOT_STARTED",
"type": "CONTINUOUS",
"source": "projects/project-id/locations/region/connectionProfiles/source-connection-profile-id",
"destination":"projects/project-id/locations/region/connectionProfiles/destination-connection-profile-id",
"sourceDatabase": {
"engine": "MYSQL",
"provider": "provider"
},
"reverseSshConnectivity": {
"vm": "vm-name",
"vm_ip": "vm-ip-address",
"vm_port": vm-port,
"vpc": "vpc-name"
},
"dump_path": "gs://cloud-storage-bucket/dump-file"
"dump_flags": {"dump_flags":[{"name": "flag-name", "value": "flag-value"}]}
}
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
"metadata": {
"@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
"createTime": "2020-06-12T14:46:01.744267779Z",
"target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
"verb": "create",
"requestedCancellation": false,
"apiVersion": "v1"
},
"done": false
}
gcloud
כאן אפשר לקרוא מידע נוסף על שימוש ב-gcloud ליצירת משימות העברה ב-Database Migration Service.
יצירת משימת העברה עם קישוריות לרשימת היתרים של כתובות IP
בדוגמה הבאה מוצגת בקשה ליצירת משימת העברה להעברת מופע עצמאי של MySQL או שירות מנוהל של מסד נתונים למסד נתונים של Cloud SQL ל-MySQL, באמצעות רשימת כתובות IP להיתר.
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- project-id: מזהה הפרויקט
- region: האזור של הפרויקט
- migration-job-id: מזהה משימת ההעברה
- migration-job-name: השם של משימת ההעברה
- source-connection-profile-id: מזהה פרופיל החיבור למקור
- destination-connection-profile-id: מזהה פרופיל החיבור של היעד
- provider: הספק שמשויך לסוג הסיווג של מסד הנתונים של המקור.
- במקרה של מופע עצמאי של MySQL, צריך להשתמש בערך
DATABASE_PROVIDER_UNSPECIFIEDכי הוא משויך למסד נתונים מקומי. - במקרה של מכונת Cloud SQL ל-MySQL, משתמשים ב-
CLOUDSQL. - לכל שירות מסד נתונים מנוהל, משתמשים בערך
ENUMהמתאים. פרטים נוספים מופיעים בחומר העזר על אובייקטDatabaseProvider.
- במקרה של מופע עצמאי של MySQL, צריך להשתמש בערך
- cloud-storage-bucket (אופציונלי): הקטגוריה ב-Cloud Storage שבה מאחסנים את קובץ ה-dump.
dump-file (אופציונלי): קובץ ה-dump שמאחסנים בקטגוריה ב-Cloud Storage.
flag-name ו-flag-value (אופציונלי): השם והערך של דגל שמוסיפים לכלי
mysqldump. כלי השירות הזה יוצר את קובץ ה-dump.
ה-method של ה-HTTP וכתובת ה-URL:
POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs?migrationJobId=migration-job-id
תוכן בקשת JSON:
{
"displayName": "migration-job-name",
"state": "NOT_STARTED",
"type": "CONTINUOUS",
"source": "projects/project-id/locations/region/connectionProfiles/source-connection-profile-id",
"destination":"projects/project-id/locations/region/connectionProfiles/destination-connection-profile-id",
"sourceDatabase": {
"engine": "MYSQL",
"provider": "provider"
},
"staticIpConnectivity": {}
"dump_path": "gs://cloud-storage-bucket/dump-file"
"dump_flags": {"dump_flags":[{"name": "flag-name", "value": "flag-value"}]}
}
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
"metadata": {
"@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
"createTime": "2020-06-12T14:46:01.744267779Z",
"target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
"verb": "create",
"requestedCancellation": false,
"apiVersion": "v1"
},
"done": false
}
gcloud
כאן אפשר לקרוא מידע נוסף על שימוש ב-gcloud ליצירת משימות העברה ב-Database Migration Service.
קבלת מידע על עבודת העברה
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- project-id: מזהה הפרויקט
- region: האזור של הפרויקט
- migration-job-id: מזהה משימת ההעברה
ה-method של ה-HTTP וכתובת ה-URL:
GET https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"name": "projects/project-id/locations/region/migrationJobs/one-time-vpc-job",
"createTime": "2020-06-12T15:48:39.666093835Z",
"updateTime": "2020-06-12T15:48:39.666093835Z",
"displayName": "migration-job-display-name",
"state": "CREATING",
"type": "CONTINUOUS",
"source": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
"destination": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
"sourceDatabase": {
"engine": "MYSQL"
},
"destinationDatabase": {
"provider": "CLOUDSQL"
},
"vpcPeeringConnectivity": {
"vpc": "default"
}
}
gcloud
למידע נוסף על שימוש ב-gcloud כדי לאחזר מידע על עבודת ההעברה, אפשר ללחוץ כאן.
הצגת רשימה של משימות העברה
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- project-id: מזהה הפרויקט
- region: האזור של הפרויקט
orderBy:המסנן הזה מאפשר לאחזר רשימה של כל משימות ההעברה באזור מסוים, בסדר אלפביתי. לדוגמה, המסנןorderBy=nameמחזיר את כל משימות ההעברה, לפי סדר אלפביתי של השמות.-
pageSize:משתמשים במסנן הזה כדי לציין את המספר המקסימלי של משימות העברה ש-Database Migration Service מאחזר ומציג בדף. לדוגמה, אם מגדירים אתpageSize=10, Database Migration Service יחזיר עד 10 משימות העברה לדף.
אם יש יותר מ-10 משימות העברה, הן יופיעו בדפים אחרים. בסוף כל דף מופיעים פרמטר nextPageToken ומזהה ייחודי (לדוגמה, oasndfoasdnoasun1241243ojsandf). משתמשים במזהה כדי לאחזר את רשימת משימות ההעברה של הדף הבא. בדף האחרון, הפרמטר nextPageToken והמזהה הייחודי לא מופיעים.
ה-method של ה-HTTP וכתובת ה-URL:
GET https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"migrationJobs": [
{
"name": "projects/project-id/locations/region/migrationJobs/name-of-first-migration-job",
"createTime": "2020-06-12T15:48:39.666093835Z",
"updateTime": "2020-06-12T15:48:39.666093835Z",
"displayName": "display-name-of-first-migration-job",
"state": "NOT_STARTED",
"type": "CONTINUOUS",
"source": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
"destination": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
"sourceDatabase": {
"engine": "MYSQL"
},
"destinationDatabase": {
"provider": "CLOUDSQL"
},
"vpcPeeringConnectivity": {
"vpc": "default"
}
}
{
"name": "projects/project-id/locations/region/migrationJobs/name-of-second-migration-job",
"createTime": "2021-02-13T11:59:39.104613835Z",
"updateTime": "2021-02-13T12:01:38.666093835Z",
"displayName": "display-name-of-second-migration-job",
"state": "RUNNING",
"type": "CONTINUOUS",
"source": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
"destination": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
"sourceDatabase": {
"engine": "MYSQL"
},
"destinationDatabase": {
"provider": "CLOUDSQL"
},
"staticIpConnectivity": {}
"vpc": "default"
}
],
"nextPageToken": "unique-identifier"
}
gcloud
כאן אפשר לקרוא מידע נוסף על שימוש ב-gcloud כדי לאחזר מידע על כל עבודות ההעברה.
יצירת סקריפט להגדרת מנהרת SSH לעבודת העברה
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- project-id: מזהה הפרויקט
- region: האזור של הפרויקט
- migration-job-id: מזהה משימת ההעברה
ה-method של ה-HTTP וכתובת ה-URL:
POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:generateSshScript
תוכן בקשת JSON:
{
"vm":"vm-name",
"vmCreationConfig":{
"vmMachineType":"machine-type",
"subnet":"subnet-name"
}
}
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
"metadata": {
"@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
"createTime": "2020-06-12T14:46:01.744267779Z",
"target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
"verb": "generate",
"requestedCancellation": false,
"apiVersion": "v1"
},
"done": false
}
gcloud
מידע נוסף על שימוש ב-gcloud ליצירת סקריפט SSH למשימת ההעברה זמין כאן.
אימות של משימת העברה
בדוגמה הבאה מוצגת בקשה לאימות של משימת העברה. אימות של משימת העברה מאפשר לוודא שהמשימה תתחיל ותפעל בהצלחה.
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- project-id: מזהה הפרויקט
- region: האזור של הפרויקט
- migration-job-id: מזהה משימת ההעברה
ה-method של ה-HTTP וכתובת ה-URL:
POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:verify
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
"metadata": {
"@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
"createTime": "2020-06-12T14:46:01.744267779Z",
"target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
"verb": "verify",
"requestedCancellation": false,
"apiVersion": "v1"
},
"done": false
}
gcloud
מידע נוסף על שימוש ב-gcloud כדי לאמת את עבודת ההעברה זמין כאן.
עדכון של משימת העברה
בדוגמה הבאה מוצגת בקשה לעדכון השם לתצוגה של משימת העברה קיימת. כשמשתמשים בפרמטר updateMask בבקשה, צריך לכלול בגוף הבקשה רק את השדות האלה.
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- project-id: מזהה הפרויקט
- region: האזור של הפרויקט
- migration-job-id: מזהה משימת ההעברה
ה-method של ה-HTTP וכתובת ה-URL:
PATCH https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id?updateMask=displayName
תוכן בקשת JSON:
{
"displayName": "updated-display-name",
}
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
"metadata": {
"@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
"createTime": "2020-06-12T14:46:01.744267779Z",
"target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
"verb": "update",
"requestedCancellation": false,
"apiVersion": "v1"
},
"done": false
}
gcloud
כאן אפשר לקרוא מידע נוסף על שימוש ב-gcloud כדי לעדכן את עבודת ההעברה.
התחלת משימת העברה
בדוגמה הבאה מוצגת בקשה להפעלת משימת העברה.
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- project-id: מזהה הפרויקט
- region: האזור של הפרויקט
- migration-job-id: מזהה משימת ההעברה
ה-method של ה-HTTP וכתובת ה-URL:
POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:start
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
"metadata": {
"@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
"createTime": "2020-06-12T14:46:01.744267779Z",
"target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
"verb": "start",
"requestedCancellation": false,
"apiVersion": "v1"
},
"done": false
}
gcloud
מידע נוסף על שימוש ב-gcloud כדי להתחיל את עבודת ההעברה זמין כאן.
הפעלה מחדש של עבודת העברה שנכשלה
בדוגמה הבאה מוצגת בקשה להפעלה מחדש של משימת העברה. אפשר להפעיל מחדש את עבודת ההעברה מההתחלה אם ההעברה נכשלה ואי אפשר לשחזר אותה, או אם היא הופסקה במהלך גיבוי מלא.
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- project-id: מזהה הפרויקט
- region: האזור של הפרויקט
- migration-job-id: מזהה משימת ההעברה
ה-method של ה-HTTP וכתובת ה-URL:
POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:restart
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
"metadata": {
"@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
"createTime": "2020-06-12T14:46:01.744267779Z",
"target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
"verb": "restart",
"requestedCancellation": false,
"apiVersion": "v1"
},
"done": false
}
gcloud
מידע נוסף על שימוש ב-gcloud כדי להפעיל מחדש את עבודת ההעברה זמין כאן.
הפסקת משימת העברה
בדוגמה הבאה מוצגת בקשה להפסקת משימת העברה.
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- project-id: מזהה הפרויקט
- region: האזור של הפרויקט
- migration-job-id: מזהה משימת ההעברה
ה-method של ה-HTTP וכתובת ה-URL:
POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:stop
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
"metadata": {
"@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
"createTime": "2020-06-12T14:46:01.744267779Z",
"target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
"verb": "stop",
"requestedCancellation": false,
"apiVersion": "v1"
},
"done": false
}
gcloud
מידע נוסף על שימוש בלחצן gcloud כדי להפסיק את עבודת ההעברה זמין כאן.
המשך של משימת העברה
בדוגמה הבאה מוצגת בקשה להמשך של משימת העברה.
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- project-id: מזהה הפרויקט
- region: האזור של הפרויקט
- migration-job-id: מזהה משימת ההעברה
ה-method של ה-HTTP וכתובת ה-URL:
POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:resume
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
"metadata": {
"@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
"createTime": "2020-06-12T14:46:01.744267779Z",
"target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
"verb": "resume",
"requestedCancellation": false,
"apiVersion": "v1"
},
"done": false
}
gcloud
מידע נוסף על שימוש ב-gcloud כדי להפעיל מחדש את עבודת ההעברה זמין כאן.
קידום של משימת העברה
בדוגמה הבאה מוצגת בקשה לקידום של משימת העברה.
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- project-id: מזהה הפרויקט
- region: האזור של הפרויקט
- migration-job-id: מזהה משימת ההעברה
ה-method של ה-HTTP וכתובת ה-URL:
POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:promote
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
"metadata": {
"@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
"createTime": "2020-06-12T14:46:01.744267779Z",
"target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
"verb": "promote",
"requestedCancellation": false,
"apiVersion": "v1"
},
"done": false
}
gcloud
מידע נוסף על שימוש ב-gcloud לקידום משימת ההעברה זמין כאן.
מחיקה של משימת העברה
בדוגמה הבאה מוצגת בקשה למחיקת משימת העברה.
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- project-id: מזהה הפרויקט
- region: האזור של הפרויקט
- migration-job-id: מזהה משימת ההעברה
ה-method של ה-HTTP וכתובת ה-URL:
DELETE https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
"metadata": {
"@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
"createTime": "2020-06-12T14:46:01.744267779Z",
"target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
"verb": "delete",
"requestedCancellation": false,
"apiVersion": "v1"
},
"done": false
}
gcloud
מידע נוסף על שימוש ב-gcloud למחיקת משימת ההעברה זמין כאן.