צפייה במדיניות בנושא מיקומי מודעות

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

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

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

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

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

    gcloud

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

      gcloud init

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

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

    • REST

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

      התקינו את ה-CLI של Google Cloud.

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

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

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

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

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

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

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

  • כדי לראות את רשימת כללי מדיניות המיקום: compute.resourcePolicies.list בפרויקט
  • כדי לראות את הפרטים של מדיניות בנושא מיקומי מודעות: compute.resourcePolicies.get בפרויקט

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

עיון במדיניות בנושא מיקומי מודעות

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

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

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

gcloud

כדי לראות רשימה של מדיניות מיקום, משתמשים בפקודה gcloud compute resource-policies list עם הדגל --filter שמוגדר לערך groupPlacementPolicy:*.

gcloud compute resource-policies list \
    --filter="groupPlacementPolicy:*"

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

NAME: example-compact-policy
DESCRIPTION:
REGION: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1
CREATION_TIMESTAMP: 2024-05-09T02:09:24.588-07:00

NAME: example-spread-policy
DESCRIPTION:
REGION: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1
CREATION_TIMESTAMP: 2024-05-09T02:08:13.404-07:00

למידע נוסף על שימוש בביטויי סינון כדי לצמצם את הרשימה של משאבי Compute Engine, אפשר לעיין בפקודה gcloud topic filters.

REST

כדי לראות רשימה של כללי מדיניות לגבי מיקומי מודעות שנמצאים באזור מסוים, שולחים בקשת GET אל ה-method‏ resourcePolicies.list. בכתובת ה-URL של הבקשה, מוסיפים את הפרמטר filter של השאילתה ומגדירים אותו לערך groupPlacementPolicy%3A*.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies?filter=groupPlacementPolicy%3A*

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

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

  • ‫REGION: האזור שבו נמצאות מדיניות מיקום אחת או יותר.

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

{
  "kind": "compute#resourcePolicyList",
  "id": "projects/example-project/regions/us-central1/resourcePolicies",
  "items": [
    {
      "kind": "compute#resourcePolicy",
      "id": "5587673659722509355",
      "creationTimestamp": "2024-05-09T02:09:24.588-07:00",
      "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-compact-policy",
      "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
      "name": "example-compact-policy",
      "groupPlacementPolicy": {
        "collocation": "COLLOCATED"
      },
      "status": "READY"
    },
    {
      "kind": "compute#resourcePolicy",
      "id": "5970772604948130963",
      "creationTimestamp": "2024-05-09T02:08:13.404-07:00",
      "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-spread-policy",
      "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
      "name": "example-spread-policy",
      "groupPlacementPolicy": {
        "availabilityDomainCount": 5
      },
      "status": "READY"
    }
  ],
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies",
  "etag": "-L7XCupTQ5V9__TOJ8G5RDcR2cY=/g_xt0udkOM_tU7jSL0z9I2Sivis="
}

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

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

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

gcloud

כדי לראות את הפרטים של מדיניות מיקום, משתמשים בפקודה gcloud compute resource-policies describe.

gcloud compute resource-policies describe POLICY_NAME \
    --region=REGION

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

  • ‫POLICY_NAME: השם של מדיניות מיקום קיימת.

  • ‫REGION: האזור שבו נמצאת מדיניות המיקום.

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

  • אם אתם צופים בפרטים של מדיניות למיקום קומפקטי:

    creationTimestamp: '2024-05-09T02:09:24.588-07:00'
groupPlacementPolicy:
  collocation: COLLOCATED
id: '5587673659722509355'
kind: compute#resourcePolicy
name: example-compact-policy
region: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1
selfLink: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-compact-policy
status: READY

  • אם אתם צופים בפרטים של מדיניות למיקום מרווח:

    creationTimestamp: '2024-05-09T02:08:13.404-07:00'
groupPlacementPolicy:
  availabilityDomainCount: 5
id: '5970772604948130963'
kind: compute#resourcePolicy
name: example-spread-policy
region: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1
selfLink: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-spread-policy
status: READY

REST

כדי לראות את הפרטים של מדיניות בנושא מיקומי מודעות, צריך לשלוח בקשת GET ל-method‏ resourcePolicies.get.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME

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

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

  • ‫REGION: האזור שבו נמצאת מדיניות המיקום.

  • ‫POLICY_NAME: השם של מדיניות מיקום קיימת.

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

  • אם אתם צופים בפרטים של מדיניות למיקום קומפקטי:

    {
  "kind": "compute#resourcePolicy",
  "id": "5587673659722509355",
  "creationTimestamp": "2024-05-09T02:09:24.588-07:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-compact-policy",
  "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
  "name": "example-compact-policy",
  "groupPlacementPolicy": {
    "collocation": "COLLOCATED"
  },
  "status": "READY"
}

  • אם אתם צופים בפרטים של מדיניות למיקום מרווח:

    {
  "kind": "compute#resourcePolicy",
  "id": "5970772604948130963",
  "creationTimestamp": "2024-05-09T02:08:13.404-07:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-spread-policy",
  "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
  "name": "example-spread-policy",
  "groupPlacementPolicy": {
    "availabilityDomainCount": 5
  },
  "status": "READY"
}

מה השלב הבא?