Wajib. Koleksi induk tempat Rollout harus dibuat. Format harus projects/{projectId}/locations/{location_name}/deliveryPipelines/{pipeline_name}/releases/{release_name}.
Parameter kueri
Parameter
rolloutId
string
Wajib. ID Rollout.
requestId
string
Opsional. ID permintaan untuk mengidentifikasi permintaan. Tetapkan ID permintaan unik sehingga jika Anda harus mencoba lagi permintaan, server akan mengabaikan permintaan tersebut jika sudah diselesaikan. Server menjamin bahwa setidaknya 60 menit setelah permintaan pertama.
Misalnya, pertimbangkan situasi saat Anda membuat permintaan awal dan waktu permintaan habis. Jika Anda membuat permintaan lagi dengan ID permintaan yang sama, server dapat memeriksa apakah operasi asli dengan ID permintaan yang sama diterima, dan jika demikian, akan mengabaikan permintaan kedua. Langkah ini mencegah klien membuat komitmen duplikat secara tidak sengaja.
ID permintaan harus berupa UUID yang valid dengan pengecualian bahwa nol UUID tidak didukung (00000000-0000-0000-0000-000000000000).
validateOnly
boolean
Opsional. Jika disetel ke benar (true), permintaan divalidasi dan pengguna akan diberikan hasil yang diharapkan, tetapi tidak ada perubahan aktual yang dibuat.
startingPhaseId
string
Opsional. ID fase awal untuk Rollout. Jika kosong, Rollout akan dimulai dari fase pertama.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2024-04-24 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)."]]
