Method: projects.locations.privateClouds.externalAddresses.create

Crea un recurso ExternalAddress nuevo en una nube privada determinada. La política de red que corresponde a la nube privada debe tener habilitado el servicio de red de dirección IP externa (NetworkPolicy.external_ip).

Solicitud HTTP

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

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 en la que se creará una dirección IP externa nueva. 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-a/privateClouds/my-cloud.

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

  • vmwareengine.externalAddresses.create

Parámetros de consulta

Parámetros
externalAddressId

string

Obligatorio. Es el identificador proporcionado por el usuario del ExternalAddress que se creará. Este identificador debe ser único entre los recursos ExternalAddress 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

Es 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 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 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 ExternalAddress.

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.