הצגת הפרטים והסטטוס של תוסף ה-VM

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

במאמר הזה מוסבר איך להשתמש בשיטות לקריאה בלבד של get ו-list בהיררכיית המשאבים ב- Google Cloud כדי לבצע את המשימות הבאות:

  • הצגת כללי המדיניות של התוספים בהיררכיית המשאבים הצגת רשימה של כללי מדיניות גלובליים או אזוריים של תוספי VM כדי לראות את פרטי המדיניות ואת מצב ההשקה בארגון, בתיקייה או בפרויקט.
  • הצגת התוספים והגרסאות של המכונה הווירטואלית להציג רשימה של תוספי VM שנתמכים ב-VM Extension Manager, או לראות פרטים על התוספים – כולל מספרי גרסאות ורמות תמיכה – בכל האזורים או באזור ספציפי בארגון, בתיקייה או בפרויקט.
  • לצפות בסטטוס של התוספים שמותקנים בכל מכונה וירטואלית. להציג רשימה של כל התוספים שמותקנים במכונה וירטואלית ואת מצבי זמן הריצה שלהם במכונה, כשמדיניות מסוימת מתקינה כמה תוספים במכונה וירטואלית, או להציג את ההגדרה הסופית בפועל ואת המדיניות שחלה (policyId) כשכמה כללי מדיניות חלים על אותה מכונה וירטואלית.
  • פתרון בעיות בתוספים במכונה. לראות את התקדמות ההתקנה, את סטטוס התקינות בזמן הריצה ואת הודעות האבחון כשתוסף לא צפוי מותקן או כשתוסף נכשל במכונה וירטואלית.

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

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

  • במאמר מידע על VM Extension Manager מוסבר איך כללי המדיניות של התוספים מנהלים את הפלאגינים של סוכני האורחים בכל ה-VMs.
  • אם עדיין לא פרסתם תוספים במכונות שלכם, קודם צריך ליצור מדיניות. מידע נוסף זמין במאמר התקנת תוספים למכונות וירטואליות באמצעות יצירת מדיניות לתוספים.
  • מוודאים שיש לכם את ההרשאות הנדרשות לניהול זהויות והרשאות גישה (IAM) כדי להציג את כללי המדיניות של התוספים, לאחזר את פרטי התוספים ולבדוק את מצבי התוספים של המכונות.

מגבלות על הצגת מדיניות ותוספים

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

  • אפשר לראות את כללי המדיניות של תוספי VM ברמת התיקייה וברמת הארגון רק באמצעות Google Cloud CLI או Compute Engine API בארכיטקטורת REST.
  • אפשר לאחזר את פרטי התוספים של המכונות הווירטואליות ואת מצבי התוספים של המכונות רק באמצעות Google Cloud CLI או Compute Engine API בארכיטקטורת REST. אי אפשר לראות את פרטי התוספים של המכונות הווירטואליות או את מצבי התוספים לכל מכונה במסוףGoogle Cloud .
  • ממשקי ה-API של מצב התוסף של המכונה (getVmExtensionState ו-listVmExtensionStates) מדווחים על סטטוס זמן הריצה רק לתוספים שכללי המדיניות של VM Extension Manager מתקינים ומנהלים. ממשקי ה-API האלה לא מדווחים על הסטטוס של סוכנים נפרדים שאתם מתקינים באופן ידני מחוץ ל-VM Extension Manager.

הצגת כללי המדיניות של התוספים

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

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

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

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

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

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

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

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

  • רשימת כללי המדיניות של התוספים: compute.orgVmExtensionPolicies.list
  • הצגת פרטים של מדיניות תוספים: compute.orgVmExtensionPolicies.get

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

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

gcloud

כדי לראות את כל כללי המדיניות הגלובליים של התוספים בארגון, מריצים את הפקודה gcloud preview compute global-vm-extension-policies list עם הדגל --organization:

gcloud preview compute global-vm-extension-policies list \
  --organization=organizations/ORGANIZATION_ID \
  --page-size=PAGE_SIZE

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

  • ‫ORGANIZATION_ID: מזהה הארגון ב- Google Cloud .
  • ‫PAGE_SIZE: המספר המקסימלי של התוצאות שיוחזרו בכל דף.

כדי לראות פרטים של מדיניות גלובלית ספציפית של תוספים בארגון, מריצים את הפקודה gcloud preview compute global-vm-extension-policies describe עם הדגל --organization:

gcloud preview compute global-vm-extension-policies describe POLICY_NAME \
  --organization=organizations/ORGANIZATION_ID

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

  • ‫POLICY_NAME: השם של מדיניות התוספים ל-VM שרוצים לראות.
  • ‫ORGANIZATION_ID: מזהה הארגון ב- Google Cloud .

REST

כדי לראות את כל כללי המדיניות הגלובליים של התוספים בארגון, שולחים בקשת GET לשיטה organizationGlobalVmExtensionPolicies.list:

GET https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/global/vmExtensionPolicies

כדי לראות פרטים של מדיניות תוספים גלובלית ספציפית בארגון, שולחים בקשת GET ל-method organizationGlobalVmExtensionPolicies.get:

