aws-cdk-lib 2.139.1__py3-none-any.whl → 2.141.0__py3-none-any.whl

aws_cdk/aws_apigateway/__init__.py

@@ -390,7 +390,7 @@ RootStack(App())
 > **Warning:** In the code above, an API Gateway deployment is created during the initial CDK deployment.
 > However, if there are changes to the resources in subsequent CDK deployments, a new API Gateway deployment is not
 > automatically created. As a result, the latest state of the resources is not reflected. To ensure the latest state
-> of the resources is reflected, a manual deployment of the API Gateway is required after the CDK deployment.
+> of the resources is reflected, a manual deployment of the API Gateway is required after the CDK deployment. See [Controlled triggering of deployments](#controlled-triggering-of-deployments) for more info.
 
 ## Integration Targets
 
@@ -1117,7 +1117,7 @@ Instructions for configuring your trust store can be found [here](https://aws.am
 By default, the `RestApi` construct will automatically create an API Gateway
 [Deployment](https://docs.aws.amazon.com/apigateway/api-reference/resource/deployment/) and a "prod" [Stage](https://docs.aws.amazon.com/apigateway/api-reference/resource/stage/) which represent the API configuration you
 defined in your CDK app. This means that when you deploy your app, your API will
-be have open access from the internet via the stage URL.
+have open access from the internet via the stage URL.
 
 The URL of your API can be obtained from the attribute `restApi.url`, and is
 also exported as an `Output` from your stack, so it's printed when you `cdk deploy` your app:
@@ -1177,6 +1177,71 @@ api = apigateway.RestApi(self, "books",
 )
 ```
 
+### Deploying to an existing stage
+
+#### Using RestApi
+
+If you want to use an existing stage to deploy your `RestApi`, first set `{ deploy: false }` so the construct doesn't automatically create new `Deployment` and `Stage` resources.  Then you can manually define a `apigateway.Deployment` resource and specify the stage name for your existing stage using the `stageName` property.
+
+Note that as long as the deployment's logical ID doesn't change, it will represent the snapshot in time when the resource was created. To ensure your deployment reflects changes to the `RestApi` model, see [Controlled triggering of deployments](#controlled-triggering-of-deployments).
+
+```python
+rest_api = apigateway.RestApi(self, "my-rest-api",
+    deploy=False
+)
+
+# Use `stageName` to deploy to an existing stage
+deployment = apigateway.Deployment(self, "my-deployment",
+    api=rest_api,
+    stage_name="dev",
+    retain_deployments=True
+)
+```
+
+#### Using SpecRestApi
+
+If you want to use an existing stage to deploy your `SpecRestApi`, first set `{ deploy: false }` so the construct doesn't automatically create new `Deployment` and `Stage` resources. Then you can manually define a `apigateway.Deployment` resource and specify the stage name for your existing stage using the `stageName` property.
+
+To automatically create a new deployment that reflects the latest API changes, you can use the `addToLogicalId()` method and pass in your OpenAPI definition.
+
+```python
+my_api_definition = apigateway.ApiDefinition.from_asset("path-to-file.json")
+spec_rest_api = apigateway.SpecRestApi(self, "my-specrest-api",
+    deploy=False,
+    api_definition=my_api_definition
+)
+
+# Use `stageName` to deploy to an existing stage
+deployment = apigateway.Deployment(self, "my-deployment",
+    api=spec_rest_api,
+    stage_name="dev",
+    retain_deployments=True
+)
+
+# Trigger a new deployment on OpenAPI definition updates
+deployment.add_to_logical_id(my_api_definition)
+```
+
+> Note: If the `stageName` property is set but a stage with the corresponding name does not exist, a new stage resource will be created with the provided stage name.
+
+> Note: If you update the `stageName` property, you should be triggering a new deployment (i.e. with an updated logical ID and API changes). Otherwise, an error will occur during deployment.
+
+### Controlled triggering of deployments
+
+By default, the `RestApi` construct deploys changes immediately. If you want to
+control when deployments happen, set `{ deploy: false }` and create a `Deployment` construct yourself. Add a revision counter to the construct ID, and update it in your source code whenever you want to trigger a new deployment:
+
+```python
+rest_api = apigateway.RestApi(self, "my-api",
+    deploy=False
+)
+
+deployment_revision = 5 # Bump this counter to trigger a new deployment
+apigateway.Deployment(self, f"Deployment{deploymentRevision}",
+    api=rest_api
+)
+```
+
 ### Deep dive: Invalidation of deployments
 
 API Gateway deployments are an immutable snapshot of the API. This means that we
@@ -2704,15 +2769,21 @@ class ApiDefinition(
 
     Example::
 
-        # integration: apigateway.Integration
-        
+        my_api_definition = apigateway.ApiDefinition.from_asset("path-to-file.json")
+        spec_rest_api = apigateway.SpecRestApi(self, "my-specrest-api",
+            deploy=False,
+            api_definition=my_api_definition
+        )
         
-        api = apigateway.SpecRestApi(self, "books-api",
-            api_definition=apigateway.ApiDefinition.from_asset("path-to-file.json")
+        # Use `stageName` to deploy to an existing stage
+        deployment = apigateway.Deployment(self, "my-deployment",
+            api=spec_rest_api,
+            stage_name="dev",
+            retain_deployments=True
         )
         
-        books_resource = api.root.add_resource("books")
-        books_resource.add_method("GET", integration)
+        # Trigger a new deployment on OpenAPI definition updates
+        deployment.add_to_logical_id(my_api_definition)
     '''
 
     def __init__(self) -> None:
@@ -3128,55 +3199,25 @@ class AssetApiDefinition(
 ):
     '''OpenAPI specification from a local file.
 
-    :exampleMetadata: fixture=_generated
+    :exampleMetadata: infused
 
     Example::
 
-        # The code below shows an example of how to instantiate this type.
-        # The values are placeholders you should change.
-        import aws_cdk as cdk
-        from aws_cdk import aws_apigateway as apigateway
-        from aws_cdk import aws_iam as iam
-        
-        # docker_image: cdk.DockerImage
-        # grantable: iam.IGrantable
-        # local_bundling: cdk.ILocalBundling
-        
-        asset_api_definition = apigateway.AssetApiDefinition("path",
-            asset_hash="assetHash",
-            asset_hash_type=cdk.AssetHashType.SOURCE,
-            bundling=cdk.BundlingOptions(
-                image=docker_image,
-        
-                # the properties below are optional
-                bundling_file_access=cdk.BundlingFileAccess.VOLUME_COPY,
-                command=["command"],
-                entrypoint=["entrypoint"],
-                environment={
-                    "environment_key": "environment"
-                },
-                local=local_bundling,
-                network="network",
-                output_type=cdk.BundlingOutput.ARCHIVED,
-                platform="platform",
-                security_opt="securityOpt",
-                user="user",
-                volumes=[cdk.DockerVolume(
-                    container_path="containerPath",
-                    host_path="hostPath",
+        my_api_definition = apigateway.ApiDefinition.from_asset("path-to-file.json")
+        spec_rest_api = apigateway.SpecRestApi(self, "my-specrest-api",
+            deploy=False,
+            api_definition=my_api_definition
+        )
         
-                    # the properties below are optional
-                    consistency=cdk.DockerVolumeConsistency.CONSISTENT
-                )],
-                volumes_from=["volumesFrom"],
-                working_directory="workingDirectory"
-            ),
-            deploy_time=False,
-            exclude=["exclude"],
-            follow_symlinks=cdk.SymlinkFollowMode.NEVER,
-            ignore_mode=cdk.IgnoreMode.GLOB,
-            readers=[grantable]
+        # Use `stageName` to deploy to an existing stage
+        deployment = apigateway.Deployment(self, "my-deployment",
+            api=spec_rest_api,
+            stage_name="dev",
+            retain_deployments=True
         )
+        
+        # Trigger a new deployment on OpenAPI definition updates
+        deployment.add_to_logical_id(my_api_definition)
     '''
 
     def __init__(
@@ -14015,6 +14056,7 @@ class Deployment(
         api: "IRestApi",
         description: typing.Optional[builtins.str] = None,
         retain_deployments: typing.Optional[builtins.bool] = None,
+        stage_name: typing.Optional[builtins.str] = None,
     ) -> None:
         '''
         :param scope: -
@@ -14022,13 +14064,17 @@ class Deployment(
         :param api: The Rest API to deploy.
         :param description: A description of the purpose of the API Gateway deployment. Default: - No description.
         :param retain_deployments: When an API Gateway model is updated, a new deployment will automatically be created. If this is true, the old API Gateway Deployment resource will not be deleted. This will allow manually reverting back to a previous deployment in case for example Default: false
+        :param stage_name: The name of the stage the API Gateway deployment deploys to. Default: - No stage name. If the ``stageName`` property is set but a stage with the corresponding name does not exist, a new stage resource will be created with the provided stage name.
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__60052a26fedba9d01bde406c7bb3c749dd3ea02f314d0f61d824f756c590721b)
             check_type(argname="argument scope", value=scope, expected_type=type_hints["scope"])
             check_type(argname="argument id", value=id, expected_type=type_hints["id"])
         props = DeploymentProps(
-            api=api, description=description, retain_deployments=retain_deployments
+            api=api,
+            description=description,
+            retain_deployments=retain_deployments,
+            stage_name=stage_name,
         )
 
         jsii.create(self.__class__, self, [scope, id, props])
@@ -14061,6 +14107,12 @@ class Deployment(
         '''
         return typing.cast(builtins.str, jsii.get(self, "deploymentId"))
 
+    @builtins.property
+    @jsii.member(jsii_name="stageName")
+    def stage_name(self) -> typing.Optional[builtins.str]:
+        '''The stage of the API gateway deployment.'''
+        return typing.cast(typing.Optional[builtins.str], jsii.get(self, "stageName"))
+
 
 @jsii.data_type(
     jsii_type="aws-cdk-lib.aws_apigateway.DeploymentProps",
@@ -14069,6 +14121,7 @@ class Deployment(
         "api": "api",
         "description": "description",
         "retain_deployments": "retainDeployments",
+        "stage_name": "stageName",
     },
 )
 class DeploymentProps:
@@ -14078,11 +14131,13 @@ class DeploymentProps:
         api: "IRestApi",
         description: typing.Optional[builtins.str] = None,
         retain_deployments: typing.Optional[builtins.bool] = None,
+        stage_name: typing.Optional[builtins.str] = None,
     ) -> None:
         '''
         :param api: The Rest API to deploy.
         :param description: A description of the purpose of the API Gateway deployment. Default: - No description.
         :param retain_deployments: When an API Gateway model is updated, a new deployment will automatically be created. If this is true, the old API Gateway Deployment resource will not be deleted. This will allow manually reverting back to a previous deployment in case for example Default: false
+        :param stage_name: The name of the stage the API Gateway deployment deploys to. Default: - No stage name. If the ``stageName`` property is set but a stage with the corresponding name does not exist, a new stage resource will be created with the provided stage name.
 
         :exampleMetadata: infused
 
@@ -14121,6 +14176,7 @@ class DeploymentProps:
             check_type(argname="argument api", value=api, expected_type=type_hints["api"])
             check_type(argname="argument description", value=description, expected_type=type_hints["description"])
             check_type(argname="argument retain_deployments", value=retain_deployments, expected_type=type_hints["retain_deployments"])
+            check_type(argname="argument stage_name", value=stage_name, expected_type=type_hints["stage_name"])
         self._values: typing.Dict[builtins.str, typing.Any] = {
             "api": api,
         }
@@ -14128,6 +14184,8 @@ class DeploymentProps:
             self._values["description"] = description
         if retain_deployments is not None:
             self._values["retain_deployments"] = retain_deployments
+        if stage_name is not None:
+            self._values["stage_name"] = stage_name
 
     @builtins.property
     def api(self) -> "IRestApi":
@@ -14157,6 +14215,19 @@ class DeploymentProps:
         result = self._values.get("retain_deployments")
         return typing.cast(typing.Optional[builtins.bool], result)
 
+    @builtins.property
+    def stage_name(self) -> typing.Optional[builtins.str]:
+        '''The name of the stage the API Gateway deployment deploys to.
+
+        :default:
+
+        - No stage name. If the ``stageName`` property is set but a stage with the
+        corresponding name does not exist, a new stage resource will be created with the
+        provided stage name.
+        '''
+        result = self._values.get("stage_name")
+        return typing.cast(typing.Optional[builtins.str], result)
+
     def __eq__(self, rhs: typing.Any) -> builtins.bool:
         return isinstance(rhs, self.__class__) and rhs._values == self._values
 
@@ -33678,6 +33749,7 @@ def _typecheckingstub__60052a26fedba9d01bde406c7bb3c749dd3ea02f314d0f61d824f756c
     api: IRestApi,
     description: typing.Optional[builtins.str] = None,
     retain_deployments: typing.Optional[builtins.bool] = None,
+    stage_name: typing.Optional[builtins.str] = None,
 ) -> None:
     """Type checking stubs"""
     pass
@@ -33693,6 +33765,7 @@ def _typecheckingstub__689289fb9a086819dc2bb6611b99cf777d39e89a4f67f62a4fb0ee0ba
     api: IRestApi,
     description: typing.Optional[builtins.str] = None,
     retain_deployments: typing.Optional[builtins.bool] = None,
+    stage_name: typing.Optional[builtins.str] = None,
 ) -> None:
     """Type checking stubs"""
     pass

aws_cdk/aws_applicationautoscaling/__init__.py

@@ -1269,10 +1269,7 @@ class CfnScalableTarget(
     @builtins.property
     @jsii.member(jsii_name="attrId")
     def attr_id(self) -> builtins.str:
-        '''This value can be returned by using the Ref function.
-
-        Ref returns the Cloudformation generated ID of the resource in format - ResourceId|ScalableDimension|ServiceNamespace
-
+        '''
         :cloudformationAttribute: Id
         '''
         return typing.cast(builtins.str, jsii.get(self, "attrId"))

aws_cdk/aws_arczonalshift/__init__.py

@@ -84,6 +84,9 @@ class CfnZonalAutoshiftConfiguration(
         from aws_cdk import aws_arczonalshift as arczonalshift
         
         cfn_zonal_autoshift_configuration = arczonalshift.CfnZonalAutoshiftConfiguration(self, "MyCfnZonalAutoshiftConfiguration",
+            resource_identifier="resourceIdentifier",
+        
+            # the properties below are optional
             practice_run_configuration=arczonalshift.CfnZonalAutoshiftConfiguration.PracticeRunConfigurationProperty(
                 outcome_alarms=[arczonalshift.CfnZonalAutoshiftConfiguration.ControlConditionProperty(
                     alarm_identifier="alarmIdentifier",
@@ -98,7 +101,6 @@ class CfnZonalAutoshiftConfiguration(
                     type="type"
                 )]
             ),
-            resource_identifier="resourceIdentifier",
             zonal_autoshift_status="zonalAutoshiftStatus"
         )
     '''
@@ -108,15 +110,15 @@ class CfnZonalAutoshiftConfiguration(
         scope: _constructs_77d1e7e8.Construct,
         id: builtins.str,
         *,
+        resource_identifier: builtins.str,
         practice_run_configuration: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnZonalAutoshiftConfiguration.PracticeRunConfigurationProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
-        resource_identifier: typing.Optional[builtins.str] = None,
         zonal_autoshift_status: typing.Optional[builtins.str] = None,
     ) -> None:
         '''
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
-        :param practice_run_configuration: A practice run configuration for a resource includes the Amazon CloudWatch alarms that you've specified for a practice run, as well as any blocked dates or blocked windows for the practice run. When a resource has a practice run configuration, Route 53 ARC shifts traffic for the resource weekly for practice runs. Practice runs are required for zonal autoshift. The zonal shifts that Route 53 ARC starts for practice runs help you to ensure that shifting away traffic from an Availability Zone during an autoshift is safe for your application. You can update or delete a practice run configuration. Before you delete a practice run configuration, you must disable zonal autoshift for the resource. A practice run configuration is required when zonal autoshift is enabled.
         :param resource_identifier: The identifier for the resource that AWS shifts traffic for. The identifier is the Amazon Resource Name (ARN) for the resource. At this time, supported resources are Network Load Balancers and Application Load Balancers with cross-zone load balancing turned off.
+        :param practice_run_configuration: A practice run configuration for a resource includes the Amazon CloudWatch alarms that you've specified for a practice run, as well as any blocked dates or blocked windows for the practice run. When a resource has a practice run configuration, Route 53 ARC shifts traffic for the resource weekly for practice runs. Practice runs are required for zonal autoshift. The zonal shifts that Route 53 ARC starts for practice runs help you to ensure that shifting away traffic from an Availability Zone during an autoshift is safe for your application. You can update or delete a practice run configuration. Before you delete a practice run configuration, you must disable zonal autoshift for the resource. A practice run configuration is required when zonal autoshift is enabled.
         :param zonal_autoshift_status: When zonal autoshift is ``ENABLED`` , you authorize AWS to shift away resource traffic for an application from an Availability Zone during events, on your behalf, to help reduce time to recovery. Traffic is also shifted away for the required weekly practice runs.
         '''
         if __debug__:
@@ -124,8 +126,8 @@ class CfnZonalAutoshiftConfiguration(
             check_type(argname="argument scope", value=scope, expected_type=type_hints["scope"])
             check_type(argname="argument id", value=id, expected_type=type_hints["id"])
         props = CfnZonalAutoshiftConfigurationProps(
-            practice_run_configuration=practice_run_configuration,
             resource_identifier=resource_identifier,
+            practice_run_configuration=practice_run_configuration,
             zonal_autoshift_status=zonal_autoshift_status,
         )
 
@@ -166,6 +168,19 @@ class CfnZonalAutoshiftConfiguration(
     def _cfn_properties(self) -> typing.Mapping[builtins.str, typing.Any]:
         return typing.cast(typing.Mapping[builtins.str, typing.Any], jsii.get(self, "cfnProperties"))
 
+    @builtins.property
+    @jsii.member(jsii_name="resourceIdentifier")
+    def resource_identifier(self) -> builtins.str:
+        '''The identifier for the resource that AWS shifts traffic for.'''
+        return typing.cast(builtins.str, jsii.get(self, "resourceIdentifier"))
+
+    @resource_identifier.setter
+    def resource_identifier(self, value: builtins.str) -> None:
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__0172f855e8c8e45fb028b84c5b6c061a5bab422e24d02655056a950949eb68fa)
+            check_type(argname="argument value", value=value, expected_type=type_hints["value"])
+        jsii.set(self, "resourceIdentifier", value)
+
     @builtins.property
     @jsii.member(jsii_name="practiceRunConfiguration")
     def practice_run_configuration(
@@ -184,19 +199,6 @@ class CfnZonalAutoshiftConfiguration(
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
         jsii.set(self, "practiceRunConfiguration", value)
 
-    @builtins.property
-    @jsii.member(jsii_name="resourceIdentifier")
-    def resource_identifier(self) -> typing.Optional[builtins.str]:
-        '''The identifier for the resource that AWS shifts traffic for.'''
-        return typing.cast(typing.Optional[builtins.str], jsii.get(self, "resourceIdentifier"))
-
-    @resource_identifier.setter
-    def resource_identifier(self, value: typing.Optional[builtins.str]) -> None:
-        if __debug__:
-            type_hints = typing.get_type_hints(_typecheckingstub__0172f855e8c8e45fb028b84c5b6c061a5bab422e24d02655056a950949eb68fa)
-            check_type(argname="argument value", value=value, expected_type=type_hints["value"])
-        jsii.set(self, "resourceIdentifier", value)
-
     @builtins.property
     @jsii.member(jsii_name="zonalAutoshiftStatus")
     def zonal_autoshift_status(self) -> typing.Optional[builtins.str]:
@@ -428,8 +430,8 @@ class CfnZonalAutoshiftConfiguration(
     jsii_type="aws-cdk-lib.aws_arczonalshift.CfnZonalAutoshiftConfigurationProps",
     jsii_struct_bases=[],
     name_mapping={
-        "practice_run_configuration": "practiceRunConfiguration",
         "resource_identifier": "resourceIdentifier",
+        "practice_run_configuration": "practiceRunConfiguration",
         "zonal_autoshift_status": "zonalAutoshiftStatus",
     },
 )
@@ -437,14 +439,14 @@ class CfnZonalAutoshiftConfigurationProps:
     def __init__(
         self,
         *,
+        resource_identifier: builtins.str,
         practice_run_configuration: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnZonalAutoshiftConfiguration.PracticeRunConfigurationProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
-        resource_identifier: typing.Optional[builtins.str] = None,
         zonal_autoshift_status: typing.Optional[builtins.str] = None,
     ) -> None:
         '''Properties for defining a ``CfnZonalAutoshiftConfiguration``.
 
-        :param practice_run_configuration: A practice run configuration for a resource includes the Amazon CloudWatch alarms that you've specified for a practice run, as well as any blocked dates or blocked windows for the practice run. When a resource has a practice run configuration, Route 53 ARC shifts traffic for the resource weekly for practice runs. Practice runs are required for zonal autoshift. The zonal shifts that Route 53 ARC starts for practice runs help you to ensure that shifting away traffic from an Availability Zone during an autoshift is safe for your application. You can update or delete a practice run configuration. Before you delete a practice run configuration, you must disable zonal autoshift for the resource. A practice run configuration is required when zonal autoshift is enabled.
         :param resource_identifier: The identifier for the resource that AWS shifts traffic for. The identifier is the Amazon Resource Name (ARN) for the resource. At this time, supported resources are Network Load Balancers and Application Load Balancers with cross-zone load balancing turned off.
+        :param practice_run_configuration: A practice run configuration for a resource includes the Amazon CloudWatch alarms that you've specified for a practice run, as well as any blocked dates or blocked windows for the practice run. When a resource has a practice run configuration, Route 53 ARC shifts traffic for the resource weekly for practice runs. Practice runs are required for zonal autoshift. The zonal shifts that Route 53 ARC starts for practice runs help you to ensure that shifting away traffic from an Availability Zone during an autoshift is safe for your application. You can update or delete a practice run configuration. Before you delete a practice run configuration, you must disable zonal autoshift for the resource. A practice run configuration is required when zonal autoshift is enabled.
         :param zonal_autoshift_status: When zonal autoshift is ``ENABLED`` , you authorize AWS to shift away resource traffic for an application from an Availability Zone during events, on your behalf, to help reduce time to recovery. Traffic is also shifted away for the required weekly practice runs.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-arczonalshift-zonalautoshiftconfiguration.html
@@ -457,6 +459,9 @@ class CfnZonalAutoshiftConfigurationProps:
             from aws_cdk import aws_arczonalshift as arczonalshift
             
             cfn_zonal_autoshift_configuration_props = arczonalshift.CfnZonalAutoshiftConfigurationProps(
+                resource_identifier="resourceIdentifier",
+            
+                # the properties below are optional
                 practice_run_configuration=arczonalshift.CfnZonalAutoshiftConfiguration.PracticeRunConfigurationProperty(
                     outcome_alarms=[arczonalshift.CfnZonalAutoshiftConfiguration.ControlConditionProperty(
                         alarm_identifier="alarmIdentifier",
@@ -471,23 +476,36 @@ class CfnZonalAutoshiftConfigurationProps:
                         type="type"
                     )]
                 ),
-                resource_identifier="resourceIdentifier",
                 zonal_autoshift_status="zonalAutoshiftStatus"
             )
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__df846ffeb392d27b90c69c753d2f5defce1421dd94b678654bb7fe32434590d0)
-            check_type(argname="argument practice_run_configuration", value=practice_run_configuration, expected_type=type_hints["practice_run_configuration"])
             check_type(argname="argument resource_identifier", value=resource_identifier, expected_type=type_hints["resource_identifier"])
+            check_type(argname="argument practice_run_configuration", value=practice_run_configuration, expected_type=type_hints["practice_run_configuration"])
             check_type(argname="argument zonal_autoshift_status", value=zonal_autoshift_status, expected_type=type_hints["zonal_autoshift_status"])
-        self._values: typing.Dict[builtins.str, typing.Any] = {}
+        self._values: typing.Dict[builtins.str, typing.Any] = {
+            "resource_identifier": resource_identifier,
+        }
         if practice_run_configuration is not None:
             self._values["practice_run_configuration"] = practice_run_configuration
-        if resource_identifier is not None:
-            self._values["resource_identifier"] = resource_identifier
         if zonal_autoshift_status is not None:
             self._values["zonal_autoshift_status"] = zonal_autoshift_status
 
+    @builtins.property
+    def resource_identifier(self) -> builtins.str:
+        '''The identifier for the resource that AWS shifts traffic for.
+
+        The identifier is the Amazon Resource Name (ARN) for the resource.
+
+        At this time, supported resources are Network Load Balancers and Application Load Balancers with cross-zone load balancing turned off.
+
+        :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-arczonalshift-zonalautoshiftconfiguration.html#cfn-arczonalshift-zonalautoshiftconfiguration-resourceidentifier
+        '''
+        result = self._values.get("resource_identifier")
+        assert result is not None, "Required property 'resource_identifier' is missing"
+        return typing.cast(builtins.str, result)
+
     @builtins.property
     def practice_run_configuration(
         self,
@@ -505,19 +523,6 @@ class CfnZonalAutoshiftConfigurationProps:
         result = self._values.get("practice_run_configuration")
         return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, CfnZonalAutoshiftConfiguration.PracticeRunConfigurationProperty]], result)
 
-    @builtins.property
-    def resource_identifier(self) -> typing.Optional[builtins.str]:
-        '''The identifier for the resource that AWS shifts traffic for.
-
-        The identifier is the Amazon Resource Name (ARN) for the resource.
-
-        At this time, supported resources are Network Load Balancers and Application Load Balancers with cross-zone load balancing turned off.
-
-        :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-arczonalshift-zonalautoshiftconfiguration.html#cfn-arczonalshift-zonalautoshiftconfiguration-resourceidentifier
-        '''
-        result = self._values.get("resource_identifier")
-        return typing.cast(typing.Optional[builtins.str], result)
-
     @builtins.property
     def zonal_autoshift_status(self) -> typing.Optional[builtins.str]:
         '''When zonal autoshift is ``ENABLED`` , you authorize AWS to shift away resource traffic for an application from an Availability Zone during events, on your behalf, to help reduce time to recovery.
@@ -552,8 +557,8 @@ def _typecheckingstub__8c7357d3884cea81f1166de2f6ac59cb16a8663a471270d73a743eb77
     scope: _constructs_77d1e7e8.Construct,
     id: builtins.str,
     *,
+    resource_identifier: builtins.str,
     practice_run_configuration: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnZonalAutoshiftConfiguration.PracticeRunConfigurationProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
-    resource_identifier: typing.Optional[builtins.str] = None,
     zonal_autoshift_status: typing.Optional[builtins.str] = None,
 ) -> None:
     """Type checking stubs"""
@@ -571,14 +576,14 @@ def _typecheckingstub__d6cd5c905f39dc6d9cfcdb3f49d58c5ca237eb10b38e48744425b3c2c
     """Type checking stubs"""
     pass
 
-def _typecheckingstub__deabf71a3e0015b91f35f23b96354f1d2feeb19a3f783edd9e6c4be281a4d00a(
-    value: typing.Optional[typing.Union[_IResolvable_da3f097b, CfnZonalAutoshiftConfiguration.PracticeRunConfigurationProperty]],
+def _typecheckingstub__0172f855e8c8e45fb028b84c5b6c061a5bab422e24d02655056a950949eb68fa(
+    value: builtins.str,
 ) -> None:
     """Type checking stubs"""
     pass
 
-def _typecheckingstub__0172f855e8c8e45fb028b84c5b6c061a5bab422e24d02655056a950949eb68fa(
-    value: typing.Optional[builtins.str],
+def _typecheckingstub__deabf71a3e0015b91f35f23b96354f1d2feeb19a3f783edd9e6c4be281a4d00a(
+    value: typing.Optional[typing.Union[_IResolvable_da3f097b, CfnZonalAutoshiftConfiguration.PracticeRunConfigurationProperty]],
 ) -> None:
     """Type checking stubs"""
     pass
@@ -609,8 +614,8 @@ def _typecheckingstub__09d714a4c978f7c2d70e24869d7ce300d549509a8b35174736a9571be
 
 def _typecheckingstub__df846ffeb392d27b90c69c753d2f5defce1421dd94b678654bb7fe32434590d0(
     *,
+    resource_identifier: builtins.str,
     practice_run_configuration: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnZonalAutoshiftConfiguration.PracticeRunConfigurationProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
-    resource_identifier: typing.Optional[builtins.str] = None,
     zonal_autoshift_status: typing.Optional[builtins.str] = None,
 ) -> None:
     """Type checking stubs"""