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

# aws_apigateway_stage{% #aws_apigateway_stage %}

## `access_log_settings`{% #access_log_settings %}

**Type**: `STRUCT`**Provider name**: `accessLogSettings`**Description**: Settings for logging access in this stage.

- `destination_arn`**Type**: `STRING`**Provider name**: `destinationArn`**Description**: The Amazon Resource Name (ARN) of the CloudWatch Logs log group or Kinesis Data Firehose delivery stream to receive access logs. If you specify a Kinesis Data Firehose delivery stream, the stream name must begin with `amazon-apigateway-`.
- `format`**Type**: `STRING`**Provider name**: `format`**Description**: A single line format of the access logs of data, as specified by selected $context variables. The format must include at least `$context.requestId`.

## `account_id`{% #account_id %}

**Type**: `STRING`

## `cache_cluster_enabled`{% #cache_cluster_enabled %}

**Type**: `BOOLEAN`**Provider name**: `cacheClusterEnabled`**Description**: Specifies whether a cache cluster is enabled for the stage.

## `cache_cluster_size`{% #cache_cluster_size %}

**Type**: `STRING`**Provider name**: `cacheClusterSize`**Description**: The stage's cache capacity in GB. For more information about choosing a cache size, see [Enabling API caching to enhance responsiveness](https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-caching.html).

## `cache_cluster_status`{% #cache_cluster_status %}

**Type**: `STRING`**Provider name**: `cacheClusterStatus`**Description**: The status of the cache cluster for the stage, if enabled.

## `canary_settings`{% #canary_settings %}

**Type**: `STRUCT`**Provider name**: `canarySettings`**Description**: Settings for the canary deployment in this stage.

- `deployment_id`**Type**: `STRING`**Provider name**: `deploymentId`**Description**: The ID of the canary deployment.
- `percent_traffic`**Type**: `DOUBLE`**Provider name**: `percentTraffic`**Description**: The percent (0-100) of traffic diverted to a canary deployment.
- `stage_variable_overrides`**Type**: `MAP_STRING_STRING`**Provider name**: `stageVariableOverrides`**Description**: Stage variables overridden for a canary release deployment, including new stage variables introduced in the canary. These stage variables are represented as a string-to-string map between stage variable names and their values.
- `use_stage_cache`**Type**: `BOOLEAN`**Provider name**: `useStageCache`**Description**: A Boolean flag to indicate whether the canary deployment uses the stage cache or not.

## `client_certificate_id`{% #client_certificate_id %}

**Type**: `STRING`**Provider name**: `clientCertificateId`**Description**: The identifier of a client certificate for an API stage.

## `created_date`{% #created_date %}

**Type**: `TIMESTAMP`**Provider name**: `createdDate`**Description**: The timestamp when the stage was created.

## `deployment_id`{% #deployment_id %}

**Type**: `STRING`**Provider name**: `deploymentId`**Description**: The identifier of the Deployment that the stage points to.

## `description`{% #description %}

**Type**: `STRING`**Provider name**: `description`**Description**: The stage's description.

## `documentation_version`{% #documentation_version %}

**Type**: `STRING`**Provider name**: `documentationVersion`**Description**: The version of the associated API documentation.

## `last_updated_date`{% #last_updated_date %}

**Type**: `TIMESTAMP`**Provider name**: `lastUpdatedDate`**Description**: The timestamp when the stage last updated.

## `method_settings`{% #method_settings %}

**Type**: `STRING`**Provider name**: `methodSettings`**Description**: A map that defines the method settings for a Stage resource. Keys (designated as `/{method_setting_key` below) are method paths defined as `{resource_path}/{http_method}` for an individual method override, or `/*/*` for overriding all methods in the stage.

## `stage_arn`{% #stage_arn %}

**Type**: `STRING`

## `stage_name`{% #stage_name %}

**Type**: `STRING`**Provider name**: `stageName`**Description**: The name of the stage is the first path segment in the Uniform Resource Identifier (URI) of a call to API Gateway. Stage names can only contain alphanumeric characters, hyphens, and underscores. Maximum length is 128 characters.

## `tags`{% #tags %}

**Type**: `UNORDERED_LIST_STRING`

## `tracing_enabled`{% #tracing_enabled %}

**Type**: `BOOLEAN`**Provider name**: `tracingEnabled`**Description**: Specifies whether active tracing with X-ray is enabled for the Stage.

## `variables`{% #variables %}

**Type**: `MAP_STRING_STRING`**Provider name**: `variables`**Description**: A map that defines the stage variables for a Stage resource. Variable names can have alphanumeric and underscore characters, and the values must match `[A-Za-z0-9-._~:/?#&=,]+`.

## `web_acl_arn`{% #web_acl_arn %}

**Type**: `STRING`**Provider name**: `webAclArn`**Description**: The ARN of the WebAcl associated with the Stage.