Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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

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

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

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

מערכת Compute Engine מוסיפה את המכונות השמורות של Compute Engine להזמנה. אחרי כן תוכלו להתחיל להשתמש בהזמנה על ידי יצירת מופעי מחשוב שתואמים להזמנה.
אפשר לשנות את השמירה כדי לאפשר למשימות אימון או חיזוי של Vertex AI להשתמש בה. הוראות מפורטות זמינות במאמר בנושא שינוי מדיניות השיתוף של הזמנה.

מגבלות

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

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

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

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

gcloud

במסוף Google Cloud , מפעילים את Cloud Shell.

הפעלת Cloud Shell

בחלק התחתון של Google Cloud המסוף יתחיל סשן של Cloud Shell ותופיע הודעה של שורת הפקודה. Cloud Shell היא סביבת מעטפת שבה ה-CLI של Google Cloud מותקן ומוגדרים ערכים לפרויקט הקיים. הסשן יופעל תוך כמה שניות.
REST

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

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

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

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

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

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

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

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

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

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

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

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

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

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

המסוף

פותחים את הדף Reservations במסוף Google Cloud .
כניסה לדף Reservations
לוחצים על הכרטיסייה Future reservations. בטבלה מופיעה כל בקשה למקום שמור לעתיד, וכל עמודה בטבלה מתארת מאפיין.
אופציונלי: כדי לצמצם את רשימת הבקשות, בשדה 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 לאחת מהשיטות הבאות:

כדי לראות רשימה של בקשות בכל האזורים: ‫futureReservations.aggregatedList method
כדי לראות רשימה של בקשות באזור מסוים: ‫futureReservations.list method

לדוגמה, כדי לראות רשימה של בקשות בכל האזורים, שולחים בקשת 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": "a3-ultragpu-8g",
          "guestAccelerators": [
            {
              "acceleratorType": "nvidia-h200-141gb",
              "acceleratorCount": 8
            }
          ],
          "localSsds": [
            {
              "diskSizeGb": "375",
              "interface": "NVME"
            },
            ...
          ]
        },
        "totalCount": "2"
      },
      "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-west1-b/futureReservations/example-draft-request",
      "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/7979651787097007552",
      "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-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": "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 פרמטר השאילתה.

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

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

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

המסוף

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

כניסה לדף Reservations
לוחצים על הכרטיסייה Future reservations. בטבלה מופיעה כל בקשה למקום שמור לעתיד, וכל עמודה בטבלה מתארת מאפיין.
כדי לראות את פרטי הבקשה, בעמודה 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": "a3-ultragpu-8g",
      "guestAccelerators": [
        {
          "acceleratorType": "nvidia-h200-141gb",
          "acceleratorCount": 8
        }
      ],
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        ...
      ]
    },
    "totalCount": "2"
  },
  "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-west1-b/futureReservations/example-draft-request",
  "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/7979651787097007552",
  "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-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": "INDEPENDENT",
  "autoCreatedReservationsDeleteTime": "2026-02-10T19:20:00Z"
}

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

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

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

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

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

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

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

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

המסוף

פותחים את הדף Reservations במסוף Google Cloud .
כניסה לדף Reservations

בכרטיסייה On-demand reservations (ברירת המחדל), כל הזמנה מופיעה בשורה בטבלה, וכל עמודה בטבלה מתארת מאפיין.
אופציונלי: כדי לצמצם את רשימת ההזמנות, בשדה 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 לאחת מהשיטות הבאות:

כדי לראות רשימה של ההזמנות בכל האזורים: reservations.aggregatedList שיטה
כדי לראות רשימה של ההזמנות שלכם באזור אחד: שיטת reservations.list

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

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

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

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

{
  "id": "projects/example-project/zones/europe-west1-b/futureReservations",
  "items": [
    {
      "specificSkuProperties": {
        "instanceProperties": {
          "machineType": "a3-ultragpu-8g",
          "guestAccelerators": [
            {
              "acceleratorType": "nvidia-h200-141gb",
              "acceleratorCount": 8
            }
          ],
          "localSsds": [
            {
              "diskSizeGb": "375",
              "interface": "NVME"
            },
            ...
          ]
        },
        "totalCount": "2"
      },
      "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-west1-b/futureReservations/example-draft-request",
      "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/7979651787097007552",
      "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-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": "INDEPENDENT",
      "autoCreatedReservationsDeleteTime": "2026-02-10T19:20:00Z"
    }
    ...
  ],
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations",
  "etag": "AnzKY34l-cvvV-JnniESJ0dtQvQ=/hvc4jaHpxFAZmOt1FVtKNgzZu-M=",
  "kind": "compute#futureReservationsListResponse"
}

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

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

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

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

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

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