GET https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/global/vmExtensionPolicies/POLICY_NAME

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

  • ‫POLICY_NAME: השם של מדיניות התוספים ל-VM שרוצים לראות.
  • ‫ORGANIZATION_ID: מזהה הארגון ב- Google Cloud .

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

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

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

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

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

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

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

  • מדיניות לגבי תוספי רשימות: compute.folderVmExtensionPolicies.list
  • הצגת פרטים של מדיניות תוספים: compute.folderVmExtensionPolicies.get

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

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

gcloud

כדי לראות את כל כללי המדיניות הגלובליים של התוספים בתיקייה, מריצים את הפקודה gcloud preview compute global-vm-extension-policies list עם הדגל --folder:

gcloud preview compute global-vm-extension-policies list \
  --folder=folders/FOLDER_ID \
  --page-size=PAGE_SIZE

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

  • ‫FOLDER_ID: מזהה התיקייה ב- Google Cloud .
  • ‫PAGE_SIZE: המספר המקסימלי של התוצאות שיוחזרו בכל דף.

כדי לראות פרטים של מדיניות תוספים גלובלית ספציפית בתיקייה, מריצים את הפקודה gcloud preview compute global-vm-extension-policies describe עם הדגל --folder:

gcloud preview compute global-vm-extension-policies describe POLICY_NAME \
  --folder=folders/FOLDER_ID

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

  • ‫POLICY_NAME: השם של מדיניות התוספים ל-VM שרוצים להציג.
  • ‫FOLDER_ID: מזהה התיקייה ב- Google Cloud .

REST

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

GET https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/global/vmExtensionPolicies

כדי לראות פרטים של מדיניות תוספים גלובלית ספציפית בתיקייה, שולחים בקשת GET ל-method folderGlobalVmExtensionPolicies.get:

GET https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/global/vmExtensionPolicies/POLICY_NAME

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

  • ‫POLICY_NAME: השם של מדיניות התוספים ל-VM שרוצים לראות.
  • ‫FOLDER_ID: מזהה התיקייה ב- Google Cloud .

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

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

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

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

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

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

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

  • רשימת כללי המדיניות של התוספים: compute.vmExtensionPolicies.list
  • הצגת פרטים של מדיניות תוספים: compute.vmExtensionPolicies.get

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

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

המסוף

כדי לראות את כללי המדיניות הגלובליים של תוספי VM בפרויקט באמצעות מסוף Google Cloud :

  1. נכנסים לדף VM extension policies במסוף Google Cloud .

    לדף VM extension policies

  2. לוחצים על מדיניות גלובלית. בכרטיסייה הזו מופיעה רשימה של כל כללי המדיניות הגלובליים של תוספי VM בפרויקט.

gcloud

כדי לראות את כל כללי המדיניות הגלובליים של התוספים בפרויקט, מריצים את הפקודה gcloud compute global-vm-extension-policies list:

gcloud compute global-vm-extension-policies list \
  --project=PROJECT_ID \
  --page-size=PAGE_SIZE

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

  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
  • ‫PAGE_SIZE: המספר המקסימלי של התוצאות שיוחזרו בכל דף.

כדי לראות פרטים של מדיניות תוספים גלובלית ספציפית בפרויקט, מריצים את הפקודה gcloud compute global-vm-extension-policies describe:

gcloud compute global-vm-extension-policies describe POLICY_NAME \
  --project=PROJECT_ID

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

  • ‫POLICY_NAME: השם של מדיניות התוספים ל-VM שרוצים להציג.
  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .

REST

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

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/vmExtensionPolicies

כדי לראות פרטים של מדיניות תוספים גלובלית ספציפית בפרויקט, שולחים בקשת GET ל-method globalVmExtensionPolicies.get:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/vmExtensionPolicies/POLICY_NAME

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

  • ‫POLICY_NAME: השם של מדיניות התוספים ל-VM שרוצים לראות.
  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .

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

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

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

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

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

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

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

  • רשימת כללי המדיניות של התוספים: compute.orgVmExtensionPolicies.list
  • הצגת פרטים של מדיניות תוספים: compute.orgVmExtensionPolicies.get

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

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

gcloud

כדי לראות את כל כללי המדיניות של התוספים ברמת הארגון באזור מסוים, מריצים את הפקודה gcloud preview compute zone-vm-extension-policies list עם הדגל --organization:

gcloud preview compute zone-vm-extension-policies list \
  --organization=organizations/ORGANIZATION_ID \
  --zone=ZONE \
  --page-size=PAGE_SIZE

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

  • ‫ORGANIZATION_ID: מזהה הארגון ב- Google Cloud .
  • ‫ZONE: שם האזור שבו רוצים להציג את רשימת כללי המדיניות של תוספי המכונות הווירטואליות.
  • ‫PAGE_SIZE: המספר המקסימלי של התוצאות שיוחזרו בכל דף.

כדי לראות את הפרטים של מדיניות ספציפית להרחבת אזור ברמת הארגון, מריצים את הפקודה gcloud preview compute zone-vm-extension-policies describe עם הדגל --organization:

