Method: projects.locations.targets.create

Cria um novo destino em um determinado projeto e local.

Solicitação HTTP

POST https://clouddeploy.googleapis.com/v1/{parent=projects/*/locations/*}/targets

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

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. A coleção mãe em que o Target precisa ser criado. O formato precisa ser projects/{projectId}/locations/{location_name}.

Parâmetros de consulta

Parâmetros
targetId

string

Obrigatório. ID do Target.
requestId

string

Opcional. Um ID de solicitação para identificar solicitações. Especifique um ID de solicitação exclusivo para que, se você precisar repetir sua solicitação, o servidor sabe que deve ignorar a solicitação se ela já tiver sido concluída. O servidor garante isso por pelo menos 60 minutos após a primeira solicitação.

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, com exceção de que o UUID zero não é aceito (00000000-0000-0000-0000-000000000000).
validateOnly

boolean

Opcional. Se definido como verdadeiro, a solicitação será validada e o usuário receberá um resultado esperado, mas nenhuma alteração real será feita.

Corpo da solicitação

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

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 saber mais, consulte a Visão geral da autenticação.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso parent:

  • clouddeploy.targets.create

Para mais informações, consulte a documentação do IAM.