‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

עריכת מופעים

MySQL | PostgreSQL | SQL Server

בדף הזה מוסבר איך לערוך מכונה קיימת של Cloud SQL.

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

אתם יכולים לשלב את Cloud SQL ל-SQL Server עם השירות המנוהל ל-Microsoft Active Directory (שירות מנוהל ל-Microsoft AD). השילוב הזה כולל יכולות להצטרפות לדומיין של שירות מנוהל ל-Microsoft AD ולעזיבה שלו ברמת המכונה. מידע נוסף זמין במאמר סקירה כללית על שירות מנוהל ל-Microsoft AD ב-Cloud SQL.

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

עריכת מופע

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

המסוף

נכנסים לדף Cloud SQL Instances במסוף Google Cloud .

כניסה לדף Cloud SQL Instances
כדי לפתוח את הדף Overview של מכונה, לוחצים על שם המכונה.
לוחצים על Edit.
בקטע Customize your instance, אם התפריט Show configuration options מופיע, לוחצים עליו.
מעדכנים את ההגדרות שניתנות לעריכה במכונה.

מידע נוסף על הגדרות המכונה
לוחצים על Save.

gcloud

הפקודה הזו משנה את שעת ההתחלה של הגיבוי.

gcloud sql instances patch INSTANCE_NAME \
--backup-start-time 16:00

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

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

REST v1

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

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

‫PROJECT_ID: מזהה הפרויקט
‫INSTANCE_ID: מזהה המכונה
‫PRIVATE_NETWORK: הרשת שמוסיפים או בוחרים כדי ליצור חיבור פרטי

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

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID

תוכן בקשת JSON:

{
  "settings": {
    "backupConfiguration": {
      "startTime": "16:00",
      "enabled": true,
      "binaryLogEnabled": true
    }
  }
    "ipConfiguration": {
      "privateNetwork": "PRIVATE_NETWORK",
      "authorizedNetworks": [],
      "ipv4Enabled": false,
    }
}

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

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

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

שומרים את גוף הבקשה בקובץ בשם 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://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_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 PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

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

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

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

כדי לראות איך בקשת ה-API הבסיסית בארכיטקטורת REST בנויה למשימה הזו, עיינו ב-APIs Explorer בדף instances:patch.

‫REST v1beta4

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

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

‫PROJECT_ID: מזהה הפרויקט
‫INSTANCE_ID: מזהה המכונה
‫PRIVATE_NETWORK: הרשת שמוסיפים או בוחרים כדי ליצור חיבור פרטי

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

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

תוכן בקשת JSON:

{
  "settings": {
    "backupConfiguration": {
      "startTime": "16:00",
      "enabled": true,
      "binaryLogEnabled": true
    }
  }
    "ipConfiguration": {
      "privateNetwork": "PRIVATE_NETWORK",
      "authorizedNetworks": [],
      "ipv4Enabled": false,
    }
}

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

‫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://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID"

‎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://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

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

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

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

כדי לראות איך בקשת ה-API הבסיסית בארכיטקטורת REST בנויה למשימה הזו, עיינו ב-APIs Explorer בדף instances:patch.

עריכת מכונה עם Private Service Connect מופעל

אפשר לעדכן מכונה שמופעל בה Private Service Connect באמצעות ה-CLI של gcloud או ה-API. לדוגמה, אתם יכולים לעדכן פרויקטים שמשויכים למכונות למטרות הבאות:

כדי לאפשר חיבורים מנקודות קצה של Private Service Connect למכונות של Cloud SQL.
בכל המכונות של Cloud SQL שנוצרו, שוכפלו או ש-Private Service Connect הופעל בהן באוגוסט 2026 ואילך, התכונה "ניהול חיבורים" מופעלת כברירת מחדל ואי אפשר להשבית אותה. כשמסירים פרויקט מרשימת הפרויקטים המורשים, כל החיבורים הקיימים של Private Service Connect מהפרויקט שהוסר נסגרים מיד (מתואמים). כלומר, אפליקציות שמשתמשות בנקודות קצה של Private Service Connect בפרויקטים שהוסרו לא יכולות להמשיך להתחבר באמצעות נקודות הקצה האלה. במכונות שנוצרו לפני אוגוסט 2026, כשמסירים פרויקט מרשימת הפרויקטים המורשים, אפליקציות שמשתמשות בנקודות קצה של Private Service Connect בפרויקטים שהוסרו ממשיכות להתחבר עד שמסירים את נקודות הקצה האלה באופן ידני.

