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