gcloud preview compute zone-vm-extension-policies describe POLICY_NAME \
  --organization=organizations/ORGANIZATION_ID \
  --zone=ZONE

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

  • ‫POLICY_NAME: השם של מדיניות התוספים ל-VM שרוצים להציג.
  • ‫ORGANIZATION_ID: מזהה הארגון ב- Google Cloud .
  • ‫ZONE: האזור Google Cloud שבו נמצאת מדיניות התוספים של המכונה הווירטואלית.

REST

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

GET https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/zones/ZONE/vmExtensionPolicies

כדי לראות את הפרטים של מדיניות ספציפית להרחבת אזור בארגון, שולחים בקשת GET ל-method organizationZoneVmExtensionPolicies.get:

GET https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/zones/ZONE/vmExtensionPolicies/POLICY_NAME

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

  • ‫POLICY_NAME: השם של מדיניות התוספים ל-VM שרוצים לראות.
  • ‫ORGANIZATION_ID: מזהה הארגון ב- Google Cloud .
  • ‫ZONE: האזור Google Cloud שבו נמצאת מדיניות התוספים של המכונה הווירטואלית.

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

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

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

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

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

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

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

  • מדיניות לגבי תוספי רשימות: compute.folderVmExtensionPolicies.list
  • הצגת פרטים של מדיניות תוספים: compute.folderVmExtensionPolicies.get

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

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

gcloud

כדי לראות את כל כללי המדיניות של התוספים ברמת התיקייה באזור מסוים, מריצים את הפקודה gcloud preview compute zone-vm-extension-policies list עם הדגל --folder:

gcloud preview compute zone-vm-extension-policies list \
  --folder=folders/FOLDER_ID \
  --zone=ZONE \
  --page-size=PAGE_SIZE

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

  • ‫FOLDER_ID: מזהה התיקייה ב- Google Cloud .
  • ‫ZONE: שם האזור שבו רוצים להציג את רשימת כללי המדיניות של תוספי המכונות הווירטואליות.
  • ‫PAGE_SIZE: המספר המקסימלי של התוצאות שיוחזרו בכל דף.

כדי לראות את הפרטים של מדיניות ספציפית להרחבה אזורית ברמת התיקייה, מריצים את הפקודה gcloud preview compute zone-vm-extension-policies describe עם הדגל --folder:

gcloud preview compute zone-vm-extension-policies describe POLICY_NAME \
  --folder=folders/FOLDER_ID \
  --zone=ZONE

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

  • ‫POLICY_NAME: השם של מדיניות התוספים ל-VM שרוצים להציג.
  • ‫FOLDER_ID: מזהה התיקייה ב- Google Cloud .
  • ‫ZONE: האזור Google Cloud שבו נמצאת מדיניות התוספים של המכונה הווירטואלית.

REST

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

GET https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/zones/ZONE/vmExtensionPolicies

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

GET https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/zones/ZONE/vmExtensionPolicies/POLICY_NAME

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

  • ‫POLICY_NAME: השם של מדיניות התוספים ל-VM שרוצים לראות.
  • ‫FOLDER_ID: מזהה התיקייה ב- Google Cloud .
  • ‫ZONE: האזור Google Cloud שבו נמצאת מדיניות התוספים של המכונה הווירטואלית.

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

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

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

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

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

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

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

  • רשימת כללי המדיניות של התוספים: compute.vmExtensionPolicies.list
  • הצגת פרטים של מדיניות תוספים: compute.vmExtensionPolicies.get

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

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

המסוף

כדי לראות את כללי המדיניות של תוספי ה-VM האזוריים בפרויקט באמצעות מסוף Google Cloud :

  1. נכנסים לדף VM extension policies במסוף Google Cloud .

    לדף VM extension policies

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

gcloud

כדי לראות את כל כללי המדיניות של התוספים ברמת הפרויקט באזור מסוים, מריצים את הפקודה gcloud compute zone-vm-extension-policies list:

gcloud compute zone-vm-extension-policies list \
  --project=PROJECT_ID \
  --zone=ZONE \
  --page-size=PAGE_SIZE

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

  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
  • ‫ZONE: שם האזור שבו רוצים להציג את רשימת כללי המדיניות של תוספי המכונות הווירטואליות.
  • ‫PAGE_SIZE: המספר המקסימלי של התוצאות שיוחזרו בכל דף.

כדי לראות את הפרטים של מדיניות ספציפית להרחבה אזורית ברמת הפרויקט, מריצים את הפקודה gcloud compute zone-vm-extension-policies describe:

gcloud compute zone-vm-extension-policies describe POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE

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

  • ‫POLICY_NAME: השם של מדיניות התוספים ל-VM שרוצים להציג.
  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
  • ‫ZONE: האזור Google Cloud שבו נמצאת מדיניות התוספים של המכונה הווירטואלית.

REST

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

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

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

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/vmExtensionPolicies/POLICY_NAME

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

  • ‫POLICY_NAME: השם של מדיניות התוספים ל-VM שרוצים לראות.
  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
  • ‫ZONE: האזור Google Cloud שבו נמצאת מדיניות התוספים של המכונה הווירטואלית.

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

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

