Method: projects.locations.deliveryPipelines.patch

Atualiza os parâmetros de um único DeliveryPipeline.

Solicitação HTTP

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

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

Parâmetros de caminho

Parâmetros
deliveryPipeline.name

string

Opcional. Nome da DeliveryPipeline. O formato é projects/{project}/locations/{location}/deliveryPipelines/{deliveryPipeline}. O componente deliveryPipeline 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 DeliveryPipeline 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 DeliveryPipeline que não existe resultará na criação de um novo DeliveryPipeline.

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 DeliveryPipeline.

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.deliveryPipelines.update

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