הצגת המפנים למכונות של Compute Engine

כדי לראות את הקשרים בין מכונות Compute Engine לבין משאבים אחרים של Compute Engine, צריך להשתמש ב-CLI של gcloud או ב-REST.

כשמציגים את רשימת הגורמים המפנים למכונות, Compute Engine מחזיר רשימה של הפניות שמתארות:

  • משאב המקור: המשאב שמפנה למשאב היעד
  • משאב היעד: המשאב הרלוונטי
  • סוג ההפניה: הקשר בין שני המשאבים

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

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

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

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

    gcloud

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

      gcloud init
  • הגדרת אזור ותחום כברירת מחדל.

    • REST

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

      התקינו את ה-CLI של Google Cloud ואז היכנסו ל-CLI של gcloud באמצעות הזהות המאוחדת שלכם.

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

מגבלות

  • אפשר להציג קשרים רק בין מכונות לבין קבוצות של מכונות. יש תמיכה גם בקבוצות של מכונות מנוהלות וגם בקבוצות של מכונות לא מנוהלות.

הוספת מקור הפניה יחיד לרשימה

מפנה הוא משאב שמפנה למשאב אחר. במכונות, מפנה נפוץ הוא קבוצת מכונות.

לדוגמה, נניח שיש לכם מכונה בשם example-ig-a1 באזור us-central1-a. המכונה היא חלק מקבוצת מכונות בשם example-ig באותו אזור, כמו שמוצג בתרשים הבא:

מכונה היא חלק מקבוצת מכונות באותו אזור.

כדי לראות את הקשר הזה, משתמשים ב-CLI של gcloud או ב-REST:

gcloud

משתמשים בפקודה gcloud compute instances list-referrers:

gcloud compute instances list-referrers INSTANCE_NAME \
    --zone=ZONE

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

  • ‫INSTANCE_NAME: השם של המכונה שרוצים להציג את המפנים שלה.
  • ‫ZONE: האזור שבו נמצאת המכונה.

לדוגמה, כדי להציג רשימה של מפנים למכונה example-ig-a1 באזור us-central1-a, מריצים את הפקודה הבאה:

gcloud compute instances list-referrers example-ig-a1 \
    --zone=us-central1-a

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

REFERRER                                                                                          REFERENCE_TYPE  TARGET
https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroups/example-ig  MEMBER_OF       https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/example-ig-a1

REST

שולחים בקשת GET ל-method‏ instances.listReferrers:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/referrers

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

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

לדוגמה, כדי להציג רשימה של הגורמים המפנים למכונה example-ig-a1 באזור us-central1-a, שולחים את בקשת ה-HTTP הבאה:

GET https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/example-ig-a1/referrers

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

{
  "items": [
    {
      "target": "https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/example-ig-a1",
      "referenceType": "MEMBER_OF",
      "referrer": "https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroups/example-ig"
    }
  ]
}

במקרה הזה, משאב היעד הוא example-ig-a1, שהוא MEMBER_OF של המשאב המפנה, קבוצת המכונות example-ig.

הצגת רשימה של כמה מקורות הפניה

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

אם מכונה היא חברה בשתי קבוצות של מכונות, התשובה תכיל את שתי הקבוצות.

לדוגמה, נניח שהמכונה בשם example-instance-a2 באזור us-central1-a שייכת לשתי קבוצות של מכונות, example-ig ו-example-ig-2:

gcloud

משתמשים בפקודה gcloud compute instances list-referrers:

gcloud compute instances list-referrers INSTANCE_NAME \
    --zone=ZONE

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

  • ‫INSTANCE_NAME: השם של המכונה שרוצים להציג את המפנים שלה.
  • ‫ZONE: האזור שבו נמצאת המכונה.

לדוגמה, כדי להציג רשימה של מפנים למכונה example-instance-a2 באזור us-central1-a, מריצים את הפקודה הבאה:

gcloud compute instances list-referrers example-instance-a2 \
    --zone=us-central1-a

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

REFERRER                                                                                            REFERENCE_TYPE  TARGET
https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroups/example-ig    MEMBER_OF       https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/example-instance-a2
https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroups/example-ig-2  MEMBER_OF       https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/example-instance-a2

REST

שולחים בקשת GET ל-method‏ instances.listReferrers:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/referrers

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

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

לדוגמה, כדי להציג רשימה של הגורמים המפנים למכונה example-instance-a2 באזור us-central1-a, שולחים את בקשת ה-HTTP הבאה:

GET https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/example-instance-a2/referrers

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

{
  "items": [
    {
      "target": "https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/example-instance-a2",
      "referenceType": "MEMBER_OF",
      "referrer": "https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroups/example-ig"
    },
    {
      "target": "https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/example-instance-a2",
      "referenceType": "MEMBER_OF",
      "referrer": "https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroups/example-ig-2"
    }
  ]
}

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

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

באזור us-central1, המכונה new-instance-a3 בתחום us-central1-a היא חלק מקבוצת המכונות האזורית example-rmig.

כדי לראות את המפנים שמטרגטים את המכונה הזו, משתמשים ב-CLI של gcloud או ב-REST:

gcloud

משתמשים בפקודה gcloud compute instances list-referrers:

gcloud compute instances list-referrers INSTANCE_NAME \
    --zone=ZONE

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

  • ‫INSTANCE_NAME: השם של המכונה שרוצים להציג את המפנים שלה.
  • ‫ZONE: האזור שבו נמצאת המכונה.

לדוגמה, כדי להציג רשימה של מפנים למכונה new-instance-a3 באזור us-central1-a, מריצים את הפקודה הבאה:

gcloud compute instances list-referrers new-instance-a3 \
    --zone=us-central1-a

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

REFERRER                                                                                          REFERENCE_TYPE  TARGET
https://www.googleapis.com/compute/v1/projects/myproject/regions/us-central1/instanceGroups/example-rmig  MEMBER_OF       https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/new-instance-a3

REST

שולחים בקשת GET ל-method‏ instances.listReferrers:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/referrers

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

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

לדוגמה, כדי להציג רשימה של הגורמים המפנים למכונה new-instance-a3 באזור us-central1-a, שולחים את בקשת ה-HTTP הבאה:

GET https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/new-instance-a3/referrers

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

{
  "items": [
    {
      "target": "https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/new-instance-a3",
      "referenceType": "MEMBER_OF",
      "referrer": "https://compute.googleapis.com/compute/v1/projects/myproject/regions/us-central1/instanceGroups/example-rmig"
    }
  ]
}

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

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

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

gcloud

משתמשים בפקודה gcloud compute instances list-referrers עם התו הכללי לחיפוש -:

gcloud compute instances list-referrers - \
    --zone=ZONE

מחליפים את ZONE באזור שבו רוצים להציג את המפנים של כל המכונות.

לדוגמה, כדי להציג רשימה של מפנים לכל המכונות באזור us-central1-a, מריצים את הפקודה הבאה:

gcloud compute instances list-referrers - \
    --zone=us-central1-a

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

REFERRER                                                                                            REFERENCE_TYPE  TARGET
https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroups/example-ig    MEMBER_OF       https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/example-ig-a1
https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroups/example-ig    MEMBER_OF       https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/example-ig-a2
https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroups/example-ig-2  MEMBER_OF       https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/example-ig-a2
https://www.googleapis.com/compute/v1/projects/myproject/regions/us-central1/instanceGroups/example-rmig  MEMBER_OF       https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/new-instance-a3

REST

שולחים בקשת GET ל-method‏ instances.listReferrers עם התו הכללי לחיפוש -:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/-/referrers

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

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

לדוגמה, כדי להציג רשימה של מפנים לכל המכונות באזור us-central1-a, שולחים את בקשת ה-HTTP הבאה:

GET https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/-/referrers

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

{
  "items": [
    {
      "target": "https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/example-ig-a1",
      "referenceType": "MEMBER_OF",
      "referrer": "https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroups/example-ig"
    },
    {
      "target": "https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/example-ig-a2",
      "referenceType": "MEMBER_OF",
      "referrer": "https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroups/example-ig"
    },
    {
      "target": "https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/example-ig-a2",
      "referenceType": "MEMBER_OF",
      "referrer": "https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroups/example-ig-2"
    },
    {
      "target": "https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/new-instance-a3",
      "referenceType": "MEMBER_OF",
      "referrer": "https://compute.googleapis.com/compute/v1/projects/myproject/regions/us-central1/instanceGroups/example-rmig"
    }
  ]
}

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