הצגת תוספי VM בכל האזורים בארגון

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

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

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

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

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

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

  • הצגת רשימה של תוספי VM: compute.orgVmExtensions.list
  • הצגת הפרטים של תוסף למכונה וירטואלית: compute.orgVmExtensions.get

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

כדי לראות את התוספים והגרסאות של המכונות הווירטואליות שנתמכים על ידי VM Extension Manager בכל האזורים בארגון, בוחרים באחת מהאפשרויות הבאות:

gcloud

כדי להציג את כל התוספים ל-VM שנתמכים ב-VM Extension Manager ואת רמות התמיכה שלהם בכל האזורים בארגון, מריצים את הפקודה gcloud preview compute global-vm-extension-policies extensions list עם הדגל --organization:

gcloud preview compute global-vm-extension-policies extensions list \
  --organization=organizations/ORGANIZATION_ID

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

  • ‫ORGANIZATION_ID: מזהה הארגון ב- Google Cloud .

בפלט מופיעה רשימה של תוספי ה-VM שנתמכים ב-VM Extension Manager, הגרסאות שלהם ורמות התמיכה בתוספים.

כדי לראות את הפרטים של תוסף VM ספציפי בארגון, מריצים את הפקודה gcloud preview compute global-vm-extension-policies extensions describe עם הדגל --organization:

gcloud preview compute global-vm-extension-policies extensions describe EXTENSION_NAME \
  --organization=organizations/ORGANIZATION_ID

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

  • ‫EXTENSION_NAME: השם של תוסף ה-VM (לדוגמה, ops-agent,‏ google-cloud-sap-extension או google-cloud-workload-extension).
  • ‫ORGANIZATION_ID: מזהה הארגון ב- Google Cloud .

REST

כדי להציג את כל התוספים ל-VM שנתמכים ב-VM Extension Manager ואת רמות התמיכה שלהם בכל האזורים בארגון, שולחים בקשת GET לשיטה organizationGlobalVmExtensionPolicies.listVmExtensions:

GET https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/global/vmExtensions

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

  • ‫ORGANIZATION_ID: מזהה הארגון ב- Google Cloud .

התשובה מפרטת את תוספי ה-VM שנתמכים ב-VM Extension Manager, את הגרסאות שלהם ואת רמות התמיכה בתוספים.

כדי לראות את הפרטים של תוסף ספציפי למכונה וירטואלית בארגון, שולחים בקשת GET ל-method‏ organizationGlobalVmExtensionPolicies.getVmExtension:

GET https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/global/vmExtensions/EXTENSION_NAME

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

  • ‫ORGANIZATION_ID: מזהה הארגון ב- Google Cloud .
  • ‫EXTENSION_NAME: השם של תוסף ה-VM (לדוגמה, ops-agent).

הצגת תוספי VM בכל האזורים בתיקייה

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

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

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

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

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

כדי לראות את התוספים של ה-VM בתיקייה, צריך את ההרשאות הבאות:

  • הצגת רשימה של תוספי VM: compute.folderVmExtensions.list
  • הצגת הפרטים של תוסף למכונה וירטואלית: compute.folderVmExtensions.get

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

כדי לראות את התוספים והגרסאות של המכונות הווירטואליות שנתמכים על ידי VM Extension Manager בכל האזורים בתיקייה, בוחרים באחת מהאפשרויות הבאות:

gcloud

כדי להציג את כל התוספים ל-VM שנתמכים ב-VM Extension Manager ואת רמות התמיכה שלהם בכל האזורים בתיקייה, מריצים את הפקודה gcloud preview compute global-vm-extension-policies extensions list עם הדגל --folder:

gcloud preview compute global-vm-extension-policies extensions list \
  --folder=folders/FOLDER_ID

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

  • ‫FOLDER_ID: מזהה התיקייה ב- Google Cloud .

בפלט מופיעה רשימה של תוספי ה-VM שנתמכים ב-VM Extension Manager, הגרסאות שלהם ורמות התמיכה בתוספים.

כדי לראות את הפרטים של תוסף VM ספציפי בתיקייה, מריצים את הפקודה gcloud preview compute global-vm-extension-policies extensions describe עם הדגל --folder:

gcloud preview compute global-vm-extension-policies extensions describe EXTENSION_NAME \
  --folder=folders/FOLDER_ID

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

  • ‫EXTENSION_NAME: השם של תוסף ה-VM (לדוגמה, ops-agent,‏ google-cloud-sap-extension או google-cloud-workload-extension).
  • ‫FOLDER_ID: מזהה התיקייה ב- Google Cloud .

REST

כדי להציג את כל התוספים של VM Extension Manager ואת רמות התמיכה שלהם בכל האזורים בתיקייה, שולחים בקשת GET לmethod folderGlobalVmExtensionPolicies.listVmExtensions:

GET https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/global/vmExtensions

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

  • ‫FOLDER_ID: מזהה התיקייה ב- Google Cloud .

התשובה מפרטת את תוספי ה-VM שנתמכים ב-VM Extension Manager, את הגרסאות שלהם ואת רמות התמיכה בתוספים.

כדי לראות את הפרטים של תוסף VM ספציפי בתיקייה, שולחים בקשת GET לשיטה folderGlobalVmExtensionPolicies.getVmExtension:

