הצגה והגדרה של חלונות תחזוקה

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

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

אלה האפשרויות לתזמון עדכון התחזוקה:

  • אם בוחרים באפשרות Any או לא מגדירים את ההגדרה הזו, עדכון התחזוקה יכול להתבצע בכל שלב, אבל בדרך כלל הוא מתבצע במהלך השבוע הראשון של ההשקה.
  • אם בוחרים באפשרות Week 1 (שנקראת גם preview ו-canary), עדכון התחזוקה מתבצע 7 עד 14 ימים אחרי שנשלחת ההודעה על התחזוקה.
  • אם בוחרים באפשרות Week 2 (שנקראת גם production ו-stable), עדכון התחזוקה מתבצע 15 עד 21 ימים אחרי שנשלחת ההתראה על התחזוקה.
  • אם בוחרים באפשרות Week 5, עדכון התחזוקה מתבצע 35 עד 42 ימים אחרי שנשלחת ההודעה על התחזוקה.

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

לפני שמתחילים

  1. In the Cloud de Confiance console, on the project selector page, select or create a Cloud de Confiance project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  2. Verify that billing is enabled for your Cloud de Confiance project.

  3. Install the gcloud CLI.

  4. Configure the gcloud CLI to use your federated identity.

    For more information, see Sign in to the gcloud CLI with your federated identity.

  5. To initialize the gcloud CLI, run the following command: 

    gcloud init

הגדרת חלון זמן לתחזוקה במכונה

המסוף

  1. נכנסים לדף Cloud SQL Instances במסוף Cloud de Confiance .

    כניסה לדף Cloud SQL Instances

  2. כדי לפתוח את הדף Overview של מכונה, לוחצים על שם המכונה.
  3. בקטע Maintenance, לוחצים על Edit maintenance preferences.
  4. בקטע Configuration options, פותחים את Maintenance.
  5. קובעים את ההגדרות הבאות:
    • תזמון התחזוקה. בוחרים את השבוע שבו רוצים להחיל את עדכון התחזוקה האוטומטי. יש לכם כמה אפשרויות:
      • ‫Any: עדכון התחזוקה יכול להתבצע בכל שלב, אבל בדרך כלל הוא מתבצע במהלך Week 1.
      • שבוע 1: התחזוקה מתבצעת 7 עד 14 ימים אחרי שליחת ההודעה על התחזוקה.
      • שבוע 2: עדכון התחזוקה מתבצע 15 עד 21 ימים אחרי שליחת ההתראה.
      • שבוע 5: עדכון התחזוקה מתבצע 35 עד 42 ימים אחרי שליחת ההתראה.
    • חלון זמן לתחזוקה. בוחרים את היום בשבוע ואת חלון הזמן המועדפים. האפשרויות כוללות:
      • כל חלון זמן: חלון הזמן לתחזוקה שמוגדר כברירת מחדל. עדכון התחזוקה לא מוגבל ליום מסוים בשבוע או לשעה מסוימת ביום.
      • Day of the week: בוחרים יום לחלון הזמן לתחזוקה: Saturday,‏ Sunday,‏ Monday,‏ Tuesday,‏ Wednesday,‏ Thursday או Friday.
      • שעה ביום: אם בוחרים יום בשבוע, אפשר גם לבחור שעה ביום. בוחרים מרווח של שעה באזור הזמן המקומי.

gcloud

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

gcloud sql instances patch INSTANCE_ID \
  --maintenance-window-day=DAY \
  --maintenance-window-hour=HOUR \
  --maintenance-release-channel=MAINTENANCE_TIMING

מחליפים את המשתנים הבאים:

  • ‫INSTANCE_ID: מזהה המכונה, שלא יכול להיות מכונה של רפליקה לקריאה בלבד.
  • ‫DAY: היום בשבוע שבו רוצים שתתבצע התחזוקה. צריך להגדיר את הערך MONDAY,‏ TUESDAY,‏ WEDNESDAY,‏ THURSDAY,‏ FRIDAY,‏ SATURDAY או SUNDAY. צריך לציין את אזור הזמן UTC.
  • ‫HOUR: השעה ביום, 0 עד 23, שבה יתבצע חלון הזמן לתחזוקה. צריך לציין את אזור הזמן UTC.
  • ‫MAINTENANCE_TIMING: השבוע בתקופת ההשקה של התחזוקה שבו רוצים להחיל את עדכון התחזוקה. האפשרויות כוללות:
    • ‫preview: זהו השבוע הראשון אחרי שנשלחת ההודעה על התחזוקה. עדכון התחזוקה מתוזמן ל-7 עד 14 ימים אחרי ההתראה.
    • ‫production: זה אומר שבוע 2 אחרי שנשלחה ההודעה על התחזוקה. עדכון התחזוקה מתוזמן ל-15 עד 21 ימים אחרי ההתראה.
    • ‫week5: עדכון התחזוקה מתוזמן ל-35 עד 42 ימים אחרי שליחת ההודעה על התחזוקה.

