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