הצגת ההתחייבויות לשימוש במשאבים

ב-Compute Engine אפשר לראות רשימה של כל ההתחייבויות לשימוש במשאבים שרכשתם, או לאחזר את המאפיינים המפורטים של התחייבות ספציפית.

אפשר לראות את ההתחייבויות האלה באמצעות מסוף Google Cloud , ה-CLI של gcloud או REST.

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

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

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

  המסוף

  כשמשתמשים במסוף Google Cloud כדי לגשת לשירותים ולממשקי ה-API של Google Cloud , לא צריך להגדיר אימות.

  gcloud

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

     gcloud init

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

     הערה: אם התקנתם את ה-CLI של gcloud, השתמשו בפקודה gcloud components update כדי לבדוק אם הגרסה העדכנית מותקנת.
• הגדרת אזור ותחום כברירת מחדל.

REST

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

התקינו את ה-CLI של Google Cloud.

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

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

התפקידים הנדרשים

כדי לקבל את ההרשאה שנדרשת לצפייה בהתחייבויות לשימוש במשאבים, צריך לבקש מהאדמין להקצות לכם בפרויקט את התפקיד "צפייה ב-Compute"‏ (roles/compute.viewer) או "אדמין של Compute"‏ (roles/compute.admin) ב-IAM. כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

התפקיד המוגדר מראש הזה כולל את ההרשאות compute.commitments.get ו-compute.commitments.list, שנדרשות כדי לצפות בהתחייבויות לשימוש במשאבים.

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

הצגת רשימת ההתחייבויות לשימוש

אתם יכולים לראות את רשימת כל ההתחייבויות בפרויקט באמצעות מסוףGoogle Cloud , ה-CLI של gcloud או REST.

המסוף

1. נכנסים לדף הנחות תמורת התחייבות לשימוש במסוף Google Cloud . לדף Committed use discounts

2. כדי לראות רשימה של התחייבויות בקטגוריה מסוימת, בוחרים באחת מהכרטיסיות הבאות:

   • התחייבויות לחומרה: בכרטיסייה הזו אפשר לראות התחייבויות למשאבי חומרה, כמו מעבדי vCPU, זיכרון, מעבדי GPU, דיסקים מקומיים של SSD ושרתים לדייר יחיד (sole-tenant).
   • התחייבויות לרישיונות תוכנה: בכרטיסייה הזו אפשר לראות את ההתחייבויות לרישיונות של מערכת ההפעלה.
   • ‫Block storage commitments: בכרטיסייה הזו מוצגות ההתחייבויות לקיבולת של Exapool.

gcloud

כדי להציג את כל ההתחייבויות באזור מסוים, משתמשים בפקודה gcloud compute commitments list:

gcloud compute commitments list \
    --regions=REGION \
    --project=PROJECT_ID

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

• ‫REGION: האזור שבו רוצים לראות את ההתחייבויות.
• ‫PROJECT_ID: מזהה הפרויקט.

דוגמאות

לדוגמה, כדי להציג את רשימת ההתחייבויות באזור us-central1 באמצעות הפרויקט project-list-example, מריצים את הפקודה הבאה:

gcloud compute commitments list \
    --regions=us-central1 \
    --project=project-list-example

REST

כדי להציג רשימה של התחייבויות באזור ספציפי, שולחים בקשת GET ל-method‏ regionCommitments.list:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments

כדי להציג רשימה של ההתחייבויות בכל האזורים בפרויקט, שולחים בקשת GET ל-method‏ regionCommitments.aggregatedList:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/commitments

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

• ‫PROJECT_ID: מזהה הפרויקט שבו רוצים לראות את ההתחייבויות.
• ‫REGION: האזור שבו רוצים לראות את ההתחייבויות.

הצגת פרטים של התחייבות ספציפית

אפשר לראות את המאפיינים המפורטים של ההתחייבות, כמו:

• סטטוס
• תוכנית התחייבות
• שעות ההתחלה והסיום של ההתחייבות
• הגדרות החידוש האוטומטי
• סוגי המשאבים והכמויות שהתחייבתם להם

אתם יכולים לראות את ההתחייבויות שלכם באמצעות מסוף Google Cloud , ה-CLI של gcloud או REST.

המסוף

1. נכנסים לדף הנחות תמורת התחייבות לשימוש במסוף Google Cloud . לדף Committed use discounts

2. בוחרים את הכרטיסייה של סוג ההתחייבות שרוצים לראות:

   • כדי לראות את ההתחייבויות למשאבי חומרה, לוחצים על הכרטיסייה Hardware commitments. התחייבויות לחומרה כוללות מעבדי vCPU, זיכרון, מעבדי GPU, דיסקים מקומיים של SSD וצמתים לדייר יחיד (sole-tenant).
   • כדי לראות את ההתחייבויות לרישיונות פרימיום לתוכנות, לוחצים על הכרטיסייה Software license commitments. התחייבויות לרישיונות כוללות רישיונות למערכות הפעלה (OS), כמו SUSE Linux Enterprise Server‏ (SLES),‏ SLES ל-SAP או Red Hat Enterprise Linux‏ (RHEL).
   • כדי לראות את ההתחייבויות למאגרי אחסון ברשת (NAS), לוחצים על הכרטיסייה Block storage commitments. ההתחייבויות לאחסון בלוקים כוללות את הקיבולת של Exapool.

3. כדי להציג את דף הפרטים של התחייבות, לוחצים על שם ההתחייבות.

