addEnvironment

addExistingEnvironment

Adds an extension association to the application.

addExtension

addHostedConfiguration

addSourcedConfiguration

Adds an AT_DEPLOYMENT_TICK extension with the provided event destination and also creates an extension association to an application.

atDeploymentTick

Returns the list of associated environments.

environments

Adds an extension defined by the action point and event destination and also creates an extension association to an application.

Adds an ON_DEPLOYMENT_BAKING extension with the provided event destination and also creates an extension association to an application.

onDeploymentBaking

Adds an ON_DEPLOYMENT_COMPLETE extension with the provided event destination and also creates an extension association to an application.

onDeploymentComplete

Adds an ON_DEPLOYMENT_ROLLED_BACK extension with the provided event destination and also creates an extension association to an application.

onDeploymentRolledBack

Adds an ON_DEPLOYMENT_START extension with the provided event destination and also creates an extension association to an application.

onDeploymentStart

Adds an ON_DEPLOYMENT_STEP extension with the provided event destination and also creates an extension association to an application.

onDeploymentStep

Adds a PRE_CREATE_HOSTED_CONFIGURATION_VERSION extension with the provided event destination and also creates an extension association to an application.

preCreateHostedConfigurationVersion

Adds a PRE_START_DEPLOYMENT extension with the provided event destination and also creates an extension association to an application.

preStartDeployment

Application

applicationName

description

DeploymentStrategy

The rollout strategy for the deployment strategy.

You can use predefined deployment
strategies, such as RolloutStrategy.ALL_AT_ONCE, RolloutStrategy.LINEAR_50_PERCENT_EVERY_30_SECONDS,
or RolloutStrategy.CANARY_10_PERCENT_20_MINUTES.

rolloutStrategy

deploymentStrategyName

A description of the deployment strategy.

An AWS AppConfig environment.

[disable-awslint:no-grants]

Creates a deployment of the supplied configuration to this environment.

Note that you can only deploy one configuration at a time to an environment.
However, you can deploy one configuration each to different environments at the same time.
If more than one deployment is requested for this environment, they will occur in the same order they were provided.

addDeployment

Creates a deployment for each of the supplied configurations to this environment.

These configurations will be deployed in the same order as the input array.

addDeployments

Adds an extension association to the environment.

grant

grantReadConfig

Adds an extension defined by the action point and event destination and also creates an extension association to the environment.

Adds an ON_DEPLOYMENT_BAKING extension with the provided event destination and also creates an extension association to the environment.

Adds an ON_DEPLOYMENT_COMPLETE extension with the provided event destination and also creates an extension association to the environment.

Adds an ON_DEPLOYMENT_ROLLED_BACK extension with the provided event destination and also creates an extension association to the environment.

Adds an ON_DEPLOYMENT_START extension with the provided event destination and also creates an extension association to the environment.

Adds an ON_DEPLOYMENT_STEP extension with the provided event destination and also creates an extension association to the environment.

Adds a PRE_CREATE_HOSTED_CONFIGURATION_VERSION extension with the provided event destination and also creates an extension association to the environment.

Adds a PRE_START_DEPLOYMENT extension with the provided event destination and also creates an extension association to the environment.

Environment

The application to be associated with the environment.

application

A property to prevent accidental deletion of active environments.

deletionProtectionCheck

environmentName

monitors

This class is meant to be used by AWS AppConfig resources (application, configuration profile, environment) directly.

There is currently no use
for this class outside of the AWS AppConfig construct implementation. It is
intended to be used with the resources since there is currently no way to
inherit from two classes (at least within JSII constraints).

Adds an extension association to the derived resource.

Adds an AT_DEPLOYMENT_TICK extension with the provided event destination and also creates an extension association to the derived resource.

Adds an extension defined by the action point and event destination and also creates an extension association to the derived resource.

Adds an ON_DEPLOYMENT_BAKING extension with the provided event destination and also creates an extension association to the derived resource.

Adds an ON_DEPLOYMENT_COMPLETE extension with the provided event destination and also creates an extension association to the derived resource.

Adds an ON_DEPLOYMENT_ROLLED_BACK extension with the provided event destination and also creates an extension association to the derived resource.

