הצגת מקורות תנועה למכונות וירטואליות

כדי לראות את הקשרים בין מכונות וירטואליות לבין משאבים אחרים ב-Compute Engine, משתמשים ב-listReferrers API בארכיטקטורת REST.

כשמשתמשים ב-REST, ‏ Compute Engine מחזיר רשימה של הפניות שמתארות:

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

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

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

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

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

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

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

מגבלות

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

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

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

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

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

כדי לראות את הקשר הזה, מפעילים את ה-method‏ listReferrers ב-example-ig-a1 באמצעות בקשת ה-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
  }
]

במקרה הזה, target הוא example-ig-a1, שהוא MEMBER_OF הקבוצה referrer, example-ig instance.

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

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

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

לדוגמה, התגובה הבאה מציינת שהמופע שנקרא example-instance-a2 שייך לשתי קבוצות של מופעים, example-ig ו-example-ig-2:

"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
  }
]

הפניות חוצות-היקף

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

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

מבצעים קריאה ל-method‏ listReferrers כדי לטרגט את המופע הזה באמצעות בקשת ה-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
  }
]

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

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

באמצעות התו הכללי לחיפוש (-), אפשר לבקש רשימה של כל מקורות התנועה לכל המופעים של מכונות וירטואליות באזור מסוים. אפשר לשלוח את הבקשה באמצעות בקשת 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
  }
]

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