gcloud

כדי לתאר התחייבות ספציפית, משתמשים בפקודה gcloud compute commitments describe:

gcloud compute commitments describe COMMITMENT_NAME \
    --region=REGION \
    --project=PROJECT_ID

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

• ‫COMMITMENT_NAME: שם ההתחייבות.
• ‫REGION: האזור שבו נמצאת ההתחייבות.
• ‫PROJECT_ID: מזהה הפרויקט.

דוגמאות

בדוגמאות הבאות מתוארות התחייבויות בפרויקט myproject ובאזור us-central1.

דוגמה 1: תיאור של התחייבות לשימוש בחומרה

כדי לתאר התחייבות קיימת לחומרה (example-hardware-commitment), מריצים את הפקודה הבאה:

gcloud compute commitments describe example-hardware-commitment \
    --region=us-central1 \
    --project=myproject

הפקודה מחזירה את מאפייני ההתחייבות, בדומה לדוגמה הבאה:

autoRenew: true
category: MACHINE
creationTimestamp: '2025-05-15T09:30:00.000-07:00'
endTimestamp: '2026-05-15T09:30:00.000-07:00'
kind: compute#commitment
name: example-hardware-commitment
plan: TWELVE_MONTH
region: https://www.googleapis.com/compute/v1/projects/myproject/regions/us-central1
resources:
- amount: '4'
  type: VCPU
- amount: '16384'
  type: MEMORY
status: ACTIVE
type: GENERAL_PURPOSE

דוגמה 2: תיאור של התחייבות לאחסון בלוקים

כדי לתאר התחייבות קיימת לאחסון בלוקים (example-block-storage-commitment), מריצים את הפקודה gcloud beta compute commitments describe:

gcloud beta compute commitments describe example-block-storage-commitment \
    --region=us-central1 \
    --project=myproject

הפקודה מחזירה את המאפיינים של ההתחייבות, ויוצרת את הקשר של ההתחייבות ל-Exapools, בדומה לדוגמה הבאה:

autoRenew: true
category: PERSISTENT_DISK
creationTimestamp: '2025-08-20T14:45:00.000-07:00'
endTimestamp: '2026-08-20T14:45:00.000-07:00'
kind: compute#commitment
name: example-block-storage-commitment
persistentDiskResources:
- amount: '102400'
  dimensionType: CAPACITY_OPTIMIZED
  productType: HYPERDISK_EXAPOOL_BALANCED
plan: TWELVE_MONTH
region: https://www.googleapis.com/compute/beta/projects/myproject/regions/us-central1
status: ACTIVE

REST

שולחים בקשת GET ל-method‏ regionCommitments.get:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments/COMMITMENT_NAME

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

• ‫PROJECT_ID: מזהה הפרויקט שלכם.
• ‫REGION: האזור שבו נרכשה ההתחייבות.
• ‫COMMITMENT_NAME: שם ההתחייבות.

דוגמאות

בדוגמאות הבאות מוצג איך לאחזר את הפרטים של התחייבות בפרויקט myproject ובאזור us-central1.

דוגמה 1: תיאור של התחייבות לשימוש בחומרה

כדי לאחזר את המאפיינים של התחייבות לחומרה (example-hardware-commitment), שולחים את בקשת ה-GET הבאה:

GET https://compute.googleapis.com/compute/v1/projects/myproject/regions/us-central1/commitments/example-hardware-commitment

התגובה מכילה את המאפיינים של ההתחייבות לחומרה, בדומה לפלט הבא:

{
  "autoRenew": true,
  "category": "MACHINE",
  "creationTimestamp": "2025-05-15T09:30:00.000-07:00",
  "endTimestamp": "2026-05-15T09:30:00.000-07:00",
  "kind": "compute#commitment",
  "name": "example-hardware-commitment",
  "plan": "TWELVE_MONTH",
  "region": "https://www.googleapis.com/compute/v1/projects/myproject/regions/us-central1",
  "resources": [
    {
      "amount": "4",
      "type": "VCPU"
    },
    {
      "amount": "16384",
      "type": "MEMORY"
    }
  ],
  "status": "ACTIVE",
  "type": "GENERAL_PURPOSE"
}

דוגמה 2: תיאור של התחייבות לאחסון בלוקים

כדי לאחזר את המאפיינים של התחייבות לאחסון בלוקים (example-block-storage-commitment), שולחים את בקשת ה-GET הבאה לשיטה beta regionCommitments.get:

GET https://compute.googleapis.com/compute/beta/projects/myproject/regions/us-central1/commitments/example-block-storage-commitment

התגובה מכילה את המאפיינים שמייצגים את קיבולת ההתחייבות לאחסון בלוקים, בדומה לפלט ה-JSON הבא:

{
  "autoRenew": true,
  "category": "PERSISTENT_DISK",
  "creationTimestamp": "2025-08-20T14:45:00.000-07:00",
  "endTimestamp": "2026-08-20T14:45:00.000-07:00",
  "kind": "compute#commitment",
  "name": "example-block-storage-commitment",
  "persistentDiskResources": [
    {
      "amount": "102400",
      "dimensionType": "CAPACITY_OPTIMIZED",
      "productType": "HYPERDISK_EXAPOOL_BALANCED"
    }
  ],
  "plan": "TWELVE_MONTH",
  "region": "https://www.googleapis.com/compute/beta/projects/myproject/regions/us-central1",
  "status": "ACTIVE"
}