‫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
כדי לפתוח את הדף סקירה כללית של מכונה, לוחצים על שם המכונה.
לוחצים על Edit.
בקטע Customize your instance (התאמה אישית של המופע), אם מופיע התפריט Show configuration options (הצגת אפשרויות ההגדרה), לוחצים עליו.
מעדכנים את ההגדרות שניתנות לעריכה במופע.

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

gcloud

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

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

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

מידע נוסף על פלאגים להגדרת מופעים זמין במאמר בנושא gcloud sql instances patch.

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 למכונת Cloud SQL‏ myinstance שנמצאת בפרויקט 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) של השרת במופע כדי להשתמש באפשרות של CA משותף (GOOGLE_MANAGED_CAS_CA) או באפשרות של CA בניהול הלקוח (CUSTOMER_MANAGED_CAS_CA).

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

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

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

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

המסוף

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

כניסה לדף Cloud SQL Instances
כדי לפתוח את הדף סקירה כללית של מכונה, לוחצים על שם המכונה.
לוחצים על Edit.
בקטע Customize your instance (התאמה אישית של המופע), מרחיבים את האפשרות Show configuration options (הצגת אפשרויות ההגדרה).
לוחצים על אבטחה.
בקטע Server certificate authority mode (מצב רשות האישורים של השרת), בוחרים באפשרות Google managed CAS certificate authority (רשות אישורים של CAS בניהול Google).
אופציונלי: כדי להפעיל את הסיבוב האוטומטי של אישורי השרת, מסמנים את התיבה Rotate server certificates automatically.
לוחצים על 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 משותף, משתמשים בשיטה 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, אתם צריכים להגדיר את ההגדרה של שם חלופי של בעלים (subject) (SAN) בהתאמה אישית בזמן יצירת המכונה. שם ה-DNS המותאם אישית שמוסיפים להגדרת ה-SAN המותאמת אישית, מתווסף לשדה ה-SAN של אישור השרת של המופע. כך תוכלו להשתמש בשם ה-DNS המותאם אישית עם אימות שם המארח בצורה מאובטחת.

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

מוסיפים שמות DNS למופע: מוסיפים לרשימה מופרדת בפסיקים של עד שלושה שמות DNS מותאמים אישית להגדרה של SAN מותאם אישית. שמות המארחים האלה מתווספים לשדה SAN באישור השרת ב-Cloud SQL. אפשר לאבטח כמה שמות 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)

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

עריכת מופעים