aws-cdk-lib 2.185.0__py3-none-any.whl → 2.187.0__py3-none-any.whl

aws_cdk/aws_apigateway/__init__.py

@@ -2834,6 +2834,7 @@ class ApiDefinition(
         file: builtins.str,
         *,
         deploy_time: typing.Optional[builtins.bool] = None,
+        display_name: typing.Optional[builtins.str] = None,
         readers: typing.Optional[typing.Sequence[_IGrantable_71c4f5de]] = None,
         source_kms_key: typing.Optional[_IKey_5f11635f] = None,
         asset_hash: typing.Optional[builtins.str] = None,
@@ -2847,6 +2848,7 @@ class ApiDefinition(
 
         :param file: -
         :param deploy_time: Whether or not the asset needs to exist beyond deployment time; i.e. are copied over to a different location and not needed afterwards. Setting this property to true has an impact on the lifecycle of the asset, because we will assume that it is safe to delete after the CloudFormation deployment succeeds. For example, Lambda Function assets are copied over to Lambda during deployment. Therefore, it is not necessary to store the asset in S3, so we consider those deployTime assets. Default: false
+        :param display_name: A display name for this asset. If supplied, the display name will be used in locations where the asset identifier is printed, like in the CLI progress information. If the same asset is added multiple times, the display name of the first occurrence is used. The default is the construct path of the Asset construct, with respect to the enclosing stack. If the asset is produced by a construct helper function (such as ``lambda.Code.fromAsset()``), this will look like ``MyFunction/Code``. We use the stack-relative construct path so that in the common case where you have multiple stacks with the same asset, we won't show something like ``/MyBetaStack/MyFunction/Code`` when you are actually deploying to production. Default: - Stack-relative construct path
         :param readers: A list of principals that should be able to read this asset from S3. You can use ``asset.grantRead(principal)`` to grant read permissions later. Default: - No principals that can read file asset.
         :param source_kms_key: The ARN of the KMS key used to encrypt the handler code. Default: - the default server-side encryption with Amazon S3 managed keys(SSE-S3) key will be used.
         :param asset_hash: Specify a custom hash for this asset. If ``assetHashType`` is set it must be set to ``AssetHashType.CUSTOM``. For consistency, this custom hash will be SHA256 hashed and encoded as hex. The resulting hash will be the asset hash. NOTE: the hash is used in order to identify a specific revision of the asset, and used for optimizing and caching deployment activities related to this asset such as packaging, uploading to Amazon S3, etc. If you chose to customize the hash, you will need to make sure it is updated every time the asset changes, or otherwise it is possible that some deployments will not be invalidated. Default: - based on ``assetHashType``
@@ -2861,6 +2863,7 @@ class ApiDefinition(
             check_type(argname="argument file", value=file, expected_type=type_hints["file"])
         options = _AssetOptions_2aa69621(
             deploy_time=deploy_time,
+            display_name=display_name,
             readers=readers,
             source_kms_key=source_kms_key,
             asset_hash=asset_hash,
@@ -3266,6 +3269,7 @@ class AssetApiDefinition(
         path: builtins.str,
         *,
         deploy_time: typing.Optional[builtins.bool] = None,
+        display_name: typing.Optional[builtins.str] = None,
         readers: typing.Optional[typing.Sequence[_IGrantable_71c4f5de]] = None,
         source_kms_key: typing.Optional[_IKey_5f11635f] = None,
         asset_hash: typing.Optional[builtins.str] = None,
@@ -3278,6 +3282,7 @@ class AssetApiDefinition(
         '''
         :param path: -
         :param deploy_time: Whether or not the asset needs to exist beyond deployment time; i.e. are copied over to a different location and not needed afterwards. Setting this property to true has an impact on the lifecycle of the asset, because we will assume that it is safe to delete after the CloudFormation deployment succeeds. For example, Lambda Function assets are copied over to Lambda during deployment. Therefore, it is not necessary to store the asset in S3, so we consider those deployTime assets. Default: false
+        :param display_name: A display name for this asset. If supplied, the display name will be used in locations where the asset identifier is printed, like in the CLI progress information. If the same asset is added multiple times, the display name of the first occurrence is used. The default is the construct path of the Asset construct, with respect to the enclosing stack. If the asset is produced by a construct helper function (such as ``lambda.Code.fromAsset()``), this will look like ``MyFunction/Code``. We use the stack-relative construct path so that in the common case where you have multiple stacks with the same asset, we won't show something like ``/MyBetaStack/MyFunction/Code`` when you are actually deploying to production. Default: - Stack-relative construct path
         :param readers: A list of principals that should be able to read this asset from S3. You can use ``asset.grantRead(principal)`` to grant read permissions later. Default: - No principals that can read file asset.
         :param source_kms_key: The ARN of the KMS key used to encrypt the handler code. Default: - the default server-side encryption with Amazon S3 managed keys(SSE-S3) key will be used.
         :param asset_hash: Specify a custom hash for this asset. If ``assetHashType`` is set it must be set to ``AssetHashType.CUSTOM``. For consistency, this custom hash will be SHA256 hashed and encoded as hex. The resulting hash will be the asset hash. NOTE: the hash is used in order to identify a specific revision of the asset, and used for optimizing and caching deployment activities related to this asset such as packaging, uploading to Amazon S3, etc. If you chose to customize the hash, you will need to make sure it is updated every time the asset changes, or otherwise it is possible that some deployments will not be invalidated. Default: - based on ``assetHashType``
@@ -3292,6 +3297,7 @@ class AssetApiDefinition(
             check_type(argname="argument path", value=path, expected_type=type_hints["path"])
         options = _AssetOptions_2aa69621(
             deploy_time=deploy_time,
+            display_name=display_name,
             readers=readers,
             source_kms_key=source_kms_key,
             asset_hash=asset_hash,
@@ -7703,6 +7709,7 @@ class CfnDomainName(
             certificate_arn="certificateArn",
             domain_name="domainName",
             endpoint_configuration=apigateway.CfnDomainName.EndpointConfigurationProperty(
+                ip_address_type="ipAddressType",
                 types=["types"]
             ),
             mutual_tls_authentication=apigateway.CfnDomainName.MutualTlsAuthenticationProperty(
@@ -7967,18 +7974,20 @@ class CfnDomainName(
     @jsii.data_type(
         jsii_type="aws-cdk-lib.aws_apigateway.CfnDomainName.EndpointConfigurationProperty",
         jsii_struct_bases=[],
-        name_mapping={"types": "types"},
+        name_mapping={"ip_address_type": "ipAddressType", "types": "types"},
     )
     class EndpointConfigurationProperty:
         def __init__(
             self,
             *,
+            ip_address_type: typing.Optional[builtins.str] = None,
             types: typing.Optional[typing.Sequence[builtins.str]] = None,
         ) -> None:
             '''The ``EndpointConfiguration`` property type specifies the endpoint types of an Amazon API Gateway domain name.
 
             ``EndpointConfiguration`` is a property of the `AWS::ApiGateway::DomainName <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-domainname.html>`_ resource.
 
+            :param ip_address_type: 
             :param types: A list of endpoint types of an API (RestApi) or its custom domain name (DomainName). For an edge-optimized API and its custom domain name, the endpoint type is ``"EDGE"`` . For a regional API and its custom domain name, the endpoint type is ``REGIONAL`` . For a private API, the endpoint type is ``PRIVATE`` .
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-apigateway-domainname-endpointconfiguration.html
@@ -7991,16 +8000,28 @@ class CfnDomainName(
                 from aws_cdk import aws_apigateway as apigateway
                 
                 endpoint_configuration_property = apigateway.CfnDomainName.EndpointConfigurationProperty(
+                    ip_address_type="ipAddressType",
                     types=["types"]
                 )
             '''
             if __debug__:
                 type_hints = typing.get_type_hints(_typecheckingstub__1d33c3bf6996efa92019e1b28e2d6c1c9ad4dd0fa50f2ad639962efcfa774fb2)
+                check_type(argname="argument ip_address_type", value=ip_address_type, expected_type=type_hints["ip_address_type"])
                 check_type(argname="argument types", value=types, expected_type=type_hints["types"])
             self._values: typing.Dict[builtins.str, typing.Any] = {}
+            if ip_address_type is not None:
+                self._values["ip_address_type"] = ip_address_type
             if types is not None:
                 self._values["types"] = types
 
+        @builtins.property
+        def ip_address_type(self) -> typing.Optional[builtins.str]:
+            '''
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-apigateway-domainname-endpointconfiguration.html#cfn-apigateway-domainname-endpointconfiguration-ipaddresstype
+            '''
+            result = self._values.get("ip_address_type")
+            return typing.cast(typing.Optional[builtins.str], result)
+
         @builtins.property
         def types(self) -> typing.Optional[typing.List[builtins.str]]:
             '''A list of endpoint types of an API (RestApi) or its custom domain name (DomainName).
@@ -8443,6 +8464,7 @@ class CfnDomainNameProps:
                 certificate_arn="certificateArn",
                 domain_name="domainName",
                 endpoint_configuration=apigateway.CfnDomainName.EndpointConfigurationProperty(
+                    ip_address_type="ipAddressType",
                     types=["types"]
                 ),
                 mutual_tls_authentication=apigateway.CfnDomainName.MutualTlsAuthenticationProperty(
@@ -11452,6 +11474,7 @@ class CfnRestApi(
             description="description",
             disable_execute_api_endpoint=False,
             endpoint_configuration=apigateway.CfnRestApi.EndpointConfigurationProperty(
+                ip_address_type="ipAddressType",
                 types=["types"],
                 vpc_endpoint_ids=["vpcEndpointIds"]
             ),
@@ -11819,12 +11842,17 @@ class CfnRestApi(
     @jsii.data_type(
         jsii_type="aws-cdk-lib.aws_apigateway.CfnRestApi.EndpointConfigurationProperty",
         jsii_struct_bases=[],
-        name_mapping={"types": "types", "vpc_endpoint_ids": "vpcEndpointIds"},
+        name_mapping={
+            "ip_address_type": "ipAddressType",
+            "types": "types",
+            "vpc_endpoint_ids": "vpcEndpointIds",
+        },
     )
     class EndpointConfigurationProperty:
         def __init__(
             self,
             *,
+            ip_address_type: typing.Optional[builtins.str] = None,
             types: typing.Optional[typing.Sequence[builtins.str]] = None,
             vpc_endpoint_ids: typing.Optional[typing.Sequence[builtins.str]] = None,
         ) -> None:
@@ -11832,6 +11860,7 @@ class CfnRestApi(
 
             ``EndpointConfiguration`` is a property of the `AWS::ApiGateway::RestApi <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-restapi.html>`_ resource.
 
+            :param ip_address_type: 
             :param types: A list of endpoint types of an API (RestApi) or its custom domain name (DomainName). For an edge-optimized API and its custom domain name, the endpoint type is ``"EDGE"`` . For a regional API and its custom domain name, the endpoint type is ``REGIONAL`` . For a private API, the endpoint type is ``PRIVATE`` .
             :param vpc_endpoint_ids: A list of VpcEndpointIds of an API (RestApi) against which to create Route53 ALIASes. It is only supported for ``PRIVATE`` endpoint type.
 
@@ -11845,20 +11874,32 @@ class CfnRestApi(
                 from aws_cdk import aws_apigateway as apigateway
                 
                 endpoint_configuration_property = apigateway.CfnRestApi.EndpointConfigurationProperty(
+                    ip_address_type="ipAddressType",
                     types=["types"],
                     vpc_endpoint_ids=["vpcEndpointIds"]
                 )
             '''
             if __debug__:
                 type_hints = typing.get_type_hints(_typecheckingstub__df9522828c39c6e4b1e829251c3b77d5b94051a139bf4f10dfa3ac8717e878b6)
+                check_type(argname="argument ip_address_type", value=ip_address_type, expected_type=type_hints["ip_address_type"])
                 check_type(argname="argument types", value=types, expected_type=type_hints["types"])
                 check_type(argname="argument vpc_endpoint_ids", value=vpc_endpoint_ids, expected_type=type_hints["vpc_endpoint_ids"])
             self._values: typing.Dict[builtins.str, typing.Any] = {}
+            if ip_address_type is not None:
+                self._values["ip_address_type"] = ip_address_type
             if types is not None:
                 self._values["types"] = types
             if vpc_endpoint_ids is not None:
                 self._values["vpc_endpoint_ids"] = vpc_endpoint_ids
 
+        @builtins.property
+        def ip_address_type(self) -> typing.Optional[builtins.str]:
+            '''
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-apigateway-restapi-endpointconfiguration.html#cfn-apigateway-restapi-endpointconfiguration-ipaddresstype
+            '''
+            result = self._values.get("ip_address_type")
+            return typing.cast(typing.Optional[builtins.str], result)
+
         @builtins.property
         def types(self) -> typing.Optional[typing.List[builtins.str]]:
             '''A list of endpoint types of an API (RestApi) or its custom domain name (DomainName).
@@ -12089,6 +12130,7 @@ class CfnRestApiProps:
                 description="description",
                 disable_execute_api_endpoint=False,
                 endpoint_configuration=apigateway.CfnRestApi.EndpointConfigurationProperty(
+                    ip_address_type="ipAddressType",
                     types=["types"],
                     vpc_endpoint_ids=["vpcEndpointIds"]
                 ),
@@ -33279,6 +33321,7 @@ def _typecheckingstub__931fac6af706dd0dae384cc682b2ecb066666ff6165060417e461a392
     file: builtins.str,
     *,
     deploy_time: typing.Optional[builtins.bool] = None,
+    display_name: typing.Optional[builtins.str] = None,
     readers: typing.Optional[typing.Sequence[_IGrantable_71c4f5de]] = None,
     source_kms_key: typing.Optional[_IKey_5f11635f] = None,
     asset_hash: typing.Optional[builtins.str] = None,
@@ -33346,6 +33389,7 @@ def _typecheckingstub__8d060d6bc8fc5b369cfe71dc05efc964aa6b083b674baa7dc17f1762a
     path: builtins.str,
     *,
     deploy_time: typing.Optional[builtins.bool] = None,
+    display_name: typing.Optional[builtins.str] = None,
     readers: typing.Optional[typing.Sequence[_IGrantable_71c4f5de]] = None,
     source_kms_key: typing.Optional[_IKey_5f11635f] = None,
     asset_hash: typing.Optional[builtins.str] = None,
@@ -34145,6 +34189,7 @@ def _typecheckingstub__30658cbd8b896f811f887630d934f0751b5370d775062da4c8686d7ca
 
 def _typecheckingstub__1d33c3bf6996efa92019e1b28e2d6c1c9ad4dd0fa50f2ad639962efcfa774fb2(
     *,
+    ip_address_type: typing.Optional[builtins.str] = None,
     types: typing.Optional[typing.Sequence[builtins.str]] = None,
 ) -> None:
     """Type checking stubs"""
@@ -34848,6 +34893,7 @@ def _typecheckingstub__9ae71bb5beb4f360ca0016003cbb508243a9ad4b5e494d1a4655780f8
 
 def _typecheckingstub__df9522828c39c6e4b1e829251c3b77d5b94051a139bf4f10dfa3ac8717e878b6(
     *,
+    ip_address_type: typing.Optional[builtins.str] = None,
     types: typing.Optional[typing.Sequence[builtins.str]] = None,
     vpc_endpoint_ids: typing.Optional[typing.Sequence[builtins.str]] = None,
 ) -> None:

aws_cdk/aws_apigatewayv2/__init__.py

@@ -4044,6 +4044,15 @@ class CfnDomainName(
         '''The CloudFormation resource type name for this resource class.'''
         return typing.cast(builtins.str, jsii.sget(cls, "CFN_RESOURCE_TYPE_NAME"))
 
+    @builtins.property
+    @jsii.member(jsii_name="attrDomainNameArn")
+    def attr_domain_name_arn(self) -> builtins.str:
+        '''Represents an Amazon Resource Name (ARN).
+
+        :cloudformationAttribute: DomainNameArn
+        '''
+        return typing.cast(builtins.str, jsii.get(self, "attrDomainNameArn"))
+
     @builtins.property
     @jsii.member(jsii_name="attrRegionalDomainName")
     def attr_regional_domain_name(self) -> builtins.str:

aws_cdk/aws_appconfig/__init__.py

@@ -1418,7 +1418,7 @@ class CfnConfigurationProfile(
         :param deletion_protection_check: On resource deletion this controls whether the Deletion Protection check should be applied, bypassed, or (the default) whether the behavior should be controlled by the account-level Deletion Protection setting. See https://docs.aws.amazon.com/appconfig/latest/userguide/deletion-protection.html
         :param description: A description of the configuration profile.
         :param kms_key_identifier: The AWS Key Management Service key identifier (key ID, key alias, or key ARN) provided when the resource was created or updated.
-        :param retrieval_role_arn: The ARN of an IAM role with permission to access the configuration at the specified ``LocationUri`` . .. epigraph:: A retrieval role ARN is not required for configurations stored in the AWS AppConfig hosted configuration store. It is required for all other sources that store your configuration.
+        :param retrieval_role_arn: The ARN of an IAM role with permission to access the configuration at the specified ``LocationUri`` . .. epigraph:: 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.
         :param tags: 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.
         :param type: 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``
         :param validators: A list of methods for validating the configuration.
@@ -1753,7 +1753,7 @@ class CfnConfigurationProfileProps:
         :param deletion_protection_check: On resource deletion this controls whether the Deletion Protection check should be applied, bypassed, or (the default) whether the behavior should be controlled by the account-level Deletion Protection setting. See https://docs.aws.amazon.com/appconfig/latest/userguide/deletion-protection.html
         :param description: A description of the configuration profile.
         :param kms_key_identifier: The AWS Key Management Service key identifier (key ID, key alias, or key ARN) provided when the resource was created or updated.
-        :param retrieval_role_arn: The ARN of an IAM role with permission to access the configuration at the specified ``LocationUri`` . .. epigraph:: A retrieval role ARN is not required for configurations stored in the AWS AppConfig hosted configuration store. It is required for all other sources that store your configuration.
+        :param retrieval_role_arn: The ARN of an IAM role with permission to access the configuration at the specified ``LocationUri`` . .. epigraph:: 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.
         :param tags: 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.
         :param type: 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``
         :param validators: A list of methods for validating the configuration.
@@ -1892,7 +1892,7 @@ class CfnConfigurationProfileProps:
 
         .. epigraph::
 
-           A retrieval role ARN is not required for configurations stored in the AWS AppConfig hosted configuration store. It is required for all other sources that store your configuration.
+           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.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appconfig-configurationprofile.html#cfn-appconfig-configurationprofile-retrievalrolearn
         '''