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.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2024-06-26 UTC."],[[["\u003cp\u003eThis page details how to create a new Rollout within a specified project, location, delivery pipeline, and release using a POST HTTP request.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires specifying the \u003ccode\u003eparent\u003c/code\u003e path parameter, which includes the project ID, location name, pipeline name, and release name.\u003c/p\u003e\n"],["\u003cp\u003eSeveral query parameters are available, such as \u003ccode\u003erolloutId\u003c/code\u003e (required), \u003ccode\u003erequestId\u003c/code\u003e, \u003ccode\u003evalidateOnly\u003c/code\u003e, \u003ccode\u003eoverrideDeployPolicy[]\u003c/code\u003e, and \u003ccode\u003estartingPhaseId\u003c/code\u003e, allowing for customization of the rollout creation process.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must include an instance of the \u003ccode\u003eRollout\u003c/code\u003e resource, and upon successful creation, the response will contain an instance of the \u003ccode\u003eOperation\u003c/code\u003e resource.\u003c/p\u003e\n"],["\u003cp\u003eCreating a rollout necessitates the \u003ccode\u003eclouddeploy.rollouts.create\u003c/code\u003e IAM permission on the parent resource and the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.deliveryPipelines.releases.rollouts.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [IAM Permissions](#body.aspect_1)\n- [Try it!](#try-it)\n\nCreates a new Rollout in a given project and location.\n\n### HTTP request\n\n`POST https://clouddeploy.googleapis.com/v1/{parent=projects/*/locations/*/deliveryPipelines/*/releases/*}/rollouts`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body contains an instance of [Rollout](/deploy/docs/api/reference/rest/v1/projects.locations.deliveryPipelines.releases.rollouts#Rollout).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Operation](/deploy/docs/api/reference/rest/v1/projects.locations.operations#Operation).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp).\n\n### IAM Permissions\n\nRequires the following [IAM](https://cloud.google.com/iam/docs) permission on the `parent` resource:\n\n- `clouddeploy.rollouts.create`\n\nFor more information, see the [IAM documentation](https://cloud.google.com/iam/docs)."]]