gcloud

כדי לעדכן את הפרויקטים שיכולים להשתמש ב-Private Service Connect, משתמשים בפקודה gcloud sql instances patch:

gcloud sql instances patch INSTANCE_NAME \
--project=PROJECT_ID \
--allowed-psc-projects=ALLOWED_PROJECTS

מחליפים את הפרטים הבאים:

‫INSTANCE_NAME: השם של מכונת Cloud SQL שאליה יכולות להתחבר נקודות קצה של Private Service Connect ברשתות VPC.
‫PROJECT_ID: המזהה או מספר הפרויקט של הפרויקט ב- Google Cloud שמכיל את המכונה שאליה יכולות להתחבר נקודות קצה של Private Service Connect ברשתות VPC.
‫ALLOWED_PROJECTS: רשימה של מזהי פרויקטים או מספרי פרויקטים מותרים, מופרדים בפסיקים. הפרויקטים האלה מבטלים פרויקטים שכבר מוגדרים לשימוש ב-Private Service Connect. אם פרויקט לא מופיע ברשימה הזו, אי אפשר להשתמש בו כדי ליצור מכונה ולהפעיל בה את Private Service Connect.

בדוגמה הבאה, שני פרויקטים (98765 ו-87654) יכולים ליצור חיבורים מנקודות קצה של Private Service Connect למכונה myinstance של Cloud SQL, שנמצאת בפרויקט 12345:

gcloud sql instances patch myinstance \
--project=12345 \
--allowed-psc-projects='98765','87654'

כדי להסיר את כל הפרויקטים המורשים, משתמשים בפקודה gcloud sql instances patch ובדגל
--clear-allowed-psc-projects:

gcloud sql instances patch INSTANCE_NAME \
--project=PROJECT_ID \
--clear-allowed-psc-projects

הדגל הזה מבטיח שאף פרויקט לא יאושר בטעות.

REST v1

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

‫PROJECT_ID: המזהה או מספר הפרויקט של הפרויקט ב- Google Cloud שמכיל את המכונה שאליה יכולות להתחבר נקודות קצה של Private Service Connect ברשתות VPC.
‫INSTANCE_NAME: השם של מכונת Cloud SQL שאליה יכולות להתחבר נקודות קצה של Private Service Connect ברשתות VPC.
‫ALLOWED_PROJECTS: רשימה של מזהי פרויקטים או מספרי פרויקטים מותרים, מופרדים בפסיקים. הפרויקטים האלה מבטלים פרויקטים שכבר מוגדרים לשימוש ב-Private Service Connect. אם פרויקט לא מופיע ברשימה הזו, אי אפשר להשתמש בו כדי ליצור מכונה ולהפעיל בה את Private Service Connect.

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

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

תוכן בקשת JSON:

{
  "kind": "sql#instance",
  "name": "INSTANCE_NAME",
  "project": "PROJECT_ID",
  "settings": {
    "ipConfiguration": {
      "pscConfig": {
        "allowedConsumerProjects": [ALLOWED_PROJECTS]
      }
    },
    "kind": "sql#settings"
  }
}

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

‫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://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

‎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://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

כדי להסיר את כל הפרויקטים המורשים, משתמשים בדגל clear-allowed-psc-projects. הדגל הזה מבטיח שאף פרויקט לא יאושר בטעות.

כדי לראות איך בקשת ה-API הבסיסית בארכיטקטורת REST בנויה למשימה הזו, עיינו ב-APIs Explorer בדף instances:patch.

