Method: projects.locations.bareMetalClusters.enroll

Inscribe un clúster de usuario existente alojado en equipos físicos y sus grupos de nodos en la API de Anthos On-Prem dentro de un proyecto y una ubicación determinados. A través de la inscripción, un clúster existente se convertirá en un clúster administrado por la API de Anthos On-Prem. Se crearán los recursos de GCP correspondientes y se espera que todas las modificaciones futuras del clúster o sus grupos de nodos se realicen a través de la API.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
parent

string

Obligatorio. Es el elemento superior del proyecto y la ubicación en los que se inscribió el clúster. Formato: "projects/{project}/locations/{location}"

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "bareMetalClusterId": string,
  "localName": string,
  "adminClusterMembership": string,
  "localNamespace": string
}
Campos
bareMetalClusterId

string

Es el identificador de OnePlatform proporcionado por el usuario que se usa como parte del nombre del recurso. Debe ser único entre todos los clústeres de metal desnudo dentro de un proyecto y una ubicación, y devolverá un error 409 si el clúster ya existe.

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

string

Opcional. Nombre del objeto del recurso personalizado del clúster de equipos físicos en el clúster de administrador asociado. Este campo se usa para admitir nombres de recursos en conflicto cuando se inscriben clústeres existentes en la API. Cuando no se proporciona, este campo se resolverá como bareMetalClusterId. De lo contrario, debe coincidir con el nombre del objeto del recurso personalizado del clúster de metal desnudo. No se puede modificar fuera de la operación de inscripción.
adminClusterMembership

string

Obligatorio. Es el clúster de administrador al que pertenece este clúster de usuario de Bare Metal. Es el nombre completo del recurso de la membresía de la flota del clúster de administrador. En el futuro, es posible que se permitan referencias a otros tipos de recursos si los clústeres de administrador se modelan como sus propios recursos.
localNamespace

string

Opcional. Es el espacio de nombres del clúster.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Operation.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta Authentication Overview.