GET https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/global/vmExtensions/EXTENSION_NAME

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

  • ‫FOLDER_ID: מזהה התיקייה ב- Google Cloud .
  • ‫EXTENSION_NAME: השם של תוסף ה-VM (לדוגמה, ops-agent).

הצגת תוספי VM בכל האזורים בפרויקט

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

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

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

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

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

כדי לראות את התוספים של המכונות הווירטואליות בפרויקט, צריך את ההרשאות הבאות:

  • הצגת רשימה של תוספי VM: compute.vmExtensions.list
  • הצגת הפרטים של תוסף למכונה וירטואלית: compute.vmExtensions.get

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

כדי לראות את התוספים והגרסאות של המכונות הווירטואליות שנתמכים על ידי VM Extension Manager בכל האזורים בפרויקט, בוחרים באחת מהאפשרויות הבאות:

gcloud

כדי להציג את כל תוספי ה-VM שנתמכים ב-VM Extension Manager ואת רמות התמיכה שלהם בכל האזורים בפרויקט, מריצים את הפקודה gcloud preview compute global-vm-extension-policies extensions list:

gcloud preview compute global-vm-extension-policies extensions list \
  --project=PROJECT_ID

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

  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .

בפלט מופיעה רשימה של תוספי ה-VM שנתמכים ב-VM Extension Manager, הגרסאות שלהם ורמות התמיכה בתוספים.

כדי לראות את הפרטים של תוסף VM ספציפי בפרויקט, מריצים את הפקודה gcloud preview compute global-vm-extension-policies extensions describe:

gcloud preview compute global-vm-extension-policies extensions describe EXTENSION_NAME \
  --project=PROJECT_ID

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

  • ‫EXTENSION_NAME: השם של תוסף ה-VM (לדוגמה, ops-agent,‏ google-cloud-sap-extension או google-cloud-workload-extension).
  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .

REST

כדי להציג את כל תוספי ה-VM שנתמכים ב-VM Extension Manager ואת רמות התמיכה שלהם בכל האזורים בפרויקט, שולחים בקשת GET לmethod globalVmExtensionPolicies.listVmExtensions:

GET https://compute.googleapis.com/compute/2026-10-01-preview/projects/PROJECT_ID/global/vmExtensions

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

  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .

קטע ה-JSON הבא מציג דוגמה לתגובה שמפרטת את התוספים של VM שנתמכים על ידי VM Extension Manager ואת רמות התמיכה בתוספים:

{
  "kind": "compute#globalVmExtensionList",
  "items": [
    {
      "kind": "compute#globalVmExtension",
      "name": "ops-agent",
      "versions": [
        "2.58.0",
        "2.57.0"
      ],
      "supportLevel": "GA",
      "selfLink": "https://www.googleapis.com/compute/2026-10-01-preview/projects/my-project/global/vmExtensions/ops-agent"
    }
  ]
}

כדי לראות את הפרטים של תוסף ספציפי למכונה וירטואלית בפרויקט, שולחים בקשת GET ל-method globalVmExtensionPolicies.getVmExtension:

GET https://compute.googleapis.com/compute/2026-10-01-preview/projects/PROJECT_ID/global/vmExtensions/EXTENSION_NAME

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

  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
  • ‫EXTENSION_NAME: השם של תוסף ה-VM (לדוגמה, ops-agent).

הצגת תוספי VM באזור בארגון

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

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

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

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

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

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

  • הצגת רשימה של תוספי VM: compute.orgVmExtensions.list
  • הצגת הפרטים של תוסף למכונה וירטואלית: compute.orgVmExtensions.get

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

כדי לראות את התוספים והגרסאות של המכונות הווירטואליות שנתמכים על ידי VM Extension Manager באזור מסוים בארגון, בוחרים באחת מהאפשרויות הבאות:

gcloud

כדי להציג את כל התוספים ל-VM שנתמכים על ידי VM Extension Manager ואת רמות התמיכה שלהם באזור ספציפי בארגון, מריצים את הפקודה gcloud preview compute zone-vm-extension-policies extensions list עם הדגל --organization:

gcloud preview compute zone-vm-extension-policies extensions list \
  --organization=organizations/ORGANIZATION_ID \
  --zone=ZONE

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

  • ‫ORGANIZATION_ID: מזהה הארגון ב- Google Cloud .
  • ‫ZONE: האזור ב- Google Cloud שבו רוצים להציג את רשימת התוספים של המכונות הווירטואליות (לדוגמה, us-central1-a).

בפלט מופיעה רשימה של תוספי ה-VM שנתמכים ב-VM Extension Manager, הגרסאות שלהם ורמות התמיכה בתוספים.

כדי לראות את הפרטים של תוסף VM ספציפי באזור מסוים בארגון, מריצים את הפקודה gcloud preview compute zone-vm-extension-policies extensions describe עם הדגל --organization:

gcloud preview compute zone-vm-extension-policies extensions describe EXTENSION_NAME \
  --organization=organizations/ORGANIZATION_ID \
  --zone=ZONE

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

  • ‫EXTENSION_NAME: השם של תוסף ה-VM (לדוגמה, ops-agent).
  • ‫ORGANIZATION_ID: מזהה הארגון ב- Google Cloud .
  • ‫ZONE: האזור שבו רוצים לראות את פרטי התוסף.