למידע נוסף, ראו gcloud sql instances patch.

REST v1

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

  • ‫PROJECT_ID: המזהה או מספר הפרויקט ב- Cloud de Confiance .
  • ‫INSTANCE_ID: מזהה המכונה, שלא יכול להיות מכונה של רפליקה לקריאה בלבד.
  • ‫HOUR: השעה ביום, 0 עד 23, שבה יתבצע חלון הזמן לתחזוקה. צריך לציין את אזור הזמן UTC.
  • ‫DAY: היום בשבוע שבו יתבצע עדכון התחזוקה. ‫מציינים את הערך MONDAY,‏ TUESDAY,‏ WEDNESDAY,‏ THURSDAY,‏ FRIDAY,‏ SATURDAY או SUNDAY. צריך לציין את אזור הזמן UTC.
  • ‫MAINTENANCE_TIMING: השבוע בתקופת ההשקה של התחזוקה שבו רוצים להחיל את עדכון התחזוקה. האפשרויות כוללות:
    • ‫canary: זה מתורגם לשבוע 1 אחרי שנשלחת ההודעה על התחזוקה. עדכון התחזוקה מתוזמן ל-7 עד 14 ימים אחרי ההתראה.
    • ‫stable: זה אומר שבוע 2 אחרי שנשלחה ההודעה על התחזוקה. עדכון התחזוקה מתוזמן ל-15 עד 21 ימים אחרי ההתראה.
    • ‫week5: עדכון התחזוקה מתוזמן ל-35 עד 42 ימים אחרי שליחת ההודעה על התחזוקה.

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

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

תוכן בקשת JSON: 

{
  "settings": {
    "maintenanceWindow": {
        "hour": "HOUR",
        "day": "DAY",
        "updateTrack": "MAINTENANCE_TIMING"
    }
  }
}

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

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

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-04-01T21:30:35.667Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

‫REST v1beta4

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

  • ‫PROJECT_ID: המזהה או מספר הפרויקט ב- Cloud de Confiance .
  • ‫INSTANCE_ID: מזהה המכונה, שלא יכול להיות מכונה של רפליקה לקריאה בלבד.
  • ‫HOUR: השעה ביום, 0 עד 23, שבה יתבצע חלון הזמן לתחזוקה. צריך לציין את אזור הזמן UTC.
  • ‫DAY: היום בשבוע שבו רוצים שיתבצע עדכון התחזוקה. ‫מציינים את הערך MONDAY,‏ TUESDAY,‏ WEDNESDAY,‏ THURSDAY,‏ FRIDAY,‏ SATURDAY או SUNDAY. צריך לציין את אזור הזמן UTC.
  • ‫MAINTENANCE_TIMING: השבוע בתקופת ההשקה של התחזוקה שבו רוצים להחיל את עדכון התחזוקה. האפשרויות כוללות:
    • ‫canary: זה מתורגם לשבוע 1 אחרי שנשלחת ההודעה על התחזוקה. עדכון התחזוקה מתוזמן ל-7 עד 14 ימים אחרי ההתראה.
    • ‫stable: זה אומר שבוע 2 אחרי שנשלחה ההודעה על התחזוקה. עדכון התחזוקה מתוזמן ל-15 עד 21 ימים אחרי ההתראה.
    • ‫week5: עדכון התחזוקה מתוזמן ל-35 עד 42 ימים אחרי שליחת ההודעה על התחזוקה.

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

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

תוכן בקשת JSON: 

{
  "settings": {
    "maintenanceWindow": {
        "hour": "HOUR",
        "day": "DAY",
        "updateTrack": "MAINTENANCE_TIMING"
    }
  }
}

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

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

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-04-01T21:30:35.667Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

הסכמה לקבלת התראות לגבי פעולות תחזוקה

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

  1. עוברים לדף תקשורת. מעבר לתקשורת
  2. בשורה של Cloud SQL, חלון זמן לתחזוקה, לוחצים על כפתור הבחירה שמתחת ל-Email כדי להעביר אותו למצב ON.

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

איך מוצאים התראות לגבי פעולות תחזוקה במסוף Cloud de Confiance