Adds an ON_DEPLOYMENT_START extension with the provided event destination and also creates an extension association to the derived resource.

Adds an ON_DEPLOYMENT_STEP extension with the provided event destination and also creates an extension association to the derived resource.

Adds a PRE_CREATE_HOSTED_CONFIGURATION_VERSION extension with the provided event destination and also creates an extension association to the derived resource.

Adds a PRE_START_DEPLOYMENT extension with the provided event destination and also creates an extension association to the derived resource.

ExtensibleBase

Extension

actions

extensionName

The latest version number of the extension.

When you create a new version,
specify the most recent current version number. For example, you create version 3,
enter 2 for this field.

latestVersionNumber

The parameters accepted for the extension.

parameters

A hosted configuration represents configuration stored in the AWS AppConfig hosted configuration store.

Adds an extension association to the configuration profile.

Adds an extension defined by the action point and event destination and also creates an extension association to the configuration profile.

Adds an ON_DEPLOYMENT_BAKING extension with the provided event destination and also creates an extension association to the configuration profile.

Adds an ON_DEPLOYMENT_COMPLETE extension with the provided event destination and also creates an extension association to the configuration profile.

Adds an ON_DEPLOYMENT_ROLLED_BACK extension with the provided event destination and also creates an extension association to the configuration profile.

Adds an ON_DEPLOYMENT_START extension with the provided event destination and also creates an extension association to the configuration profile.

Adds an ON_DEPLOYMENT_STEP extension with the provided event destination and also creates an extension association to the configuration profile.

Adds a PRE_CREATE_HOSTED_CONFIGURATION_VERSION extension with the provided event destination and also creates an extension association to the configuration profile.

Adds a PRE_START_DEPLOYMENT extension with the provided event destination and also creates an extension association to the configuration profile.

HostedConfiguration

content

The customer managed key to encrypt hosted configuration.

kmsKey

The latest version number of the hosted configuration.

The version label of the hosted configuration.

versionLabel

The application associated with the configuration.

A parameter to configure deletion protection.

Deletion protection prevents a user from deleting a configuration profile if your application has called
either `GetLatestConfiguration` or `GetConfiguration` for the configuration profile during the specified interval.

deploymentKey

The deployment strategy for the configuration.

deploymentStrategy

The list of environments to deploy the configuration to.

If this parameter is not specified, then there will be no
deployment created alongside this configuration.

Deployments can be added later using the `IEnvironment.addDeployment` or
`IEnvironment.addDeployments` methods.

deployTo

name

type

validators

A sourced configuration represents configuration stored in an Amazon S3 bucket, AWS Secrets Manager secret, Systems Manager (SSM) Parameter Store parameter, SSM document, or AWS CodePipeline.

SourcedConfiguration

The location where the configuration is stored.

location

The IAM role to retrieve the configuration.

retrievalRole

The version number of the sourced configuration to deploy.

If this is not specified,
then there will be no deployment.

versionNumber

The `AWS::AppConfig::Application` resource creates an application.

In AWS AppConfig , an application is simply an organizational construct like a folder. This organizational construct has a relationship with some unit of executable code. For example, you could create an application called MyMobileApp to organize and manage configuration data for a mobile application installed by your users.

AWS AppConfig requires that you create resources and deploy a configuration in the following order:

- Create an application
- Create an environment
- Create a configuration profile
- Choose a pre-defined deployment strategy or create your own
- Deploy the configuration