‫REST v1beta4

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

‫PROJECT_ID: המזהה או מספר הפרויקט של הפרויקט ב- Google Cloud שמכיל את המכונה שאליה יכולות להתחבר נקודות קצה של Private Service Connect ברשתות VPC.
‫INSTANCE_NAME: השם של מכונת Cloud SQL שאליה יכולות להתחבר נקודות קצה של Private Service Connect ברשתות VPC.
‫ALLOWED_PROJECTS: רשימה של מזהי פרויקטים או מספרי פרויקטים מותרים, מופרדים בפסיקים. הפרויקטים האלה מבטלים פרויקטים שכבר מוגדרים לשימוש ב-Private Service Connect. אם פרויקט לא מופיע ברשימה הזו, אי אפשר להשתמש בו כדי ליצור מכונה ולהפעיל בה את Private Service Connect.

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

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

תוכן בקשת JSON:

{
  "kind": "sql#instance",
  "name": "INSTANCE_NAME",
  "project": "PROJECT_ID",
  "settings": {
    "ipConfiguration": {
      "pscConfig": {
        "allowedConsumerProjects": [ALLOWED_PROJECTS]
      }
    },
    "kind": "sql#settings"
  }
}

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

‫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://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

‎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://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

כדי להסיר את כל הפרויקטים המורשים, משתמשים בדגל clear-allowed-psc-projects. הדגל הזה מבטיח שאף פרויקט לא יאושר בטעות.

כדי לראות איך בקשת ה-API הבסיסית בארכיטקטורת REST בנויה למשימה הזו, עיינו ב-APIs Explorer בדף instances:patch.

עריכת מצב ה-CA של השרת במכונה

אתם יכולים לשנות את מצב רשות האישורים (CA) של השרת במכונה, כדי להשתמש באפשרות של רשות אישורים משותפת (GOOGLE_MANAGED_CAS_CA) או באפשרות של רשות אישורים בניהול הלקוח (CUSTOMER_MANAGED_CAS_CA).

אי אפשר לשנות מכונה כך שתשתמש באפשרות של רשות אישורים לכל מכונה (GOOGLE_MANAGED_INTERNAL_CA), שהיא הגדרת ברירת המחדל.

מידע נוסף על האפשרויות השונות של מצב CA של השרת זמין במאמר היררכיות של רשויות אישורים (CA).

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

עיינו ברשימת Google Cloud השירותים שלא תומכים בחיבורים למכונות Cloud SQL שמוגדרות להשתמש ב-CA משותף או ב-CA בניהול הלקוח. אם אתם צריכים להשתמש בשירות בפריסה שלכם, יכול להיות שתצטרכו לדחות את העדכון.
אם אתם משתמשים ב-Cloud SQL Auth Proxy או בכל אחד ממחברי השפה של Cloud SQL כדי להתחבר למכונה, ודאו שהם מריצים את הגרסאות המינימליות הנדרשות. ל-CA משותף, צריך להשתמש ב-Cloud SQL Auth Proxy בגרסה 2.13.0 ואילך, ול-CA בניהול הלקוח, צריך להשתמש ב-Cloud SQL Auth Proxy בגרסה 2.14.3 ואילך. במאמר הדרישות של מחברי השפה של Cloud SQL מפורטות הגרסאות המינימליות הנדרשות של מחברי השפה של Cloud SQL.
אם אתם עוברים ל-CA משותף, הורידו את חבילות ה-CA הגלובליות והאזוריות, העתיקו אותן ללקוחות מסד הנתונים שלכם והגדירו אותם כך שיתנו אמון ברשויות האישורים האלה. כדי למנוע הפרעות אפשריות ללקוחות של מסד הנתונים, כדאי להגדיר את האישורים לפני שמשנים את הגדרת מצב ה-CA של השרת.
אם אתם עוברים ל-CA בניהול הלקוח, בצעו את הפעולות הבאות:
- חשוב לוודא שכבר יצרתם מאגר רשויות להנפקת אישורים (CA) ונתתם לחשבון השירות גישה למאגר.
- מוודאים שיש לפחות רשות אחת להנפקת אישורים במאגר רשויות להנפקת אישורים (CA).
- כדי למנוע שיבושים אחרי העדכון, הורידו את האישורים מה-CA שמנוהל על ידי הלקוח, והגדירו את לקוחות מסד הנתונים כך שיסמכו על ה-CA שלכם.

