Method: projects.locations.targets.patch

Atualiza os parâmetros de um único destino.

Solicitação HTTP

PATCH https://clouddeploy.googleapis.com/v1/{target.name=projects/*/locations/*/targets/*}

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

Parâmetros de caminho

Parâmetros
target.name

string

Opcional. Nome da Target. O formato é projects/{project}/locations/{location}/targets/{target}. O componente target precisa corresponder a [a-z]([a-z0-9-]{0,61}[a-z0-9])?

Parâmetros de consulta

Parâmetros
updateMask

string (FieldMask format)

Obrigatório. A máscara de campo é usada para especificar os campos a serem substituídos no recurso de destino pela atualização. Os campos especificados na updateMask são relativos ao recurso, não à solicitação completa. Um campo será substituído se estiver na máscara. Se o usuário não fornecer uma máscara, todos os campos serão substituídos.

É uma lista separada por vírgulas de nomes de campos totalmente qualificados. Exemplo: "user.displayName,photo".
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).
allowMissing

boolean

Opcional. Se definida como verdadeira, a atualização de um Target que não existe resultará na criação de um novo Target.
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 conterá 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 name:

  • clouddeploy.targets.update

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