For more information, see [AWS AppConfig](https://docs.aws.amazon.com/appconfig/latest/userguide/what-is-appconfig.html) in the *AWS AppConfig User Guide* .

CfnApplication

Metadata to assign to the application.

Tags help organize and categorize your AWS AppConfig resources. Each tag consists of a key and an optional value, both of which you define.

CfnConfigurationProfile

applicationId

A URI to locate the configuration. You can specify the following:.

- For the AWS AppConfig hosted configuration store and for feature flags, specify `hosted` .
- For an AWS Systems Manager Parameter Store parameter, specify either the parameter name in the format `ssm-parameter://<parameter name>` or the ARN.
- For an AWS CodePipeline pipeline, specify the URI in the following format: `codepipeline` ://<pipeline name>.
- For an AWS Secrets Manager secret, specify the URI in the following format: `secretsmanager` ://<secret name>.
- For an Amazon S3 object, specify the URI in the following format: `s3://<bucket>/<objectKey>` . Here is an example: `s3://amzn-s3-demo-bucket/my-app/us-east-1/my-config.json`
- For an SSM document, specify either the document name in the format `ssm-document://<document name>` or the Amazon Resource Name (ARN).

locationUri

A parameter to configure deletion protection.

Deletion protection prevents a user from deleting a configuration profile if your application has called either [GetLatestConfiguration](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_appconfigdata_GetLatestConfiguration.html) or [GetConfiguration](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_GetConfiguration.html) for the configuration profile during the specified interval.

This parameter supports the following values:

- `BYPASS` : Instructs AWS AppConfig to bypass the deletion protection check and delete a configuration profile even if deletion protection would have otherwise prevented it.
- `APPLY` : Instructs the deletion protection check to run, even if deletion protection is disabled at the account level. `APPLY` also forces the deletion protection check to run against resources created in the past hour, which are normally excluded from deletion protection checks.
- `ACCOUNT_DEFAULT` : The default setting, which instructs AWS AppConfig to implement the deletion protection value specified in the `UpdateAccountSettings` API.

A description of the configuration profile.

The AWS Key Management Service key identifier (key ID, key alias, or key ARN) provided when the resource was created or updated.

kmsKeyIdentifier

The ARN of an IAM role with permission to access the configuration at the specified `LocationUri` .

> A retrieval role ARN is not required for configurations stored in AWS CodePipeline or the AWS AppConfig hosted configuration store. It is required for all other sources that store your configuration.

retrievalRoleArn

Metadata to assign to the configuration profile.

Tags help organize and categorize your AWS AppConfig resources. Each tag consists of a key and an optional value, both of which you define.

The type of configurations contained in the profile.

AWS AppConfig supports `feature flags` and `freeform` configurations. We recommend you create feature flag configurations to enable or disable new features and freeform configurations to distribute configurations to an application. When calling this API, enter one of the following values for `Type` :

`AWS.AppConfig.FeatureFlags`

`AWS.Freeform`

A list of methods for validating the configuration.

The `AWS::AppConfig::Deployment` resource starts a deployment.

Starting a deployment in AWS AppConfig calls the `StartDeployment` API action. This call includes the IDs of the AWS AppConfig application, the environment, the configuration profile, and (optionally) the configuration data version to deploy. The call also includes the ID of the deployment strategy to use, which determines how the configuration data is deployed.

AWS AppConfig monitors the distribution to all hosts and reports status. If a distribution fails, then AWS AppConfig rolls back the configuration.

AWS AppConfig requires that you create resources and deploy a configuration in the following order:

- Create an application
- Create an environment
- Create a configuration profile
- Choose a pre-defined deployment strategy or create your own
- Deploy the configuration

For more information, see [AWS AppConfig](https://docs.aws.amazon.com/appconfig/latest/userguide/what-is-appconfig.html) in the *AWS AppConfig User Guide* .

CfnDeployment

configurationProfileId

The configuration version to deploy.

If deploying an AWS AppConfig hosted configuration version, you can specify either the version number or version label. For all other configurations, you must specify the version number.

configurationVersion

deploymentStrategyId

environmentId

A map of dynamic extension parameter names to values to pass to associated extensions with `PRE_START_DEPLOYMENT` actions.

dynamicExtensionParameters

Metadata to assign to the deployment.

Tags help organize and categorize your AWS AppConfig resources. Each tag consists of a key and an optional value, both of which you define.

The `AWS::AppConfig::DeploymentStrategy` resource creates an AWS AppConfig deployment strategy.

A deployment strategy defines important criteria for rolling out your configuration to the designated targets. A deployment strategy includes: the overall duration required, a percentage of targets to receive the deployment during each interval, an algorithm that defines how percentage grows, and bake time.

AWS AppConfig requires that you create resources and deploy a configuration in the following order:

- Create an application
- Create an environment
- Create a configuration profile
- Choose a pre-defined deployment strategy or create your own
- Deploy the configuration

For more information, see [AWS AppConfig](https://docs.aws.amazon.com/appconfig/latest/userguide/what-is-appconfig.html) in the *AWS AppConfig User Guide* .

CfnDeploymentStrategy

Total amount of time for a deployment to last.

deploymentDurationInMinutes

The percentage of targets to receive a deployed configuration during each interval.

growthFactor

Save the deployment strategy to a Systems Manager (SSM) document.

replicateTo

Specifies the amount of time AWS AppConfig monitors for Amazon CloudWatch alarms after the configuration has been deployed to 100% of its targets, before considering the deployment to be complete.

If an alarm is triggered during this time, AWS AppConfig rolls back the deployment. You must configure permissions for AWS AppConfig to roll back based on CloudWatch alarms. For more information, see [Configuring permissions for rollback based on Amazon CloudWatch alarms](https://docs.aws.amazon.com/appconfig/latest/userguide/getting-started-with-appconfig-cloudwatch-alarms-permissions.html) in the *AWS AppConfig User Guide* .

finalBakeTimeInMinutes

The algorithm used to define how percentage grows over time. AWS AppConfig supports the following growth types:.

*Linear* : For this type, AWS AppConfig processes the deployment by dividing the total number of targets by the value specified for `Step percentage` . For example, a linear deployment that uses a `Step percentage` of 10 deploys the configuration to 10 percent of the hosts. After those deployments are complete, the system deploys the configuration to the next 10 percent. This continues until 100% of the targets have successfully received the configuration.

*Exponential* : For this type, AWS AppConfig processes the deployment exponentially using the following formula: `G*(2^N)` . In this formula, `G` is the growth factor specified by the user and `N` is the number of steps until the configuration is deployed to all targets. For example, if you specify a growth factor of 2, then the system rolls out the configuration as follows:

`2*(2^0)`

`2*(2^1)`

`2*(2^2)`

Expressed numerically, the deployment rolls out as follows: 2% of the targets, 4% of the targets, 8% of the targets, and continues until the configuration has been deployed to all targets.

growthType

Assigns metadata to an AWS AppConfig resource.

Tags help organize and categorize your AWS AppConfig resources. Each tag consists of a key and an optional value, both of which you define. You can specify a maximum of 50 tags for a resource.

The `AWS::AppConfig::Environment` resource creates an environment, which is a logical deployment group of AWS AppConfig targets, such as applications in a `Beta` or `Production` environment.

You define one or more environments for each AWS AppConfig application. You can also define environments for application subcomponents such as the `Web` , `Mobile` and `Back-end` components for your application. You can configure Amazon CloudWatch alarms for each environment. The system monitors alarms during a configuration deployment. If an alarm is triggered, the system rolls back the configuration.

AWS AppConfig requires that you create resources and deploy a configuration in the following order:

- Create an application
- Create an environment
- Create a configuration profile
- Choose a pre-defined deployment strategy or create your own
- Deploy the configuration

For more information, see [AWS AppConfig](https://docs.aws.amazon.com/appconfig/latest/userguide/what-is-appconfig.html) in the *AWS AppConfig User Guide* .

CfnEnvironment

A parameter to configure deletion protection.

Deletion protection prevents a user from deleting an environment if your application called either [GetLatestConfiguration](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_appconfigdata_GetLatestConfiguration.html) or [GetConfiguration](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_GetConfiguration.html) in the environment during the specified interval.

This parameter supports the following values:

- `BYPASS` : Instructs AWS AppConfig to bypass the deletion protection check and delete a configuration profile even if deletion protection would have otherwise prevented it.
- `APPLY` : Instructs the deletion protection check to run, even if deletion protection is disabled at the account level. `APPLY` also forces the deletion protection check to run against resources created in the past hour, which are normally excluded from deletion protection checks.
- `ACCOUNT_DEFAULT` : The default setting, which instructs AWS AppConfig to implement the deletion protection value specified in the `UpdateAccountSettings` API.

Amazon CloudWatch alarms to monitor during the deployment process.

Metadata to assign to the environment.

Tags help organize and categorize your AWS AppConfig resources. Each tag consists of a key and an optional value, both of which you define.

Creates an AWS AppConfig extension.

An extension augments your ability to inject logic or behavior at different points during the AWS AppConfig workflow of creating or deploying a configuration.

You can create your own extensions or use the AWS authored extensions provided by AWS AppConfig . For an AWS AppConfig extension that uses AWS Lambda , you must create a Lambda function to perform any computation and processing defined in the extension. If you plan to create custom versions of the AWS authored notification extensions, you only need to specify an Amazon Resource Name (ARN) in the `Uri` field for the new extension version.

- For a custom EventBridge notification extension, enter the ARN of the EventBridge default events in the `Uri` field.
- For a custom Amazon SNS notification extension, enter the ARN of an Amazon SNS topic in the `Uri` field.
- For a custom Amazon SQS notification extension, enter the ARN of an Amazon SQS message queue in the `Uri` field.

For more information about extensions, see [Extending workflows](https://docs.aws.amazon.com/appconfig/latest/userguide/working-with-appconfig-extensions.html) in the *AWS AppConfig User Guide* .

CfnExtension

A name for the extension.

Each extension name in your account must be unique. Extension versions use the same name.

You can omit this field when you create an extension.

When you create a new version, specify the most recent current version number. For example, you create version 3, enter 2 for this field.

The parameters accepted by the extension.

You specify parameter values when you associate the extension to an AWS AppConfig resource by using the `CreateExtensionAssociation` API action. For AWS Lambda extension actions, these parameters are included in the Lambda request object.

Adds one or more tags for the specified extension.

Tags are metadata that help you categorize resources in different ways, for example, by purpose, owner, or environment. Each tag consists of a key and an optional value, both of which you define.

When you create an extension or configure an AWS authored extension, you associate the extension with an AWS AppConfig application, environment, or configuration profile.

For example, you can choose to run the `AWS AppConfig deployment events to Amazon SNS` AWS authored extension and receive notifications on an Amazon SNS topic anytime a configuration deployment is started for a specific application. Defining which extension to associate with an AWS AppConfig resource is called an *extension association* . An extension association is a specified relationship between an extension and an AWS AppConfig resource, such as an application or a configuration profile. For more information about extensions and associations, see [Extending workflows](https://docs.aws.amazon.com/appconfig/latest/userguide/working-with-appconfig-extensions.html) in the *AWS AppConfig User Guide* .

CfnExtensionAssociation

The name, the ID, or the Amazon Resource Name (ARN) of the extension.

extensionIdentifier

The version number of the extension.

If not specified, AWS AppConfig uses the maximum version of the extension.

extensionVersionNumber

The parameter names and values defined in the extensions.

Extension parameters marked `Required` must be entered for this field.

The ARN of an application, configuration profile, or environment.

resourceIdentifier

Adds one or more tags for the specified extension association.

Tags are metadata that help you categorize resources in different ways, for example, by purpose, owner, or environment. Each tag consists of a key and an optional value, both of which you define.

Create a new configuration in the AWS AppConfig hosted configuration store.

Configurations must be 1 MB or smaller. The AWS AppConfig hosted configuration store provides the following benefits over other configuration store options.

- You don't need to set up and configure other services such as Amazon Simple Storage Service ( Amazon S3 ) or Parameter Store.
- You don't need to configure AWS Identity and Access Management ( IAM ) permissions to use the configuration store.
- You can store configurations in any content type.
- There is no cost to use the store.
- You can create a configuration and add it to the store when you create a configuration profile.

CfnHostedConfigurationVersion

The configuration data, as bytes.

> AWS AppConfig accepts any type of data, including text formats like JSON or TOML, or binary formats like protocol buffers or compressed data.

A standard MIME type describing the format of the configuration content.

For more information, see [Content-Type](https://docs.aws.amazon.com/https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.17) .

contentType

A description of the configuration.

> Due to HTTP limitations, this field only supports ASCII characters.

An optional locking token used to prevent race conditions from overwriting configuration updates when creating a new version.

To ensure your data is not overwritten when creating multiple hosted configuration versions in rapid succession, specify the version number of the latest hosted configuration version.

A user-defined label for an AWS AppConfig hosted configuration version.

AWS appconfig

L2 Constructs7