המסוף

נכנסים לדף Cloud SQL Instances במסוף Google Cloud .

כניסה לדף Cloud SQL Instances
כדי לפתוח את הדף Overview של מכונה, לוחצים על שם המכונה.
לוחצים על Edit.
בקטע Customize your instance, מרחיבים את Show configuration options.
לוחצים על אבטחה.
בקטע Server certificate authority mode, בוחרים באפשרות Google managed CAS certificate authority.
אופציונלי: כדי להפעיל את הרוטציה האוטומטית של אישורי השרת, מסמנים את התיבה רוטציה אוטומטית של אישורי השרת.
לוחצים על Save.

כדי לעדכן את המכונה כך שתשתמש ב-CA בניהול הלקוח במקום ב-CA לכל מכונה או ב-CA משותף, קראו את המאמר שימוש ב-CA בניהול הלקוח.

gcloud

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

gcloud sql instances patch INSTANCE_NAME \
--server-ca-mode=GOOGLE_MANAGED_CAS_CA

‫INSTANCE_NAME: שם המכונה של Cloud SQL שרוצים לתקן.

בדגל --server-ca-mode, מציינים את הערך GOOGLE_MANAGED_CAS_CA.

REST

כדי לעדכן את המכונה כך שתשתמש ב-CA משותף במקום ב-CA לכל מכונה, משתמשים ב-method‏ instances.patch ומציינים את המאפיינים הבאים:

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

‫PROJECT_ID מזהה הפרויקט שבו נמצאת המכונה של Cloud SQL.
‫INSTANCE_ID השם של מכונת Cloud SQL שרוצים לתקן.

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

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID

תוכן בקשת JSON:

{
  "settings":{
     "ipConfiguration":
      {
         "serverCaMode": "GOOGLE_MANAGED_CAS_CA"
      }
   }
}

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

‫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://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID"

‎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://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

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

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2025-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

עריכת SAN בהתאמה אישית למכונה

אם אתם רוצים להשתמש בשם DNS בהתאמה אישית כדי להתחבר למכונה של Cloud SQL במקום להשתמש בכתובת IP, אתם צריכים להגדיר את השם החלופי של הבעלים (SAN) בהתאמה אישית בזמן שאתם יוצרים את המכונה. שם ה-DNS בהתאמה אישית שאתם מזינים בהגדרת ה-SAN בהתאמה אישית מתווסף לשדה ה-SAN של אישור השרת של המכונה. כך תוכלו להשתמש בשם ה-DNS בהתאמה אישית עם אימות שם המארח באופן מאובטח.

אפשר לבצע את הפעולות הבאות באמצעות SAN בהתאמה אישית לאישור שרת של מכונה:

הוספת שמות DNS למכונה: מוסיפים רשימה מופרדת בפסיקים של עד שלושה שמות DNS בהתאמה אישית להגדרה של SAN בהתאמה אישית. מערכת Cloud SQL מוסיפה את השמות האלה לשדה SAN של אישור השרת. אתם יכולים לאבטח כמה שמות DNS באמצעות אישור אחד.
שינוי שמות ה-DNS של המכונה: משנים את שמות ה-DNS בהתאמה אישית שרוצים להוסיף לשדה SAN של אישור השרת של המכונה.
הסרת שמות DNS מהמכונה: מסירים את כל שמות ה-DNS בהתאמה אישית מהשדה SAN של אישור השרת של המכונה.

אפשר לערוך SAN בהתאמה אישית למכונה באמצעות ה-CLI של gcloud או ה-API.

