---
title: Cloud Deploy Rollout
description: Datadog, the leading service for cloud-scale monitoring.
breadcrumbs: Docs > DDSQL Reference > Data Directory > Cloud Deploy Rollout
---

# Cloud Deploy Rollout

Cloud Deploy Rollout in Google Cloud represents a specific deployment instance within a delivery pipeline. It defines how a particular version of an application is released to one or more target environments. Each rollout includes configuration details such as deployment strategies, phases, and approval steps. It helps manage progressive delivery, track deployment status, and ensure controlled promotion of releases across environments.

```
gcp.clouddeploy_rollout
```

## Fields

| Title                        | ID   | Type          | Data Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | Description |
| ---------------------------- | ---- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- |
| _key                         | core | string        |
| active_repair_automation_run | core | string        | Output only. The AutomationRun actively repairing the rollout.                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| ancestors                    | core | array<string> |
| annotations                  | core | hstore        | 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.                                                                                                                                                                                                                                                                                                              |
| approval_state               | core | string        | Output only. Approval state of the `Rollout`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| approve_time                 | core | timestamp     | Output only. Time at which the `Rollout` was approved.                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| controller_rollout           | core | string        | Output only. Name of the `ControllerRollout`. Format is `projects/{project}/locations/{location}/deliveryPipelines/{deliveryPipeline}/releases/{release}/rollouts/{rollout}`.                                                                                                                                                                                                                                                                                                                                             |
| create_time                  | core | timestamp     | Output only. Time at which the `Rollout` was created.                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| datadog_display_name         | core | string        |
| deploy_end_time              | core | timestamp     | Output only. Time at which the `Rollout` finished deploying.                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| deploy_failure_cause         | core | string        | Output only. The reason this rollout failed. This will always be unspecified while the rollout is in progress.                                                                                                                                                                                                                                                                                                                                                                                                            |
| deploy_start_time            | core | timestamp     | Output only. Time at which the `Rollout` started deploying.                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| deploying_build              | core | 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}`.                                                                                                                                                                                                                                                                                                                                                  |
| description                  | core | string        | Optional. Description of the `Rollout` for user purposes. Max length is 255 characters.                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| enqueue_time                 | core | timestamp     | Output only. Time at which the `Rollout` was enqueued.                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| etag                         | core | 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.                                                                                                                                                                                                                                                                                                                                 |
| failure_reason               | core | string        | Output only. Additional information about the rollout failure, if available.                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| labels                       | core | array<string> | 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. |
| metadata                     | core | json          | Output only. Metadata contains information about the rollout.                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| name                         | core | 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])?`                                                                                                                                                                                                                                                                                   |
| organization_id              | core | string        |
| parent                       | core | string        |
| phases                       | core | json          | Output only. The phases that represent the workflows of this `Rollout`.                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| project_id                   | core | string        |
| project_number               | core | string        |
| region_id                    | core | string        |
| resource_name                | core | string        |
| rollback_of_rollout          | core | string        | Output only. Name of the `Rollout` that is rolled back by this `Rollout`. Empty if this `Rollout` wasn't created as a rollback.                                                                                                                                                                                                                                                                                                                                                                                           |
| rolled_back_by_rollouts      | core | array<string> | Output only. Names of `Rollouts` that rolled back this `Rollout`.                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| state                        | core | string        | Output only. Current state of the `Rollout`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| tags                         | core | hstore_csv    |
| target_id                    | core | string        | Required. The ID of Target to which this `Rollout` is deploying.                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| uid                          | core | string        | Output only. Unique identifier of the `Rollout`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| zone_id                      | core | string        |