רושם אשכול משתמשים קיים ב-VMware ומאגרי צמתים שלו ב-Anthos On-Prem API בפרויקט ובמיקום נתונים. תהליך ההרשמה יגרום לכך שאשכול קיים יהפוך לאשכול שמנוהל על ידי Anthos On-Prem API. ייווצרו משאבי GCP תואמים, וכל השינויים העתידיים באשכול או במאגרי הצמתים שלו יבוצעו דרך ה-API.
בקשת HTTP
POST https://gkeonprem.googleapis.com/v1/{parent=projects/*/locations/*}/vmwareClusters:enroll
כתובת ה-URL כתובה בתחביר של gRPC Transcoding.
פרמטרים של נתיב
| פרמטרים | |
|---|---|
parent |
חובה. הפרויקט והמיקום שבהם האשכול רשום. פורמט: projects/{project}/locations/{location} |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
| ייצוג ב-JSON |
|---|
{ "vmwareClusterId": string, "localName": string, "adminClusterMembership": string, "validateOnly": boolean } |
| שדות | |
|---|---|
vmwareClusterId |
מזהה OnePlatform שסופק על ידי המשתמש ומשמש כחלק משם המשאב. השם הזה צריך להיות ייחודי בין כל אשכולות GKE on-prem בפרויקט ובמיקום, ואם האשכול כבר קיים, תוחזר שגיאה 409. (https://tools.ietf.org/html/rfc1123) format. |
localName |
זה שינוי אופציונלי. שם האובייקט של המשאב המותאם אישית VMware OnPremUserCluster באוסף האדמין המשויך. השדה הזה משמש לתמיכה בשמות משאבים שמתנגשים כשרושמים אשכולות קיימים ל-API. אם לא מציינים ערך בשדה הזה, הוא יקבל את הערך של vmwareClusterId. אחרת, הוא צריך להיות זהה לשם האובייקט של המשאב המותאם אישית OnPremUserCluster של VMware. אי אפשר לשנות אותו מחוץ לפעולת ההרשמה. |
adminClusterMembership |
חובה. אשכול האדמין שאליו משתייך אשכול המשתמשים של VMware. זהו השם המלא של המשאב של החברות בצי של אשכול האדמין. יכול להיות שבעתיד נאפשר הפניות לסוגים אחרים של משאבים, אם אשכולות אדמין יוגדרו כמשאבים משלהם. |
validateOnly |
אימות הבקשה בלי לבצע עדכונים בפועל. |
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע של Operation.
היקפי הרשאות
נדרש היקף ההרשאות הבא של OAuth:
https://www.googleapis.com/auth/cloud-platform
ניתן למצוא מידע נוסף כאן: Authentication Overview.