CfnDeploymentProps

class aws_cdk.aws_apigateway.CfnDeploymentProps(*, rest_api_id, deployment_canary_settings=None, description=None, stage_description=None, stage_name=None)

Bases: object

Properties for defining a CfnDeployment.

Parameters:
  • rest_api_id (str) – The string identifier of the associated RestApi.

  • deployment_canary_settings (Union[IResolvable, DeploymentCanarySettingsProperty, Dict[str, Any], None]) – The input configuration for a canary deployment.

  • description (Optional[str]) – The description for the Deployment resource to create.

  • stage_description (Union[IResolvable, StageDescriptionProperty, Dict[str, Any], None]) – The description of the Stage resource for the Deployment resource to create. To specify a stage description, you must also provide a stage name.

  • stage_name (Optional[str]) – The name of the Stage resource for the Deployment resource to create.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-deployment.html

ExampleMetadata:

fixture=_generated

Example:

# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
from aws_cdk import aws_apigateway as apigateway

cfn_deployment_props = apigateway.CfnDeploymentProps(
    rest_api_id="restApiId",

    # the properties below are optional
    deployment_canary_settings=apigateway.CfnDeployment.DeploymentCanarySettingsProperty(
        percent_traffic=123,
        stage_variable_overrides={
            "stage_variable_overrides_key": "stageVariableOverrides"
        },
        use_stage_cache=False
    ),
    description="description",
    stage_description=apigateway.CfnDeployment.StageDescriptionProperty(
        access_log_setting=apigateway.CfnDeployment.AccessLogSettingProperty(
            destination_arn="destinationArn",
            format="format"
        ),
        cache_cluster_enabled=False,
        cache_cluster_size="cacheClusterSize",
        cache_data_encrypted=False,
        cache_ttl_in_seconds=123,
        caching_enabled=False,
        canary_setting=apigateway.CfnDeployment.CanarySettingProperty(
            percent_traffic=123,
            stage_variable_overrides={
                "stage_variable_overrides_key": "stageVariableOverrides"
            },
            use_stage_cache=False
        ),
        client_certificate_id="clientCertificateId",
        data_trace_enabled=False,
        description="description",
        documentation_version="documentationVersion",
        logging_level="loggingLevel",
        method_settings=[apigateway.CfnDeployment.MethodSettingProperty(
            cache_data_encrypted=False,
            cache_ttl_in_seconds=123,
            caching_enabled=False,
            data_trace_enabled=False,
            http_method="httpMethod",
            logging_level="loggingLevel",
            metrics_enabled=False,
            resource_path="resourcePath",
            throttling_burst_limit=123,
            throttling_rate_limit=123
        )],
        metrics_enabled=False,
        tags=[CfnTag(
            key="key",
            value="value"
        )],
        throttling_burst_limit=123,
        throttling_rate_limit=123,
        tracing_enabled=False,
        variables={
            "variables_key": "variables"
        }
    ),
    stage_name="stageName"
)

Attributes

deployment_canary_settings

The input configuration for a canary deployment.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-deployment.html#cfn-apigateway-deployment-deploymentcanarysettings

description

The description for the Deployment resource to create.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-deployment.html#cfn-apigateway-deployment-description

rest_api_id

The string identifier of the associated RestApi.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-deployment.html#cfn-apigateway-deployment-restapiid

stage_description

The description of the Stage resource for the Deployment resource to create.

To specify a stage description, you must also provide a stage name.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-deployment.html#cfn-apigateway-deployment-stagedescription

stage_name

The name of the Stage resource for the Deployment resource to create.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-deployment.html#cfn-apigateway-deployment-stagename