Erforderlich. Die übergeordnete Sammlung, in der das Release erstellt werden soll. Verwenden Sie das Format projects/{projectId}/locations/{location_name}/deliveryPipelines/{pipeline_name}.
Abfrageparameter
Parameter
releaseId
string
Erforderlich. ID von Release.
requestId
string
Optional. Eine Anfrage-ID zur Identifizierung von Anfragen. Geben Sie eine eindeutige Anfrage-ID an, damit der Server die Anfrage ignorieren kann, wenn sie noch einmal ausgeführt wurde. Der Server garantiert dies für mindestens 60 Minuten nach der ersten Anfrage.
Stellen Sie sich beispielsweise eine Situation vor, in der Sie eine erste Anfrage stellen und diese das Zeitlimit überschreitet. Wenn Sie die Anfrage mit derselben Anfrage-ID noch einmal senden, kann der Server prüfen, ob der ursprüngliche Vorgang mit derselben Anfrage-ID empfangen wurde. Ist dies der Fall, wird die zweite Anfrage ignoriert. Dadurch wird verhindert, dass Clients versehentlich doppelte Zusicherungen erstellen.
Die Anfrage-ID muss eine gültige UUID sein, mit der Ausnahme, dass null UUID nicht unterstützt wird (00000000-0000-0000-0000-000000000000).
validateOnly
boolean
Optional. Ist die Richtlinie auf „true“ gesetzt, wird die Anfrage validiert und der Nutzer erhält ein erwartetes Ergebnis. Es wird jedoch keine Änderung vorgenommen.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2024-06-28 (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)."]]