Method: projects.locations.vmwareClusters.enroll

Registra un cluster utente VMware esistente e i relativi pool di nodi nell'API Anthos On-Prem in un determinato progetto e in una determinata località. Tramite la registrazione, un cluster esistente diventerà gestito dall'API Anthos On-Prem. Verranno create le risorse Google Cloud corrispondenti e tutte le modifiche future al cluster e/o ai relativi node pool dovrebbero essere eseguite tramite l'API.

Richiesta HTTP

POST https://gkeonprem.googleapis.com/v1/{parent=projects/*/locations/*}/vmwareClusters:enroll

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Obbligatorio. Il progetto principale e la località 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 
{
  "vmwareClusterId": string,
  "localName": string,
  "adminClusterMembership": string,
  "validateOnly": boolean
}
Campi
vmwareClusterId

string

Identificatore OnePlatform fornito dall'utente che viene utilizzato come parte del nome della risorsa. Deve essere univoco tra tutti i cluster GKE on-premise all'interno di un progetto e di una località e restituirà un codice 409 se il cluster esiste già.

(https://tools.ietf.org/html/rfc1123).
localName

string

Facoltativo. Il nome dell'oggetto della risorsa personalizzata VMware OnPremUserCluster nel cluster di amministrazione associato. Questo campo viene utilizzato per supportare i nomi delle risorse in conflitto durante la registrazione di cluster esistenti nell'API. Se non viene fornito, questo campo verrà risolto in vmwareClusterId. In caso contrario, deve corrispondere al nome dell'oggetto della risorsa personalizzata VMware OnPremUserCluster. Non è modificabile al di fuori dell'operazione di registrazione.
adminClusterMembership

string

Obbligatorio. Il cluster di amministrazione a cui appartiene questo cluster utente VMware. Si tratta del 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 amministratori vengono modellati come risorse proprie.
validateOnly

boolean

Convalida la richiesta senza eseguire effettivamente alcun aggiornamento.

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 sezione Authentication Overview.