אפשר לראות את ההתראות על תחזוקה בכמה מקומות במסוף Cloud de Confiance :

  • בדף Logs Explorer במסוף Cloud de Confiance . בתפריט הנפתח All logs name, מחפשים את maintenance-events ולוחצים על Apply. אם נקבעו עבודות תחזוקה למכונה, ביומן מופיעים השם של המכונה ושעת ההתחלה של עבודות התחזוקה.

  • כשמתוזמנת תחזוקה למכונה, תאריך התחזוקה מופיע בדף Instances בעמודה Maintenance. העמודה Maintenance בדרך כלל מוסתרת, אבל היא מוצגת באופן אוטומטי כשמתוזמנת פעולת תחזוקה. אם רוצים שהעמודה Maintenance תמיד תופיע, אפשר לבחור באפשרות Maintenance בתפריט Column display options (סמל האפשרויות להצגת עמודות הוא שלוש שורות).

  • אפשר גם לבחור מכונה כדי לעבור לדף Instance details. אם המכונה מתוזמנת לתחזוקה, תופיע הודעה בחלונית Maintenance.
    כניסה לדף Cloud SQL instances

חיפוש פעולות תחזוקה מתוזמנות באמצעות ה-API

gcloud

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

gcloud sql instances describe INSTANCE_ID

מחליפים את המשתנה הבא:

  • ‫INSTANCE_ID: המכונה שבה רוצים לבדוק אם יש עבודות תחזוקה מתוזמנות.

בתשובה, מחפשים את הקטע scheduledMaintenance.

REST v1

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

  • ‫PROJECT_ID: המזהה או מספר הפרויקט של הפרויקט ב- Cloud de Confiance שמכיל את המכונה
  • ‫INSTANCE_NAME: השם של המכונה שאתם מגדירים לזמינות גבוהה

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

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

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

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

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "MYSQL_8_0"
}

בתשובה, מחפשים את הקטע scheduledMaintenance.

‫REST v1beta4

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

  • ‫PROJECT_ID: המזהה או מספר הפרויקט של הפרויקט ב- Cloud de Confiance שמכיל את המכונה
  • ‫INSTANCE_NAME: השם של המכונה שאתם מגדירים לזמינות גבוהה

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

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

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

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

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "MYSQL_8_0"
}

בתשובה, מחפשים את הקטע scheduledMaintenance.

שינוי המועד של פעולת תחזוקה מתוכננת

אפשר לשנות את מועד התחזוקה באמצעות מסוף Cloud de Confiance , ה-CLI של gcloud או Cloud SQL Admin API.

אם הגדרתם את מועד התחזוקה של המכונה לשבוע 1 או לשבוע 2, אתם יכולים לשנות את מועד התחזוקה עד 28 ימים.

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

המסוף

  1. נכנסים לדף Cloud SQL Instances במסוף Cloud de Confiance .

    כניסה לדף Cloud SQL Instances

  2. מסננים לפי המונח Maintenance כדי להציג את כל המכונות שמתוזמנות לתחזוקה.
  3. בעמודה Maintenance, לוחצים על Reschedule.
  4. בתיבת הדו-שיח Reschedule, בוחרים אם לבצע את התחזוקה באופן מיידי, לתזמן אותה מחדש למועד ספציפי בתוך תקופת הדחייה המותרת, כפי שמוגדר בתזמון מחדש של תחזוקה מתוכננת, או לדחות אותה לחלון הזמן הבא לתחזוקה.

gcloud

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

gcloud sql reschedule-maintenance INSTANCE_ID \
  --reschedule-type=RESCHEDULE_TYPE \
  [--schedule-time=RESCHEDULE_TIME]

מחליפים את המשתנים הבאים:

  • ‫INSTANCE_ID: המופע שרוצים לתזמן מחדש.
  • ‫RESCHEDULE_TYPE: צריך להשתמש באחד מהערכים הבאים: IMMEDIATE,‏ NEXT_AVAILABLE_WINDOW או SPECIFIC_TIME.

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

  • ‫RESCHEDULE_TIME: אם מציינים את הערך SPECIFIC_TIME בשביל RESCHEDULE_TYPE, צריך גם להגדיר את הדגל --schedule-time כדי לציין את היום והשעה החדשים שבהם תתבצע התחזוקה. בפורמט ISO 8601. לדוגמה, 2020-01-16T16:56:00.000Z

למידע נוסף, ראו gcloud sql reschedule-maintenance.

