Method: projects.locations.privateConnections.create

Crea una conexión privada nueva que se puede usar para acceder a nubes privadas.

Solicitud HTTP

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

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 ubicación en la que se creará la nueva conexión privada. La conexión privada es un recurso regional. 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.

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

  • vmwareengine.privateConnections.create

Parámetros de consulta

Parámetros
privateConnectionId

string

Obligatorio. Es el identificador proporcionado por el usuario de la nueva conexión privada. Este identificador debe ser único entre los recursos de conexión privada 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, 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 PrivateConnection.

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.