המסוף

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

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

gcloud

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

gcloud compute reservations describe RESERVATION_NAME \
    --zone=ZONE

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

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

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

advancedDeploymentControl:
  reservationOperationalMode: ALL_CAPACITY
creationTimestamp: '2025-07-18T13:23:22.191-07:00'
deleteAtTime: '2026-06-19T00:00:00Z'
deploymentType: DENSE
enableEmergentMaintenance: false
id: '4298354039694234582'
kind: compute#reservation
name: example-res1
reservationSharingPolicy:
  serviceShareType: DISALLOW_ALL
resourceStatus:
  healthInfo:
    degradedBlockCount: 0
    healthStatus: HEALTHY
    healthyBlockCount: 1
  reservationBlockCount: 1
  reservationMaintenance:
    schedulingType: GROUPED
schedulingType: GROUPED
selfLink: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1
selfLinkWithId: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/4298354039694234582
shareSettings:
  shareType: LOCAL
specificReservation:
  assuredCount: '18'
  count: '18'
  inUseCount: '2'
  instanceProperties:
    guestAccelerators:
    -   acceleratorCount: 4
      acceleratorType: nvidia-gb200
    localSsds:
    -   diskSizeGb: '3000'
      interface: NVME
    -   diskSizeGb: '3000'
      interface: NVME
    -   diskSizeGb: '3000'
      interface: NVME
    -   diskSizeGb: '3000'
      interface: NVME
    machineType: a4x-highgpu-4g
specificReservationRequired: true
status: READY
zone: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a

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

‫name: השם של ההזמנה.
‫healthInfo: המידע הרפואי של ההזמנה, באופן הבא:
- ‫degradedBlockCount: מספר הבלוקים שהביצועים שלהם ירדו בהזמנה.
- ‫healthStatus: סטטוס הבריאות הכולל של ההזמנה.
- ‫healthyBlockCount: מספר הבלוקים התקינים בהזמנה.
‫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": "a4x-highgpu-4g",
      "guestAccelerators": [
        {
          "acceleratorType": "nvidia-gb200",
          "acceleratorCount": 4
        }
      ],
      "localSsds": [
        {
          "diskSizeGb": "3000",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "3000",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "3000",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "3000",
          "interface": "NVME"
        }
      ]
    },
    "count": "36",
    "inUseCount": "35",
    "assuredCount": "33"
  },
  "kind": "compute#reservation",
  "id": "6823689647457870910",
  "creationTimestamp": "2025-08-04T13:40:50.496-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": "SPECIFIC_PROJECTS"
  },
  "resourceStatus": {
    "reservationMaintenance": {
      "upcomingGroupMaintenance": {
        "type": "SCHEDULED",
        "canReschedule": false,
        "maintenanceStatus": "ONGOING"
      },
      "maintenanceOngoingCount": 2,
      "maintenancePendingCount": 34,
      "schedulingType": "GROUPED",
      "subblockInfraMaintenanceOngoingCount": 0,
      "subblockInfraMaintenancePendingCount": 0,
      "instanceMaintenanceOngoingCount": 3,
      "instanceMaintenancePendingCount": 32
    },
    "reservationBlockCount": 1,
    "healthInfo": {
      "healthStatus": "DEGRADED",
      "healthyBlockCount": 0,
      "degradedBlockCount": 1
    }
  },
  "reservationSharingPolicy": {
    "serviceShareType": "DISALLOW_ALL"
  },
  "deploymentType": "DENSE",
  "advancedDeploymentControl": {
    "reservationOperationalMode": "ALL_CAPACITY"
  },
  "enableEmergentMaintenance": false,
  "schedulingType": "GROUPED",
  "deleteAtTime": "2025-10-01T00:00:00Z"
}

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

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

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

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

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

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

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

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