gcloud

כדי לערוך SAN בהתאמה אישית למכונה, משתמשים בפקודה gcloud sql instances patch:

gcloud sql instances patch INSTANCE_NAME \
--project=PROJECT_ID \
--custom-subject-alternative-names=DNS_NAMES

מחליפים את הפרטים הבאים:

‫INSTANCE_NAME: השם של מכונת Cloud SQL שיש לה אישור שרת, שאליו אתם מוסיפים, משנים או מסירים שמות DNS
‫PROJECT_ID: המזהה או מספר הפרויקט של הפרויקט ב- Google Cloud שמכיל את המכונה
‫DNS_NAMES: רשימה מופרדת בפסיקים של עד שלושה שמות DNS שמוסיפים לאישור השרת של המכונה.
הערה: אם כבר יש שמות DNS שהוספתם לאישור, ואתם משתמשים בפרמטר הזה כדי לציין שמות DNS אחרים, Cloud SQL מסיר את שמות ה-DNS המקוריים מהאישור.

כדי להסיר את כל שמות ה-DNS מאישור השרת של מכונה ב-Cloud SQL, משתמשים בפקודה gcloud sql instances patch ובדגל
--clear-custom-subject-alternative-names:

gcloud sql instances patch INSTANCE_NAME \
--project=PROJECT_ID \
--clear-custom-subject-alternative-names

הדגל הזה מבטיח שלא יתווספו שמות DNS לאישור בטעות.

REST

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

‫PROJECT_ID: המזהה או מספר הפרויקט ב- Google Cloud . בפרויקט הזה יש מכונה של Cloud SQL עם אישור שרת שאתם מוסיפים, משנים או מסירים את שמות ה-DNS שלו.
‫INSTANCE_NAME: שם המכונה.
‫DNS_NAMES: רשימה מופרדת בפסיקים של עד שלושה שמות DNS שאתם מוסיפים לאישור השרת של המכונה.

אם כבר הוספתם שמות DNS לאישור, ואתם משתמשים בפרמטר הזה כדי לציין שמות DNS אחרים, Cloud SQL מסיר את שמות ה-DNS המקוריים מהאישור.

אם לא תציינו שמות DNS לפרמטר customSubjectAlternativeNames, אלא תספקו את הערך null [], ‏Cloud SQL יסיר את כל שמות ה-DNS מאישור השרת של המכונה. כך אפשר לוודא ששמות DNS לא יתווספו לאישור בטעות.

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

PATCH https://sqladmin.googleapis.com/sql/v1veta4/projects/PROJECT_ID/instances/INSTANCE_NAME

תוכן בקשת JSON:

{
  "kind": "sql#instance",
  "name": "INSTANCE_NAME",
  "project": "PROJECT_ID",
  "settings": {
    "ipConfiguration": {
      "customSubjectAlternativeNames": "DNS_NAMES"
    },
    "kind": "sql#settings"
  }
}

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

‫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://sqladmin.googleapis.com/sql/v1veta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

‎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://sqladmin.googleapis.com/sql/v1veta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

כדי לראות איך בקשת ה-API הבסיסית בארכיטקטורת REST בנויה למשימה הזו, אפשר לעיין ב-APIs Explorer בדף instances:patch.

המאמרים הבאים

מידע על הגדרות המכונה

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

עריכת מופע

המסוף

gcloud

REST v1

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

‎PowerShell (Windows)

‫REST v1beta4

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

‎PowerShell (Windows)

עריכת מכונה עם Private Service Connect מופעל

gcloud

REST v1

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

‎PowerShell (Windows)

‫REST v1beta4

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

‎PowerShell (Windows)

עריכת מצב ה-CA של השרת במכונה

המסוף

gcloud

REST

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

‎PowerShell (Windows)

עריכת SAN בהתאמה אישית למכונה

gcloud

REST

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

‎PowerShell (Windows)

המאמרים הבאים

עריכת מופעים