---
title: Getting Started with Datadog
description: Datadog, the leading service for cloud-scale monitoring.
breadcrumbs: Docs > Infrastructure > Datadog Resource Catalog
---

# gcp_config_preview{% #gcp_config_preview %}

## `ancestors`{% #ancestors %}

**Type**: `UNORDERED_LIST_STRING`

## `annotations`{% #annotations %}

**Type**: `MAP_STRING_STRING`**Provider name**: `annotations`**Description**: Optional. Arbitrary key-value metadata storage e.g. to help client tools identify preview during automation. See [https://google.aip.dev/148#annotations](https://google.aip.dev/148#annotations) for details on format and size limitations.

## `artifacts_gcs_bucket`{% #artifacts_gcs_bucket %}

**Type**: `STRING`**Provider name**: `artifactsGcsBucket`**Description**: Optional. User-defined location of Cloud Build logs, artifacts, and in Google Cloud Storage. Format: `gs://{bucket}/{folder}` A default bucket will be bootstrapped if the field is not set or empty Default Bucket Format: `gs://--blueprint-config` Constraints: - The bucket needs to be in the same project as the deployment - The path cannot be within the path of `gcs_source` If omitted and deployment resource ref provided has artifacts_gcs_bucket defined, that artifact bucket is used.

## `build`{% #build %}

**Type**: `STRING`**Provider name**: `build`**Description**: Output only. Cloud Build instance UUID associated with this preview.

## `create_time`{% #create_time %}

**Type**: `TIMESTAMP`**Provider name**: `createTime`**Description**: Output only. Time the preview was created.

## `deployment`{% #deployment %}

**Type**: `STRING`**Provider name**: `deployment`**Description**: Optional. Optional deployment reference. If specified, the preview will be performed using the provided deployment's current state and use any relevant fields from the deployment unless explicitly specified in the preview create request.

## `error_code`{% #error_code %}

**Type**: `STRING`**Provider name**: `errorCode`**Description**: Output only. Code describing any errors that may have occurred.**Possible values**:

- `ERROR_CODE_UNSPECIFIED` - No error code was specified.
- `CLOUD_BUILD_PERMISSION_DENIED` - Cloud Build failed due to a permissions issue.
- `BUCKET_CREATION_PERMISSION_DENIED` - Cloud Storage bucket failed to create due to a permissions issue.
- `BUCKET_CREATION_FAILED` - Cloud Storage bucket failed for a non-permissions-related issue.
- `DEPLOYMENT_LOCK_ACQUIRE_FAILED` - Acquiring lock on provided deployment reference failed.
- `PREVIEW_BUILD_API_FAILED` - Preview encountered an error when trying to access Cloud Build API.
- `PREVIEW_BUILD_RUN_FAILED` - Preview created a build but build failed and logs were generated.

## `error_logs`{% #error_logs %}

**Type**: `STRING`**Provider name**: `errorLogs`**Description**: Output only. Link to tf-error.ndjson file, which contains the full list of the errors encountered during a Terraform preview. Format: `gs://{bucket}/{object}`.

## `error_status`{% #error_status %}

**Type**: `STRUCT`**Provider name**: `errorStatus`**Description**: Output only. Additional information regarding the current state.

- `code`**Type**: `INT32`**Provider name**: `code`**Description**: The status code, which should be an enum value of google.rpc.Code.
- `message`**Type**: `STRING`**Provider name**: `message`**Description**: A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.

## `labels`{% #labels %}

**Type**: `UNORDERED_LIST_STRING`

## `logs`{% #logs %}

**Type**: `STRING`**Provider name**: `logs`**Description**: Output only. Location of preview logs in `gs://{bucket}/{object}` format.

## `name`{% #name %}

**Type**: `STRING`**Provider name**: `name`**Description**: Identifier. Resource name of the preview. Resource name can be user provided or server generated ID if unspecified. Format: `projects/{project}/locations/{location}/previews/{preview}`

## `organization_id`{% #organization_id %}

**Type**: `STRING`

## `parent`{% #parent %}

**Type**: `STRING`

## `preview_artifacts`{% #preview_artifacts %}

**Type**: `STRUCT`**Provider name**: `previewArtifacts`**Description**: Output only. Artifacts from preview.

- `artifacts`**Type**: `STRING`**Provider name**: `artifacts`**Description**: Output only. Location of artifacts in Google Cloud Storage. Format: `gs://{bucket}/{object}`
- `content`**Type**: `STRING`**Provider name**: `content`**Description**: Output only. Location of a blueprint copy and other content in Google Cloud Storage. Format: `gs://{bucket}/{object}`

## `preview_mode`{% #preview_mode %}

**Type**: `STRING`**Provider name**: `previewMode`**Description**: Optional. Current mode of preview.**Possible values**:

- `PREVIEW_MODE_UNSPECIFIED` - Unspecified policy, default mode will be used.
- `DEFAULT` - DEFAULT mode generates an execution plan for reconciling current resource state into expected resource state.
- `DELETE` - DELETE mode generates as execution plan for destroying current resources.

## `project_id`{% #project_id %}

**Type**: `STRING`

## `project_number`{% #project_number %}

**Type**: `STRING`

## `region_id`{% #region_id %}

**Type**: `STRING`

## `resource_name`{% #resource_name %}

**Type**: `STRING`

## `service_account`{% #service_account %}

**Type**: `STRING`**Provider name**: `serviceAccount`**Description**: Required. User-specified Service Account (SA) credentials to be used when previewing resources. Format: `projects/{projectID}/serviceAccounts/{serviceAccount}`

## `state`{% #state %}

**Type**: `STRING`**Provider name**: `state`**Description**: Output only. Current state of the preview.**Possible values**:

- `STATE_UNSPECIFIED` - The default value. This value is used if the state is unknown.
- `CREATING` - The preview is being created.
- `SUCCEEDED` - The preview has succeeded.
- `APPLYING` - The preview is being applied.
- `STALE` - The preview is stale. A preview can become stale if a revision has been applied after this preview was created.
- `DELETING` - The preview is being deleted.
- `FAILED` - The preview has encountered an unexpected error.
- `DELETED` - The preview has been deleted.

## `tags`{% #tags %}

**Type**: `UNORDERED_LIST_STRING`

## `terraform_blueprint`{% #terraform_blueprint %}

**Type**: `STRUCT`**Provider name**: `terraformBlueprint`**Description**: The terraform blueprint to preview.

- `gcs_source`**Type**: `STRING`**Provider name**: `gcsSource`**Description**: URI of an object in Google Cloud Storage. Format: `gs://{bucket}/{object}` URI may also specify an object version for zipped objects. Format: `gs://{bucket}/{object}#{version}`
- `git_source`**Type**: `STRUCT`**Provider name**: `gitSource`**Description**: URI of a public Git repo.
  - `directory`**Type**: `STRING`**Provider name**: `directory`**Description**: Optional. Subdirectory inside the repository. Example: 'staging/my-package'
  - `ref`**Type**: `STRING`**Provider name**: `ref`**Description**: Optional. Git reference (e.g. branch or tag).
  - `repo`**Type**: `STRING`**Provider name**: `repo`**Description**: Optional. Repository URL. Example: '[https://github.com/kubernetes/examples.git'](https://github.com/kubernetes/examples.git%27)

## `tf_errors`{% #tf_errors %}

**Type**: `UNORDERED_LIST_STRUCT`**Provider name**: `tfErrors`**Description**: Output only. Summary of errors encountered during Terraform preview. It has a size limit of 10, i.e. only top 10 errors will be summarized here.

- `error`**Type**: `STRUCT`**Provider name**: `error`**Description**: Output only. Original error response from underlying Google API, if available.
  - `code`**Type**: `INT32`**Provider name**: `code`**Description**: The status code, which should be an enum value of google.rpc.Code.
  - `message`**Type**: `STRING`**Provider name**: `message`**Description**: A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
- `error_description`**Type**: `STRING`**Provider name**: `errorDescription`**Description**: A human-readable error description.
- `http_response_code`**Type**: `INT32`**Provider name**: `httpResponseCode`**Description**: HTTP response code returned from Google Cloud Platform APIs when Terraform fails to provision the resource. If unset or 0, no HTTP response code was returned by Terraform.
- `resource_address`**Type**: `STRING`**Provider name**: `resourceAddress`**Description**: Address of the resource associated with the error, e.g. `google_compute_network.vpc_network`.

## `tf_version`{% #tf_version %}

**Type**: `STRING`**Provider name**: `tfVersion`**Description**: Output only. The current Terraform version set on the preview. It is in the format of "Major.Minor.Patch", for example, "1.3.10".

## `tf_version_constraint`{% #tf_version_constraint %}

**Type**: `STRING`**Provider name**: `tfVersionConstraint`**Description**: Optional. The user-specified Terraform version constraint. Example: "=1.3.10".

## `worker_pool`{% #worker_pool %}

**Type**: `STRING`**Provider name**: `workerPool`**Description**: Optional. The user-specified Worker Pool resource in which the Cloud Build job will execute. Format projects/{project}/locations/{location}/workerPools/{workerPoolId} If this field is unspecified, the default Cloud Build worker pool will be used. If omitted and deployment resource ref provided has worker_pool defined, that worker pool is used.

## `zone_id`{% #zone_id %}

**Type**: `STRING`