הצגת הקיבולת שהוזמנה

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

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

אחרי ש- Cloud de Confiance by S3NS מאשרת בקשה למקום שמור לעתיד, מערכת Compute Engine יוצרת באופן אוטומטי (יצירה אוטומטית) שמירת מקום ריקה למשאבים שביקשתם. אחרי כן תוכלו לראות את ההזמנה כדי לתכנן את עומס העבודה. בהמשך, בשעת ההתחלה שצוינה, מערכת Compute Engine מוסיפה את המכונות הווירטואליות (VM) שהזמנתם לשמירת המקום. לאחר מכן תוכלו להתחיל להשתמש בהזמנה על ידי יצירת מכונות וירטואליות שתואמות להזמנה.

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

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

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

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

ההרשאות הנדרשות

כדי לראות את ההזמנות, צריך את ההרשאות הבאות:

  • כדי לראות את הפרטים של בקשה למקום שמור לעתיד: compute.futureReservations.get בפרויקט
  • כדי לראות את פרטי ההזמנה: compute.reservations.get בפרויקט

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

מגבלות

אפשר לראות בקשה משותפת לשריון מקום שמור או בקשה משותפת לשריון מקום שמור לעתיד רק בפרויקט שבו Google יצרה אותה.

צפייה בבקשות לקיבולת שמורה

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

הצגת רשימה של בקשות להזמנות עתידיות

אתם יכולים לראות רשימה של מקומות שמורים לעתיד כדי לבדוק את התקופה, הסטטוס והתחום (zone) של הבקשות.

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

המסוף

  1. פותחים את הדף Reservations במסוף Cloud de Confiance .

    כניסה לדף Reservations

  2. לוחצים על הכרטיסייה Future reservations. בטבלה מופיעה כל בקשה למקום שמור לעתיד, וכל עמודה בטבלה מתארת מאפיין.
  3. אופציונלי: כדי לצמצם את רשימת הבקשות, בשדה Filter בוחרים את המאפיינים שלפיהם רוצים לסנן את הבקשות.

gcloud

כדי להציג רשימה של בקשות למקום שמור לעתיד, משתמשים בפקודה gcloud compute future-reservations list:

gcloud compute future-reservations list

הפלט אמור להיראות כך:

NAME: fr-01
TOTAL_COUNT: 100
START_TIME: 2026-07-20T07:00:00Z
END_TIME: 2026-08-05T07:00:00Z
PROCUREMENT_STATUS: FULFILLED
ZONE: us-west4-b

NAME: fr-02
TOTAL_COUNT: 10
START_TIME: 2026-07-20T07:00:00Z
END_TIME: 2026-12-01T00:00:00Z
PROCUREMENT_STATUS: PENDING_APPROVAL
ZONE: us-west4-b

אם רוצים לשפר את רשימת מקומות שמורים לעתיד, משתמשים באותה פקודה עם הדגל --filter.

REST

כדי לראות רשימה של בקשות למקומות שמורים לעתיד, שולחים בקשת GET לאחת מהשיטות הבאות:

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

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

מחליפים את PROJECT_ID במזהה הפרויקט שבו נמצאות הבקשות.

הפלט של רשימת בקשות למקומות שמורים לעתיד באזור יחיד אמור להיראות כך:

{
  "id": "projects/example-project/aggregated/futureReservations",
  "items": [
    {
      "specificSkuProperties": {
        "instanceProperties": {
          "machineType": "h4d-standard-192-lssd",
          "localSsds": [
            {
              "diskSizeGb": "375",
              "interface": "NVME"
            },
            ...
          ]
        },
        "totalCount": "8"
      },
      "kind": "compute#futureReservation",
      "id": "7979651787097007552",
      "creationTimestamp": "2025-11-27T11:14:58.305-08:00",
      "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/futureReservations/example-draft-request",
      "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/futureReservations/7979651787097007552",
      "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a",
      "name": "example-draft-request",
      "timeWindow": {
        "startTime": "2026-01-27T19:20:00Z",
        "endTime": "2026-02-10T19:20:00Z"
      },
      "status": {
        "procurementStatus": "DRAFTING",
        "lockTime": "2026-01-27T19:15:00Z"
      },
      "planningStatus": "DRAFT",
      "specificReservationRequired": true,
      "reservationName": "example-reservation",
      "deploymentType": "DENSE",
      "schedulingType": "INDEPENDENT",
      "autoCreatedReservationsDeleteTime": "2026-02-10T19:20:00Z"
    },
    ...
  ],
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/aggregated/futureReservations",
  "etag": "AnzKY34l-cvvV-JnniESJ0dtQvQ=/hvc4jaHpxFAZmOt1FVtKNgzZu-M=",
  "kind": "compute#futureReservationsListResponse"
}

אם רוצים לשנות את רשימת הבקשות למקומות שמורים לעתיד, שולחים את אותה בקשה וכוללים בכתובת ה-URL של הבקשה את filter פרמטר השאילתה.

צפייה בפרטים של בקשה למקום שמור לעתיד

אתם יכולים לראות את הפרטים של בקשה למקום שמור לעתיד כדי לבדוק את המאפיינים ואת התקופה של המשאבים ששמרתם.

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

המסוף

  1. פותחים את הדף Reservations במסוף Cloud de Confiance .

    כניסה לדף Reservations

  2. לוחצים על הכרטיסייה Future reservations. בטבלה מופיעה כל בקשה למקום שמור לעתיד, וכל עמודה בטבלה מתארת מאפיין.
  3. כדי לראות את פרטי הבקשה, בעמודה Name (שם), לוחצים על שם הבקשה. ייפתח דף עם הפרטים של בקשת המקום השמור לעתיד.

gcloud

כדי לראות את הפרטים של בקשה למקום שמור לעתיד, משתמשים בפקודה gcloud compute future-reservations describe:

gcloud compute future-reservations describe FUTURE_RESERVATION_NAME \
    --zone=ZONE

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

  • FUTURE_RESERVATION_NAME: השם של הבקשה למקום שמור לעתיד.
  • ZONE: האזור שבו קיימת הבקשה למקום שמור לעתיד.

הפלט אמור להיראות כך:

autoCreatedReservationsDeleteTime: '2026-02-10T19:20:00Z'
creationTimestamp: '2025-11-27T11:14:58.305-08:00'
deploymentType: DENSE
id: '7979651787097007552'
kind: compute#futureReservation
name: example-draft-request
planningStatus: DRAFT
reservationName: example-reservation
schedulingType: INDEPENDENT
selfLink: https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/example-draft-request
selfLinkWithId: https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/7979651787097007552
specificReservationRequired: true
specificSkuProperties:
  instanceProperties:
    guestAccelerators:
    -   acceleratorCount: 8
      acceleratorType: nvidia-h200-141gb
    localSsds:
    -   diskSizeGb: '375'
      interface: NVME
    ...
  machineType: a3-ultragpu-8g
totalCount: '2'
status:
  autoCreatedReservations:
  -   https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/reservations/example-reservation
  fulfilledCount: '2'
  lockTime: '2026-01-27T19:15:00Z'
  procurementStatus: DRAFTING
timeWindow:
  endTime: '2026-02-10T19:20:00Z'
  startTime: '2026-01-27T19:20:00Z'
zone: https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b

REST

כדי לראות את הפרטים של בקשה למקום שמור לעתיד, שולחים בקשת GET אל ה-method‏ futureReservations.get:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME

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

  • PROJECT_ID: מזהה הפרויקט שבו קיימת בקשת ההזמנה העתידית.
  • ZONE: האזור שבו קיימת הבקשה למקום שמור לעתיד.
  • FUTURE_RESERVATION_NAME: השם של בקשת ההזמנה העתידית.

הפלט אמור להיראות כך:

{
  "specificSkuProperties": {
    "instanceProperties": {
      "machineType": "h4d-standard-192"
    },
    "totalCount": "8"
  },
  "kind": "compute#futureReservation",
  "id": "7201773389437194422",
  "creationTimestamp": "2025-11-27T11:14:58.305-08:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/futureReservations/example-draft-request",
  "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/futureReservations/7201773389437194422",
  "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a",
  "name": "example-draft-request",
  "timeWindow": {
    "startTime": "2026-01-27T19:20:00Z",
    "endTime": "2026-02-10T19:20:00Z"
  },
  "status": {
    "procurementStatus": "DRAFTING",
    "lockTime": "2026-01-27T19:15:00Z"
  },
  "planningStatus": "DRAFT",
  "specificReservationRequired": true,
  "reservationName": "example-reservation",
  "deploymentType": "DENSE",
  "schedulingType": "GROUPED",
  "autoCreatedReservationsDeleteTime": "2026-02-10T19:20:00Z"
}

איך רואים את הקיבולת שהוזמנה

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

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

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

צפייה ברשימת ההזמנות

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

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

המסוף

  1. פותחים את הדף Reservations במסוף Cloud de Confiance .

    כניסה לדף Reservations

    בכרטיסייה On-demand reservations (ברירת המחדל), כל הזמנה מופיעה בשורה בטבלה, וכל עמודה בטבלה מתארת מאפיין.

  2. אופציונלי: כדי לצמצם את רשימת ההזמנות, בשדה Filter בוחרים את המאפיינים שלפיהם רוצים לסנן את ההזמנות.

gcloud

כדי לראות את רשימת ההזמנות, משתמשים בפקודה gcloud compute reservations list:

gcloud compute reservations list

הפלט אמור להיראות כך:

NAME: r-01
IN_USE_COUNT: 0
COUNT: 5
ZONE: europe-west4-b
SHARE_TYPE: LOCAL

NAME: r-02
IN_USE_COUNT: 3
COUNT: 10
ZONE: europe-west4-b
SHARE_TYPE: LOCAL

אם רוצים לצמצם את רשימת ההזמנות, משתמשים באותה פקודה עם הדגל --filter.

REST

כדי לראות רשימה של ההזמנות, שולחים בקשת GET לאחת מהשיטות הבאות:

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

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

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

הפלט של רשימת הזמנות באזור אחד אמור להיראות כך:

{
  "id": "projects/example-project/zones/europe-west4-b/futureReservations",
  "items": [
    {
      "specificSkuProperties": {
        "instanceProperties": {
          "machineType": "h4d-highmem-192-lssd",
          "localSsds": [
            {
              "diskSizeGb": "375",
              "interface": "NVME"
            }
          ]
        },
        "totalCount": "8"
      },
      "kind": "compute#futureReservation",
      "id": "7979651787097007552",
      "creationTimestamp": "2025-11-27T11:14:58.305-08:00",
      "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west4-b/futureReservations/example-draft-request",
      "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west4-b/futureReservations/7979651787097007552",
      "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west4-b",
      "name": "example-draft-request",
      "timeWindow": {
        "startTime": "2026-01-27T19:20:00Z",
        "endTime": "2026-02-10T19:20:00Z"
      },
      "status": {
        "procurementStatus": "DRAFTING",
        "lockTime": "2026-01-27T19:15:00Z"
      },
      "planningStatus": "DRAFT",
      "specificReservationRequired": true,
      "reservationName": "example-reservation",
      "deploymentType": "DENSE",
      "schedulingType": "GROUPED",
      "autoCreatedReservationsDeleteTime": "2026-02-10T19:20:00Z"
    }
    ...
  ],
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west4-b/futureReservations",
  "etag": "AnzKY34l-cvvV-JnniESJ0dtQvQ=/hvc4jaHpxFAZmOt1FVtKNgzZu-M=",
  "kind": "compute#futureReservationsListResponse"
}

אם רוצים לצמצם את רשימת ההזמנות, שולחים את אותה בקשה וכוללים בכתובת ה-URL של הבקשה את פרמטר השאילתה filter.

הצגת פרטי הזמנה

אתם יכולים לראות את פרטי ההזמנות בפרויקט כדי להבין פרטים כמו:

  • אילו סוגים של מכונות וירטואליות כלולים בהזמנה.
  • כמה מכונות וירטואליות מוזמנות וזמינות בהזמנה.

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

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

המסוף

  1. פותחים את הדף Reservations במסוף Cloud de Confiance .

    כניסה לדף Reservations

  2. בטבלה On-demand reservations, בעמודה Name, לוחצים על השם של ההזמנה שרוצים לראות את הפרטים שלה. יופיע דף עם פרטי ההזמנה.

gcloud

כדי לראות את פרטי ההזמנה, משתמשים בפקודה gcloud compute reservations describe:

gcloud compute reservations describe RESERVATION_NAME \
    --zone=ZONE

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

  • RESERVATION_NAME: השם של ההזמנה.
  • ZONE: האזור שבו קיימת ההזמנה.

הפלט אמור להיראות כך:

advancedDeploymentControl:
  reservationOperationalMode: HIGHLY_AVAILABLE_CAPACITY
creationTimestamp: '2025-11-20T15:49:02.541-07:00'
deleteAtTime: '2026-01-31T07:00:00Z'
deploymentType: DENSE
id: '5555834036379788721'
kind: compute#reservation
name: example-res1
reservationSharingPolicy:
  serviceShareType: DISALLOW_ALL
resourceStatus:
  reservationBlockCount: 1
  reservationMaintenance:
    schedulingType: GROUPED
schedulingType: GROUPED
selfLink: https://www.s3nsapis.fr/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1
shareSettings:
  shareType: LOCAL
specificReservation:
  assuredCount: '8'
  count: '8'
  inUseCount: '0'
  instanceProperties:
    machineType: h4d-highmem-192
    minCpuPlatform: Any CPU Platform
specificReservationRequired: true
status: READY
zone: https://www.s3nsapis.fr/compute/v1/projects/example-project/zones/us-central1-a

הפלט כולל את השדות הבאים של ההזמנה:

  • name: השם של ההזמנה.
  • reservationBlockCount: המספר הכולל של הבלוקים בהזמנה.
  • assuredCount: המספר הכולל של מכונות וירטואליות שאפשר לפרוס באמצעות ההזמנה. אם הערך הזה קטן מ-count, כדאי לעיין במאמר בנושא פתרון בעיות שקשורות ל זמינות של פחות מכונות וירטואליות לשימוש.
  • inUseCount: מספר המכונות הווירטואליות שכבר נפרסו בהזמנה.
  • instanceProperties: המאפיינים של המכונות הווירטואליות שאפשר לפרוס בהזמנה.

REST

כדי לראות את פרטי ההזמנה, שולחים בקשת GET ל-method‏ reservations.get:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME

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

  • PROJECT_ID: מזהה הפרויקט שבו קיימת ההזמנה.
  • ZONE: האזור שבו קיימת ההזמנה.
  • RESERVATION_NAME: השם של ההזמנה.

הפלט אמור להיראות כך:

{
  "specificReservation": {
    "instanceProperties": {
      "machineType": "h4d-highmem-192-lssd",
      "minCpuPlatform": "Any CPU Platform",
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        }
      ]
    },
    "count": "8",
    "inUseCount": "0",
    "assuredCount": "8"
  },
  "kind": "compute#reservation",
  "id": "5555834036379788721",
  "creationTimestamp": "2025-11-20T15:49:02.541-07:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1",
  "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a",
  "name": "example-res1",
  "specificReservationRequired": true,
  "status": "READY",
  "shareSettings": {
    "shareType": "LOCAL"
  },
  "resourceStatus": {
    "reservationMaintenance": {
      "schedulingType": "INDEPENDENT"
    },
    "reservationBlockCount": 1
  },
  "reservationSharingPolicy": {
    "serviceShareType": "DISALLOW_ALL"
  },
  "deploymentType": "DENSE",
  "advancedDeploymentControl": {
    "reservationOperationalMode": "HIGHLY_AVAILABLE_CAPACITY"
  },
  "schedulingType": "INDEPENDENT",
  "deleteAtTime": "2026-01-31T07:00:00Z"
}

הפלט כולל את השדות הבאים של ההזמנה:

הצגת הטופולוגיה של הזמנה

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

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

הצגת בלוקים שמורים

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

  • אילו בלוקים של קיבולת כלולים בהזמנה.
  • כמה קיבולת זמינה בכל בלוק.
  • השם, הבלוק ותת-הבלוק של כל המכונות הווירטואליות שנפרסו בבלוק. (זמין רק כשמציגים בלוק ספציפי באמצעות ה-CLI של gcloud או REST).

המסוף

  1. פותחים את הדף Reservations במסוף Cloud de Confiance .

    כניסה לדף Reservations

  2. בטבלה On-demand reservations, בעמודה Name, לוחצים על השם של ההזמנה שרוצים לראות את הפרטים שלה. ייפתח דף הפרטים של ההזמנה.
  3. בקטע Resource topology אפשר לראות מידע על הבלוקים שהוזמנו. הפרטים האלה כוללים את הנתונים הבאים לגבי כל בלוק:
    • Block ID: שם הבלוק.
    • Count: המספר הכולל של המכונות הווירטואליות שאפשר לפרוס בבלוק.
    • בשימוש: מספר המכונות הווירטואליות שכבר נפרסו בבלוק.

gcloud

אפשר לראות את החסימות בהזמנה באמצעות הפקודות הבאות:

  • כדי לראות את כל הבלוקים הזמינים בהזמנה, משתמשים בפקודה gcloud compute reservations blocks list:
    gcloud compute reservations blocks list RESERVATION_NAME \
        --zone=ZONE
    
  • כדי להציג בלוק ספציפי בהזמנה, משתמשים בפקודה gcloud compute reservations blocks describe. כדי לראות גם את השם והטופולוגיה של כל המכונות הווירטואליות שנפרסו בבלוק, מוסיפים את הדגל --full-view=BLOCK_VIEW_FULL.
    gcloud compute reservations blocks describe RESERVATION_NAME \
        --zone=ZONE \
        --block-name=BLOCK_NAME \
        --full-view=BLOCK_VIEW_FULL
    

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

  • RESERVATION_NAME: השם של השמירה.
  • ZONE: האזור שבו קיימת ההזמנה.
  • BLOCK_NAME: השם של הבלוק.

הפלט של כל בלוק אמור להיראות כך:

resource:
  count: 36
  creationTimestamp: '2025-08-04T15:15:07.074-07:00'
  id: '4360924059555106309'
  inUseCount: 35
  kind: compute#reservationBlock
  name: example-res1-block-0001
  physicalTopology:
    block: 1acd074d42cd3be9e4486b524db2e9ab
    cluster: us-central1-cluster-dnkc
    instances:
    -   instanceId: '5815586279631866288'
      physicalHostTopology:
        host: c229b308380a83e0ca345d4a0de05aa7
        subBlock: c02af6bdaeccacef571e0adbe79e8c28
      projectId: 'PROJECT_NUMBER'
    ...
    -   instanceId: '8389759878923049076'
      physicalHostTopology:
        host: '3ac534f00c20e6e0c87c3aaff2705be6'
        subBlock: 'c081876ba0aa2857d608eb30a5b2fa40'
      projectId: 'PROJECT_NUMBER'
  reservationMaintenance:
    instanceMaintenanceOngoingCount: 3
    instanceMaintenancePendingCount: 32
    maintenanceOngoingCount: 2
    maintenancePendingCount: 34
    schedulingType: GROUPED
    subblockInfraMaintenanceOngoingCount: 0
    subblockInfraMaintenancePendingCount: 0
    upcomingGroupMaintenance:
      canReschedule: false
      maintenanceReasons:
      -   PLANNED_UPDATE
      maintenanceStatus: ONGOING
      type: SCHEDULED
      windowEndTime: '2025-09-08T17:00:00.000-07:00'
      windowStartTime: '2025-09-08T13:00:00.000-07:00'
  reservationSubBlockCount: 2
  reservationSubBlockInUseCount: 2
  selfLink: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/example-res1-block-0001
  selfLinkWithId: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/4360924059555106309
  status: READY
  zone: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a

הפלט כולל את השדות הבאים לכל בלוק:

  • count: המספר הכולל של המכונות הווירטואליות שאפשר לפרוס בבלוק.
  • inUseCount: מספר המכונות הווירטואליות שכבר נפרסו בבלוק.
  • name: השם של הבלוק.
  • physicalTopology: המיקום הפיזי של הבלוק, שמופיע גם ב טופולוגיית ה-VM, באופן הבא:
    • block: המזהה הספציפי לארגון של הבלוק.
    • cluster: השם הגלובלי של האשכול.
    • instances: רשימה של השמות והמיקומים הפיזיים של כל המכונות הווירטואליות בבלוק, באופן הבא. (השדה הזה מופיע רק כשכוללים את הדגל --full-view=BLOCK_VIEW_FULL).
      • instanceId: המזהה של מופע.
      • subBlock: המזהה הספציפי לארגון של תת-הבלוק שבו נמצאת המכונה הזו.
      • block: המזהה הספציפי לארגון של הבלוק שבו נמצא המופע הזה.
  • reservationSubBlockCount: מספר תתי-הבלוקים בבלוק.
  • reservationSubBlockInUseCount: מספר תתי הבלוקים בבלוק עם לפחות מכונה וירטואלית אחת שכבר נפרסה.

REST

אפשר לראות את החסימות בהזמנה בדרכים הבאות:

  • כדי לראות את כל הבלוקים שזמינים בהזמנה, שולחים בקשת GET ל-method‏ reservationBlocks.list:
    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks
    
  • כדי לראות בלוק ספציפי בהזמנה, שולחים בקשת GET אל ה-method‏ reservationBlocks.get. כדי לראות גם את השם והטופולוגיה של כל המכונות הווירטואליות שנפרסו בבלוק, מוסיפים את פרמטר השאילתה ?view=FULL.
    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks/BLOCK_NAME?view=FULL
    

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

  • PROJECT_ID: מזהה הפרויקט שבו קיימת ההזמנה.
  • ZONE: האזור שבו קיימת ההזמנה.
  • RESERVATION_NAME: השם של ההזמנה.
  • BLOCK_NAME: השם של הבלוק.

הפלט של כל בלוק אמור להיראות כך:

{
  "resource": {
    "kind": "compute#reservationBlock",
    "id": "4360924059555106309",
    "creationTimestamp": "2025-08-04T15:15:07.074-07:00",
    "name": "example-res1-block-0001",
    "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a",
    "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/example-res1-block-0001",
    "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/4360924059555106309",
    "count": 36,
    "inUseCount": 35,
    "reservationMaintenance": {
      "upcomingGroupMaintenance": {
        "type": "SCHEDULED",
        "canReschedule": false,
        "windowStartTime": "2025-09-08T13:00:00.000-07:00",
        "windowEndTime": "2025-09-08T17:00:00.000-07:00",
        "maintenanceStatus": "ONGOING",
        "maintenanceReasons": [
          "PLANNED_UPDATE"
        ]
      },
      "maintenanceOngoingCount": 2,
      "maintenancePendingCount": 34,
      "schedulingType": "GROUPED",
      "subblockInfraMaintenanceOngoingCount": 0,
      "subblockInfraMaintenancePendingCount": 0,
      "instanceMaintenanceOngoingCount": 3,
      "instanceMaintenancePendingCount": 32
    },
    "status": "READY",
    "physicalTopology": {
      "cluster": "us-central1-cluster-dnkc",
      "block": "1acd074d42cd3be9e4486b524db2e9ab",
      "instances": [
        {
          "instanceId": "5815586279631866288",
          "projectId": "PROJECT_NUMBER",
          "physicalHostTopology": {
            "subBlock": "c02af6bdaeccacef571e0adbe79e8c28",
            "host": "c229b308380a83e0ca345d4a0de05aa7"
          }
        },
        ...
        {
          "instanceId": "8389759878923049076",
          "projectId": "PROJECT_NUMBER",
          "physicalHostTopology": {
            "subBlock": "c081876ba0aa2857d608eb30a5b2fa40",
            "host": "3ac534f00c20e6e0c87c3aaff2705be6"
          }
        }
      ]
    },
    "reservationSubBlockCount": 2,
    "reservationSubBlockInUseCount": 2
  }
}

