aws-cdk-lib 2.172.0__py3-none-any.whl → 2.173.1__py3-none-any.whl

aws_cdk/aws_apigateway/__init__.py

@@ -4974,6 +4974,8 @@ class CfnBasePathMapping(
 ):
     '''The ``AWS::ApiGateway::BasePathMapping`` resource creates a base path that clients who call your API must use in the invocation URL.
 
+    Supported only for public custom domain names.
+
     :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-basepathmapping.html
     :cloudformationResource: AWS::ApiGateway::BasePathMapping
     :exampleMetadata: fixture=_generated
@@ -5259,7 +5261,9 @@ class CfnBasePathMappingV2(
     metaclass=jsii.JSIIMeta,
     jsii_type="aws-cdk-lib.aws_apigateway.CfnBasePathMappingV2",
 ):
-    '''Resource Type definition for AWS::ApiGateway::BasePathMappingV2.
+    '''The ``AWS::ApiGateway::BasePathMappingV2`` resource creates a base path that clients who call your API must use in the invocation URL.
+
+    Supported only for private custom domain names.
 
     :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-basepathmappingv2.html
     :cloudformationResource: AWS::ApiGateway::BasePathMappingV2
@@ -5294,10 +5298,10 @@ class CfnBasePathMappingV2(
         '''
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
-        :param domain_name_arn: The Arn of an AWS::ApiGateway::DomainNameV2 resource.
-        :param rest_api_id: The ID of the API.
-        :param base_path: The base path name that callers of the API must provide in the URL after the domain name.
-        :param stage: The name of the API's stage.
+        :param domain_name_arn: The ARN of the domain name for the BasePathMappingV2 resource to be described.
+        :param rest_api_id: The private API's identifier. This identifier is unique across all of your APIs in API Gateway.
+        :param base_path: The base path name that callers of the private API must provide as part of the URL after the domain name.
+        :param stage: Represents a unique identifier for a version of a deployed private RestApi that is callable by users. The Stage must depend on the ``RestApi`` 's stage. To create a dependency, add a DependsOn attribute to the BasePathMappingV2 resource.
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__a583f31dead36a23816022dfcb476b0ff18ec097d668a0cf42b19791b749acae)
@@ -5359,7 +5363,7 @@ class CfnBasePathMappingV2(
     @builtins.property
     @jsii.member(jsii_name="domainNameArn")
     def domain_name_arn(self) -> builtins.str:
-        '''The Arn of an AWS::ApiGateway::DomainNameV2 resource.'''
+        '''The ARN of the domain name for the BasePathMappingV2 resource to be described.'''
         return typing.cast(builtins.str, jsii.get(self, "domainNameArn"))
 
     @domain_name_arn.setter
@@ -5372,7 +5376,7 @@ class CfnBasePathMappingV2(
     @builtins.property
     @jsii.member(jsii_name="restApiId")
     def rest_api_id(self) -> builtins.str:
-        '''The ID of the API.'''
+        '''The private API's identifier.'''
         return typing.cast(builtins.str, jsii.get(self, "restApiId"))
 
     @rest_api_id.setter
@@ -5385,7 +5389,7 @@ class CfnBasePathMappingV2(
     @builtins.property
     @jsii.member(jsii_name="basePath")
     def base_path(self) -> typing.Optional[builtins.str]:
-        '''The base path name that callers of the API must provide in the URL after the domain name.'''
+        '''The base path name that callers of the private API must provide as part of the URL after the domain name.'''
         return typing.cast(typing.Optional[builtins.str], jsii.get(self, "basePath"))
 
     @base_path.setter
@@ -5398,7 +5402,7 @@ class CfnBasePathMappingV2(
     @builtins.property
     @jsii.member(jsii_name="stage")
     def stage(self) -> typing.Optional[builtins.str]:
-        '''The name of the API's stage.'''
+        '''Represents a unique identifier for a version of a deployed private RestApi that is callable by users.'''
         return typing.cast(typing.Optional[builtins.str], jsii.get(self, "stage"))
 
     @stage.setter
@@ -5430,10 +5434,10 @@ class CfnBasePathMappingV2Props:
     ) -> None:
         '''Properties for defining a ``CfnBasePathMappingV2``.
 
-        :param domain_name_arn: The Arn of an AWS::ApiGateway::DomainNameV2 resource.
-        :param rest_api_id: The ID of the API.
-        :param base_path: The base path name that callers of the API must provide in the URL after the domain name.
-        :param stage: The name of the API's stage.
+        :param domain_name_arn: The ARN of the domain name for the BasePathMappingV2 resource to be described.
+        :param rest_api_id: The private API's identifier. This identifier is unique across all of your APIs in API Gateway.
+        :param base_path: The base path name that callers of the private API must provide as part of the URL after the domain name.
+        :param stage: Represents a unique identifier for a version of a deployed private RestApi that is callable by users. The Stage must depend on the ``RestApi`` 's stage. To create a dependency, add a DependsOn attribute to the BasePathMappingV2 resource.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-basepathmappingv2.html
         :exampleMetadata: fixture=_generated
@@ -5470,7 +5474,7 @@ class CfnBasePathMappingV2Props:
 
     @builtins.property
     def domain_name_arn(self) -> builtins.str:
-        '''The Arn of an AWS::ApiGateway::DomainNameV2 resource.
+        '''The ARN of the domain name for the BasePathMappingV2 resource to be described.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-basepathmappingv2.html#cfn-apigateway-basepathmappingv2-domainnamearn
         '''
@@ -5480,7 +5484,9 @@ class CfnBasePathMappingV2Props:
 
     @builtins.property
     def rest_api_id(self) -> builtins.str:
-        '''The ID of the API.
+        '''The private API's identifier.
+
+        This identifier is unique across all of your APIs in API Gateway.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-basepathmappingv2.html#cfn-apigateway-basepathmappingv2-restapiid
         '''
@@ -5490,7 +5496,7 @@ class CfnBasePathMappingV2Props:
 
     @builtins.property
     def base_path(self) -> typing.Optional[builtins.str]:
-        '''The base path name that callers of the API must provide in the URL after the domain name.
+        '''The base path name that callers of the private API must provide as part of the URL after the domain name.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-basepathmappingv2.html#cfn-apigateway-basepathmappingv2-basepath
         '''
@@ -5499,7 +5505,9 @@ class CfnBasePathMappingV2Props:
 
     @builtins.property
     def stage(self) -> typing.Optional[builtins.str]:
-        '''The name of the API's stage.
+        '''Represents a unique identifier for a version of a deployed private RestApi that is callable by users.
+
+        The Stage must depend on the ``RestApi`` 's stage. To create a dependency, add a DependsOn attribute to the BasePathMappingV2 resource.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-basepathmappingv2.html#cfn-apigateway-basepathmappingv2-stage
         '''
@@ -7659,7 +7667,7 @@ class CfnDomainName(
     metaclass=jsii.JSIIMeta,
     jsii_type="aws-cdk-lib.aws_apigateway.CfnDomainName",
 ):
-    '''The ``AWS::ApiGateway::DomainName`` resource specifies a custom domain name for your API in API Gateway.
+    '''The ``AWS::ApiGateway::DomainName`` resource specifies a public custom domain name for your API in API Gateway.
 
     You can use a custom domain name to provide a URL that's more intuitive and easier to recall. For more information about using custom domain names, see `Set up Custom Domain Name for an API in API Gateway <https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-custom-domains.html>`_ in the *API Gateway Developer Guide* .
 
@@ -7710,7 +7718,7 @@ class CfnDomainName(
         '''
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
-        :param certificate_arn: The reference to an AWS -managed certificate that will be used by edge-optimized endpoint for this domain name. AWS Certificate Manager is the only supported source.
+        :param certificate_arn: The reference to an AWS -managed certificate that will be used by edge-optimized endpoint or private endpoint for this domain name. AWS Certificate Manager is the only supported source.
         :param domain_name: The custom domain name as an API host name, for example, ``my-api.example.com`` .
         :param endpoint_configuration: The endpoint configuration of this DomainName showing the endpoint types of the domain name.
         :param mutual_tls_authentication: The mutual TLS authentication configuration for a custom domain name. If specified, API Gateway performs two-way authentication between the client and the server. Clients must present a trusted certificate to access your API.
@@ -7824,7 +7832,7 @@ class CfnDomainName(
     @builtins.property
     @jsii.member(jsii_name="certificateArn")
     def certificate_arn(self) -> typing.Optional[builtins.str]:
-        '''The reference to an AWS -managed certificate that will be used by edge-optimized endpoint for this domain name.'''
+        '''The reference to an AWS -managed certificate that will be used by edge-optimized endpoint or private endpoint for this domain name.'''
         return typing.cast(typing.Optional[builtins.str], jsii.get(self, "certificateArn"))
 
     @certificate_arn.setter
@@ -8083,7 +8091,11 @@ class CfnDomainNameAccessAssociation(
     metaclass=jsii.JSIIMeta,
     jsii_type="aws-cdk-lib.aws_apigateway.CfnDomainNameAccessAssociation",
 ):
-    '''Resource Type definition for AWS::ApiGateway::DomainNameAccessAssociation.
+    '''The ``AWS::ApiGateway::DomainNameAccessAssociation`` resource creates a domain name access association between an access association source and a private custom domain name.
+
+    Use a domain name access association to invoke a private custom domain name while isolated from the public internet.
+
+    You can only create or delete a DomainNameAccessAssociation using CloudFormation. To reject a domain name access association, use the AWS CLI.
 
     :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-domainnameaccessassociation.html
     :cloudformationResource: AWS::ApiGateway::DomainNameAccessAssociation
@@ -8121,10 +8133,10 @@ class CfnDomainNameAccessAssociation(
         '''
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
-        :param access_association_source: The source of the domain name access association resource.
-        :param access_association_source_type: The source type of the domain name access association resource.
-        :param domain_name_arn: The amazon resource name (ARN) of the domain name resource.
-        :param tags: An array of arbitrary tags (key-value pairs) to associate with the domainname access association.
+        :param access_association_source: The identifier of the domain name access association source. For a ``VPCE`` , the value is the VPC endpoint ID.
+        :param access_association_source_type: The type of the domain name access association source. Only ``VPCE`` is currently supported.
+        :param domain_name_arn: The ARN of the domain name.
+        :param tags: The collection of tags. Each tag element is associated with a given resource.
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__cafcd3b452004fc09063699f5b2263d0f36c2a080b20c7f0d51493646ac87441)
@@ -8172,7 +8184,9 @@ class CfnDomainNameAccessAssociation(
     @builtins.property
     @jsii.member(jsii_name="attrDomainNameAccessAssociationArn")
     def attr_domain_name_access_association_arn(self) -> builtins.str:
-        '''The amazon resource name (ARN) of the domain name access association resource.
+        '''The access association ARN.
+
+        For example: ``arn:aws:apigateway:us-west-2:111122223333:/accessassociations/domainname/private.example.com+abcd1234/vpcesource/vpce-abcd1234efg`` .
 
         :cloudformationAttribute: DomainNameAccessAssociationArn
         '''
@@ -8192,7 +8206,7 @@ class CfnDomainNameAccessAssociation(
     @builtins.property
     @jsii.member(jsii_name="accessAssociationSource")
     def access_association_source(self) -> builtins.str:
-        '''The source of the domain name access association resource.'''
+        '''The identifier of the domain name access association source.'''
         return typing.cast(builtins.str, jsii.get(self, "accessAssociationSource"))
 
     @access_association_source.setter
@@ -8205,7 +8219,7 @@ class CfnDomainNameAccessAssociation(
     @builtins.property
     @jsii.member(jsii_name="accessAssociationSourceType")
     def access_association_source_type(self) -> builtins.str:
-        '''The source type of the domain name access association resource.'''
+        '''The type of the domain name access association source.'''
         return typing.cast(builtins.str, jsii.get(self, "accessAssociationSourceType"))
 
     @access_association_source_type.setter
@@ -8218,7 +8232,7 @@ class CfnDomainNameAccessAssociation(
     @builtins.property
     @jsii.member(jsii_name="domainNameArn")
     def domain_name_arn(self) -> builtins.str:
-        '''The amazon resource name (ARN) of the domain name resource.'''
+        '''The ARN of the domain name.'''
         return typing.cast(builtins.str, jsii.get(self, "domainNameArn"))
 
     @domain_name_arn.setter
@@ -8231,7 +8245,7 @@ class CfnDomainNameAccessAssociation(
     @builtins.property
     @jsii.member(jsii_name="tags")
     def tags(self) -> typing.Optional[typing.List[_CfnTag_f6864754]]:
-        '''An array of arbitrary tags (key-value pairs) to associate with the domainname access association.'''
+        '''The collection of tags.'''
         return typing.cast(typing.Optional[typing.List[_CfnTag_f6864754]], jsii.get(self, "tags"))
 
     @tags.setter
@@ -8263,10 +8277,10 @@ class CfnDomainNameAccessAssociationProps:
     ) -> None:
         '''Properties for defining a ``CfnDomainNameAccessAssociation``.
 
-        :param access_association_source: The source of the domain name access association resource.
-        :param access_association_source_type: The source type of the domain name access association resource.
-        :param domain_name_arn: The amazon resource name (ARN) of the domain name resource.
-        :param tags: An array of arbitrary tags (key-value pairs) to associate with the domainname access association.
+        :param access_association_source: The identifier of the domain name access association source. For a ``VPCE`` , the value is the VPC endpoint ID.
+        :param access_association_source_type: The type of the domain name access association source. Only ``VPCE`` is currently supported.
+        :param domain_name_arn: The ARN of the domain name.
+        :param tags: The collection of tags. Each tag element is associated with a given resource.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-domainnameaccessassociation.html
         :exampleMetadata: fixture=_generated
@@ -8305,7 +8319,9 @@ class CfnDomainNameAccessAssociationProps:
 
     @builtins.property
     def access_association_source(self) -> builtins.str:
-        '''The source of the domain name access association resource.
+        '''The identifier of the domain name access association source.
+
+        For a ``VPCE`` , the value is the VPC endpoint ID.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-domainnameaccessassociation.html#cfn-apigateway-domainnameaccessassociation-accessassociationsource
         '''
@@ -8315,7 +8331,9 @@ class CfnDomainNameAccessAssociationProps:
 
     @builtins.property
     def access_association_source_type(self) -> builtins.str:
-        '''The source type of the domain name access association resource.
+        '''The type of the domain name access association source.
+
+        Only ``VPCE`` is currently supported.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-domainnameaccessassociation.html#cfn-apigateway-domainnameaccessassociation-accessassociationsourcetype
         '''
@@ -8325,7 +8343,7 @@ class CfnDomainNameAccessAssociationProps:
 
     @builtins.property
     def domain_name_arn(self) -> builtins.str:
-        '''The amazon resource name (ARN) of the domain name resource.
+        '''The ARN of the domain name.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-domainnameaccessassociation.html#cfn-apigateway-domainnameaccessassociation-domainnamearn
         '''
@@ -8335,7 +8353,9 @@ class CfnDomainNameAccessAssociationProps:
 
     @builtins.property
     def tags(self) -> typing.Optional[typing.List[_CfnTag_f6864754]]:
-        '''An array of arbitrary tags (key-value pairs) to associate with the domainname access association.
+        '''The collection of tags.
+
+        Each tag element is associated with a given resource.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-domainnameaccessassociation.html#cfn-apigateway-domainnameaccessassociation-tags
         '''
@@ -8383,7 +8403,7 @@ class CfnDomainNameProps:
     ) -> None:
         '''Properties for defining a ``CfnDomainName``.
 
-        :param certificate_arn: The reference to an AWS -managed certificate that will be used by edge-optimized endpoint for this domain name. AWS Certificate Manager is the only supported source.
+        :param certificate_arn: The reference to an AWS -managed certificate that will be used by edge-optimized endpoint or private endpoint for this domain name. AWS Certificate Manager is the only supported source.
         :param domain_name: The custom domain name as an API host name, for example, ``my-api.example.com`` .
         :param endpoint_configuration: The endpoint configuration of this DomainName showing the endpoint types of the domain name.
         :param mutual_tls_authentication: The mutual TLS authentication configuration for a custom domain name. If specified, API Gateway performs two-way authentication between the client and the server. Clients must present a trusted certificate to access your API.
@@ -8450,7 +8470,7 @@ class CfnDomainNameProps:
 
     @builtins.property
     def certificate_arn(self) -> typing.Optional[builtins.str]:
-        '''The reference to an AWS -managed certificate that will be used by edge-optimized endpoint for this domain name.
+        '''The reference to an AWS -managed certificate that will be used by edge-optimized endpoint or private endpoint for this domain name.
 
         AWS Certificate Manager is the only supported source.
 
@@ -8554,7 +8574,9 @@ class CfnDomainNameV2(
     metaclass=jsii.JSIIMeta,
     jsii_type="aws-cdk-lib.aws_apigateway.CfnDomainNameV2",
 ):
-    '''Resource Type definition for AWS::ApiGateway::DomainNameV2.
+    '''The ``AWS::ApiGateway::DomainNameV2`` resource specifies a custom domain name for your private APIs in API Gateway.
+
+    You can use a private custom domain name to provide a URL for your private API that's more intuitive and easier to recall.
 
     :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-domainnamev2.html
     :cloudformationResource: AWS::ApiGateway::DomainNameV2
@@ -8601,13 +8623,13 @@ class CfnDomainNameV2(
         '''
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
-        :param certificate_arn: 
-        :param domain_name: 
-        :param endpoint_configuration: 
+        :param certificate_arn: The reference to an AWS -managed certificate that will be used by the private endpoint for this domain name. AWS Certificate Manager is the only supported source.
+        :param domain_name: Represents a custom domain name as a user-friendly host name of an API (RestApi).
+        :param endpoint_configuration: The endpoint configuration to indicate the types of endpoints an API (RestApi) or its custom domain name (DomainName) has.
         :param management_policy: 
-        :param policy: 
-        :param security_policy: 
-        :param tags: 
+        :param policy: A stringified JSON policy document that applies to the ``execute-api`` service for this DomainName regardless of the caller and Method configuration. You can use ``Fn::ToJsonString`` to enter your ``policy`` . For more information, see `Fn::ToJsonString <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-ToJsonString.html>`_ .
+        :param security_policy: The Transport Layer Security (TLS) version + cipher suite for this DomainName. Only ``TLS_1_2`` is supported.
+        :param tags: The collection of tags. Each tag element is associated with a given resource.
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__a4f501d10d57d39a48913872efdcb7d389a076fed9b5aabb21034b8e60a1e0bf)
@@ -8658,7 +8680,7 @@ class CfnDomainNameV2(
     @builtins.property
     @jsii.member(jsii_name="attrDomainNameArn")
     def attr_domain_name_arn(self) -> builtins.str:
-        '''The amazon resource name (ARN) of the domain name resource.
+        '''The ARN of the domain name.
 
         :cloudformationAttribute: DomainNameArn
         '''
@@ -8667,7 +8689,8 @@ class CfnDomainNameV2(
     @builtins.property
     @jsii.member(jsii_name="attrDomainNameId")
     def attr_domain_name_id(self) -> builtins.str:
-        '''
+        '''The domain name ID.
+
         :cloudformationAttribute: DomainNameId
         '''
         return typing.cast(builtins.str, jsii.get(self, "attrDomainNameId"))
@@ -8686,6 +8709,7 @@ class CfnDomainNameV2(
     @builtins.property
     @jsii.member(jsii_name="certificateArn")
     def certificate_arn(self) -> typing.Optional[builtins.str]:
+        '''The reference to an AWS -managed certificate that will be used by the private endpoint for this domain name.'''
         return typing.cast(typing.Optional[builtins.str], jsii.get(self, "certificateArn"))
 
     @certificate_arn.setter
@@ -8698,6 +8722,7 @@ class CfnDomainNameV2(
     @builtins.property
     @jsii.member(jsii_name="domainName")
     def domain_name(self) -> typing.Optional[builtins.str]:
+        '''Represents a custom domain name as a user-friendly host name of an API (RestApi).'''
         return typing.cast(typing.Optional[builtins.str], jsii.get(self, "domainName"))
 
     @domain_name.setter
@@ -8712,6 +8737,7 @@ class CfnDomainNameV2(
     def endpoint_configuration(
         self,
     ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnDomainNameV2.EndpointConfigurationProperty"]]:
+        '''The endpoint configuration to indicate the types of endpoints an API (RestApi) or its custom domain name (DomainName) has.'''
         return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnDomainNameV2.EndpointConfigurationProperty"]], jsii.get(self, "endpointConfiguration"))
 
     @endpoint_configuration.setter
@@ -8739,6 +8765,7 @@ class CfnDomainNameV2(
     @builtins.property
     @jsii.member(jsii_name="policy")
     def policy(self) -> typing.Any:
+        '''A stringified JSON policy document that applies to the ``execute-api`` service for this DomainName regardless of the caller and Method configuration.'''
         return typing.cast(typing.Any, jsii.get(self, "policy"))
 
     @policy.setter
@@ -8751,6 +8778,7 @@ class CfnDomainNameV2(
     @builtins.property
     @jsii.member(jsii_name="securityPolicy")
     def security_policy(self) -> typing.Optional[builtins.str]:
+        '''The Transport Layer Security (TLS) version + cipher suite for this DomainName.'''
         return typing.cast(typing.Optional[builtins.str], jsii.get(self, "securityPolicy"))
 
     @security_policy.setter
@@ -8763,6 +8791,7 @@ class CfnDomainNameV2(
     @builtins.property
     @jsii.member(jsii_name="tags")
     def tags(self) -> typing.Optional[typing.List[_CfnTag_f6864754]]:
+        '''The collection of tags.'''
         return typing.cast(typing.Optional[typing.List[_CfnTag_f6864754]], jsii.get(self, "tags"))
 
     @tags.setter
@@ -8783,8 +8812,9 @@ class CfnDomainNameV2(
             *,
             types: typing.Optional[typing.Sequence[builtins.str]] = None,
         ) -> None:
-            '''
-            :param types: 
+            '''The endpoint configuration to indicate the types of endpoints an API (RestApi) or its custom domain name (DomainName) has.
+
+            :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-domainnamev2-endpointconfiguration.html
             :exampleMetadata: fixture=_generated
@@ -8808,7 +8838,10 @@ class CfnDomainNameV2(
 
         @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).
+
+            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-domainnamev2-endpointconfiguration.html#cfn-apigateway-domainnamev2-endpointconfiguration-types
             '''
             result = self._values.get("types")
@@ -8853,13 +8886,13 @@ class CfnDomainNameV2Props:
     ) -> None:
         '''Properties for defining a ``CfnDomainNameV2``.
 
-        :param certificate_arn: 
-        :param domain_name: 
-        :param endpoint_configuration: 
+        :param certificate_arn: The reference to an AWS -managed certificate that will be used by the private endpoint for this domain name. AWS Certificate Manager is the only supported source.
+        :param domain_name: Represents a custom domain name as a user-friendly host name of an API (RestApi).
+        :param endpoint_configuration: The endpoint configuration to indicate the types of endpoints an API (RestApi) or its custom domain name (DomainName) has.
         :param management_policy: 
-        :param policy: 
-        :param security_policy: 
-        :param tags: 
+        :param policy: A stringified JSON policy document that applies to the ``execute-api`` service for this DomainName regardless of the caller and Method configuration. You can use ``Fn::ToJsonString`` to enter your ``policy`` . For more information, see `Fn::ToJsonString <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-ToJsonString.html>`_ .
+        :param security_policy: The Transport Layer Security (TLS) version + cipher suite for this DomainName. Only ``TLS_1_2`` is supported.
+        :param tags: The collection of tags. Each tag element is associated with a given resource.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-domainnamev2.html
         :exampleMetadata: fixture=_generated
@@ -8915,7 +8948,10 @@ class CfnDomainNameV2Props:
 
     @builtins.property
     def certificate_arn(self) -> typing.Optional[builtins.str]:
-        '''
+        '''The reference to an AWS -managed certificate that will be used by the private endpoint for this domain name.
+
+        AWS Certificate Manager is the only supported source.
+
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-domainnamev2.html#cfn-apigateway-domainnamev2-certificatearn
         '''
         result = self._values.get("certificate_arn")
@@ -8923,7 +8959,8 @@ class CfnDomainNameV2Props:
 
     @builtins.property
     def domain_name(self) -> typing.Optional[builtins.str]:
-        '''
+        '''Represents a custom domain name as a user-friendly host name of an API (RestApi).
+
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-domainnamev2.html#cfn-apigateway-domainnamev2-domainname
         '''
         result = self._values.get("domain_name")
@@ -8933,7 +8970,8 @@ class CfnDomainNameV2Props:
     def endpoint_configuration(
         self,
     ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnDomainNameV2.EndpointConfigurationProperty]]:
-        '''
+        '''The endpoint configuration to indicate the types of endpoints an API (RestApi) or its custom domain name (DomainName) has.
+
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-domainnamev2.html#cfn-apigateway-domainnamev2-endpointconfiguration
         '''
         result = self._values.get("endpoint_configuration")
@@ -8949,7 +8987,10 @@ class CfnDomainNameV2Props:
 
     @builtins.property
     def policy(self) -> typing.Any:
-        '''
+        '''A stringified JSON policy document that applies to the ``execute-api`` service for this DomainName regardless of the caller and Method configuration.
+
+        You can use ``Fn::ToJsonString`` to enter your ``policy`` . For more information, see `Fn::ToJsonString <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-ToJsonString.html>`_ .
+
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-domainnamev2.html#cfn-apigateway-domainnamev2-policy
         '''
         result = self._values.get("policy")
@@ -8957,7 +8998,10 @@ class CfnDomainNameV2Props:
 
     @builtins.property
     def security_policy(self) -> typing.Optional[builtins.str]:
-        '''
+        '''The Transport Layer Security (TLS) version + cipher suite for this DomainName.
+
+        Only ``TLS_1_2`` is supported.
+
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-domainnamev2.html#cfn-apigateway-domainnamev2-securitypolicy
         '''
         result = self._values.get("security_policy")
@@ -8965,7 +9009,10 @@ class CfnDomainNameV2Props:
 
     @builtins.property
     def tags(self) -> typing.Optional[typing.List[_CfnTag_f6864754]]:
-        '''
+        '''The collection of tags.
+
+        Each tag element is associated with a given resource.
+
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-domainnamev2.html#cfn-apigateway-domainnamev2-tags
         '''
         result = self._values.get("tags")