המסוף

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

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

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'
  healthInfo:
    degradedSubBlockCount: 2
    healthStatus: DEGRADED
    healthySubBlockCount: 0
  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: המספר הכולל של מופעי מחשוב שאפשר לפרוס בבלוק.
‫healthInfo: פרטי הבריאות של הבלוק, באופן הבא:
- ‫degradedSubBlockCount: מספר תת-הבלוקים שהאיכות שלהם ירדה בבלוק.
- ‫healthStatus: הסטטוס הכללי של תקינות הבלוק.
- ‫healthySubBlockCount: מספר תתי-הבלוקים התקינים בבלוק.
‫inUseCount: מספר המכונות הווירטואליות לחישוב שכבר נפרסו בבלוק.
‫name: השם של הבלוק.
‫physicalTopology: המיקום הפיזי של הבלוק, שמופיע גם ב טופולוגיה של מופע Compute, באופן הבא:
- ‫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,
    "healthInfo": {
      "healthStatus": "DEGRADED",
      "healthySubBlockCount": 0,
      "degradedSubBlockCount": 2
    }
  }
}

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

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

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

כדי להציג ולתאר את בלוקי המשנה שזמינים בבלוק של מקום שמור, משתמשים ב-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'
healthInfo:
  degradedHostCount: 0
  degradedInfraCount: 0
  healthStatus: HEALTHY
  healthyHostCount: 18
  healthyInfraCount: 1
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: המספר הכולל של מופעי מחשוב שאפשר לפרוס בתת-הבלוק.
healthInfo: פרטי הבריאות של תת-הבלוק באופן הבא:
- ‫degradedHostCount: מספר המכונות המארחות שהביצועים שלהן ירדו בתת-הבלוק.
- ‫degradedInfraCount: מספר החיבורים המקוצרים של המאיצים שהביצועים שלהם ירדו בבלוק המשנה.
- ‫healthStatus: סטטוס תקינות כללי של בלוק המשנה.
- ‫healthyHostCount: מספר המכונות המארחות התקינות בתת-הבלוק.
- ‫healthyInfraCount: מספר החיבורים התקינים בין המאיצים בתת-הבלוק.
‫inUseCount: מספר מכונות ה-Compute שכבר נפרסו בתת-הבלוק.
‫name: השם של בלוק המשנה.
‫physicalTopology: המיקום הפיזי של בלוק המשנה, שמופיע גם ב טופולוגיה של מכונת מחשוב, באופן הבא:
- ‫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"
    },
    "healthInfo": {
      "healthStatus": "DEGRADED",
      "healthyHostCount": 16,
      "degradedHostCount": 2,
      "healthyInfraCount": 1,
      "degradedInfraCount": 0
    }
  }
}

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

‫name: השם של בלוק המשנה.
‫count: המספר הכולל של מופעי מחשוב שאפשר לפרוס בתת-הבלוק.
‫inUseCount: מספר מכונות ה-Compute שכבר נפרסו בתת-הבלוק.
‫physicalTopology: המיקום הפיזי של בלוק המשנה, שמופיע גם ב טופולוגיה של מכונת מחשוב, באופן הבא:
- ‫cluster: השם הגלובלי של האשכול.
- ‫block: המזהה הספציפי לארגון של הבלוק.
- ‫subblock: המזהה הספציפי לארגון של תת-הבלוק.
healthInfo: פרטי הבריאות של תת-הבלוק באופן הבא:
- ‫healthStatus: סטטוס תקינות כללי של בלוק המשנה.
- ‫healthyHostCount: מספר המכונות המארחות התקינות בתת-הבלוק.
- ‫degradedHostCount: מספר המכונות המארחות שהביצועים שלהן ירדו בחלק המשנה.
- ‫healthyInfraCount: מספר החיבורים התקינים בין המאיצים בחלק המשנה.
- ‫degradedInfraCount: מספר החיבורים המקוצרים של המאיצים שהביצועים שלהם ירדו בבלוק המשנה.

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

מגבלות

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

המסוף

gcloud

REST

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

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

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

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

המסוף

gcloud

REST

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

המסוף

gcloud

REST

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

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

המסוף

gcloud

REST

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

המסוף

gcloud

REST

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

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

המסוף

gcloud

REST

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

gcloud

REST

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

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