aws-cdk-lib 2.138.0__py3-none-any.whl → 2.139.0__py3-none-any.whl

aws_cdk/aws_appconfig/__init__.py

@@ -257,8 +257,7 @@ appconfig.HostedConfiguration(self, "MyHostedConfiguration",
 )
 ```
 
-The `deployTo` parameter is used to specify which environments to deploy the configuration to. If this parameter is not
-specified, there will not be a deployment.
+The `deployTo` parameter is used to specify which environments to deploy the configuration to.
 
 A hosted configuration with `deployTo`:
 
@@ -274,6 +273,96 @@ appconfig.HostedConfiguration(self, "MyHostedConfiguration",
 )
 ```
 
+When more than one configuration is set to deploy to the same environment, the
+deployments will occur one at a time. This is done to satisfy
+[AppConfig's constraint](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-deploying.html):
+
+> [!NOTE]
+> 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.
+
+The deployment order matches the order in which the configurations are declared.
+
+```python
+app = appconfig.Application(self, "MyApp")
+env = appconfig.Environment(self, "MyEnv",
+    application=app
+)
+
+appconfig.HostedConfiguration(self, "MyFirstHostedConfig",
+    application=app,
+    deploy_to=[env],
+    content=appconfig.ConfigurationContent.from_inline_text("This is my first configuration content.")
+)
+
+appconfig.HostedConfiguration(self, "MySecondHostedConfig",
+    application=app,
+    deploy_to=[env],
+    content=appconfig.ConfigurationContent.from_inline_text("This is my second configuration content.")
+)
+```
+
+If an application would benefit from a deployment order that differs from the
+declared order, you can defer the decision by using `IEnvironment.addDeployment`
+rather than the `deployTo` property.
+In this example, `firstConfig` will be deployed before `secondConfig`.
+
+```python
+app = appconfig.Application(self, "MyApp")
+env = appconfig.Environment(self, "MyEnv",
+    application=app
+)
+
+second_config = appconfig.HostedConfiguration(self, "MySecondHostedConfig",
+    application=app,
+    content=appconfig.ConfigurationContent.from_inline_text("This is my second configuration content.")
+)
+
+first_config = appconfig.HostedConfiguration(self, "MyFirstHostedConfig",
+    application=app,
+    deploy_to=[env],
+    content=appconfig.ConfigurationContent.from_inline_text("This is my first configuration content.")
+)
+
+env.add_deployment(second_config)
+```
+
+Alternatively, you can defer multiple deployments in favor of
+`IEnvironment.addDeployments`, which allows you to declare multiple
+configurations in the order they will be deployed.
+In this example the deployment order will be
+`firstConfig`, then `secondConfig`, and finally `thirdConfig`.
+
+```python
+app = appconfig.Application(self, "MyApp")
+env = appconfig.Environment(self, "MyEnv",
+    application=app
+)
+
+second_config = appconfig.HostedConfiguration(self, "MySecondHostedConfig",
+    application=app,
+    content=appconfig.ConfigurationContent.from_inline_text("This is my second configuration content.")
+)
+
+third_config = appconfig.HostedConfiguration(self, "MyThirdHostedConfig",
+    application=app,
+    content=appconfig.ConfigurationContent.from_inline_text("This is my third configuration content.")
+)
+
+first_config = appconfig.HostedConfiguration(self, "MyFirstHostedConfig",
+    application=app,
+    content=appconfig.ConfigurationContent.from_inline_text("This is my first configuration content.")
+)
+
+env.add_deployments(first_config, second_config, third_config)
+```
+
+Any mix of `deployTo`, `addDeployment`, and `addDeployments` is permitted.
+The declaration order will be respected regardless of the approach used.
+
+> [!IMPORTANT]
+> If none of these options are utilized, there will not be any deployments.
+
 ### SourcedConfiguration
 
 A sourced configuration represents configuration stored in any of the following:
@@ -4584,13 +4673,15 @@ class ConfigurationContent(
 
     Example::
 
-        # application: appconfig.Application
-        
+        app = appconfig.Application(self, "MyApp")
+        env = appconfig.Environment(self, "MyEnv",
+            application=app
+        )
         
-        appconfig.HostedConfiguration(self, "MyHostedConfiguration",
-            application=application,
-            content=appconfig.ConfigurationContent.from_inline_text("This is my configuration content."),
-            type=appconfig.ConfigurationType.FEATURE_FLAGS
+        appconfig.HostedConfiguration(self, "MyHostedConfig",
+            application=app,
+            deploy_to=[env],
+            content=appconfig.ConfigurationContent.from_inline_text("This is my configuration content.")
         )
     '''
 
@@ -4736,7 +4827,7 @@ class ConfigurationOptions:
 
         :param deployment_key: The deployment key of the configuration. Default: - None.
         :param deployment_strategy: The deployment strategy for the configuration. Default: - A deployment strategy with the rollout strategy set to RolloutStrategy.CANARY_10_PERCENT_20_MINUTES
-        :param deploy_to: The list of environments to deploy the configuration to. If this parameter is not specified, then there will be no deployment. Default: - None.
+        :param deploy_to: 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. Default: - None.
         :param description: The description of the configuration. Default: - No description.
         :param name: The name of the configuration. Default: - A name is generated.
         :param type: The type of configuration. Default: ConfigurationType.FREEFORM
@@ -4817,7 +4908,10 @@ class ConfigurationOptions:
         '''The list of environments to deploy the configuration to.
 
         If this parameter is not specified, then there will be no
-        deployment.
+        deployment created alongside this configuration.
+
+        Deployments can be added later using the ``IEnvironment.addDeployment`` or
+        ``IEnvironment.addDeployments`` methods.
 
         :default: - None.
         '''
@@ -4903,7 +4997,7 @@ class ConfigurationProps(ConfigurationOptions):
 
         :param deployment_key: The deployment key of the configuration. Default: - None.
         :param deployment_strategy: The deployment strategy for the configuration. Default: - A deployment strategy with the rollout strategy set to RolloutStrategy.CANARY_10_PERCENT_20_MINUTES
-        :param deploy_to: The list of environments to deploy the configuration to. If this parameter is not specified, then there will be no deployment. Default: - None.
+        :param deploy_to: 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. Default: - None.
         :param description: The description of the configuration. Default: - No description.
         :param name: The name of the configuration. Default: - A name is generated.
         :param type: The type of configuration. Default: ConfigurationType.FREEFORM
@@ -4992,7 +5086,10 @@ class ConfigurationProps(ConfigurationOptions):
         '''The list of environments to deploy the configuration to.
 
         If this parameter is not specified, then there will be no
-        deployment.
+        deployment created alongside this configuration.
+
+        Deployments can be added later using the ``IEnvironment.addDeployment`` or
+        ``IEnvironment.addDeployments`` methods.
 
         :default: - None.
         '''
@@ -5679,10 +5776,16 @@ class EnvironmentProps(EnvironmentOptions):
                 application=app
             )
             
-            appconfig.HostedConfiguration(self, "MyHostedConfig",
+            appconfig.HostedConfiguration(self, "MyFirstHostedConfig",
                 application=app,
                 deploy_to=[env],
-                content=appconfig.ConfigurationContent.from_inline_text("This is my configuration content.")
+                content=appconfig.ConfigurationContent.from_inline_text("This is my first configuration content.")
+            )
+            
+            appconfig.HostedConfiguration(self, "MySecondHostedConfig",
+                application=app,
+                deploy_to=[env],
+                content=appconfig.ConfigurationContent.from_inline_text("This is my second configuration content.")
             )
         '''
         if __debug__:
@@ -6166,7 +6269,7 @@ class HostedConfigurationOptions(ConfigurationOptions):
 
         :param deployment_key: The deployment key of the configuration. Default: - None.
         :param deployment_strategy: The deployment strategy for the configuration. Default: - A deployment strategy with the rollout strategy set to RolloutStrategy.CANARY_10_PERCENT_20_MINUTES
-        :param deploy_to: The list of environments to deploy the configuration to. If this parameter is not specified, then there will be no deployment. Default: - None.
+        :param deploy_to: 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. Default: - None.
         :param description: The description of the configuration. Default: - No description.
         :param name: The name of the configuration. Default: - A name is generated.
         :param type: The type of configuration. Default: ConfigurationType.FREEFORM
@@ -6265,7 +6368,10 @@ class HostedConfigurationOptions(ConfigurationOptions):
         '''The list of environments to deploy the configuration to.
 
         If this parameter is not specified, then there will be no
-        deployment.
+        deployment created alongside this configuration.
+
+        Deployments can be added later using the ``IEnvironment.addDeployment`` or
+        ``IEnvironment.addDeployments`` methods.
 
         :default: - None.
         '''
@@ -6382,7 +6488,7 @@ class HostedConfigurationProps(ConfigurationProps):
 
         :param deployment_key: The deployment key of the configuration. Default: - None.
         :param deployment_strategy: The deployment strategy for the configuration. Default: - A deployment strategy with the rollout strategy set to RolloutStrategy.CANARY_10_PERCENT_20_MINUTES
-        :param deploy_to: The list of environments to deploy the configuration to. If this parameter is not specified, then there will be no deployment. Default: - None.
+        :param deploy_to: 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. Default: - None.
         :param description: The description of the configuration. Default: - No description.
         :param name: The name of the configuration. Default: - A name is generated.
         :param type: The type of configuration. Default: ConfigurationType.FREEFORM
@@ -6396,13 +6502,15 @@ class HostedConfigurationProps(ConfigurationProps):
 
         Example::
 
-            # application: appconfig.Application
-            
+            app = appconfig.Application(self, "MyApp")
+            env = appconfig.Environment(self, "MyEnv",
+                application=app
+            )
             
-            appconfig.HostedConfiguration(self, "MyHostedConfiguration",
-                application=application,
-                content=appconfig.ConfigurationContent.from_inline_text("This is my configuration content."),
-                type=appconfig.ConfigurationType.FEATURE_FLAGS
+            appconfig.HostedConfiguration(self, "MyHostedConfig",
+                application=app,
+                deploy_to=[env],
+                content=appconfig.ConfigurationContent.from_inline_text("This is my configuration content.")
             )
         '''
         if __debug__:
@@ -6467,7 +6575,10 @@ class HostedConfigurationProps(ConfigurationProps):
         '''The list of environments to deploy the configuration to.
 
         If this parameter is not specified, then there will be no
-        deployment.
+        deployment created alongside this configuration.
+
+        Deployments can be added later using the ``IEnvironment.addDeployment`` or
+        ``IEnvironment.addDeployments`` methods.
 
         :default: - None.
         '''
@@ -6644,7 +6755,7 @@ class IApplication(_IResource_c80c4260, typing_extensions.Protocol):
         :param version_label: The version label of the hosted configuration. Default: - None.
         :param deployment_key: The deployment key of the configuration. Default: - None.
         :param deployment_strategy: The deployment strategy for the configuration. Default: - A deployment strategy with the rollout strategy set to RolloutStrategy.CANARY_10_PERCENT_20_MINUTES
-        :param deploy_to: The list of environments to deploy the configuration to. If this parameter is not specified, then there will be no deployment. Default: - None.
+        :param deploy_to: 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. Default: - None.
         :param description: The description of the configuration. Default: - No description.
         :param name: The name of the configuration. Default: - A name is generated.
         :param type: The type of configuration. Default: ConfigurationType.FREEFORM
@@ -6676,7 +6787,7 @@ class IApplication(_IResource_c80c4260, typing_extensions.Protocol):
         :param version_number: The version number of the sourced configuration to deploy. If this is not specified, then there will be no deployment. Default: - None.
         :param deployment_key: The deployment key of the configuration. Default: - None.
         :param deployment_strategy: The deployment strategy for the configuration. Default: - A deployment strategy with the rollout strategy set to RolloutStrategy.CANARY_10_PERCENT_20_MINUTES
-        :param deploy_to: The list of environments to deploy the configuration to. If this parameter is not specified, then there will be no deployment. Default: - None.
+        :param deploy_to: 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. Default: - None.
         :param description: The description of the configuration. Default: - No description.
         :param name: The name of the configuration. Default: - A name is generated.
         :param type: The type of configuration. Default: ConfigurationType.FREEFORM
@@ -6960,7 +7071,7 @@ class _IApplicationProxy(
         :param version_label: The version label of the hosted configuration. Default: - None.
         :param deployment_key: The deployment key of the configuration. Default: - None.
         :param deployment_strategy: The deployment strategy for the configuration. Default: - A deployment strategy with the rollout strategy set to RolloutStrategy.CANARY_10_PERCENT_20_MINUTES
-        :param deploy_to: The list of environments to deploy the configuration to. If this parameter is not specified, then there will be no deployment. Default: - None.
+        :param deploy_to: 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. Default: - None.
         :param description: The description of the configuration. Default: - No description.
         :param name: The name of the configuration. Default: - A name is generated.
         :param type: The type of configuration. Default: ConfigurationType.FREEFORM
@@ -7008,7 +7119,7 @@ class _IApplicationProxy(
         :param version_number: The version number of the sourced configuration to deploy. If this is not specified, then there will be no deployment. Default: - None.
         :param deployment_key: The deployment key of the configuration. Default: - None.
         :param deployment_strategy: The deployment strategy for the configuration. Default: - A deployment strategy with the rollout strategy set to RolloutStrategy.CANARY_10_PERCENT_20_MINUTES
-        :param deploy_to: The list of environments to deploy the configuration to. If this parameter is not specified, then there will be no deployment. Default: - None.
+        :param deploy_to: 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. Default: - None.
         :param description: The description of the configuration. Default: - No description.
         :param name: The name of the configuration. Default: - A name is generated.
         :param type: The type of configuration. Default: ConfigurationType.FREEFORM
@@ -7586,6 +7697,28 @@ class IEnvironment(_IResource_c80c4260, typing_extensions.Protocol):
         '''The name of the environment.'''
         ...
 
+    @jsii.member(jsii_name="addDeployment")
+    def add_deployment(self, configuration: IConfiguration) -> None:
+        '''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.
+
+        :param configuration: The configuration that will be deployed to this environment.
+        '''
+        ...
+
+    @jsii.member(jsii_name="addDeployments")
+    def add_deployments(self, *configurations: IConfiguration) -> None:
+        '''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.
+
+        :param configurations: The configurations that will be deployed to this environment.
+        '''
+        ...
+
     @jsii.member(jsii_name="addExtension")
     def add_extension(self, extension: "IExtension") -> None:
         '''Adds an extension association to the environment.
@@ -7810,6 +7943,34 @@ class _IEnvironmentProxy(
         '''The name of the environment.'''
         return typing.cast(typing.Optional[builtins.str], jsii.get(self, "name"))
 
+    @jsii.member(jsii_name="addDeployment")
+    def add_deployment(self, configuration: IConfiguration) -> None:
+        '''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.
+
+        :param configuration: The configuration that will be deployed to this environment.
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__3f39f9fc38c2348c1cbb526adb681012a66d9e97575dc37ba0af87ab3bc3eddc)
+            check_type(argname="argument configuration", value=configuration, expected_type=type_hints["configuration"])
+        return typing.cast(None, jsii.invoke(self, "addDeployment", [configuration]))
+
+    @jsii.member(jsii_name="addDeployments")
+    def add_deployments(self, *configurations: IConfiguration) -> None:
+        '''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.
+
+        :param configurations: The configurations that will be deployed to this environment.
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__44b48a1bae27d9166bf28c62529963c2221d313260dbc1e9f5239536a54010d5)
+            check_type(argname="argument configurations", value=configurations, expected_type=typing.Tuple[type_hints["configurations"], ...]) # pyright: ignore [reportGeneralTypeIssues]
+        return typing.cast(None, jsii.invoke(self, "addDeployments", [*configurations]))
+
     @jsii.member(jsii_name="addExtension")
     def add_extension(self, extension: "IExtension") -> None:
         '''Adds an extension association to the environment.
@@ -9550,7 +9711,7 @@ class SourcedConfiguration(
         :param application: The application associated with the configuration.
         :param deployment_key: The deployment key of the configuration. Default: - None.
         :param deployment_strategy: The deployment strategy for the configuration. Default: - A deployment strategy with the rollout strategy set to RolloutStrategy.CANARY_10_PERCENT_20_MINUTES
-        :param deploy_to: The list of environments to deploy the configuration to. If this parameter is not specified, then there will be no deployment. Default: - None.
+        :param deploy_to: 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. Default: - None.
         :param description: The description of the configuration. Default: - No description.
         :param name: The name of the configuration. Default: - A name is generated.
         :param type: The type of configuration. Default: ConfigurationType.FREEFORM
@@ -9987,7 +10148,7 @@ class SourcedConfigurationOptions(ConfigurationOptions):
 
         :param deployment_key: The deployment key of the configuration. Default: - None.
         :param deployment_strategy: The deployment strategy for the configuration. Default: - A deployment strategy with the rollout strategy set to RolloutStrategy.CANARY_10_PERCENT_20_MINUTES
-        :param deploy_to: The list of environments to deploy the configuration to. If this parameter is not specified, then there will be no deployment. Default: - None.
+        :param deploy_to: 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. Default: - None.
         :param description: The description of the configuration. Default: - No description.
         :param name: The name of the configuration. Default: - A name is generated.
         :param type: The type of configuration. Default: ConfigurationType.FREEFORM
@@ -10088,7 +10249,10 @@ class SourcedConfigurationOptions(ConfigurationOptions):
         '''The list of environments to deploy the configuration to.
 
         If this parameter is not specified, then there will be no
-        deployment.
+        deployment created alongside this configuration.
+
+        Deployments can be added later using the ``IEnvironment.addDeployment`` or
+        ``IEnvironment.addDeployments`` methods.
 
         :default: - None.
         '''
@@ -10208,7 +10372,7 @@ class SourcedConfigurationProps(ConfigurationProps):
 
         :param deployment_key: The deployment key of the configuration. Default: - None.
         :param deployment_strategy: The deployment strategy for the configuration. Default: - A deployment strategy with the rollout strategy set to RolloutStrategy.CANARY_10_PERCENT_20_MINUTES
-        :param deploy_to: The list of environments to deploy the configuration to. If this parameter is not specified, then there will be no deployment. Default: - None.
+        :param deploy_to: 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. Default: - None.
         :param description: The description of the configuration. Default: - No description.
         :param name: The name of the configuration. Default: - A name is generated.
         :param type: The type of configuration. Default: ConfigurationType.FREEFORM
@@ -10296,7 +10460,10 @@ class SourcedConfigurationProps(ConfigurationProps):
         '''The list of environments to deploy the configuration to.
 
         If this parameter is not specified, then there will be no
-        deployment.
+        deployment created alongside this configuration.
+
+        Deployments can be added later using the ``IEnvironment.addDeployment`` or
+        ``IEnvironment.addDeployments`` methods.
 
         :default: - None.
         '''
@@ -10645,7 +10812,7 @@ class Application(
         :param version_label: The version label of the hosted configuration. Default: - None.
         :param deployment_key: The deployment key of the configuration. Default: - None.
         :param deployment_strategy: The deployment strategy for the configuration. Default: - A deployment strategy with the rollout strategy set to RolloutStrategy.CANARY_10_PERCENT_20_MINUTES
-        :param deploy_to: The list of environments to deploy the configuration to. If this parameter is not specified, then there will be no deployment. Default: - None.
+        :param deploy_to: 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. Default: - None.
         :param description: The description of the configuration. Default: - No description.
         :param name: The name of the configuration. Default: - A name is generated.
         :param type: The type of configuration. Default: ConfigurationType.FREEFORM
@@ -10693,7 +10860,7 @@ class Application(
         :param version_number: The version number of the sourced configuration to deploy. If this is not specified, then there will be no deployment. Default: - None.
         :param deployment_key: The deployment key of the configuration. Default: - None.
         :param deployment_strategy: The deployment strategy for the configuration. Default: - A deployment strategy with the rollout strategy set to RolloutStrategy.CANARY_10_PERCENT_20_MINUTES
-        :param deploy_to: The list of environments to deploy the configuration to. If this parameter is not specified, then there will be no deployment. Default: - None.
+        :param deploy_to: 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. Default: - None.
         :param description: The description of the configuration. Default: - No description.
         :param name: The name of the configuration. Default: - A name is generated.
         :param type: The type of configuration. Default: ConfigurationType.FREEFORM
@@ -11172,10 +11339,16 @@ class Environment(
             application=app
         )
         
-        appconfig.HostedConfiguration(self, "MyHostedConfig",
+        appconfig.HostedConfiguration(self, "MyFirstHostedConfig",
             application=app,
             deploy_to=[env],
-            content=appconfig.ConfigurationContent.from_inline_text("This is my configuration content.")
+            content=appconfig.ConfigurationContent.from_inline_text("This is my first configuration content.")
+        )
+        
+        appconfig.HostedConfiguration(self, "MySecondHostedConfig",
+            application=app,
+            deploy_to=[env],
+            content=appconfig.ConfigurationContent.from_inline_text("This is my second configuration content.")
         )
     '''
 
@@ -11268,6 +11441,34 @@ class Environment(
 
         return typing.cast(IEnvironment, jsii.sinvoke(cls, "fromEnvironmentAttributes", [scope, id, attrs]))
 
+    @jsii.member(jsii_name="addDeployment")
+    def add_deployment(self, configuration: IConfiguration) -> None:
+        '''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.
+
+        :param configuration: -
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__60a6cee655356c4a43230057c8909db67a6239e7701192ff39fda6b5549a6672)
+            check_type(argname="argument configuration", value=configuration, expected_type=type_hints["configuration"])
+        return typing.cast(None, jsii.invoke(self, "addDeployment", [configuration]))
+
+    @jsii.member(jsii_name="addDeployments")
+    def add_deployments(self, *configurations: IConfiguration) -> None:
+        '''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.
+
+        :param configurations: -
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__9a87ca2c61c81bb433441138d696247c8865c67883b0937278f3b0aa320b5db0)
+            check_type(argname="argument configurations", value=configurations, expected_type=typing.Tuple[type_hints["configurations"], ...]) # pyright: ignore [reportGeneralTypeIssues]
+        return typing.cast(None, jsii.invoke(self, "addDeployments", [*configurations]))
+
     @jsii.member(jsii_name="addExtension")
     def add_extension(self, extension: IExtension) -> None:
         '''Adds an extension association to the environment.
@@ -11570,6 +11771,18 @@ class Environment(
         '''The name of the environment.'''
         return typing.cast(typing.Optional[builtins.str], jsii.get(self, "name"))
 
+    @builtins.property
+    @jsii.member(jsii_name="deploymentQueue")
+    def _deployment_queue(self) -> typing.List[CfnDeployment]:
+        return typing.cast(typing.List[CfnDeployment], jsii.get(self, "deploymentQueue"))
+
+    @_deployment_queue.setter
+    def _deployment_queue(self, value: typing.List[CfnDeployment]) -> None:
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__bd39d7b7b77c944582e5f7fabeb3e37717eaa470540d764633f9ce909058030a)
+            check_type(argname="argument value", value=value, expected_type=type_hints["value"])
+        jsii.set(self, "deploymentQueue", value)
+
     @builtins.property
     @jsii.member(jsii_name="extensible")
     def _extensible(self) -> "ExtensibleBase":
@@ -12116,13 +12329,15 @@ class HostedConfiguration(
 
     Example::
 
-        # application: appconfig.Application
-        
+        app = appconfig.Application(self, "MyApp")
+        env = appconfig.Environment(self, "MyEnv",
+            application=app
+        )
         
-        appconfig.HostedConfiguration(self, "MyHostedConfiguration",
-            application=application,
-            content=appconfig.ConfigurationContent.from_inline_text("This is my configuration content."),
-            type=appconfig.ConfigurationType.FEATURE_FLAGS
+        appconfig.HostedConfiguration(self, "MyHostedConfig",
+            application=app,
+            deploy_to=[env],
+            content=appconfig.ConfigurationContent.from_inline_text("This is my configuration content.")
         )
     '''
 
@@ -12152,7 +12367,7 @@ class HostedConfiguration(
         :param application: The application associated with the configuration.
         :param deployment_key: The deployment key of the configuration. Default: - None.
         :param deployment_strategy: The deployment strategy for the configuration. Default: - A deployment strategy with the rollout strategy set to RolloutStrategy.CANARY_10_PERCENT_20_MINUTES
-        :param deploy_to: The list of environments to deploy the configuration to. If this parameter is not specified, then there will be no deployment. Default: - None.
+        :param deploy_to: 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. Default: - None.
         :param description: The description of the configuration. Default: - No description.
         :param name: The name of the configuration. Default: - A name is generated.
         :param type: The type of configuration. Default: ConfigurationType.FREEFORM
@@ -13679,6 +13894,18 @@ def _typecheckingstub__6e94c708c7603af848bf6e13c31c0fc2a81ad1aa833b38ab455b5a4db
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__3f39f9fc38c2348c1cbb526adb681012a66d9e97575dc37ba0af87ab3bc3eddc(
+    configuration: IConfiguration,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__44b48a1bae27d9166bf28c62529963c2221d313260dbc1e9f5239536a54010d5(
+    *configurations: IConfiguration,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__21f3fd9d8706d2da33872e0f177690ef7904e1a5bffb8f09838105674dab79cf(
     extension: IExtension,
 ) -> None:
@@ -14346,6 +14573,18 @@ def _typecheckingstub__5d0acdd2bc2062b1e3a3bcead8b9d2670bef03c315b3aa44522a20995
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__60a6cee655356c4a43230057c8909db67a6239e7701192ff39fda6b5549a6672(
+    configuration: IConfiguration,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__9a87ca2c61c81bb433441138d696247c8865c67883b0937278f3b0aa320b5db0(
+    *configurations: IConfiguration,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__46eeb9c815b4c9f3f9ff6e64ae0bba20fa3057be7b74747b611ea672668a95cf(
     extension: IExtension,
 ) -> None:
@@ -14441,6 +14680,12 @@ def _typecheckingstub__22ccb2ca13f7df2815220f1d2cdda0fb9d20c17ac1fafb9dcc5006455
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__bd39d7b7b77c944582e5f7fabeb3e37717eaa470540d764633f9ce909058030a(
+    value: typing.List[CfnDeployment],
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__f249899e37c9153afa9dc39542328ce1c247c1f209ac134fb2bc8a4ad1120946(
     value: ExtensibleBase,
 ) -> None: