- בקשת HTTP
- פרמטרים של נתיב
- פרמטרים של שאילתות
- גוף הבקשה
- גוף התשובה
- היקפי הרשאות
- הרשאות IAM
- GetPolicyOptions
הצגת מדיניות בקרת הגישה של משאב. הפונקציה מחזירה מדיניות ריקה אם המשאב קיים ואין לו מדיניות מוגדרת.
בקשת HTTP
GET https://cloudaicompanion.googleapis.com/v1/{resource=projects/*/locations/*/codeRepositoryIndexes/*/repositoryGroups/*}:getIamPolicy
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
resource |
חובה: המשאב שעבורו מבקשים את המדיניות. הערך המתאים לשדה הזה מפורט במאמר שמות משאבים. |
פרמטרים של שאילתה
פרמטרים | |
---|---|
options |
אופציונלי: אובייקט |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
אם הפעולה מצליחה, גוף התגובה מכיל מופע של Policy
.
היקפי הרשאה
נדרשת הרשאת OAuth ברמה הבאה:
https://www.googleapis.com/auth/cloud-platform
מידע נוסף זמין בAuthentication Overview.
הרשאות IAM
נדרשת אחת מההרשאות הבאות של IAM במשאב resource
, בהתאם לסוג המשאב:
cloudaicompanion.repositoryGroups.getIamPolicy
cloudaicompanion.topics.getIamPolicy
למידע נוסף, עיינו במסמכי העזרה של IAM.
GetPolicyOptions
האובייקט הזה מכיל את ההגדרות שסופקו ל-repositoryGroups.getIamPolicy.
ייצוג ב-JSON |
---|
{ "requestedPolicyVersion": integer } |
שדות | |
---|---|
requestedPolicyVersion |
זה שינוי אופציונלי. גרסת המדיניות המקסימלית שתשמש לפורמט המדיניות. הערכים החוקיים הם 0, 1 ו-3. בקשות עם ערך לא חוקי נדחות. בבקשות למדיניות עם קישורי תפקידים מותנים, צריך לציין את הגרסה 3. במדיניות ללא קישורי תפקידים מותנים, אפשר לציין כל ערך חוקי או להשאיר את השדה ללא הגדרה. יכול להיות שהמדיניות בתגובה תשתמש בגרסה של המדיניות שציינתם, או בגרסה ישנה יותר של המדיניות. לדוגמה, אם מציינים גרסה 3 אבל למדיניות אין קישורי תפקידים מותנים, התשובה תשתמש בגרסה 1. במסמכי העזרה של IAM מוסבר אילו משאבים תומכים בתנאים במדיניות IAM שלהם. |