Method: projects.locations.deliveryPipelines.releases.rollouts.create

Cria um novo lançamento em um determinado projeto e local.

Solicitação HTTP

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

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 Rollout precisa ser criado. O formato precisa ser projects/{projectId}/locations/{location_name}/deliveryPipelines/{pipeline_name}/releases/{release_name}.

Parâmetros de consulta

Parâmetros
rolloutId

string

Obrigatório. ID do Rollout.
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.
startingPhaseId

string

Opcional. O ID da fase inicial para o Rollout. Se estiver vazio, o Rollout vai começar na primeira fase.

Corpo da solicitação

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

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.rollouts.create

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