StageProps

class aws_cdk.StageProps(*, env=None, outdir=None, permissions_boundary=None, policy_validation_beta1=None, stage_name=None)

Bases: object

Initialization props for a stage.

Parameters:

  • env (Union[Environment, Dict[str, Any], None]) – Default AWS environment (account/region) for Stack``s in this ``Stage. Stacks defined inside this Stage with either region or account missing from its env will use the corresponding field given here. If either region or account``is is not configured for ``Stack (either on the Stack itself or on the containing Stage), the Stack will be environment-agnostic. Environment-agnostic stacks can be deployed to any environment, may not be able to take advantage of all features of the CDK. For example, they will not be able to use environmental context lookups, will not automatically translate Service Principals to the right format based on the environment’s AWS partition, and other such enhancements. Default: - The environments should be configured on the ``Stack``s.

  • outdir (Optional[str]) – The output directory into which to emit synthesized artifacts. Can only be specified if this stage is the root stage (the app). If this is specified and this stage is nested within another stage, an error will be thrown. Default: - for nested stages, outdir will be determined as a relative directory to the outdir of the app. For apps, if outdir is not specified, a temporary directory will be created.

  • permissions_boundary (Optional[PermissionsBoundary]) – Options for applying a permissions boundary to all IAM Roles and Users created within this Stage. Default: - no permissions boundary is applied

  • policy_validation_beta1 (Optional[Sequence[IPolicyValidationPluginBeta1]]) – Validation plugins to run during synthesis. If any plugin reports any violation, synthesis will be interrupted and the report displayed to the user. Default: - no validation plugins are used

  • stage_name (Optional[str]) – Name of this stage. Default: - Derived from the id.

ExampleMetadata:

infused

Example:

# app: App


Stage(app, "DevStage")

Stage(app, "BetaStage",
    permissions_boundary=PermissionsBoundary.from_name("beta-permissions-boundary")
)

Stage(app, "GammaStage",
    permissions_boundary=PermissionsBoundary.from_name("prod-permissions-boundary")
)

Stage(app, "ProdStage",
    permissions_boundary=PermissionsBoundary.from_name("prod-permissions-boundary")
)

Attributes

env

Default AWS environment (account/region) for Stack``s in this ``Stage.

Stacks defined inside this Stage with either region or account missing from its env will use the corresponding field given here.

If either region or account``is is not configured for ``Stack (either on the Stack itself or on the containing Stage), the Stack will be environment-agnostic.

Environment-agnostic stacks can be deployed to any environment, may not be able to take advantage of all features of the CDK. For example, they will not be able to use environmental context lookups, will not automatically translate Service Principals to the right format based on the environment’s AWS partition, and other such enhancements.

Default:

  • The environments should be configured on the ``Stack``s.

Example:

# Use a concrete account and region to deploy this Stage to
Stage(app, "Stage1",
    env=Environment(account="123456789012", region="us-east-1")
)

# Use the CLI's current credentials to determine the target environment
Stage(app, "Stage2",
    env=Environment(account=process.env.CDK_DEFAULT_ACCOUNT, region=process.env.CDK_DEFAULT_REGION)
)
outdir

The output directory into which to emit synthesized artifacts.

Can only be specified if this stage is the root stage (the app). If this is specified and this stage is nested within another stage, an error will be thrown.

Default:

  • for nested stages, outdir will be determined as a relative

directory to the outdir of the app. For apps, if outdir is not specified, a temporary directory will be created.

permissions_boundary

Options for applying a permissions boundary to all IAM Roles and Users created within this Stage.

Default:

  • no permissions boundary is applied

policy_validation_beta1

Validation plugins to run during synthesis.

If any plugin reports any violation, synthesis will be interrupted and the report displayed to the user.

Default:

  • no validation plugins are used

stage_name

Name of this stage.

Default:

  • Derived from the id.