REST

כדי להציג את כל התוספים ל-VM שנתמכים על ידי VM Extension Manager ואת רמות התמיכה שלהם באזור ספציפי בארגון, שולחים בקשת GET ל-method organizationZoneVmExtensionPolicies.listVmExtensions:

GET https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/zones/ZONE/vmExtensions

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

  • ‫ORGANIZATION_ID: מזהה הארגון ב- Google Cloud .
  • ‫ZONE: שם האזור (לדוגמה, us-central1-a).

התשובה מפרטת את תוספי ה-VM שנתמכים ב-VM Extension Manager, את הגרסאות שלהם ואת רמות התמיכה בתוספים.

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

GET https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/zones/ZONE/vmExtensions/EXTENSION_NAME

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

  • ‫ORGANIZATION_ID: מזהה הארגון ב- Google Cloud .
  • ‫ZONE: שם האזור.
  • ‫EXTENSION_NAME: השם של תוסף ה-VM.

הצגת תוספי VM באזור בתיקייה

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

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

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

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

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

כדי לראות את התוספים של ה-VM באזור מסוים בתיקייה, נדרשות ההרשאות הבאות:

  • הצגת רשימה של תוספי VM: compute.folderVmExtensions.list
  • הצגת הפרטים של תוסף למכונה וירטואלית: compute.folderVmExtensions.get

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

כדי לראות את התוספים והגרסאות של המכונות הווירטואליות שנתמכים על ידי VM Extension Manager באזור מסוים בתיקייה, בוחרים באחת מהאפשרויות הבאות:

gcloud

כדי להציג את כל התוספים ל-VM שנתמכים ב-VM Extension Manager ואת רמות התמיכה שלהם באזור ספציפי בתיקייה, מריצים את הפקודה gcloud preview compute zone-vm-extension-policies extensions list עם הדגל --folder:

gcloud preview compute zone-vm-extension-policies extensions list \
  --folder=folders/FOLDER_ID \
  --zone=ZONE

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

  • ‫FOLDER_ID: מזהה התיקייה ב- Google Cloud .
  • ‫ZONE: האזור ב- Google Cloud שבו רוצים להציג את רשימת התוספים של המכונות הווירטואליות (לדוגמה, us-central1-a).

בפלט מופיעה רשימה של תוספי ה-VM שנתמכים ב-VM Extension Manager, הגרסאות שלהם ורמות התמיכה בתוספים.

כדי לראות את הפרטים של הרחבת VM ספציפית באזור מסוים בתיקייה, מריצים את הפקודה gcloud preview compute zone-vm-extension-policies extensions describe עם הדגל --folder:

gcloud preview compute zone-vm-extension-policies extensions describe EXTENSION_NAME \
  --folder=folders/FOLDER_ID \
  --zone=ZONE

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

  • ‫EXTENSION_NAME: השם של תוסף ה-VM (לדוגמה, ops-agent).
  • ‫FOLDER_ID: מזהה התיקייה ב- Google Cloud .
  • ‫ZONE: האזור שבו רוצים לראות את פרטי התוסף.

REST

כדי להציג את כל תוספי ה-VM שנתמכים ב-VM Extension Manager ואת רמות התמיכה שלהם באזור ספציפי בתיקייה, שולחים בקשת GET לשיטה folderZoneVmExtensionPolicies.listVmExtensions:

GET https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/zones/ZONE/vmExtensions

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

  • ‫FOLDER_ID: מזהה התיקייה ב- Google Cloud .
  • ‫ZONE: שם האזור (לדוגמה, us-central1-a).

התשובה מפרטת את תוספי ה-VM שנתמכים ב-VM Extension Manager, את הגרסאות שלהם ואת רמות התמיכה בתוספים.

כדי לראות את הפרטים של הרחבה ספציפית של מכונה וירטואלית באזור מסוים בתיקייה, שולחים בקשת GET ל-method folderZoneVmExtensionPolicies.getVmExtension:

GET https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/zones/ZONE/vmExtensions/EXTENSION_NAME

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

  • ‫FOLDER_ID: מזהה התיקייה ב- Google Cloud .
  • ‫ZONE: שם האזור.
  • ‫EXTENSION_NAME: השם של תוסף ה-VM.

הצגת תוספי VM באזור בפרויקט

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

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

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

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

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

כדי לראות את התוספים של המכונות הווירטואליות באזור בפרויקט, צריך את ההרשאות הבאות:

  • הצגת רשימה של תוספי VM: compute.vmExtensions.list
  • הצגת הפרטים של תוסף למכונה וירטואלית: compute.vmExtensions.get

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

כדי לראות את התוספים והגרסאות של המכונות הווירטואליות שנתמכים על ידי VM Extension Manager באזור בפרויקט, בוחרים באחת מהאפשרויות הבאות:

gcloud

כדי להציג את כל תוספי ה-VM שנתמכים ב-VM Extension Manager ואת רמות התמיכה שלהם באזור ספציפי בפרויקט, מריצים את הפקודה gcloud preview compute zone-vm-extension-policies extensions list:

