Method: projects.locations.dnsBindPermission.grant

ההרשאה מעניקה לישות המורשית(משתמש או חשבון שירות) שהלקוח סיפק את ההרשאה לקשור את תחום ה-DNS שלה ל-VPC של האינטראנט שמשויך לפרויקט. ‫DnsBindPermission הוא משאב גלובלי, והמיקום יכול להיות רק גלובלי.

בקשת HTTP

POST https://vmwareengine.googleapis.com/v1/{name=projects/*/locations/*/dnsBindPermission}:grant

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

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

פרמטרים
name

string

חובה. שם המשאב שבו מאוחסנים המשתמשים או חשבונות השירות שיש להם הרשאה להתחבר ל-VPC המתאים של האינטראנט בפרויקט הצרכן. ‫DnsBindPermission הוא משאב גלובלי. שמות משאבים הם URI ללא סכימה שפועלים לפי המוסכמות שמופיעות בכתובת https://cloud.google.com/apis/design/resource_names. לדוגמה: projects/my-project/locations/global/dnsBindPermission

כדי לתת הרשאה, צריך את הרשאת IAM הבאה במשאב שצוין name:

  • vmwareengine.dnsBindPermission.grant

גוף הבקשה

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

ייצוג JSON 
{
  "principal": {
    object (Principal)
  },
  "requestId": string
}
שדות
principal

object (Principal)

חובה. חשבון המשתמש או חשבון השירות שסופק על ידי הצרכן, שצריך לקבל הרשאה להתחבר ל-VPC של האינטראנט שמתאים לפרויקט הצרכן. החשבון הראשי יכול להיות משתמש או חשבון שירות. לדוגמה, כדי לציין את המשתמש user@example.com, משתמשים ב-"principal": {"user": "user@example.com"}, וכדי לציין את חשבון השירות service-account@gserviceaccount.com, משתמשים ב-"principal": {"serviceAccount": "service-account@gserviceaccount.com"}.
requestId

string

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

לדוגמה, נניח ששלחתם בקשה ראשונית והזמן הקצוב לתגובה לבקשה פג. אם תשלחו שוב את הבקשה עם אותו מזהה בקשה, השרת יוכל לבדוק אם הפעולה המקורית עם אותו מזהה בקשה התקבלה, ואם כן, הוא יתעלם מהבקשה השנייה. כך נמנע מצב שבו לקוחות יוצרים בטעות התחייבויות כפולות.

מזהה הבקשה חייב להיות מזהה ייחודי אוניברסלי (UUID) תקין, למעט מזהה UUID אפס שלא נתמך (00000000-0000-0000-0000-000000000000).

גוף התשובה

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

היקפי הרשאות

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

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

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