--- title: "POST /v1/{+parent}/rollouts" method: POST path: "/v1/{+parent}/rollouts" tags: ["projects"] --- # POST /v1/{+parent}/rollouts `POST /v1/{+parent}/rollouts` Creates a new Rollout in a given project and location. ## Path parameters - `parent` string, required ## Query parameters - `overrideDeployPolicy` string[] - `requestId` string - `rolloutId` string - `startingPhaseId` string - `validateOnly` boolean ## Request body - Rollout — A `Rollout` resource in the Cloud Deploy API. A `Rollout` contains information around a specific deployment to a `Target`. - `state` 'STATE_UNSPECIFIED' | 'SUCCEEDED' | 'FAILED' | 'IN_PROGRESS' | 'PENDING_APPROVAL' | 'APPROVAL_REJECTED' | 'PENDING' | 'PENDING_RELEASE' | 'CANCELLING' | 'CANCELLED' | 'HALTED' — Output only. Current state of the `Rollout`. - `etag` string — This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. - `activeRepairAutomationRun` string — Output only. The AutomationRun actively repairing the rollout. - `metadata` Metadata — Metadata includes information associated with a `Rollout`. - `automation` AutomationRolloutMetadata — AutomationRolloutMetadata contains Automation-related actions that were performed on a rollout. - `promoteAutomationRun` string — Output only. The name of the AutomationRun initiated by a promote release rule. - `repairAutomationRuns` string[] — Output only. The names of the AutomationRuns initiated by a repair rollout rule. - `advanceAutomationRuns` string[] — Output only. The names of the AutomationRuns initiated by an advance rollout rule. - `cloudRun` CloudRunMetadata — CloudRunMetadata contains information from a Cloud Run deployment. - `revision` string — Output only. The Cloud Run Revision id associated with a `Rollout`. - `previousRevision` string — Output only. The previous Cloud Run Revision name associated with a `Rollout`. Only set when a canary deployment strategy is configured. Format for service is projects/{project}/locations/{location}/services/{service}/revisions/{revision}. Format for worker pool is projects/{project}/locations/{location}/workerPools/{workerpool}/revisions/{revision}. - `workerPool` string — Output only. The Cloud Run worker pool associated with a `Rollout`. Format is `projects/{project}/locations/{location}/workerPools/{worker_pool}`. - `service` string — Output only. The name of the Cloud Run Service that is associated with a `Rollout`. Format is `projects/{project}/locations/{location}/services/{service}`. - `serviceUrls` string[] — Output only. The Cloud Run Service urls that are associated with a `Rollout`. - `job` string — Output only. The name of the Cloud Run job that is associated with a `Rollout`. Format is `projects/{project}/locations/{location}/jobs/{job_name}`. - `custom` CustomMetadata — CustomMetadata contains information from a user-defined operation. - `values` object — Output only. Key-value pairs provided by the user-defined operation. - `uid` string — Output only. Unique identifier of the `Rollout`. - `labels` object — Labels are attributes that can be set and used by both the user and by Cloud Deploy. Labels must meet the following constraints: * Keys and values can contain only lowercase letters, numeric characters, underscores, and dashes. * All characters must use UTF-8 encoding, and international characters are allowed. * Keys must start with a lowercase letter or international character. * Each resource is limited to a maximum of 64 labels. Both keys and values are additionally constrained to be <= 128 bytes. - `deployEndTime` string, google-datetime — Output only. Time at which the `Rollout` finished deploying. - `deployFailureCause` 'FAILURE_CAUSE_UNSPECIFIED' | 'CLOUD_BUILD_UNAVAILABLE' | 'EXECUTION_FAILED' | 'DEADLINE_EXCEEDED' | 'RELEASE_FAILED' | 'RELEASE_ABANDONED' | 'VERIFICATION_CONFIG_NOT_FOUND' | 'CLOUD_BUILD_REQUEST_FAILED' | 'OPERATION_FEATURE_NOT_SUPPORTED' — Output only. The reason this rollout failed. This will always be unspecified while the rollout is in progress. - `failureReason` string — Output only. Additional information about the rollout failure, if available. - `controllerRollout` string — Output only. Name of the `ControllerRollout`. Format is `projects/{project}/locations/{location}/deliveryPipelines/{deliveryPipeline}/releases/{release}/rollouts/{rollout}`. - `name` string — Identifier. Name of the `Rollout`. Format is `projects/{project}/locations/{location}/deliveryPipelines/{deliveryPipeline}/releases/{release}/rollouts/{rollout}`. The `rollout` component must match `[a-z]([a-z0-9-]{0,61}[a-z0-9])?` - `annotations` object — Optional. User annotations. These attributes can only be set and used by the user, and not by Cloud Deploy. See https://google.aip.dev/128#annotations for more details such as format and size limitations. - `createTime` string, google-datetime — Output only. Time at which the `Rollout` was created. - `rolledBackByRollouts` string[] — Output only. Names of `Rollouts` that rolled back this `Rollout`. - `approvalState` 'APPROVAL_STATE_UNSPECIFIED' | 'NEEDS_APPROVAL' | 'DOES_NOT_NEED_APPROVAL' | 'APPROVED' | 'REJECTED' — Output only. Approval state of the `Rollout`. - `deployingBuild` string — Output only. The resource name of the Cloud Build `Build` object that is used to deploy the Rollout. Format is `projects/{project}/locations/{location}/builds/{build}`. - `enqueueTime` string, google-datetime — Output only. Time at which the `Rollout` was enqueued. - `deployStartTime` string, google-datetime — Output only. Time at which the `Rollout` started deploying. - `targetId` string — Required. The ID of Target to which this `Rollout` is deploying. - `phases` Phase[] — Output only. The phases that represent the workflows of this `Rollout`. - `childRolloutJobs` ChildRolloutJobs — ChildRollouts job composition - `createRolloutJobs` Job[] — Output only. List of CreateChildRolloutJobs - `id` string — Output only. The ID of the Job. - `postdeployJob` PostdeployJob — A postdeploy Job. - `tasks` Task[] — Output only. The tasks that are executed as part of the postdeploy Job. - `container` ContainerTask — This task is represented by a container that is executed in the Cloud Build execution environment. - … - `actions` string[] — Output only. The custom actions that the postdeploy Job executes. - `createChildRolloutJob` CreateChildRolloutJob — A createChildRollout Job. - `advanceChildRolloutJob` AdvanceChildRolloutJob — An advanceChildRollout Job. - `state` 'STATE_UNSPECIFIED' | 'PENDING' | 'DISABLED' | 'IN_PROGRESS' | 'SUCCEEDED' | 'FAILED' | 'ABORTED' | 'SKIPPED' | 'IGNORED' — Output only. The current state of the Job. - `jobRun` string — Output only. The name of the `JobRun` responsible for the most recent invocation of this Job. - `verifyJob` VerifyJob — A verify Job. - `tasks` Task[] — Output only. The tasks that are executed as part of the verify Job. - `container` ContainerTask — This task is represented by a container that is executed in the Cloud Build execution environment. - … - `skipMessage` string — Output only. Additional information on why the Job was skipped, if available. - `deployJob` DeployJob — A deploy Job. - `analysisJob` AnalysisJob — An analysis Job. - `duration` string, google-duration — Output only. The amount of time in minutes the analysis Job will run, up to a maximum of 48 hours. If any check in this Job is still running when the duration ends, the Job keeps running until that check completes. - `customChecks` CustomCheck[] — Output only. Custom analysis checks from 3P metric providers that are run as part of the analysis Job. - `id` string — Required. The ID of the custom Analysis check. - `task` Task — A Task represents a unit of work that is executed as part of a Job. - … - `frequency` string, google-duration — Optional. The frequency at which the custom check will be run, with a minimum and default of 5 minutes. - `googleCloud` GoogleCloudAnalysis — GoogleCloudAnalysis is a set of Google Cloud-based checks to perform on the deployment. - `alertPolicyChecks` AlertPolicyCheck[] — Optional. A list of Cloud Monitoring Alert Policy checks to perform as part of the analysis. - … - `predeployJob` PredeployJob — A predeploy Job. - `tasks` Task[] — Output only. The tasks that are executed as part of the predeploy Job. - `container` ContainerTask — This task is represented by a container that is executed in the Cloud Build execution environment. - … - `actions` string[] — Output only. The custom actions that the predeploy Job executes. - `advanceRolloutJobs` Job[] — Output only. List of AdvanceChildRolloutJobs - `id` string — Output only. The ID of the Job. - `postdeployJob` PostdeployJob — A postdeploy Job. - `tasks` Task[] — Output only. The tasks that are executed as part of the postdeploy Job. - `container` ContainerTask — This task is represented by a container that is executed in the Cloud Build execution environment. - … - `actions` string[] — Output only. The custom actions that the postdeploy Job executes. - `createChildRolloutJob` CreateChildRolloutJob — A createChildRollout Job. - `advanceChildRolloutJob` AdvanceChildRolloutJob — An advanceChildRollout Job. - `state` 'STATE_UNSPECIFIED' | 'PENDING' | 'DISABLED' | 'IN_PROGRESS' | 'SUCCEEDED' | 'FAILED' | 'ABORTED' | 'SKIPPED' | 'IGNORED' — Output only. The current state of the Job. - `jobRun` string — Output only. The name of the `JobRun` responsible for the most recent invocation of this Job. - `verifyJob` VerifyJob — A verify Job. - `tasks` Task[] — Output only. The tasks that are executed as part of the verify Job. - `container` ContainerTask — This task is represented by a container that is executed in the Cloud Build execution environment. - … - `skipMessage` string — Output only. Additional information on why the Job was skipped, if available. - `deployJob` DeployJob — A deploy Job. - `analysisJob` AnalysisJob — An analysis Job. - `duration` string, google-duration — Output only. The amount of time in minutes the analysis Job will run, up to a maximum of 48 hours. If any check in this Job is still running when the duration ends, the Job keeps running until that check completes. - `customChecks` CustomCheck[] — Output only. Custom analysis checks from 3P metric providers that are run as part of the analysis Job. - `id` string — Required. The ID of the custom Analysis check. - `task` Task — A Task represents a unit of work that is executed as part of a Job. - … - `frequency` string, google-duration — Optional. The frequency at which the custom check will be run, with a minimum and default of 5 minutes. - `googleCloud` GoogleCloudAnalysis — GoogleCloudAnalysis is a set of Google Cloud-based checks to perform on the deployment. - `alertPolicyChecks` AlertPolicyCheck[] — Optional. A list of Cloud Monitoring Alert Policy checks to perform as part of the analysis. - … - `predeployJob` PredeployJob — A predeploy Job. - `tasks` Task[] — Output only. The tasks that are executed as part of the predeploy Job. - `container` ContainerTask — This task is represented by a container that is executed in the Cloud Build execution environment. - … - `actions` string[] — Output only. The custom actions that the predeploy Job executes. - `skipMessage` string — Output only. Additional information on why the Phase was skipped, if available. - `id` string — Output only. The ID of the Phase. - `state` 'STATE_UNSPECIFIED' | 'PENDING' | 'IN_PROGRESS' | 'SUCCEEDED' | 'FAILED' | 'ABORTED' | 'SKIPPED' — Output only. Current state of the Phase. - `deploymentJobs` DeploymentJobs — Deployment job composition. - `predeployJob` Job — Job represents an operation for a `Rollout`. - `id` string — Output only. The ID of the Job. - `postdeployJob` PostdeployJob — A postdeploy Job. - `tasks` Task[] — Output only. The tasks that are executed as part of the postdeploy Job. - `container` ContainerTask — This task is represented by a container that is executed in the Cloud Build execution environment. - … - `actions` string[] — Output only. The custom actions that the postdeploy Job executes. - `createChildRolloutJob` CreateChildRolloutJob — A createChildRollout Job. - `advanceChildRolloutJob` AdvanceChildRolloutJob — An advanceChildRollout Job. - `state` 'STATE_UNSPECIFIED' | 'PENDING' | 'DISABLED' | 'IN_PROGRESS' | 'SUCCEEDED' | 'FAILED' | 'ABORTED' | 'SKIPPED' | 'IGNORED' — Output only. The current state of the Job. - `jobRun` string — Output only. The name of the `JobRun` responsible for the most recent invocation of this Job. - `verifyJob` VerifyJob — A verify Job. - `tasks` Task[] — Output only. The tasks that are executed as part of the verify Job. - `container` ContainerTask — This task is represented by a container that is executed in the Cloud Build execution environment. - … - `skipMessage` string — Output only. Additional information on why the Job was skipped, if available. - `deployJob` DeployJob — A deploy Job. - `analysisJob` AnalysisJob — An analysis Job. - `duration` string, google-duration — Output only. The amount of time in minutes the analysis Job will run, up to a maximum of 48 hours. If any check in this Job is still running when the duration ends, the Job keeps running until that check completes. - `customChecks` CustomCheck[] — Output only. Custom analysis checks from 3P metric providers that are run as part of the analysis Job. - `id` string — Required. The ID of the custom Analysis check. - `task` Task — A Task represents a unit of work that is executed as part of a Job. - … - `frequency` string, google-duration — Optional. The frequency at which the custom check will be run, with a minimum and default of 5 minutes. - `googleCloud` GoogleCloudAnalysis — GoogleCloudAnalysis is a set of Google Cloud-based checks to perform on the deployment. - `alertPolicyChecks` AlertPolicyCheck[] — Optional. A list of Cloud Monitoring Alert Policy checks to perform as part of the analysis. - … - `predeployJob` PredeployJob — A predeploy Job. - `tasks` Task[] — Output only. The tasks that are executed as part of the predeploy Job. - `container` ContainerTask — This task is represented by a container that is executed in the Cloud Build execution environment. - … - `actions` string[] — Output only. The custom actions that the predeploy Job executes. - `analysisJob` Job — Job represents an operation for a `Rollout`. - `id` string — Output only. The ID of the Job. - `postdeployJob` PostdeployJob — A postdeploy Job. - `tasks` Task[] — Output only. The tasks that are executed as part of the postdeploy Job. - `container` ContainerTask — This task is represented by a container that is executed in the Cloud Build execution environment. - … - `actions` string[] — Output only. The custom actions that the postdeploy Job executes. - `createChildRolloutJob` CreateChildRolloutJob — A createChildRollout Job. - `advanceChildRolloutJob` AdvanceChildRolloutJob — An advanceChildRollout Job. - `state` 'STATE_UNSPECIFIED' | 'PENDING' | 'DISABLED' | 'IN_PROGRESS' | 'SUCCEEDED' | 'FAILED' | 'ABORTED' | 'SKIPPED' | 'IGNORED' — Output only. The current state of the Job. - `jobRun` string — Output only. The name of the `JobRun` responsible for the most recent invocation of this Job. - `verifyJob` VerifyJob — A verify Job. - `tasks` Task[] — Output only. The tasks that are executed as part of the verify Job. - `container` ContainerTask — This task is represented by a container that is executed in the Cloud Build execution environment. - … - `skipMessage` string — Output only. Additional information on why the Job was skipped, if available. - `deployJob` DeployJob — A deploy Job. - `analysisJob` AnalysisJob — An analysis Job. - `duration` string, google-duration — Output only. The amount of time in minutes the analysis Job will run, up to a maximum of 48 hours. If any check in this Job is still running when the duration ends, the Job keeps running until that check completes. - `customChecks` CustomCheck[] — Output only. Custom analysis checks from 3P metric providers that are run as part of the analysis Job. - `id` string — Required. The ID of the custom Analysis check. - `task` Task — A Task represents a unit of work that is executed as part of a Job. - … - `frequency` string, google-duration — Optional. The frequency at which the custom check will be run, with a minimum and default of 5 minutes. - `googleCloud` GoogleCloudAnalysis — GoogleCloudAnalysis is a set of Google Cloud-based checks to perform on the deployment. - `alertPolicyChecks` AlertPolicyCheck[] — Optional. A list of Cloud Monitoring Alert Policy checks to perform as part of the analysis. - … - `predeployJob` PredeployJob — A predeploy Job. - `tasks` Task[] — Output only. The tasks that are executed as part of the predeploy Job. - `container` ContainerTask — This task is represented by a container that is executed in the Cloud Build execution environment. - … - `actions` string[] — Output only. The custom actions that the predeploy Job executes. - `deployJob` Job — Job represents an operation for a `Rollout`. - `id` string — Output only. The ID of the Job. - `postdeployJob` PostdeployJob — A postdeploy Job. - `tasks` Task[] — Output only. The tasks that are executed as part of the postdeploy Job. - `container` ContainerTask — This task is represented by a container that is executed in the Cloud Build execution environment. - … - `actions` string[] — Output only. The custom actions that the postdeploy Job executes. - `createChildRolloutJob` CreateChildRolloutJob — A createChildRollout Job. - `advanceChildRolloutJob` AdvanceChildRolloutJob — An advanceChildRollout Job. - `state` 'STATE_UNSPECIFIED' | 'PENDING' | 'DISABLED' | 'IN_PROGRESS' | 'SUCCEEDED' | 'FAILED' | 'ABORTED' | 'SKIPPED' | 'IGNORED' — Output only. The current state of the Job. - `jobRun` string — Output only. The name of the `JobRun` responsible for the most recent invocation of this Job. - `verifyJob` VerifyJob — A verify Job. - `tasks` Task[] — Output only. The tasks that are executed as part of the verify Job. - `container` ContainerTask — This task is represented by a container that is executed in the Cloud Build execution environment. - … - `skipMessage` string — Output only. Additional information on why the Job was skipped, if available. - `deployJob` DeployJob — A deploy Job. - `analysisJob` AnalysisJob — An analysis Job. - `duration` string, google-duration — Output only. The amount of time in minutes the analysis Job will run, up to a maximum of 48 hours. If any check in this Job is still running when the duration ends, the Job keeps running until that check completes. - `customChecks` CustomCheck[] — Output only. Custom analysis checks from 3P metric providers that are run as part of the analysis Job. - `id` string — Required. The ID of the custom Analysis check. - `task` Task — A Task represents a unit of work that is executed as part of a Job. - … - `frequency` string, google-duration — Optional. The frequency at which the custom check will be run, with a minimum and default of 5 minutes. - `googleCloud` GoogleCloudAnalysis — GoogleCloudAnalysis is a set of Google Cloud-based checks to perform on the deployment. - `alertPolicyChecks` AlertPolicyCheck[] — Optional. A list of Cloud Monitoring Alert Policy checks to perform as part of the analysis. - … - `predeployJob` PredeployJob — A predeploy Job. - `tasks` Task[] — Output only. The tasks that are executed as part of the predeploy Job. - `container` ContainerTask — This task is represented by a container that is executed in the Cloud Build execution environment. - … - `actions` string[] — Output only. The custom actions that the predeploy Job executes. - `verifyJob` Job — Job represents an operation for a `Rollout`. - `id` string — Output only. The ID of the Job. - `postdeployJob` PostdeployJob — A postdeploy Job. - `tasks` Task[] — Output only. The tasks that are executed as part of the postdeploy Job. - `container` ContainerTask — This task is represented by a container that is executed in the Cloud Build execution environment. - … - `actions` string[] — Output only. The custom actions that the postdeploy Job executes. - `createChildRolloutJob` CreateChildRolloutJob — A createChildRollout Job. - `advanceChildRolloutJob` AdvanceChildRolloutJob — An advanceChildRollout Job. - `state` 'STATE_UNSPECIFIED' | 'PENDING' | 'DISABLED' | 'IN_PROGRESS' | 'SUCCEEDED' | 'FAILED' | 'ABORTED' | 'SKIPPED' | 'IGNORED' — Output only. The current state of the Job. - `jobRun` string — Output only. The name of the `JobRun` responsible for the most recent invocation of this Job. - `verifyJob` VerifyJob — A verify Job. - `tasks` Task[] — Output only. The tasks that are executed as part of the verify Job. - `container` ContainerTask — This task is represented by a container that is executed in the Cloud Build execution environment. - … - `skipMessage` string — Output only. Additional information on why the Job was skipped, if available. - `deployJob` DeployJob — A deploy Job. - `analysisJob` AnalysisJob — An analysis Job. - `duration` string, google-duration — Output only. The amount of time in minutes the analysis Job will run, up to a maximum of 48 hours. If any check in this Job is still running when the duration ends, the Job keeps running until that check completes. - `customChecks` CustomCheck[] — Output only. Custom analysis checks from 3P metric providers that are run as part of the analysis Job. - `id` string — Required. The ID of the custom Analysis check. - `task` Task — A Task represents a unit of work that is executed as part of a Job. - … - `frequency` string, google-duration — Optional. The frequency at which the custom check will be run, with a minimum and default of 5 minutes. - `googleCloud` GoogleCloudAnalysis — GoogleCloudAnalysis is a set of Google Cloud-based checks to perform on the deployment. - `alertPolicyChecks` AlertPolicyCheck[] — Optional. A list of Cloud Monitoring Alert Policy checks to perform as part of the analysis. - … - `predeployJob` PredeployJob — A predeploy Job. - `tasks` Task[] — Output only. The tasks that are executed as part of the predeploy Job. - `container` ContainerTask — This task is represented by a container that is executed in the Cloud Build execution environment. - … - `actions` string[] — Output only. The custom actions that the predeploy Job executes. - `postdeployJob` Job — Job represents an operation for a `Rollout`. - `id` string — Output only. The ID of the Job. - `postdeployJob` PostdeployJob — A postdeploy Job. - `tasks` Task[] — Output only. The tasks that are executed as part of the postdeploy Job. - `container` ContainerTask — This task is represented by a container that is executed in the Cloud Build execution environment. - … - `actions` string[] — Output only. The custom actions that the postdeploy Job executes. - `createChildRolloutJob` CreateChildRolloutJob — A createChildRollout Job. - `advanceChildRolloutJob` AdvanceChildRolloutJob — An advanceChildRollout Job. - `state` 'STATE_UNSPECIFIED' | 'PENDING' | 'DISABLED' | 'IN_PROGRESS' | 'SUCCEEDED' | 'FAILED' | 'ABORTED' | 'SKIPPED' | 'IGNORED' — Output only. The current state of the Job. - `jobRun` string — Output only. The name of the `JobRun` responsible for the most recent invocation of this Job. - `verifyJob` VerifyJob — A verify Job. - `tasks` Task[] — Output only. The tasks that are executed as part of the verify Job. - `container` ContainerTask — This task is represented by a container that is executed in the Cloud Build execution environment. - … - `skipMessage` string — Output only. Additional information on why the Job was skipped, if available. - `deployJob` DeployJob — A deploy Job. - `analysisJob` AnalysisJob — An analysis Job. - `duration` string, google-duration — Output only. The amount of time in minutes the analysis Job will run, up to a maximum of 48 hours. If any check in this Job is still running when the duration ends, the Job keeps running until that check completes. - `customChecks` CustomCheck[] — Output only. Custom analysis checks from 3P metric providers that are run as part of the analysis Job. - `id` string — Required. The ID of the custom Analysis check. - `task` Task — A Task represents a unit of work that is executed as part of a Job. - … - `frequency` string, google-duration — Optional. The frequency at which the custom check will be run, with a minimum and default of 5 minutes. - `googleCloud` GoogleCloudAnalysis — GoogleCloudAnalysis is a set of Google Cloud-based checks to perform on the deployment. - `alertPolicyChecks` AlertPolicyCheck[] — Optional. A list of Cloud Monitoring Alert Policy checks to perform as part of the analysis. - … - `predeployJob` PredeployJob — A predeploy Job. - `tasks` Task[] — Output only. The tasks that are executed as part of the predeploy Job. - `container` ContainerTask — This task is represented by a container that is executed in the Cloud Build execution environment. - … - `actions` string[] — Output only. The custom actions that the predeploy Job executes. - `description` string — Optional. Description of the `Rollout` for user purposes. Max length is 255 characters. - `rollbackOfRollout` string — Output only. Name of the `Rollout` that is rolled back by this `Rollout`. Empty if this `Rollout` wasn't created as a rollback. - `approveTime` string, google-datetime — Output only. Time at which the `Rollout` was approved. ## Response `200` Successful response --- [API](https://skmtc.net/google/apis/clouddeploy.md) · [All operations](https://skmtc.net/google/apis/clouddeploy/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/clouddeploy/versions/a8819765974a/schema)