צפייה בקובצי אימג' של מערכת הפעלה של מכונות וירטואליות ל-Batch

בדף הזה מוסבר איך לראות את תמונות מערכת ההפעלה (OS) שזמינות למכונות וירטואליות (VM) שמריצות משימות Batch.

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

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

  1. אם עוד לא השתמשתם ב-Batch, כדאי לעיין במאמר תחילת העבודה עם Batch ולהפעיל את Batch על ידי השלמת הדרישות המוקדמות לפרויקטים ולמשתמשים.

צפייה ברשימה של תמונות מערכת הפעלה של מכונות וירטואליות מ-Batch

אפשר לראות רשימה של כל תמונות מערכת ההפעלה של מכונות וירטואליות מ-Batch באמצעות ה-CLI של gcloud או Batch API.

gcloud

כדי לראות רשימה של כל תמונות מערכות ההפעלה הנתמכות של מכונות וירטואליות מ-Batch, משתמשים בפקודה gcloud compute images list הבאה:

gcloud compute images list \
    --project=batch-custom-image \
    --no-standard-images
  • כדי להציג רשימת תמונות מ-Batch, צריך להשתמש בדגל --project=batch-custom-image.
  • הדגל --no-standard-images משמיט את התמונות הרגילות מ-Compute Engine.
  • אופציונלי: אם אתם צריכים לראות תמונות Batch שהוצאו משימוש, צריך לכלול גם את הדגל --show-deprecated.

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

NAME: IMAGE_NAME
PROJECT: IMAGE_PROJECT_ID
FAMILY: IMAGE_FAMILY
...

הפלט הזה כולל את הערכים הבאים:

  • ‫IMAGE_NAME: שם התמונה. שם התמונה מייצג גרסה ספציפית של תמונת מערכת הפעלה של מכונה וירטואלית. לדוגמה, שם התמונה batch-cos-stable-official-20260730-00-p01 מייצג את גרסת התמונה -20260730-00-p01 (הגרסה מ-30 ביולי 2026) במשפחת התמונות batch-cos-stable-official.
  • ‫IMAGE_PROJECT_ID: מזהה הפרויקט שמכיל את התמונה. לדוגמה, כל התמונות מ-Batch images נמצאות בפרויקט batch-custom-image.
  • ‫IMAGE_FAMILY: משפחת התמונות. משפחת תמונות כוללת תמונה ספציפית אחת או יותר ומייצגת את הסוג ואת הגרסה הראשית של מערכת ההפעלה. לדוגמה, משפחת התמונות batch-debian-12-official מכילה תמונות של Batch שמבוססות על גרסה 12 של מערכת ההפעלה Debian מ-Compute Engine.

API

כדי להציג רשימה של כל תמונות מערכות ההפעלה הנתמכות של מכונות וירטואליות מ-Batch, שולחים את הבקשה הבאה אל השיטה images.list:

GET https://compute.googleapis.com/compute/v1/projects/batch-custom-image/global/images?filter=(-deprecated%3A*)%20OR%20(deprecated.state%3D%22ACTIVE%22)
  • חובה להשתמש בפרויקט batch-custom-image כדי להציג תמונות מ-Batch.
  • הפרמטר של השאילתה ?filter=(-deprecated%3A*)%20OR%20(deprecated.state%3D%22ACTIVE%22) משמיט תמונות שהוצאו משימוש באמצעות קידוד כתובת URL כדי להגדיר את השדה filter לערך (-deprecated:*) OR (deprecated.state="ACTIVE").
    • אופציונלי: אם אתם צריכים לראות תמונות שנוספו באמצעות Batch deprecated, אתם יכולים להסיר את הפרמטר ?filter=(-deprecated%3A*)%20OR%20(deprecated.state%20%3D%20%22ACTIVE%22) של השאילתה.

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

{
  ...
  "name": "IMAGE_NAME",
  ...
  "family": "IMAGE_FAMILY",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/IMAGE_PROJECT_ID/global/images/IMAGE_NAME",
  ...
}

הפלט הזה כולל את הערכים הבאים:

  • ‫IMAGE_NAME: שם התמונה. שם התמונה מייצג גרסה ספציפית של תמונת מערכת הפעלה של מכונה וירטואלית. לדוגמה, שם התמונה batch-cos-stable-official-20260730-00-p01 מייצג את גרסת התמונה -20260730-00-p01 (הגרסה מ-30 ביולי 2026) במשפחת התמונות batch-cos-stable-official.
  • ‫IMAGE_PROJECT_ID: מזהה הפרויקט שמכיל את התמונה. לדוגמה, כל התמונות מ-Batch images נמצאות בפרויקט batch-custom-image.
  • ‫IMAGE_FAMILY: משפחת התמונות. משפחת תמונות כוללת תמונה ספציפית אחת או יותר ומייצגת את הסוג ואת הגרסה הראשית של מערכת ההפעלה. לדוגמה, משפחת התמונות batch-debian-12-official מכילה תמונות של Batch שמבוססות על גרסה 12 של מערכת ההפעלה Debian מ-Compute Engine.

הצגת הפרטים של תמונת מערכת הפעלה של מכונה וירטואלית מ-Batch

אפשר לראות את כל הפרטים של תמונת מערכת הפעלה של מכונה וירטואלית באמצעות ה-CLI של gcloud או Batch API.

gcloud

כדי לראות את הפרטים של תמונת מערכת הפעלה של מכונה וירטואלית מ-Batch, משתמשים בפקודה gcloud compute images describe ומציינים את batch-custom-image כפרויקט התמונה:

gcloud compute images describe IMAGE_NAME --project=batch-custom-image

מחליפים את IMAGE_NAME בשם של אימג' של מערכת ההפעלה של מכונה וירטואלית מ-Batch שרוצים לתאר.

API

כדי לראות את הפרטים של תמונת מערכת הפעלה של מכונה וירטואלית מ-Batch, שולחים בקשה ל-method‏ images.get ומציינים את batch-custom-image כפרויקט התמונה:

GET https://compute.googleapis.com/compute/v1/projects/batch-custom-image/global/images/IMAGE_NAME

מחליפים את IMAGE_NAME בשם של אימג' של מערכת ההפעלה של מכונה וירטואלית מ-Batch שרוצים לתאר.

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