Method: projects.locations.memberships.create

Crea una membresía nueva.

Por el momento, esto solo es compatible con los clústeres de GKE en Google Cloud. Para registrar otros clústeres, sigue las instrucciones en https://cloud.google.com/kubernetes-engine/enterprise/multicluster-management/connect/registering-a-cluster.

Solicitud HTTP

POST https://gkehub.googleapis.com/v1beta1/{parent=projects/*/locations/*}/memberships

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

Parámetros de ruta de acceso

Parámetros
parent

string

Obligatorio. El elemento superior (proyecto y ubicación) en el que se crearán las membresías. Especificado en el formato projects/*/locations/*.

La autorización requiere el siguiente permiso IAM en el recurso especificado parent:

  • gkehub.memberships.create

Parámetros de consulta

Parámetros
membershipId

string

Obligatorio. El ID de cliente que eligió para la membresía. membershipId debe ser una etiqueta de DNS válida que cumpla con RFC 1123:

  1. Longitud máxima de 63 caracteres
  2. Debe contener caracteres alfanuméricos en minúscula o -
  3. Debe comenzar y terminar con un carácter alfanumérico

que se puede expresar como la regex: [a-z0-9]([-a-z0-9]*[a-z0-9])?, y tener una longitud máxima de 63 caracteres.

requestId

string

Opcional. Un ID de solicitud para identificar solicitudes. Especifica un ID de solicitud único para que, si debes reintentar la solicitud, el servidor sepa que debe ignorarla si ya se completó. El servidor lo garantizará durante al menos 60 minutos después de la primera solicitud.

Por ejemplo, imagina una situación en la que realizas una solicitud inicial y se agota el tiempo de espera de la solicitud. Si vuelves a realizar la solicitud con el mismo ID de solicitud, el servidor puede verificar si se recibió la operación original con el mismo ID de solicitud y, de ser así, ignorar la segunda solicitud. Esto evita que los clientes creen compromisos duplicados por accidente.

El ID de solicitud debe ser un UUID válido, con la excepción de que no se admite ningún UUID cero (00000000-0000-0000-0000-000000000000).

Cuerpo de la solicitud

El cuerpo de la solicitud contiene una instancia de Membership.

Cuerpo de la respuesta

Si el proceso se realiza de forma correcta, el cuerpo de la respuesta contiene una instancia recién creada de Operation.

Alcances de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.