אם רוצים לתזמן מחדש את התחזוקה לתקופה של עד 28 ימים, צריך לבדוק את מספר הגרסה של gcloud. אם מספר הגרסה נמוך מ-390.0.0_RC00, צריך להתקין מחדש את gcloud.

REST v1

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

  • ‫PROJECT_ID: מזהה הפרויקט.
  • ‫INSTANCE_ID: מזהה המכונה.
  • ‫RESCHEDULE_TYPE: סוג התזמון מחדש. אפשר להשתמש באחת מהאפשרויות הבאות: IMMEDIATE,‏ NEXT_AVAILABLE_WINDOW או SPECIFIC_TIME.

    אם בוחרים באפשרות NEXT_AVAILABLE_WINDOW, התחזוקה תתבצע בחלון זמן לתחזוקה הבא שזמין.

    אם בוחרים באפשרות SPECIFIC_TIME, צריך לכלול גם את schedule_time בגוף הבקשה.

  • ‫SCHEDULE_TIME: אם מציינים את הערך SPECIFIC_TIME בשדה RESCHEDULE_TYPE, צריך לציין את התאריך והשעה לתזמון מחדש של התחזוקה בפורמט RFC 3339. לדוגמה, 2026-11-07T04:00:00Z. אם מציינים IMMEDIATE או NEXT_AVAILABLE_WINDOW, צריך להשמיט את schedule_time מגוף הבקשה.

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

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

תוכן בקשת JSON: 

{
  "reschedule": {
    "reschedule_type": "RESCHEDULE_TYPE",
    "schedule_time": "SCHEDULE_TIME"
  }
}

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

אתם אמורים לקבל תגובת 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",
  "startTime": "08:00",
  "endTime": "08:01",
  "operationType": "RESCHEDULE_MAINTENANCE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

‫REST v1beta4

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

  • ‫PROJECT_ID: מזהה הפרויקט.
  • ‫INSTANCE_ID: מזהה המכונה.
  • ‫RESCHEDULE_TYPE: סוג התזמון מחדש. אפשר להשתמש באחת מהאפשרויות הבאות: IMMEDIATE,‏ NEXT_AVAILABLE_WINDOW או SPECIFIC_TIME.

    אם בוחרים באפשרות NEXT_AVAILABLE_WINDOW, התחזוקה תתבצע בחלון זמן לתחזוקה הבא שזמין.

    אם בוחרים באפשרות SPECIFIC_TIME, צריך לכלול גם את schedule_time בגוף הבקשה.

  • ‫SCHEDULE_TIME: אם מציינים את הערך SPECIFIC_TIME בשדה RESCHEDULE_TYPE, צריך לציין את התאריך והשעה לתזמון מחדש של התחזוקה בפורמט RFC 3339. לדוגמה, 2026-11-07T04:00:00Z. אם מציינים IMMEDIATE או NEXT_AVAILABLE_WINDOW, צריך להשמיט את schedule_time מגוף הבקשה.

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

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

תוכן בקשת JSON: 

{
  "reschedule": {
    "reschedule_type": "RESCHEDULE_TYPE",
    "schedule_time": "SCHEDULE_TIME"
  }
}

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

אתם אמורים לקבל תגובת 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",
  "startTime": "08:00",
  "endTime": "08:01",
  "operationType": "RESCHEDULE_MAINTENANCE",
  "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:rescheduleMaintenance.

הגדרת פרק זמן לדחיית עדכונים ותחזוקה

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

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

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

יש שני פורמטים לתאריך ההתחלה ולתאריך הסיום:

  • ‫yyyy-mm-dd: מציין תאריך ספציפי
  • ‫mm-dd: מציין תאריך שחוזר על עצמו כל שנה

תאריך ההתחלה ותאריך הסיום הם לפי שעון UTC. כדי להגדיר את אזור הזמן, משתמשים בשדה הזמן כדי לשנות את שעת ההתחלה. לדוגמה, אם תאריך ההתחלה הוא 2020-10-10 והשעה היא 07:00:00, שעת ההתחלה היא 2020-10-10 07:00:00 UTC‏ (2020-10-10 00:00:00 PST).

פורמט השעה הוא: HH:mm:SS.

  • השעות הן בין 0 ל-23 (כולל).
  • הדקות והשניות הן בין 0 ל-59 (כולל).

המסוף

  1. נכנסים לדף Cloud SQL Instances במסוף Cloud de Confiance .

    כניסה לדף Cloud SQL Instances

  2. כדי לפתוח את הדף Overview של מכונה, לוחצים על שם המכונה.
  3. בקטע Maintenance, לוחצים על Edit maintenance preferences.
  4. בקטע פרק זמן לדחיית עדכונים ותחזוקה, מגדירים את תאריכי ההתחלה והסיום.
  5. בקטע אפשרויות מתקדמות, בוחרים באפשרות חזרה כל שנה (אם רוצים).
  6. לוחצים על Save.

