Method: projects.locations.instances.testIamPermissions

הפונקציה מחזירה את ההרשאות שיש למבצע הקריאה במשאב שצוין. אם המשאב לא קיים, הפונקציה תחזיר קבוצה ריקה של הרשאות, ולא שגיאה מסוג NOT_FOUND.

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

בקשת HTTP

POST https://notebooks.googleapis.com/v2/{resource}:testIamPermissions

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

פרמטרים
resource

string

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

גוף הבקשה

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

ייצוג ב-JSON 
{
  "permissions": [
    string
  ]
}
שדות
permissions[]

string

קבוצת ההרשאות לבדיקה עבור resource. אסור להשתמש בהרשאות עם תווים כלליים לחיפוש (כמו * או storage.*). מידע נוסף מופיע במאמר סקירה כללית על IAM.

גוף התשובה

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

היקפי הרשאות

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

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

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