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

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

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

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

  • אם עדיין לא עשיתם את זה, תצטרכו להגדיר אימות. אימות הוא תהליך שבו מאמתים את הזהות שלכם כדי לקבל גישה לממשקי API ולשירותים של Cloud de Confiance by S3NS . כדי להריץ קוד או דוגמאות מסביבת פיתוח מקומית, אפשר לבצע אימות ל-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 במסמכי האימות של Cloud de Confiance .

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

כדי לקבל את ההרשאות שנדרשות להצגת מדיניות מיקום, צריך לבקש מהאדמין להקצות לכם ב-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"
    }
    

מה השלב הבא?