gcloud

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

gcloud sql instances patch INSTANCE_ID\
   --deny-maintenance-period-start-date=START_DATE \
   --deny-maintenance-period-end-date=END_DATE \
   --deny-maintenance-period-time=TIME

מחליפים את המשתנים הבאים:

  • ‫INSTANCE_ID: מזהה המכונה ב-Cloud SQL
  • ‫START_DATE: התאריך שבו מתחיל מרווח הזמן. לדוגמה, 2021-11-29
  • ‫END_DATE: התאריך שבו מסתיים המרווח. לדוגמה, 2021-12-02
  • TIME: השעה ביום שבה טווח הזמן מתחיל ומסתיים. לדוגמה, 00:00:00

REST v1

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

  • ‫project-id: מזהה הפרויקט
  • ‫instance-id: מזהה המכונה
  • start-date: תאריך ההתחלה (yyyy-mm-dd) או (mm-dd) לחזרה שנתית
  • end-date: תאריך הסיום (yyyy-mm-dd) או (mm-dd) לחזרה שנתית
  • ‫time: שעת ההתחלה ושעת הסיום (HH:mm:SS)

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

POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id

תוכן בקשת JSON: 

{
  "settings":
  {
    "denyMaintenancePeriods": [{
      "start_date": "start-date",
      "end_date": "end-date"
      "time": "time"
    }]
  }
}

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

אתם אמורים לקבל תגובת 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",
  "startTime": "08:00",
  "endTime": "08:01",
  "operationType": MAINTENANCE_DENY_PERIOD,
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

‫REST v1beta4

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

  • ‫project-id: מזהה הפרויקט
  • ‫instance-id: מזהה המכונה
  • start-date: תאריך ההתחלה (yyyy-mm-dd) או (mm-dd) לחזרה שנתית
  • end-date: תאריך הסיום (yyyy-mm-dd) או (mm-dd) לחזרה שנתית
  • ‫time: שעת ההתחלה ושעת הסיום (HH:mm:SS)

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

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

תוכן בקשת JSON: 

{
  "settings":
  {
    "denyMaintenancePeriods": [{
      "start_date": "start-date",
      "end_date": "end-date"
      "time": "time"
    }]
  }
}

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

אתם אמורים לקבל תגובת 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",
  "startTime": "08:00",
  "endTime": "08:01",
  "operationType": MAINTENANCE_DENY_PERIOD,
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

הסרת פרק זמן לדחיית עדכונים ותחזוקה

המסוף

  1. נכנסים לדף Cloud SQL Instances במסוף Cloud de Confiance .

    כניסה לדף Cloud SQL Instances

  2. כדי לפתוח את הדף Overview של מכונה, לוחצים על שם המכונה.
  3. בקטע Maintenance, לוחצים על Edit maintenance preferences.
  4. בקטע פרק זמן לדחיית עדכונים ותחזוקה, לוחצים על Clear.
  5. לוחצים על Save.

gcloud

כדי להסיר ממכונה של Cloud SQL פרק זמן לדחיית עדכונים ותחזוקה, מריצים את הפקודה הבאה:

gcloud sql instances patch INSTANCE_ID \
--remove-deny-maintenance-period

מחליפים את המשתנים הבאים:

  • ‫INSTANCE_ID: מזהה המכונה ב-Cloud SQL

REST v1

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

  • ‫project-id: מזהה הפרויקט
  • ‫instance-id: מזהה המכונה

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

POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id

תוכן בקשת JSON: 

{
  "settings":
  {
    "denyMaintenancePeriods": []
  }
}

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

אתם אמורים לקבל תגובת 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",
  "startTime": "08:00",
  "endTime": "08:01",
  "operationType": MAINTENANCE_DENY_PERIOD,
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

‫REST v1beta4

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

  • ‫project-id: מזהה הפרויקט
  • ‫instance-id: מזהה המכונה

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

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

תוכן בקשת JSON: 

{
  "settings":
  {
    "denyMaintenancePeriods": []
  }
}

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

אתם אמורים לקבל תגובת 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",
  "startTime": "08:00",
  "endTime": "08:01",
  "operationType": MAINTENANCE_DENY_PERIOD,
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

התראות על פרק זמן לדחיית עדכונים ותחזוקה

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

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

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

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