gcloud preview compute zone-vm-extension-policies extensions list \
  --zone=ZONE \
  --project=PROJECT_ID

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

  • ‫ZONE: האזור ב- Google Cloud שבו רוצים להציג את רשימת התוספים של המכונות הווירטואליות (לדוגמה, us-central1-a).
  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .

בפלט מופיעה רשימה של תוספי ה-VM שנתמכים ב-VM Extension Manager, הגרסאות שלהם ורמות התמיכה בתוספים.

כדי לראות את הפרטים של תוסף VM ספציפי באזור בפרויקט, מריצים את הפקודה gcloud preview compute zone-vm-extension-policies extensions describe:

gcloud preview compute zone-vm-extension-policies extensions describe EXTENSION_NAME \
  --zone=ZONE \
  --project=PROJECT_ID

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

  • ‫EXTENSION_NAME: השם של תוסף ה-VM (לדוגמה, ops-agent).
  • ‫ZONE: האזור שבו רוצים לראות את פרטי התוסף.
  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .

REST

כדי לראות את רשימת כל התוספים של המכונות הווירטואליות שנתמכים ב-VM Extension Manager ואת רמות התמיכה שלהם באזור ספציפי בפרויקט, שולחים בקשת GET לשיטה zoneVmExtensionPolicies.listVmExtensions:

GET https://compute.googleapis.com/compute/2026-10-01-preview/projects/PROJECT_ID/zones/ZONE/vmExtensions

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

  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
  • ‫ZONE: שם האזור (לדוגמה, us-central1-a).

התשובה מפרטת את תוספי ה-VM שנתמכים ב-VM Extension Manager, את הגרסאות שלהם ואת רמות התמיכה בתוספים.

כדי לראות את הפרטים של תוסף ספציפי למכונה וירטואלית באזור בפרויקט, שולחים בקשת GET לשיטה zoneVmExtensionPolicies.getVmExtension:

GET https://compute.googleapis.com/compute/2026-10-01-preview/projects/PROJECT_ID/zones/ZONE/vmExtensions/EXTENSION_NAME

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

  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
  • ‫ZONE: שם האזור.
  • ‫EXTENSION_NAME: השם של תוסף ה-VM.

הצגת המצבים של תוספי המכונות הווירטואליות במכונה

כדי להתקין תוספים למכונות וירטואליות, יוצרים מדיניות גלובלית או אזורית לתוספים ברמת הארגון, התיקייה או הפרויקט. מדיניות אחת יכולה להתקין כמה תוספים במכונה וירטואלית אחת, וכמה כללי מדיניות בהיררכיית המשאבים יכולים לחול על אותה מכונה וירטואלית. כדי לראות את סטטוס זמן הריצה של התוספים שמותקנים בכל מכונה וירטואלית בלי להתחבר למכונות ספציפיות, אתם יכולים להשתמש בשיטות list ו-get של מצב התוסף של המכונה לקריאה בלבד. השיטות האלה עוזרות לכם לראות את ההגדרות הסופיות בפועל ואת המדיניות שחלה (policyId) על כל תוסף שמותקן, או לפתור בעיות כשתוסף לא צפוי מותקן או כשתוסף נכשל במכונה.

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

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

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

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

כדי לראות את המצבים של תוספי ה-VM במכונה, צריך את ההרשאות הבאות:

  • הצגת רשימה של כל המצבים של תוספי המכונה הווירטואלית במכונה: compute.instances.listVmExtensionStates
  • כדי לקבל את המצב של תוסף ספציפי למכונה וירטואלית במכונה: compute.instances.getVmExtensionState

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

הצגת רשימה של כל המצבים של תוספי המכונות הווירטואליות במכונה

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

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

gcloud

כדי להציג רשימה של כל התוספים המותקנים של ה-VM ולראות את המצבים הנוכחיים שלהם במכונה, מריצים את הפקודה gcloud beta compute instances list-vm-extension-states:

gcloud beta compute instances list-vm-extension-states INSTANCE_NAME \
    --zone=ZONE \
    --project=PROJECT_ID

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

  • ‫INSTANCE_NAME: השם של המכונה הווירטואלית.
  • ‫ZONE: האזור שבו נמצאת המכונה (לדוגמה, us-central1-a).
  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .

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

EXTENSION_NAME  ENFORCEMENT_STATE  HEALTH_STATUS
ops-agent       INSTALLED          RUNNING

REST

כדי להציג את כל התוספים המותקנים של המכונה הווירטואלית ואת המצבים הנוכחיים שלהם במכונה, שולחים בקשת GET לשיטה instances.listVmExtensionStates:

GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/vmExtensionStates

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

  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
  • ‫ZONE: האזור שבו נמצאת המכונה.
  • ‫INSTANCE_NAME: השם או המזהה של המכונה הווירטואלית.

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

{
  "kind": "compute#vmExtensionStatesList",
  "items": [
    {
      "name": "ops-agent",
      "version": "2.58.0",
      "healthStatus": "RUNNING",
      "enforcementState": "INSTALLED",
      "healthMsg": "Plugin is running ok",
      "policyId": "projects/my-project/zones/us-central1-a/vmExtensionPolicies/prod-ops-policy"
    }
  ]
}

