Method: projects.locations.bareMetalClusters.enroll

Registra un cluster utente bare metal esistente e i relativi pool di nodi nell'API Anthos On-Prem in un determinato progetto e 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/*}/bareMetalClusters: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 
{
  "bareMetalClusterId": string,
  "localName": string,
  "adminClusterMembership": string
}
Campi
bareMetalClusterId

string

Identificatore OnePlatform fornito dall'utente che viene 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 codice 409 se il cluster esiste già.

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

string

Facoltativo. Il nome dell'oggetto della risorsa personalizzata del cluster bare metal 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 bareMetalClusterId. In caso contrario, deve corrispondere al nome dell'oggetto della risorsa personalizzata del cluster bare metal. Non è modificabile al di fuori dell'operazione di registrazione.
adminClusterMembership

string

Obbligatorio. Il cluster di amministrazione a cui appartiene questo cluster utente bare metal. 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.

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.