- Richiesta HTTP
- Parametri del percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
Registra un cluster utente bare metal esistente e i relativi pool di nodi nell'API Anthos On-Prem all'interno di un determinato progetto e una determinata località. Tramite la registrazione, un cluster esistente verrà gestito dall'API Anthos On-Prem. Verranno create le risorse GCP corrispondenti e tutte le modifiche future al cluster e/o ai relativi node pool dovranno essere eseguite tramite l'API.
Richiesta HTTP
POST https://gkeonprem.googleapis.com/v1/{parent=projects/*/locations/*}/bareMetalClusters:enroll
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
parent |
Obbligatorio. Il progetto e la località padre in cui è registrato il cluster. Formato: "projects/{project}/locations/{location}" |
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{ "bareMetalClusterId": string, "localName": string, "adminClusterMembership": string, "localNamespace": string } |
Campi | |
---|---|
bareMetalClusterId |
Identificatore OnePlatform fornito dall'utente utilizzato come parte del nome della risorsa. Deve essere univoco tra tutti i cluster bare metal all'interno di un progetto e di una località e restituirà un errore 409 se il cluster esiste già. |
localName |
Facoltativo. Il nome dell'oggetto della risorsa personalizzata del cluster bare metal nel cluster di amministrazione associato. Questo campo viene utilizzato per supportare nomi di risorse in conflitto durante la registrazione di cluster esistenti all'API. Se non viene fornito, questo campo verrà risolto in bareMetalClusterId. In caso contrario, deve corrispondere al nome dell'oggetto della risorsa personalizzata del cluster bare metal. Non è modificabile al di fuori / oltre l'operazione di registrazione. |
adminClusterMembership |
Obbligatorio. Il cluster di amministrazione a cui appartiene questo cluster utente Bare Metal. Questo è il nome completo della risorsa dell'appartenenza al parco risorse del cluster di amministrazione. In futuro, i riferimenti ad altri tipi di risorse potrebbero essere consentiti se i cluster di amministrazione vengono modellati come risorse proprie. |
localNamespace |
Facoltativo. Lo spazio dei nomi del cluster. |
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation
.
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/cloud-platform
Per ulteriori informazioni, consulta la Authentication Overview.