Method: projects.locations.privateConnections.create

Cria uma conexão particular que pode ser usada para acessar nuvens privadas.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. O nome do recurso do local em que a nova conexão particular será criada. A conexão particular é um recurso regional. Os nomes de recursos são URIs sem esquema que seguem as convenções em https://cloud.google.com/apis/design/resource_names. Por exemplo: projects/my-project/locations/us-central1

A autorização requer a seguinte permissão do IAM no recurso especificado parent:

  • vmwareengine.privateConnections.create

Parâmetros de consulta

Parâmetros
privateConnectionId

string

Obrigatório. O identificador fornecido pelo usuário da nova conexão particular. Esse identificador precisa ser exclusivo entre os recursos de conexão particular no elemento pai e se torna o token final no URI do nome. O identificador precisa atender aos seguintes requisitos:

  • Contém apenas de 1 a 63 caracteres alfanuméricos e hifens
  • Começa com um caractere alfabético
  • Termina com um caractere que não é um hífen
  • Não formatado como um UUID
  • Em conformidade com a RFC 1034 (seção 3.5)
requestId

string

Opcional. Um ID de solicitação para identificar solicitações. Especifique um ID de solicitação exclusivo para que, se precisar repetir a solicitação, o servidor saberá que é preciso ignorar a solicitação se ela já tiver sido concluída. O servidor garante que uma solicitação não resultará na criação de compromissos duplicados por pelo menos 60 minutos.

Por exemplo, considere uma situação em que você faz uma solicitação inicial e ela expira. Se você fizer a solicitação novamente com o mesmo ID, o servidor poderá verificar se a operação original com o mesmo ID foi recebida e, em caso afirmativo, vai ignorar a segunda solicitação. Isso evita que os clientes criem compromissos duplicados acidentalmente.

O ID da solicitação precisa ser um UUID válido. O valor zero não é aceito (00000000-0000-0000-0000-000000000000).

Corpo da solicitação

O corpo da solicitação contém uma instância de PrivateConnection.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta incluirá uma instância de Operation.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.