Obrigatório. A coleção mãe em que o Release precisa ser criado. O formato precisa ser projects/{projectId}/locations/{location_name}/deliveryPipelines/{pipeline_name}.
Parâmetros de consulta
Parâmetros
releaseId
string
Obrigatório. ID do Release.
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.
Corpo da solicitação
O corpo da solicitação contém uma instância de Release.
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 webpage details the process of creating a new Release within a specified project and location using the Cloud Deploy API.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP request uses a \u003ccode\u003ePOST\u003c/code\u003e method directed to a specific URL structure that includes parameters to identify the parent project, location, and delivery pipeline.\u003c/p\u003e\n"],["\u003cp\u003eYou need to provide a \u003ccode\u003ereleaseId\u003c/code\u003e, with the option to also include a \u003ccode\u003erequestId\u003c/code\u003e for managing retries and a \u003ccode\u003evalidateOnly\u003c/code\u003e flag for testing, plus an override policy if necessary.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires a body that conforms to the \u003ccode\u003eRelease\u003c/code\u003e format, while a successful operation returns an \u003ccode\u003eOperation\u003c/code\u003e instance.\u003c/p\u003e\n"],["\u003cp\u003eCreating a release requires authorization via the \u003ccode\u003ecloud-platform\u003c/code\u003e OAuth scope and the \u003ccode\u003eclouddeploy.releases.create\u003c/code\u003e IAM permission on the parent resource.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.deliveryPipelines.releases.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 Release in a given project and location.\n\n### HTTP request\n\n`POST https://clouddeploy.googleapis.com/v1/{parent=projects/*/locations/*/deliveryPipelines/*}/releases`\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 [Release](/deploy/docs/api/reference/rest/v1/projects.locations.deliveryPipelines.releases#Release).\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.releases.create`\n\nFor more information, see the [IAM documentation](https://cloud.google.com/iam/docs)."]]