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

בדף הזה מוסבר איך למצוא ולהגדיר חלונות זמן לתחזוקה של מכונות 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 Google Cloud console, on the project selector page, select or create a Google Cloud 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 Google Cloud 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 במסוף Google Cloud .

    כניסה לדף 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: המזהה או מספר הפרויקט של הפרויקט ב- Google Cloud .
  • ‫INSTANCE_ID: מזהה המכונה, שלא יכול להיות מכונה של רפליקה לקריאה בלבד.
  • ‫HOUR: השעה ביום, 0 עד 23, שבה יתבצע חלון הזמן לתחזוקה. צריך לציין את אזור הזמן UTC.
  • ‫DAY: היום בשבוע שבו יתבצע עדכון התחזוקה. מציינים את הערך MONDAY,‏ TUESDAY,‏ WEDNESDAY,‏ THURSDAY,‏ FRIDAY,‏ SATURDAY או SUNDAY. צריך לציין את אזור הזמן UTC.
  • ‫MAINTENANCE_TIMING: השבוע בתקופת ההשקה של התחזוקה שבו רוצים להחיל את עדכון התחזוקה. האפשרויות כוללות:
    • ‫canary: שבוע אחד אחרי שנשלחת ההודעה על התחזוקה. עדכון התחזוקה מתוזמן ל-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: המזהה או מספר הפרויקט של הפרויקט ב- Google Cloud .
  • ‫INSTANCE_ID: מזהה המכונה, שלא יכול להיות מכונה של רפליקה לקריאה בלבד.
  • ‫HOUR: השעה ביום, 0 עד 23, שבה יתבצע חלון הזמן לתחזוקה. צריך לציין את אזור הזמן UTC.
  • ‫DAY: היום בשבוע שבו רוצים שיתבצע עדכון התחזוקה. מציינים את הערך MONDAY,‏ TUESDAY,‏ WEDNESDAY,‏ THURSDAY,‏ FRIDAY,‏ SATURDAY או SUNDAY. צריך לציין את אזור הזמן UTC.
  • ‫MAINTENANCE_TIMING: השבוע בתקופת ההשקה של התחזוקה שבו רוצים להחיל את עדכון התחזוקה. האפשרויות כוללות:
    • ‫canary: שבוע אחד אחרי שנשלחת ההודעה על התחזוקה. עדכון התחזוקה מתוזמן ל-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.

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

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

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

  • בדף Logs Explorer במסוף Google Cloud . בתפריט הנפתח 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: המזהה או מספר הפרויקט של הפרויקט ב- Google Cloud שמכיל את המכונה
  • ‫INSTANCE_NAME: השם של המכונה שאתם מגדירים לזמינות גבוהה

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

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

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

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

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

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

REST v1beta4

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

  • ‫PROJECT_ID: המזהה או מספר הפרויקט של הפרויקט ב- Google Cloud שמכיל את המכונה
  • ‫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": "SQLSERVER_2019_STANDARD"
}

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

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

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

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

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

המסוף

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

    כניסה לדף 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 במסוף Google Cloud .

    כניסה לדף 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 במסוף Google Cloud .

    כניסה לדף Cloud SQL Instances

  2. כדי לפתוח את הדף Overview של מכונה, לוחצים על שם המכונה.
  3. בקטע Maintenance, לוחצים על Edit maintenance preferences.
  4. בקטע Deny maintenance period, לוחצים על 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 בכל פעם שמתוזמן עדכון למכונה.

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

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