Method: projects.locations.deliveryPipelines.targets.patch

Atualiza os parâmetros de um único destino compartilhado.

Solicitação HTTP

PATCH https://clouddeploy.googleapis.com/v1/{target.name=projects/*/locations/*/deliveryPipelines/*/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}/ deliveryPipelines/{deliveryPipeline}/targets/[a-z][a-z0-9-]{0,62}.

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 saberá que a solicitação deve ser ignorada se ela já tiver sido concluída. O servidor vai garantir isso por pelo menos 60 minutos desde 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.