Method: projects.locations.privateClouds.hcxActivationKeys.create

Crea una clave de activación de HCX nueva en una nube privada determinada.

Solicitud HTTP

POST https://vmwareengine.googleapis.com/v1/{parent=projects/*/locations/*/privateClouds/*}/hcxActivationKeys

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

Parámetros de ruta

Parámetros
parent

string

Obligatorio. Es el nombre del recurso de la nube privada para la que se creará la clave. Los nombres de recursos son URIs sin esquema que siguen las convenciones que se indican en https://cloud.google.com/apis/design/resource_names. Por ejemplo: projects/my-project/locations/us-central1/privateClouds/my-cloud.

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

  • vmwareengine.hcxActivationKeys.create

Parámetros de consulta

Parámetros
hcxActivationKeyId

string

Obligatorio. Es el identificador proporcionado por el usuario del HcxActivationKey que se creará. Este identificador debe ser único entre los recursos HcxActivationKey dentro del recurso principal y se convierte en el token final en el URI del nombre. El identificador debe cumplir con los siguientes requisitos:

  • Solo contiene entre 1 y 63 caracteres alfanuméricos y guiones
  • Comienza con un carácter alfabético.
  • Termina con un carácter que no es un guion.
  • No tiene el formato de un UUID
  • Cumple con RFC 1034 (sección 3.5)
requestId

string

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 garantiza que una solicitud no genera la creación de compromisos duplicados durante al menos 60 minutos.

Por ejemplo, imagina una situación en la que haces una solicitud inicial y se agota el tiempo de espera. Si vuelves a hacer la solicitud con el mismo ID, el servidor puede verificar si se recibió la operación original con el mismo ID 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 HcxActivationKey.

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.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

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