interface CfnStageProps

Language	Type name
.NET	Amazon.CDK.AWS.Apigatewayv2.CfnStageProps
Go	github.com/aws/aws-cdk-go/awscdk/v2/awsapigatewayv2#CfnStageProps
Java	software.amazon.awscdk.services.apigatewayv2.CfnStageProps
Python	aws_cdk.aws_apigatewayv2.CfnStageProps
TypeScript	aws-cdk-lib » aws_apigatewayv2 » CfnStageProps

Properties for defining a CfnStage.

See also: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigatewayv2-stage.html

Example

// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_apigatewayv2 as apigatewayv2 } from 'aws-cdk-lib';

declare const routeSettings: any;
declare const stageVariables: any;
declare const tags: any;
const cfnStageProps: apigatewayv2.CfnStageProps = {
  apiId: 'apiId',
  stageName: 'stageName',

  // the properties below are optional
  accessLogSettings: {
    destinationArn: 'destinationArn',
    format: 'format',
  },
  accessPolicyId: 'accessPolicyId',
  autoDeploy: false,
  clientCertificateId: 'clientCertificateId',
  defaultRouteSettings: {
    dataTraceEnabled: false,
    detailedMetricsEnabled: false,
    loggingLevel: 'loggingLevel',
    throttlingBurstLimit: 123,
    throttlingRateLimit: 123,
  },
  deploymentId: 'deploymentId',
  description: 'description',
  routeSettings: routeSettings,
  stageVariables: stageVariables,
  tags: tags,
};

Properties

Name	Type	Description
apiId	string	The API identifier.
stageName	string	The stage name.
accessLogSettings?	IResolvable | AccessLogSettingsProperty	Settings for logging access in this stage.
accessPolicyId?	string	This parameter is not currently supported.
autoDeploy?	boolean | IResolvable	Specifies whether updates to an API automatically trigger a new deployment.
clientCertificateId?	string	The identifier of a client certificate for a Stage .
defaultRouteSettings?	IResolvable | RouteSettingsProperty	The default route settings for the stage.
deploymentId?	string	The deployment identifier for the API stage.
description?	string	The description for the API stage.
routeSettings?	any	Route settings for the stage.
stageVariables?	any	A map that defines the stage variables for a Stage .
tags?	any	The collection of tags.

---

apiId

Type: string

The API identifier.

See also: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigatewayv2-stage.html#cfn-apigatewayv2-stage-apiid

---

stageName

Type: string

The stage name.

Stage names can contain only alphanumeric characters, hyphens, and underscores, or be $default . Maximum length is 128 characters.

See also: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigatewayv2-stage.html#cfn-apigatewayv2-stage-stagename

---

accessLogSettings?

Type: IResolvable | AccessLogSettingsProperty (optional)

Settings for logging access in this stage.

See also: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigatewayv2-stage.html#cfn-apigatewayv2-stage-accesslogsettings

---

accessPolicyId?

Type: string (optional)

This parameter is not currently supported.

See also: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigatewayv2-stage.html#cfn-apigatewayv2-stage-accesspolicyid

---

autoDeploy?

Type: boolean | IResolvable (optional)

Specifies whether updates to an API automatically trigger a new deployment.

The default value is false .

See also: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigatewayv2-stage.html#cfn-apigatewayv2-stage-autodeploy

---

clientCertificateId?

Type: string (optional)

The identifier of a client certificate for a Stage .

Supported only for WebSocket APIs.

See also: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigatewayv2-stage.html#cfn-apigatewayv2-stage-clientcertificateid

---

defaultRouteSettings?

Type: IResolvable | RouteSettingsProperty (optional)

The default route settings for the stage.

See also: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigatewayv2-stage.html#cfn-apigatewayv2-stage-defaultroutesettings

---

deploymentId?

Type: string (optional)

The deployment identifier for the API stage.

Can't be updated if autoDeploy is enabled.

See also: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigatewayv2-stage.html#cfn-apigatewayv2-stage-deploymentid

---

description?

Type: string (optional)

The description for the API stage.

See also: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigatewayv2-stage.html#cfn-apigatewayv2-stage-description

---

routeSettings?

Type: any (optional)

Route settings for the stage.

See also: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigatewayv2-stage.html#cfn-apigatewayv2-stage-routesettings

---

stageVariables?

Type: any (optional)

A map that defines the stage variables for a Stage .

Variable names can have alphanumeric and underscore characters, and the values must match [A-Za-z0-9-._~:/?#&=,]+.

See also: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigatewayv2-stage.html#cfn-apigatewayv2-stage-stagevariables

---

tags?

Type: any (optional)

The collection of tags.

Each tag element is associated with a given resource.

See also: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigatewayv2-stage.html#cfn-apigatewayv2-stage-tags