הפלט כולל את השדות הבאים לכל בלוק:

  • name: השם של הבלוק.
  • count: המספר הכולל של המכונות הווירטואליות שאפשר לפרוס בבלוק.
  • inUseCount: מספר המכונות הווירטואליות שכבר נפרסו בבלוק.
  • physicalTopology: המיקום הפיזי של הבלוק, שמופיע גם בView H4D cluster topology, באופן הבא:
    • cluster: השם הגלובלי של האשכול.
    • block: המזהה הספציפי לארגון של הבלוק.
    • instances: רשימה של השמות והמיקומים הפיזיים של כל המכונות הווירטואליות בבלוק, באופן הבא. (השדה הזה מופיע רק כשכוללים את פרמטר השאילתה ?view=FULL).
      • instanceId: המזהה של מופע.
      • subBlock: המזהה הספציפי לארגון של תת-הבלוק שבו נמצאת המכונה הווירטואלית הזו.
      • block: המזהה הספציפי לארגון של הבלוק שבו נמצאת המכונה הווירטואלית הזו.
  • reservationSubBlockCount: מספר תתי-הבלוקים בבלוק.
  • reservationSubBlockInUseCount: מספר תתי הבלוקים בבלוק עם לפחות מכונה וירטואלית אחת שכבר נפרסה.

הצגת תתי-בלוקים שמורים

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

  • אילו תתי-בלוקים של קיבולת נמצאים בבלוק השמור.
  • מה הקיבולת שזמינה בכל תת-בלוק.

gcloud

אפשר לראות את בלוקי המשנה בהזמנה באמצעות הפקודות הבאות:

  • כדי לראות את כל תתי-הבלוקים הזמינים בבלוק של הזמנה, משתמשים בפקודה gcloud compute reservations sub-blocks list:
    gcloud compute reservations sub-blocks list RESERVATION_NAME \
        --zone=ZONE \
        --block-name=BLOCK_NAME
    
  • כדי לראות חלק ספציפי של בלוק בהזמנה, משתמשים בפקודה gcloud compute reservations sub-blocks describe:
    gcloud compute reservations sub-blocks describe RESERVATION_NAME \
        --zone=ZONE \
        --block-name=BLOCK_NAME \
        --sub-block-name=SUB-BLOCK_NAME
    

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

  • RESERVATION_NAME: השם של השמירה.
  • ZONE: האזור שבו קיימת ההזמנה.
  • BLOCK_NAME: השם של הבלוק.
  • SUB-BLOCK_NAME: השם של בלוק המשנה.

הפלט של כל תת-בלוק אמור להיראות כך:

count: 18
creationTimestamp: '2025-07-18T14:50:01.652-07:00'
id: '6848013619223297894'
inUseCount: 2
kind: compute#reservationSubBlock
name: example-res1-block-0001-subblock-0001
physicalTopology:
  block: 2b6aa63faa2b60b7ecd3b87ec337f270
  cluster: us-central1-cluster-xvhj
  subBlock: 556a310b49a0b247bc109cc7f997cea2
reservationSubBlockMaintenance:
  schedulingType: GROUPED
