Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

ניהול פרופילי חיבור באמצעות ה-API

‫MySQL | PostgreSQL | PostgreSQL ל-AlloyDB

סקירה כללית

בדף הזה מוסבר איך להשתמש ב-Database Migration Service API כדי לנהל פרופילי חיבור למסד נתונים של PostgreSQL כמקור ול-PostgreSQL כיעד.

יש שתי דרכים להשתמש ב-API של Database Migration Service. אפשר לבצע קריאות ל-API בארכיטקטורת REST או להשתמש ב-Google Cloud CLI ‏ (CLI).

כדי לראות מידע כללי על השימוש ב-gcloud לניהול פרופילים של חיבורים ל-Database Migration Service, לוחצים כאן.

יצירת פרופיל חיבור למסד נתונים של PostgreSQL

בדוגמה הבאה מוצגת בקשה ליצירת פרופיל חיבור למסד נתונים של PostgreSQL כמקור.

REST

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫project-id: מזהה הפרויקט
‫region: האזור של הפרויקט
‫connection-profile-id: מזהה פרופיל החיבור
‫connection-profile-display-name: השם המוצג של פרופיל החיבור
‫host-ip-address: כתובת ה-IP של המקור
‫username: שם המשתמש במסד הנתונים
‫password: הסיסמה של משתמש מסד הנתונים
‫client-key: המפתח הפרטי הלא מוצפן בפורמט PEM של PKCS#1 או PKCS#8 שמשויך לאישור הלקוח. אם משתמשים בשדה הזה, חובה למלא את השדה clientCertificate.
‫client-certificate: האישור בקידוד PEM של x509 שישמש את העותק המשוכפל לאימות מול שרת מסד הנתונים של המקור.אם משתמשים בשדה הזה, חובה להשתמש בשדה clientKey.
‫ca-certificate: שדה חובה. אישור X.509 בקידוד PEM של רשות האישורים שחתמה על האישור של שרת מסד הנתונים של המקור. העותק ישתמש באישור הזה כדי לוודא שהוא מתחבר למארח הנכון.

ה-method של ה-HTTP וכתובת ה-URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id

תוכן בקשת JSON:


{
"displayName": "connection-profile-display-name",
  "postgres": {
      "host": "host-ip-address",
      "port": 5432,
      "username": "username",
      "password": "password",
      "ssl": {
        "clientKey": "client-key",
        "clientCertificate": "client-certificate",
        "caCertificate": "ca-certificate"
      }
  }
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‫Curl (Linux,‏ macOS או Cloud Shell)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id"

‎PowerShell (Windows)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id" | Select-Object -Expand Content

אתם אמורים לקבל תגובת 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/connectionProfiles/connection-profile-id",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

כדי לראות מידע כללי על השימוש ב-gcloud ליצירת פרופילים של חיבורים ל-Database Migration Service, לוחצים כאן.

אחרי שיוצרים את פרופיל החיבור, אפשר לראות את המידע עליו באמצעות הקריאה לשיטה connectionProfiles/get.

REST

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫project-id: מזהה הפרויקט
‫region: האזור של הפרויקט
‫connection-profile-id: מזהה פרופיל החיבור

ה-method של ה-HTTP וכתובת ה-URL:

GET https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‫Curl (Linux,‏ macOS או Cloud Shell)

מריצים את הפקודה הבאה:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id"

‎PowerShell (Windows)

מריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id" | Select-Object -Expand Content

אתם אמורים לקבל תגובת JSON שדומה לזו:


{
  "name": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
  "createTime": "2019-12-22T16:17:37.159786963Z",
  "updateTime": "2019-12-24T13:13:39.455857411Z",
  "state": "READY",
  "displayName": "connection-profile-display-name",
  "postgres": {
    "host": "host-ip-address",
    "port": 5432,
    "username": "username"
  }
}

gcloud

מידע נוסף על שימוש ב-gcloud כדי לאחזר מידע על פרופיל החיבור זמין כאן.

יצירת פרופיל חיבור למסד נתונים של Cloud SQL ל-PostgreSQL

בדוגמה הבאה מוצגת בקשה ליצירת פרופיל חיבור למסד נתונים של Cloud SQL ל-PostgreSQL כמקור. בדוגמה הזו נעשה שימוש בפרופיל חיבור של PostgreSQL כי הוא מתחבר למנוע מסד הנתונים של PostgreSQL ולא לשכבת הניהול של Cloud SQL.

כדי ליצור את ההתאמה בין המקור לבין העותק באמצעות Cloud SQL, צריך לספק את מזהה המכונה של מסד הנתונים ב-Cloud SQL. אפשר למצוא את הערך של מזהה המופע באמצעות ה-method‏ databases/list של Cloud SQL Admin API.

REST

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫project-id: מזהה הפרויקט
‫region: האזור של הפרויקט
‫connection-profile-id: מזהה פרופיל החיבור
‫connection-profile-display-name: השם המוצג של פרופיל החיבור
‫host-ip-address: כתובת ה-IP של המקור
‫username: שם המשתמש במסד הנתונים
‫password: הסיסמה של משתמש מסד הנתונים
‫cloud-sql-instance-id: מזהה מופע Cloud SQL

ה-method של ה-HTTP וכתובת ה-URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id

תוכן בקשת JSON:


{
"displayName": "connection-profile-display-name",
  "postgres": {
      "host": "host-ip-address",
      "port": 5432,
      "username": "username",
      "password": "password",
      "cloud_sql_id": "cloud-sql-instance-id"
  }
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‫Curl (Linux,‏ macOS או Cloud Shell)

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id"

‎PowerShell (Windows)

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id" | Select-Object -Expand Content

אתם אמורים לקבל תגובת 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/connectionProfiles/connection-profile-id",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

כדי לראות מידע כללי על השימוש ב-gcloud ליצירת פרופילים של חיבורים ל-Database Migration Service, לוחצים כאן.

למידע נוסף על שימוש ב-gcloud כדי ליצור פרופיל חיבור למסד נתונים של Cloud SQL ל-PostgreSQL, אפשר ללחוץ כאן.

יצירת פרופיל חיבור ליעד Cloud SQL ל-PostgreSQL

בדוגמה הבאה מוצגת בקשה ליצירת פרופיל חיבור ליעד Cloud SQL ל-PostgreSQL. Database Migration Service משתמש במידע שבבקשה הזו כדי ליצור מכונה חדשה של Cloud SQL ל-PostgreSQL.

REST

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫project-id: מזהה הפרויקט
‫region: האזור של הפרויקט
‫connection-profile-id: מזהה פרופיל החיבור
‫connection-profile-display-name: השם המוצג של פרופיל החיבור
‫database-version: גרסת מסד הנתונים. לדוגמה, POSTGRES_12.
‫tier: סוג המכונה. לדוגמה, db-custom-1-4096.
‫data-disk-type: סוג דיסק הנתונים. לדוגמה, PD_SSD.
‫data-disk-size-gb: גודל דיסק הנתונים, ב-GB. לדוגמה, 20.
‫zone: האזור באזור הפרויקט
‫cmek_key_name: אופציונלי: הנתיב והשם המלאים של מפתח הצפנה בניהול הלקוח (CMEK). לדוגמה, "projects/project-id/locations/location/keyRings/ring/cryptoKeys/customer-managed-encryption-key".

כל הנתונים שמאוחסנים ב- Google Cloud מוצפנים במצב לא פעיל באמצעות אותן מערכות מוקשחות לניהול מפתחות שבהן אנחנו משתמשים לנתונים המוצפנים שלנו. מערכות ניהול המפתחות האלה מספקות בקרות גישה מחמירות למפתחות וביקורת, ומצפינות את נתוני המשתמשים באחסון במצב מנוחה באמצעות תקני הצפנה של AES-256. לא נדרשת הגדרה, קביעת תצורה או ניהול. Google Cloudההצפנה במנוחה שמוגדרת כברירת מחדל היא הבחירה הטובה ביותר למשתמשים שאין להם דרישות ספציפיות שקשורות לתאימות או למיקום של חומר קריפטוגרפי.

אם אתם צריכים יותר שליטה במפתחות שמשמשים להצפנת נתונים במנוחה ב Google Cloud פרויקט, תוכלו להשתמש ב-Database Migration Service כדי להגן על הנתונים באמצעות מפתחות הצפנה שמנוהלים על ידכם ב-Cloud Key Management Service‏ (KMS). מפתחות ההצפנה האלה נקראים מפתחות הצפנה בניהול הלקוח (CMEK). כשמגנים על נתונים ב-Database Migration Service באמצעות CMEK, מפתח ה-CMEK נמצא בשליטתכם.

הפרמטר cmek_key_name משויך ל-CMEK ש-Database Migration Service יכול להשתמש בו כדי להצפין נתונים שמועברים מהמקור ליעד. מפתח ה-CMEK מיוצג על ידי ה-placeholder‏ customer-managed-encryption-key.

ה-placeholder ‏ring מייצג את אוסף המפתחות של מפתח ה-CMEK. אוסף מפתחות מארגן מפתחות במיקום ספציפי ומאפשר לכם לנהל את בקרת הגישה לקבוצות של מפתחות. Google Cloud השם של אוסף המפתחות לא צריך להיות ייחודי בכל Google Cloud הפרויקט, אבל הוא חייב להיות ייחודי במיקום נתון. מידע נוסף על מחזיקי מפתחות זמין במאמר משאבי Cloud KMS.

במסגרת יצירת פרופיל החיבור, Database Migration Service יאמת שמפתח ה-CMEK קיים, וש-Database Migration Service קיבל הרשאות להשתמש במפתח.

אם אחד מהתנאים האלה לא מתקיים, תוחזר הודעת השגיאה הבאה:

CMEK_DOES_NOT_EXIST_OR_MISSING_PERMISSIONS

כדי לפתור את הבעיה, צריך לוודא שהמפתח שסיפקתם קיים, ושלחשבון השירות של Database Migration Service יש הרשאת cloudkms.cryptoKeys.get למפתח.

אם אתם מעדיפים להשתמש במערכת הפנימית לניהול מפתחות של Google Cloudבמקום במפתח CMEK כדי להצפין את הנתונים, אל תכללו את הפרמטר cmek_key_name והערך שלו בבקשת ה-API.

ה-method של ה-HTTP וכתובת ה-URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id

תוכן בקשת JSON:

{
  "displayName": "connection-profile-display-name",
  "cloudsql": {
    "settings": {
      "databaseVersion": "database-version",
      "tier": "machine-type",
      "storageAutoResizeLimit": 0,
      "activationPolicy": "ALWAYS",
      "ipConfig":
        {
        "authorizedNetworks": [],
        "enableIpv4": true,
        "privateNetwork": null
      },
      "autoStorageIncrease": false,
      "dataDiskType": "data-disk-type",
      "dataDiskSizeGb": "data-disk-size",
      "zone": "zone",
      "sourceId": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
      "cmek_key_name": "projects/project-id/locations/location/keyRings/ring/cryptoKeys/customer-managed-encryption-key"
    }
  }
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‫Curl (Linux,‏ macOS או Cloud Shell)

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id"

‎PowerShell (Windows)

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id" | Select-Object -Expand Content

אתם אמורים לקבל תגובת 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/connectionProfiles/connection-profile-id",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

כדי לראות מידע כללי על השימוש ב-gcloud ליצירת פרופילים של חיבורים ל-Database Migration Service, לוחצים כאן.

קבלת מידע על פרופיל חיבור

REST

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫project-id: מזהה הפרויקט
‫region: האזור של הפרויקט
‫connection-profile-id: מזהה פרופיל החיבור

ה-method של ה-HTTP וכתובת ה-URL:

GET https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‫Curl (Linux,‏ macOS או Cloud Shell)

מריצים את הפקודה הבאה:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id"

‎PowerShell (Windows)

מריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id" | Select-Object -Expand Content

אתם אמורים לקבל תגובת JSON שדומה לזו:


{
  "name": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
  "createTime": "2019-12-22T16:17:37.159786963Z",
  "updateTime": "2019-12-24T13:13:39.455857411Z",
  "state": "READY",
  "displayName": "connection-profile-display-name",
  "postgres": {
    "host": "host-ip-address",
    "port": 5432,
    "username": "username"
  }
}

gcloud

מידע נוסף על שימוש ב-gcloud כדי לאחזר מידע על פרופיל החיבור זמין כאן.

הצגת רשימה של פרופילי קישור

בדוגמה הבאה מוצגת בקשה לאחזור מידע על כל פרופילי החיבור שלכם.

REST

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫project-id: מזהה הפרויקט
‫region: האזור של הפרויקט

אפשר גם לסנן את רשימת פרופילי החיבור ש-Database Migration Service מאחזר, באופן הבא:

orderBy: אפשר להשתמש במסנן הזה כדי לאחזר רשימה של כל פרופילי החיבור לאזור מסוים, לפי סדר אלפביתי. לדוגמה, המסנן orderBy=name מחזיר את כל פרופילי החיבור, לפי סדר אלפביתי של השם.
pageSize: משתמשים במסנן הזה כדי לציין את המספר המקסימלי של פרופילי חיבור ש-Database Migration Service מאחזר ומציג בדף. לדוגמה, אם מגדירים את הערך pageSize=10, Database Migration Service יחזיר עד 10 פרופילים של חיבורים לדף.

אם יש יותר מ-10 פרופילים של חיבורים, הם יופיעו בדפים אחרים. בסוף כל דף מופיעים פרמטר nextPageToken ומזהה ייחודי. משתמשים במזהה כדי לאחזר את רשימת פרופילי החיבור בדף הבא.

ה-method של ה-HTTP וכתובת ה-URL:

GET https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‫Curl (Linux,‏ macOS או Cloud Shell)

מריצים את הפקודה הבאה:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles"

‎PowerShell (Windows)

מריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles" | Select-Object -Expand Content

אתם אמורים לקבל תגובת JSON שדומה לזו:


{
  "connectionProfiles": [
    {
      "name": "projects/project-id/locations/region/connectionProfiles/name-of-first-connection-profile",
      "createTime": "2019-12-22T16:17:37.159786963Z",
      "updateTime": "2019-12-24T13:13:39.455857411Z",
      "state": "READY",
      "displayName": "display-name-of-first-connection-profile",
      "postgres": {
        "host": "host-ip-address-of-first-connection-profile",
        "port": port-number-of-first-connection-profile,
        "username": "username-of-first-connection-profile",
        "password_set": "true"
      }
    }
    {
      "name": "projects/project-id/locations/region/connectionProfiles/name-of-second-connection-profile",
      "createTime": "2020-11-21T19:22:25.153824963Z",
      "updateTime": "2020-11-11T11:15:14.451046111Z",
      "state": "READY",
      "displayName": "display-name-of-second-connection-profile",
      "postgres": {
        "host": "host-ip-address-of-second-connection-profile",
        "port": port-number-of-second-connection-profile,
        "username": "username-of-second-connection-profile",
        "password_set": "true"
      }
    }
  ]
}

gcloud

כאן אפשר לקבל מידע נוסף על השימוש ב-gcloud כדי לאחזר מידע על כל פרופילי החיבור.

עדכון פרופיל קישור

בדוגמה הבאה מוצגת בקשה לעדכון השדות של שם המשתמש והסיסמה בפרופיל חיבור קיים. כשמשתמשים בפרמטר updateMask בבקשה, צריך לכלול בגוף הבקשה רק את השדות האלה.

REST

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫project-id: מזהה הפרויקט
‫region: האזור של הפרויקט
‫connection-profile-id: מזהה פרופיל החיבור
‫username: שם המשתמש במסד הנתונים
‫password: הסיסמה של משתמש מסד הנתונים

ה-method של ה-HTTP וכתובת ה-URL:

PATCH https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id?updateMask=postgres.username,postgres.password

תוכן בקשת JSON:


{
  "postgres" {
    "username": "username",
    "password": "password"
  }
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‫Curl (Linux,‏ macOS או Cloud Shell)

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id?updateMask=postgres.username,postgres.password"

‎PowerShell (Windows)

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id?updateMask=postgres.username,postgres.password" | Select-Object -Expand Content

אתם אמורים לקבל תגובת 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/connectionProfiles/connection-profile-id",
    "verb": "update",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

כאן אפשר לקרוא מידע נוסף על שימוש ב-gcloud כדי לעדכן את פרופיל החיבור.

מחיקת פרופיל קישור

חשוב: אפשר למחוק פרופיל חיבור רק אם אין משימות פעילות של העברה שמשויכות לפרופיל. אם יש בפרופיל החיבור משימות פעילות של העברה, צריך לקדם או למחוק את המשימות.

כדי לראות אם יש פרופיל חיבור עם משימות פעילות שמשויכות אליו, מריצים את הפקודה הבאה:

GET https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs?filter=state:STATE_NAME OR state:STATE_NAME AND source:projects/project-id/locations/region/connectionProfiles/connection-profile-id

לדוגמה:

GET https://datamigration.googleapis.com/v1/projects/myproject/locations/myregion/migrationJobs?filter=state:RUNNING OR state:FAILED AND source:projects/myproject/locations/myregion/connectionProfiles/postgres-src1

אלה המצבים (הסטטוסים) השונים של עבודת ההעברה:

NOT STARTED: נוצרת עבודת ההעברה, אבל היא לא מופעלת.
STARTING: תהליך ההפעלה של עבודת ההעברה מתבצע.
RUNNING: משימת ההעברה פועלת ואפשר להשתמש בה כדי להעביר נתונים ממסד הנתונים של המקור למסד הנתונים של היעד.
STOPPING: תהליך העצירה של עבודת המיגרציה מתבצע.
‫STOPPED: עבודת המיגרציה מושהית, והנתונים לא מועברים יותר למסד הנתונים של היעד.
RESUMING: עבודת ההעברה שהושהתה פועלת.
FAILED: הייתה בעיה בזמן הפעלת משימת ההעברה.
RESTARTING: שירות העברת מסד נתונים מצלם תמונה חדשה של מסד הנתונים של המקור, טוען את הנתונים הראשוניים למסד הנתונים של היעד ומעבד שינויים שוטפים בנתונים ממסד הנתונים של המקור למסד הנתונים של היעד.

אם למשתמש יש משימת העברה באחד מהסטטוסים האלה, והוא מנסה למחוק את פרופיל החיבור, הפעולה תיכשל.

REST

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫project-id: מזהה הפרויקט
‫region: האזור של הפרויקט
‫connection-profile-id: מזהה פרופיל החיבור

ה-method של ה-HTTP וכתובת ה-URL:

DELETE https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‫Curl (Linux,‏ macOS או Cloud Shell)

מריצים את הפקודה הבאה:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id"

‎PowerShell (Windows)

מריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id" | Select-Object -Expand Content

אתם אמורים לקבל תגובת 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/connectionProfiles/connection-profile-id",
    "verb": "delete",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

מידע נוסף על שימוש ב-gcloud למחיקת פרופיל החיבור זמין כאן.

מחיקת פרופיל קישור ומכונת Cloud SQL שמשויכת אליו

בדוגמה הבאה מוצגת בקשה למחיקת פרופיל חיבור ליעד, וגם מחיקה מדורגת של מכונת Cloud SQL המשויכת.

REST

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫project-id: מזהה הפרויקט
‫region: האזור של הפרויקט
‫connection-profile-id: מזהה פרופיל החיבור

ה-method של ה-HTTP וכתובת ה-URL:

DELETE https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id?force=true

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‫Curl (Linux,‏ macOS או Cloud Shell)

מריצים את הפקודה הבאה:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id?force=true"

‎PowerShell (Windows)

מריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id?force=true" | Select-Object -Expand Content

אתם אמורים לקבל תגובת 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/connectionProfiles/connection-profile-id",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

למידע נוסף על שימוש ב-gcloud כדי למחוק גם את פרופיל החיבור וגם את מכונת Cloud SQL המשויכת, אפשר ללחוץ כאן.

ניהול פרופילי חיבור באמצעות ה-API קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

סקירה כללית

יצירת פרופיל חיבור למסד נתונים של PostgreSQL

REST

‫Curl (Linux,‏ macOS או Cloud Shell)

‎PowerShell (Windows)

gcloud

REST

‫Curl (Linux,‏ macOS או Cloud Shell)

‎PowerShell (Windows)

gcloud

יצירת פרופיל חיבור למסד נתונים של Cloud SQL ל-PostgreSQL

REST

‫Curl (Linux,‏ macOS או Cloud Shell)

‎PowerShell (Windows)

gcloud

יצירת פרופיל חיבור ליעד Cloud SQL ל-PostgreSQL

REST

‫Curl (Linux,‏ macOS או Cloud Shell)

‎PowerShell (Windows)

gcloud

קבלת מידע על פרופיל חיבור

REST

‫Curl (Linux,‏ macOS או Cloud Shell)

‎PowerShell (Windows)

gcloud

הצגת רשימה של פרופילי קישור

REST

‫Curl (Linux,‏ macOS או Cloud Shell)

‎PowerShell (Windows)

gcloud

עדכון פרופיל קישור

REST

‫Curl (Linux,‏ macOS או Cloud Shell)

‎PowerShell (Windows)

gcloud

מחיקת פרופיל קישור

REST

‫Curl (Linux,‏ macOS או Cloud Shell)

‎PowerShell (Windows)

gcloud

מחיקת פרופיל קישור ומכונת Cloud SQL שמשויכת אליו

REST

‫Curl (Linux,‏ macOS או Cloud Shell)

‎PowerShell (Windows)

gcloud

ניהול פרופילי חיבור באמצעות ה-API