הצגת המצב של תוסף ספציפי למכונה וירטואלית במכונה

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

כדי לראות את המצב בפועל ואת המדיניות שחלה על תוסף VM ספציפי במכונה, בוחרים באחת מהאפשרויות הבאות:

gcloud

כדי לאחזר את המצב בפועל, הגרסה הפעילה והמדיניות השולטת של תוסף VM ספציפי במכונה, מריצים את הפקודה gcloud beta compute instances get-vm-extension-state:

gcloud beta compute instances get-vm-extension-state INSTANCE_NAME \
    --extension-name=EXTENSION_NAME \
    --zone=ZONE \
    --project=PROJECT_ID

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

  • ‫INSTANCE_NAME: השם של המכונה הווירטואלית.
  • ‫EXTENSION_NAME: שם התוסף שרוצים לבדוק (לדוגמה, ops-agent).
  • ‫ZONE: האזור שבו נמצאת המכונה.
  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .

REST

כדי לאחזר את המצב בפועל, הגרסה הפעילה והמדיניות שחלה על תוסף ספציפי של מכונה וירטואלית, שולחים בקשת GET ל-method instances.getVmExtensionState:

GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/vmExtensionStates/EXTENSION_NAME

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

  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
  • ‫ZONE: האזור שבו נמצאת המכונה.
  • ‫INSTANCE_NAME: השם או המזהה של המכונה הווירטואלית.
  • ‫EXTENSION_NAME: השם של תוסף ה-VM (לדוגמה, ops-agent).

קטע הקוד הבא ב-JSON מציג דוגמה לתגובה על מצב של תוסף VM יחיד במכונה:

{
  "name": "ops-agent",
  "version": "2.58.0",
  "healthStatus": "RUNNING",
  "enforcementState": "INSTALLED",
  "enforcementMsg": "",
  "healthMsg": "Plugin is running ok",
  "policyId": "projects/my-project/zones/us-central1-a/vmExtensionPolicies/prod-ops-policy"
}

הסבר על שדות הסטטוס של תוספי VM

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

בטבלה הבאה מתוארים השדות שמוחזרים על ידי משאב VmExtensionState:

שדה תיאור
name המזהה של תוסף ה-VM (לדוגמה, ops-agent).
version הגרסה הפעילה של התוסף שמותקן במכונה הווירטואלית.
policyId המזהה של מדיניות התוספים של ה-VM שנמצאת בתוקף, שאוכפת את התוסף הזה במכונה. אם כמה כללי מדיניות מטרגטים את ה-VM, השדה הזה מציין את המדיניות שנבחרה אחרי פתרון העדיפות.
enforcementState המצב הנוכחי של מחזור החיים של תהליך אכיפת המדיניות לגבי התוסף. הערכים האפשריים כוללים:
  • ‫ENFORCEMENT_STATE_UNSPECIFIED: מצב האכיפה לא צוין.
  • ‫INSTALLING: הסוכן האורח מתקין את התוסף.
  • ‫INSTALLED: התוסף מותקן במכונה.
  • ‫INSTALL_FAILED: ההתקנה נכשלה ואין גרסה יציבה קודמת שאפשר לחזור אליה.
  • ‫ROLLING_BACK: סוכן האורח מחזיר את התוסף לגרסה היציבה האחרונה שתועדה.
  • ‫ROLLED_BACK: התוסף חזר לגרסה היציבה האחרונה.
  • ‫ROLLBACK_FAILED: הניסיון לחזור לגרסה קודמת נכשל.
  • ‫INCOMPATIBLE: אף אחת מהגרסאות הזמינות של התוסף לא תואמת למערכת ההפעלה או לארכיטקטורה של המכונה הווירטואלית.
  • ‫REMOVING: הסוכן האורח מסיר את התוסף מהמכונה.
  • ‫SERVICE_DISABLED: ה-API של השירות שנדרש לתוסף הזה מושבת בפרויקט.
  • ‫APPLYING_CONFIG: סוכן האורח מחיל הגדרה חדשה על התוסף, מה שעשוי לכלול הפעלה מחדש של הפלאגין.
enforcementMsg הודעת סטטוס לאבחון שהסוכן האורח מחזיר אם התוסף נכשל באכיפה או נתקל בשגיאת התקנה.
healthStatus סטטוס התקינות בזמן הריצה של פלאגין התוסף שנאכף. אם התוסף עדיין לא נאכף, הערך הזה לא מצוין. הערכים האפשריים כוללים:
  • ‫HEALTH_STATUS_UNSPECIFIED: סטטוס התקינות לא צוין.
  • ‫STARTING: תהליך ההרחבה מתחיל.
  • ‫RUNNING: תהליך התוסף פועל כרגיל.
  • ‫STOPPING: תהליך התוסף מפסיק.
  • ‫STOPPED: תהליך התוסף נעצר.
  • ‫CRASHED: תהליך התוסף התחיל, אבל הפסיק לפעול באופן בלתי צפוי.
healthMsg הודעת אבחון שהתוסף מדווח על סטטוס התקינות שלו (לדוגמה, Plugin is running ok).

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