selfLink: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/example-res1-block-0001/reservationSubBlocks/example-res1-block-0001-subblock-0001
selfLinkWithId: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/example-res1-block-0001/reservationSubBlocks/6848013619223297894
status: READY
zone: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a

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

  • count: המספר הכולל של מכונות וירטואליות שאפשר לפרוס בתת-הבלוק.
  • inUseCount: מספר המכונות הווירטואליות שכבר נפרסו בתת-הבלוק.
  • name: השם של בלוק המשנה.
  • physicalTopology: המיקום הפיזי של בלוק המשנה, שמופיע גם ב טופולוגיית מכונת ה-VM, באופן הבא:
    • block: המזהה הספציפי לארגון של הבלוק.
    • cluster: השם הגלובלי של האשכול.
    • subblock: המזהה הספציפי לארגון של תת-הבלוק.

REST

אפשר לראות את בלוקי המשנה בהזמנה באמצעות השיטות הבאות:

  • כדי לראות את כל תתי-הבלוקים הזמינים בבלוק של הזמנה, שולחים בקשת GET ל-method‏ reservationSubBlocks.list:
    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks/BLOCK_NAME/reservationSubBlocks
    
  • כדי לראות בלוק משנה ספציפי בבלוק של הזמנה, שולחים בקשת GET לשיטה reservationSubBlocks.get:
    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks/BLOCK_NAME/reservationSubBlocks/SUB-BLOCK_NAME
    

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

  • PROJECT_ID: מזהה הפרויקט שבו קיימת ההזמנה.
  • ZONE: האזור שבו קיימת ההזמנה.
  • RESERVATION_NAME: השם של ההזמנה.
  • BLOCK_NAME: השם של הבלוק.
  • SUB-BLOCK_NAME: השם של בלוק המשנה.

הפלט של כל תת-בלוק אמור להיראות כך:

{
  "resource": {
    "kind": "compute#reservationSubBlock",
    "id": "5679680646666817028",
    "creationTimestamp": "2025-08-04T15:15:07.625-07:00",
    "name": "example-res1-block-0001-subblock-0001",
    "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a",
    "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/example-res1-block-0001/reservationSubBlocks/example-res1-block-0001-subblock-0001",
    "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/example-res1-block-0001/reservationSubBlocks/5679680646666817028",
    "count": 18,
    "inUseCount": 18,
    "reservationSubBlockMaintenance": {
      "upcomingGroupMaintenance": {
        "type": "SCHEDULED",
        "canReschedule": false,
        "windowStartTime": "2025-09-08T13:00:00.000-07:00",
        "windowEndTime": "2025-09-08T17:00:00.000-07:00",
        "maintenanceStatus": "ONGOING",
        "maintenanceReasons": [
          "PLANNED_UPDATE"
        ]
      },
      "maintenanceOngoingCount": 2,
      "maintenancePendingCount": 16,
      "schedulingType": "GROUPED",
      "subblockInfraMaintenanceOngoingCount": 0,
      "subblockInfraMaintenancePendingCount": 0,
      "instanceMaintenanceOngoingCount": 3,
      "instanceMaintenancePendingCount": 15
    },
    "status": "READY",
    "physicalTopology": {
      "cluster": "us-central1-cluster-dnkc",
      "block": "1acd074d42cd3be9e4486b524db2e9ab",
      "subBlock": "c081876ba0aa2857d608eb30a5b2fa40"
    }
  }
}

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

  • name: השם של בלוק המשנה.
  • count: המספר הכולל של מכונות וירטואליות שאפשר לפרוס בתת-הבלוק.
  • inUseCount: מספר המכונות הווירטואליות שכבר נפרסו בתת-הבלוק.
  • physicalTopology: המיקום הפיזי של בלוק המשנה, שמופיע גם ב טופולוגיה של מכונות וירטואליות, באופן הבא:
    • cluster: השם הגלובלי של האשכול.
    • block: המזהה הספציפי לארגון של הבלוק.
    • subblock: המזהה הספציפי לארגון של תת-הבלוק.

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