הגדרת המלצות לביטול הזמנות לא פעילות

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

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

  • אם עדיין לא עשיתם את זה, תצטרכו להגדיר אימות. אימות הוא תהליך שבו מאמתים את הזהות שלכם כדי לקבל גישה לממשקי API ולשירותים של Cloud de Confiance by S3NS . כדי להריץ קוד או דוגמאות מסביבת פיתוח מקומית, אפשר לבצע אימות ל-Compute Engine באחת מהדרכים הבאות:

    צריך לבחור את הכרטיסייה הרלוונטית לאופן שבו תכננתם להשתמש בדוגמאות בדף הזה:

    gcloud

    1. התקינו את ה-CLI של Google Cloud ואז היכנסו ל-CLI של gcloud באמצעות הזהות המאוחדת שלכם. אחרי שנכנסתם לחשבון, אתחלו את ה-CLI של Google Cloud באמצעות הפקודה הבאה: 

      gcloud init
  • הגדרת אזור ותחום כברירת מחדל

    • REST

    כדי להשתמש בסביבת פיתוח מקומית בדוגמאות של API בארכיטקטורת REST שבדף הזה, צריך להשתמש בפרטי הכניסה שאתם נותנים ל-CLI של gcloud.

      התקינו את ה-CLI של Google Cloud ואז היכנסו ל-CLI של gcloud באמצעות הזהות המאוחדת שלכם.

    מידע נוסף מופיע במאמר אימות לשימוש ב-REST במסמכי האימות של Cloud de Confiance .

הגדרת ההמלצות

כדי להגדיר את ההמלצות למקומות שמורים בלי פעילות:

  1. מקבלים את ההגדרה הנוכחית כדי לקבל את קובץ ה-JSON של ההגדרה.
  2. עורכים את קובץ ההגדרות בפורמט JSON.
  3. מעלים את קובץ ההגדרות החדש כדי להחיל את השינויים.

אחזור ההגדרה הנוכחית

אפשר לקבל את ההגדרה הנוכחית של ההמלצות לגבי מקומות שמורים בלי פעילות בפרויקט באמצעות Google Cloud CLI או REST.

כדי לבצע את המשימה הזו, אפשר להשתמש באחת מהשיטות הבאות.

gcloud

כדי לקבל את פרמטרים ההגדרה הנוכחיים, משתמשים בפקודה gcloud recommender recommender-config describe ומזינים google.compute.IdleResourceRecommender בתור מזהה הכלי להמלצות:

gcloud recommender recommender-config describe google.compute.IdleResourceRecommender \
  --location=ZONE --billing-account=BILLING_ACCOUNT_ID

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

לדוגמה:

gcloud recommender recommender-config describe google.compute.IdleResourceRecommender \
  --location=us-central1-c --billing-account=my-billing-account-id

הפקודה מחזירה את ההגדרה של הכלי להמלצות, כולל שדה המשנה params.idle_reservation_lookback_period שאפשר לשנות.

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.IdleResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "idle_reservation_lookback_period": "P7D"
    }
  },
  "etag": "\"2f3c9b65cda6a4ba\"",
  "updateTime": "2024-06-03T04:41:15.330351Z"
}

REST

כדי לאחזר את ההגדרה הנוכחית, משתמשים בשיטה recommenders.getConfig ומציינים את google.compute.IdleResourceRecommender כמזהה של שירות ההמלצות:

GET https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.IdleResourceRecommender/config

מחליפים את ZONE באזור שמכיל את הפרויקט.

מריצים את הפקודה הבאה בשורת הפקודה כדי לקבל את הגדרות שירות ההמלצות של פרויקט:

PROJECT_ID=PROJECT_ID
ZONE=ZONE
curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "x-goog-user-project: ${PROJECT_ID}" \
https://recommender.googleapis.com/v1/projects/$PROJECT_ID/locations/$ZONE/recommenders/google.compute.IdleResourceRecommender/config

הפקודה מחזירה את ההגדרות של הכלי להמלצות, כולל שדה המשנה שאפשר לשנות: params.idle_reservation_lookback_period.

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.IdleResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "idle_reservation_lookback_period": "P7D"
    }
  },
  "etag": "\"2f3c9b65cda6a4ba\"",
  "updateTime": "2024-06-03T04:41:15.330351Z"
}

עדכון ההגדרה של פרויקט

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

אפשר להגדיר את תקופת התצפית לערך של 7 עד 30 ימים, באמצעות מחרוזת שמתחילה ב-P, ואחריה מספר שלם שמייצג את מספר הימים (מינימום 7 ומקסימום 30), ואז D. לדוגמה:

  • לתקופת תצפית של 7 ימים, משתמשים ב-"P7D".
  • לתקופת תצפית של 30 ימים, משתמשים ב-"P30D".

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

gcloud

כדי לעדכן את פרמטרי ההגדרה, משתמשים בפקודה gcloud recommender recommender-config update ומזינים google.compute.IdleResourceRecommender כמזהה של שירות ההמלצות:

gcloud recommender recommender-config update google.compute.IdleResourceRecommender\
  --location=ZONE \
  --config-file=CONFIG_FILE_PATH \
  --etag=ETAG \
  --billing-account=BILLING_ACCOUNT_ID

מחליפים את מה שכתוב בשדות הבאים:

  • ‫ZONE: האזור שרוצים לקבל את ההגדרות הנוכחיות שלו
  • ‫CONFIG_FILE_PATH: הנתיב לקובץ ה-JSON עם ההגדרה הנוכחית
  • ‫ETAG: ערך ה-etag של ההגדרה הנוכחית
  • ‫BILLING_ACCOUNT_ID: המזהה של החשבון לחיוב

בקובץ ההגדרות, מציינים רק את האובייקט recommenderGenerationConfig עם פרמטרים ההגדרות המעודכנים. לדוגמה, כדי לציין תקופת תצפית של 21 ימים, משתמשים בקובץ התצורה הבא:

{
  "params": {
    "idle_reservation_lookback_period": "P21D"
  }
}

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

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.IdleResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "idle_reservation_lookback_period": "P21D"
    }
  },
  "etag": "\"1245f9435cd01ea8\"",
  "updateTime": "2024-06-03T05:00:05Z"
}

REST

כדי לעדכן את ההגדרות, שולחים בקשת PATCH אל ה-method‏ recommenders.updateConfig ומציינים את google.compute.IdleResourceRecommender כמזהה של Recommender:

PATCH https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.IdleResourceRecommender/config

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.IdleResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "idle_reservation_lookback_period": "P21D"
    }
  },
  "etag": "\"2f3c9b65cda6a4ba\""
}

מחליפים את מה שכתוב בשדות הבאים:

  • ‫PROJECT_ID: מזהה הפרויקט שרוצים לשנות את ההגדרות של הכלי להמלצות.
  • ‫ZONE: האזור שמכיל את הפרויקט.

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

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-H "x-goog-user-project: ${PROJECT_ID}" \
-d @config.json \
https://recommender.googleapis.com/v1/projects/$PROJECT_ID/locations/$ZONE/recommenders/google.compute.IdleResourceRecommender/config

הפקודה POST מחזירה גוף תגובה שדומה לזה שמוצג בהמשך, עם ההגדרה החדשה והפרמטרים ששיניתם.

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.IdleResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "idle_reservation_lookback_period": "P21D"
    }
  },
  "etag": "\"1245f9435cd01ea8\"",
  "updateTime": "2024-06-03T05:00:05Z"
}

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