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

בדף הזה מוסבר איך למצוא ולהגדיר חלונות תחזוקה למופעי 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. נכנסים לחשבון Google Cloud . אם אתם משתמשים חדשים ב- Google Cloud, צרו חשבון כדי שתוכלו להעריך את הביצועים של המוצרים שלנו בתרחישים מהעולם האמיתי. לקוחות חדשים מקבלים בחינם גם קרדיט בשווי 300$ להרצה, לבדיקה ולפריסה של עומסי העבודה.

  2. 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

  3. Verify that billing is enabled for your Google Cloud project.

  4. מתקינים את ה-CLI של gcloud.

  5. אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.

  6. כדי לאתחל את ה-CLI של gcloud, הריצו את הפקודה הבאה: 

    gcloud init

  7. 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

  8. Verify that billing is enabled for your Google Cloud project.

  9. מתקינים את ה-CLI של gcloud.

  10. אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.

  11. כדי לאתחל את ה-CLI של gcloud, הריצו את הפקודה הבאה: 

    gcloud init

הגדרת חלון זמן לתחזוקה במופע

המסוף

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

    כניסה לדף Cloud SQL Instances

  2. כדי לפתוח את הדף סקירה כללית של מכונה, לוחצים על שם המכונה.
  3. בקטע תחזוקה, לוחצים על עריכת העדפות התחזוקה.
  4. בקטע אפשרויות הגדרה, פותחים את תחזוקה.
  5. מגדירים את האפשרויות הבאות:
    • התזמון של התחזוקה. בוחרים את השבוע שבו רוצים להחיל את העדכון האוטומטי של התחזוקה. יש לכם את האפשרויות הבאות:
      • כל זמן: עדכון התחזוקה יכול להתבצע בכל זמן, אבל בדרך כלל הוא מתבצע במהלך השבוע הראשון.
      • שבוע 1: התחזוקה מתבצעת 7 עד 14 ימים אחרי שליחת ההודעה על התחזוקה.
      • שבוע 2: עדכון התחזוקה מתבצע 15 עד 21 ימים אחרי שליחת ההודעה.
      • שבוע 5: עדכון התחזוקה מתבצע 35 עד 42 ימים אחרי שליחת ההתראה.
    • חלון זמן לתחזוקה. בוחרים את היום המועדף בשבוע ואת חלון הזמן. האפשרויות כוללות:
      • כל חלון: חלון הזמן לתחזוקה שמוגדר כברירת מחדל. עדכון התחזוקה לא מוגבל ליום מסוים בשבוע או לשעה מסוימת ביום.
      • יום בשבוע: בוחרים יום לחלון זמן לתחזוקה: שבת, ראשון, שני, שלישי, רביעי, חמישי או שישי.
      • שעה ביום: אם בוחרים יום בשבוע, אפשר לבחור גם שעה ביום. בוחרים מרווח של שעה אחת באזור הזמן המקומי.

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: המשמעות היא שבוע 1 אחרי שליחת ההודעה על התחזוקה. עדכון התחזוקה מתוזמן לביצוע בין 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: המשמעות היא שבוע 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: המזהה או מספר הפרויקט של Google Cloud הפרויקט.
  • ‫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).

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

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

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

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

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

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

חיפוש פעולות תחזוקה מתוזמנות באמצעות ה-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. בעמודה תחזוקה, לוחצים על תזמון מחדש.
  4. בתיבת הדו-שיח קביעת מועד חדש, בוחרים אם להחיל את התחזוקה באופן מיידי, לקבוע מועד חדש לביצוע התחזוקה בזמן ספציפי בתוך תקופת הדחייה המותרת כפי שמוגדר בקביעת מועד חדש לתחזוקה מתוכננת, או לדחות את התחזוקה לחלון זמן לתחזוקה הבא שזמין.

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, התחזוקה מתוזמנת מחדש לחלון זמן התחזוקה הבא שזמין.

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

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

תוכן בקשת JSON: 

{
  "reschedule": {
    "reschedule_type": "RESCHEDULE_TYPE"
  }
}

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

אתם אמורים לקבל תגובת 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, התחזוקה מתוזמנת מחדש לחלון זמן התחזוקה הבא שזמין.

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

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

תוכן בקשת JSON: 

{
  "reschedule": {
    "reschedule_type": "RESCHEDULE_TYPE"
  }
}

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

אתם אמורים לקבל תגובת 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:post.

הגדרת תקופת תחזוקה לדחייה

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

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

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