Method: projects.locations.vmwareClusters.enroll

Enregistre un cluster utilisateur VMware existant et ses pools de nœuds dans l'API Anthos On-Prem dans un projet et un emplacement donnés. Lors de l'enregistrement, un cluster existant devient géré par l'API Anthos sur site. Les ressources GCP correspondantes seront créées, et toutes les futures modifications apportées au cluster et/ou à ses pools de nœuds devront être effectuées via l'API.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Parent du projet et de l'emplacement dans lesquels le cluster est inscrit. Format: "projects/{project}/locations/{location}"

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "vmwareClusterId": string,
  "localName": string,
  "adminClusterMembership": string,
  "validateOnly": boolean
}
Champs
vmwareClusterId

string

Identifiant OnePlatform fourni par l'utilisateur, qui est utilisé dans le nom de la ressource. Il doit être unique parmi tous les clusters GKE sur site d'un projet et d'un emplacement. Un code d'erreur 409 s'affiche si le cluster existe déjà.

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

string

Facultatif. Nom de l'objet de la ressource personnalisée VMware OnPremUserCluster sur le cluster d'administration associé. Ce champ permet de gérer les noms de ressources en conflit lors de l'enregistrement de clusters existants dans l'API. S'il n'est pas fourni, ce champ est remplacé par vmwareClusterId. Sinon, il doit correspondre au nom de l'objet de la ressource personnalisée VMware OnPremUserCluster. Il n'est pas modifiable en dehors de l'opération d'enregistrement.
adminClusterMembership

string

Obligatoire. Cluster d'administrateur auquel appartient ce cluster d'utilisateur VMware. Il s'agit du nom de ressource complet de l'appartenance au parc du cluster d'administrateur. À l'avenir, les références à d'autres types de ressources pourront être autorisées si les clusters d'administrateurs sont modélisés en tant que ressources propres.
validateOnly

boolean

Validez la requête sans effectuer de mises à jour.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Operation.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez Authentication Overview.