Method: projects.locations.gateways.setIamPolicy

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

יכול להחזיר את השגיאות NOT_FOUND,‏ INVALID_ARGUMENT ו-PERMISSION_DENIED.

בקשת HTTP

POST https://networkservices.googleapis.com/v1/{resource=projects/*/locations/*/gateways/*}:setIamPolicy

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של הנתיב

פרמטרים
resource

string

חובה: המשאב שעבורו מצוינת המדיניות. בקטע שמות של משאבים מוסבר מה הערך המתאים לשדה הזה.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "policy": {
    object (Policy)
  },
  "updateMask": string
}
שדות
policy

object (Policy)

חובה: המדיניות המלאה שתחול על resource. גודל המדיניות מוגבל לכמה עשרות קילובייט. מדיניות ריקה היא מדיניות תקינה, אבל יכול להיות ששירותים מסוימים של Google Cloud (כמו פרויקטים) ידחו אותה.
updateMask

string (FieldMask format)

אופציונלי: FieldMask שמציין אילו שדות במדיניות צריך לשנות. רק השדות במסכה ישתנו. אם לא מציינים מסכה, המערכת משתמשת במסכת ברירת המחדל הבאה:

paths: "bindings, etag"

זוהי רשימה מופרדת בפסיקים של שמות שדות שמוגדרים במלואם. דוגמה: "user.displayName,photo"

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע של Policy.

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/cloud-platform

ניתן למצוא מידע נוסף כאן: Authentication Overview.