aws-cdk-lib 2.205.0__py3-none-any.whl → 2.207.0__py3-none-any.whl

aws_cdk/aws_datasync/__init__.py

@@ -4643,7 +4643,7 @@ class CfnLocationNFS(
         :param id: Construct identifier for this resource (unique in its scope).
         :param on_prem_config: Specifies the Amazon Resource Name (ARN) of the DataSync agent that can connect to your NFS file server. You can specify more than one agent. For more information, see `Using multiple DataSync agents <https://docs.aws.amazon.com/datasync/latest/userguide/do-i-need-datasync-agent.html#multiple-agents>`_ .
         :param mount_options: Specifies the options that DataSync can use to mount your NFS file server.
-        :param server_hostname: Specifies the DNS name or IP version 4 address of the NFS file server that your DataSync agent connects to.
+        :param server_hostname: Specifies the DNS name or IP address (IPv4 or IPv6) of the NFS file server that your DataSync agent connects to.
         :param subdirectory: Specifies the export path in your NFS file server that you want DataSync to mount. This path (or a subdirectory of the path) is where DataSync transfers data to or from. For information on configuring an export for DataSync, see `Accessing NFS file servers <https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#accessing-nfs>`_ .
         :param tags: Specifies labels that help you categorize, filter, and search for your AWS resources. We recommend creating at least a name tag for your location.
         '''
@@ -4759,7 +4759,7 @@ class CfnLocationNFS(
     @builtins.property
     @jsii.member(jsii_name="serverHostname")
     def server_hostname(self) -> typing.Optional[builtins.str]:
-        '''Specifies the DNS name or IP version 4 address of the NFS file server that your DataSync agent connects to.'''
+        '''Specifies the DNS name or IP address (IPv4 or IPv6) of the NFS file server that your DataSync agent connects to.'''
         return typing.cast(typing.Optional[builtins.str], jsii.get(self, "serverHostname"))
 
     @server_hostname.setter
@@ -4939,7 +4939,7 @@ class CfnLocationNFSProps:
 
         :param on_prem_config: Specifies the Amazon Resource Name (ARN) of the DataSync agent that can connect to your NFS file server. You can specify more than one agent. For more information, see `Using multiple DataSync agents <https://docs.aws.amazon.com/datasync/latest/userguide/do-i-need-datasync-agent.html#multiple-agents>`_ .
         :param mount_options: Specifies the options that DataSync can use to mount your NFS file server.
-        :param server_hostname: Specifies the DNS name or IP version 4 address of the NFS file server that your DataSync agent connects to.
+        :param server_hostname: Specifies the DNS name or IP address (IPv4 or IPv6) of the NFS file server that your DataSync agent connects to.
         :param subdirectory: Specifies the export path in your NFS file server that you want DataSync to mount. This path (or a subdirectory of the path) is where DataSync transfers data to or from. For information on configuring an export for DataSync, see `Accessing NFS file servers <https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#accessing-nfs>`_ .
         :param tags: Specifies labels that help you categorize, filter, and search for your AWS resources. We recommend creating at least a name tag for your location.
 
@@ -5015,7 +5015,7 @@ class CfnLocationNFSProps:
 
     @builtins.property
     def server_hostname(self) -> typing.Optional[builtins.str]:
-        '''Specifies the DNS name or IP version 4 address of the NFS file server that your DataSync agent connects to.
+        '''Specifies the DNS name or IP address (IPv4 or IPv6) of the NFS file server that your DataSync agent connects to.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-datasync-locationnfs.html#cfn-datasync-locationnfs-serverhostname
         '''
@@ -5129,7 +5129,7 @@ class CfnLocationObjectStorage(
         :param custom_secret_config: Specifies configuration information for a customer-managed Secrets Manager secret where the secret key for a specific object storage location is stored in plain text. This configuration includes the secret ARN, and the ARN for an IAM role that provides access to the secret. .. epigraph:: You can use either ``CmkSecretConfig`` (with ``SecretKey`` ) or ``CustomSecretConfig`` (without ``SecretKey`` ) to provide credentials for a ``CreateLocationObjectStorage`` request. Do not provide both parameters for the same request.
         :param secret_key: Specifies the secret key (for example, a password) if credentials are required to authenticate with the object storage server. .. epigraph:: If you provide a secret using ``SecretKey`` , but do not provide secret configuration details using ``CmkSecretConfig`` or ``CustomSecretConfig`` , then DataSync stores the token using your AWS account's Secrets Manager secret.
         :param server_certificate: Specifies a certificate chain for DataSync to authenticate with your object storage system if the system uses a private or self-signed certificate authority (CA). You must specify a single ``.pem`` file with a full certificate chain (for example, ``file:///home/user/.ssh/object_storage_certificates.pem`` ). The certificate chain might include: - The object storage system's certificate - All intermediate certificates (if there are any) - The root certificate of the signing CA You can concatenate your certificates into a ``.pem`` file (which can be up to 32768 bytes before base64 encoding). The following example ``cat`` command creates an ``object_storage_certificates.pem`` file that includes three certificates: ``cat object_server_certificate.pem intermediate_certificate.pem ca_root_certificate.pem > object_storage_certificates.pem`` To use this parameter, configure ``ServerProtocol`` to ``HTTPS`` .
-        :param server_hostname: Specifies the domain name or IP version 4 (IPv4) address of the object storage server that your DataSync agent connects to.
+        :param server_hostname: Specifies the domain name or IP address (IPv4 or IPv6) of the object storage server that your DataSync agent connects to.
         :param server_port: Specifies the port that your object storage server accepts inbound network traffic on (for example, port 443).
         :param server_protocol: Specifies the protocol that your object storage server uses to communicate. If not specified, the default value is ``HTTPS`` .
         :param subdirectory: Specifies the object prefix for your object storage server. If this is a source location, DataSync only copies objects with this prefix. If this is a destination location, DataSync writes all objects with this prefix.
@@ -5341,7 +5341,7 @@ class CfnLocationObjectStorage(
     @builtins.property
     @jsii.member(jsii_name="serverHostname")
     def server_hostname(self) -> typing.Optional[builtins.str]:
-        '''Specifies the domain name or IP version 4 (IPv4) address of the object storage server that your DataSync agent connects to.'''
+        '''Specifies the domain name or IP address (IPv4 or IPv6) of the object storage server that your DataSync agent connects to.'''
         return typing.cast(typing.Optional[builtins.str], jsii.get(self, "serverHostname"))
 
     @server_hostname.setter
@@ -5659,7 +5659,7 @@ class CfnLocationObjectStorageProps:
         :param custom_secret_config: Specifies configuration information for a customer-managed Secrets Manager secret where the secret key for a specific object storage location is stored in plain text. This configuration includes the secret ARN, and the ARN for an IAM role that provides access to the secret. .. epigraph:: You can use either ``CmkSecretConfig`` (with ``SecretKey`` ) or ``CustomSecretConfig`` (without ``SecretKey`` ) to provide credentials for a ``CreateLocationObjectStorage`` request. Do not provide both parameters for the same request.
         :param secret_key: Specifies the secret key (for example, a password) if credentials are required to authenticate with the object storage server. .. epigraph:: If you provide a secret using ``SecretKey`` , but do not provide secret configuration details using ``CmkSecretConfig`` or ``CustomSecretConfig`` , then DataSync stores the token using your AWS account's Secrets Manager secret.
         :param server_certificate: Specifies a certificate chain for DataSync to authenticate with your object storage system if the system uses a private or self-signed certificate authority (CA). You must specify a single ``.pem`` file with a full certificate chain (for example, ``file:///home/user/.ssh/object_storage_certificates.pem`` ). The certificate chain might include: - The object storage system's certificate - All intermediate certificates (if there are any) - The root certificate of the signing CA You can concatenate your certificates into a ``.pem`` file (which can be up to 32768 bytes before base64 encoding). The following example ``cat`` command creates an ``object_storage_certificates.pem`` file that includes three certificates: ``cat object_server_certificate.pem intermediate_certificate.pem ca_root_certificate.pem > object_storage_certificates.pem`` To use this parameter, configure ``ServerProtocol`` to ``HTTPS`` .
-        :param server_hostname: Specifies the domain name or IP version 4 (IPv4) address of the object storage server that your DataSync agent connects to.
+        :param server_hostname: Specifies the domain name or IP address (IPv4 or IPv6) of the object storage server that your DataSync agent connects to.
         :param server_port: Specifies the port that your object storage server accepts inbound network traffic on (for example, port 443).
         :param server_protocol: Specifies the protocol that your object storage server uses to communicate. If not specified, the default value is ``HTTPS`` .
         :param subdirectory: Specifies the object prefix for your object storage server. If this is a source location, DataSync only copies objects with this prefix. If this is a destination location, DataSync writes all objects with this prefix.
@@ -5842,7 +5842,7 @@ class CfnLocationObjectStorageProps:
 
     @builtins.property
     def server_hostname(self) -> typing.Optional[builtins.str]:
-        '''Specifies the domain name or IP version 4 (IPv4) address of the object storage server that your DataSync agent connects to.
+        '''Specifies the domain name or IP address (IPv4 or IPv6) of the object storage server that your DataSync agent connects to.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-datasync-locationobjectstorage.html#cfn-datasync-locationobjectstorage-serverhostname
         '''
@@ -6381,7 +6381,7 @@ class CfnLocationSMB(
         :param kerberos_principal: Specifies a service principal name (SPN), which is an identity in your Kerberos realm that has permission to access the files, folders, and file metadata in your SMB file server. SPNs are case sensitive and must include a prepended cifs/. For example, an SPN might look like cifs/kerberosuser@EXAMPLE.COM. Your task execution will fail if the SPN that you provide for this parameter doesn't match exactly what's in your keytab or krb5.conf files.
         :param mount_options: Specifies the version of the SMB protocol that DataSync uses to access your SMB file server.
         :param password: Specifies the password of the user who can mount your SMB file server and has permission to access the files and folders involved in your transfer. This parameter applies only if ``AuthenticationType`` is set to ``NTLM`` .
-        :param server_hostname: Specifies the domain name or IP address of the SMB file server that your DataSync agent connects to. Remember the following when configuring this parameter: - You can't specify an IP version 6 (IPv6) address. - If you're using Kerberos authentication, you must specify a domain name.
+        :param server_hostname: Specifies the domain name or IP address (IPv4 or IPv6) of the SMB file server that your DataSync agent connects to. .. epigraph:: If you're using Kerberos authentication, you must specify a domain name.
         :param subdirectory: Specifies the name of the share exported by your SMB file server where DataSync will read or write data. You can include a subdirectory in the share path (for example, ``/path/to/subdirectory`` ). Make sure that other SMB clients in your network can also mount this path. To copy all data in the subdirectory, DataSync must be able to mount the SMB share and access all of its data. For more information, see `Providing DataSync access to SMB file servers <https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions>`_ .
         :param tags: Specifies labels that help you categorize, filter, and search for your AWS resources. We recommend creating at least a name tag for your location.
         :param user: Specifies the user that can mount and access the files, folders, and file metadata in your SMB file server. This parameter applies only if ``AuthenticationType`` is set to ``NTLM`` . For information about choosing a user with the right level of access for your transfer, see `Providing DataSync access to SMB file servers <https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions>`_ .
@@ -6595,7 +6595,7 @@ class CfnLocationSMB(
     @builtins.property
     @jsii.member(jsii_name="serverHostname")
     def server_hostname(self) -> typing.Optional[builtins.str]:
-        '''Specifies the domain name or IP address of the SMB file server that your DataSync agent connects to.'''
+        '''Specifies the domain name or IP address (IPv4 or IPv6) of the SMB file server that your DataSync agent connects to.'''
         return typing.cast(typing.Optional[builtins.str], jsii.get(self, "serverHostname"))
 
     @server_hostname.setter
@@ -6761,7 +6761,7 @@ class CfnLocationSMBProps:
         :param kerberos_principal: Specifies a service principal name (SPN), which is an identity in your Kerberos realm that has permission to access the files, folders, and file metadata in your SMB file server. SPNs are case sensitive and must include a prepended cifs/. For example, an SPN might look like cifs/kerberosuser@EXAMPLE.COM. Your task execution will fail if the SPN that you provide for this parameter doesn't match exactly what's in your keytab or krb5.conf files.
         :param mount_options: Specifies the version of the SMB protocol that DataSync uses to access your SMB file server.
         :param password: Specifies the password of the user who can mount your SMB file server and has permission to access the files and folders involved in your transfer. This parameter applies only if ``AuthenticationType`` is set to ``NTLM`` .
-        :param server_hostname: Specifies the domain name or IP address of the SMB file server that your DataSync agent connects to. Remember the following when configuring this parameter: - You can't specify an IP version 6 (IPv6) address. - If you're using Kerberos authentication, you must specify a domain name.
+        :param server_hostname: Specifies the domain name or IP address (IPv4 or IPv6) of the SMB file server that your DataSync agent connects to. .. epigraph:: If you're using Kerberos authentication, you must specify a domain name.
         :param subdirectory: Specifies the name of the share exported by your SMB file server where DataSync will read or write data. You can include a subdirectory in the share path (for example, ``/path/to/subdirectory`` ). Make sure that other SMB clients in your network can also mount this path. To copy all data in the subdirectory, DataSync must be able to mount the SMB share and access all of its data. For more information, see `Providing DataSync access to SMB file servers <https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions>`_ .
         :param tags: Specifies labels that help you categorize, filter, and search for your AWS resources. We recommend creating at least a name tag for your location.
         :param user: Specifies the user that can mount and access the files, folders, and file metadata in your SMB file server. This parameter applies only if ``AuthenticationType`` is set to ``NTLM`` . For information about choosing a user with the right level of access for your transfer, see `Providing DataSync access to SMB file servers <https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions>`_ .
@@ -6941,12 +6941,11 @@ class CfnLocationSMBProps:
 
     @builtins.property
     def server_hostname(self) -> typing.Optional[builtins.str]:
-        '''Specifies the domain name or IP address of the SMB file server that your DataSync agent connects to.
+        '''Specifies the domain name or IP address (IPv4 or IPv6) of the SMB file server that your DataSync agent connects to.
 
-        Remember the following when configuring this parameter:
+        .. epigraph::
 
-        - You can't specify an IP version 6 (IPv6) address.
-        - If you're using Kerberos authentication, you must specify a domain name.
+           If you're using Kerberos authentication, you must specify a domain name.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-datasync-locationsmb.html#cfn-datasync-locationsmb-serverhostname
         '''

aws_cdk/aws_ec2/__init__.py

@@ -24427,7 +24427,7 @@ class CfnInstanceConnectEndpoint(
         :param id: Construct identifier for this resource (unique in its scope).
         :param subnet_id: The ID of the subnet in which to create the EC2 Instance Connect Endpoint.
         :param client_token: Unique, case-sensitive identifier that you provide to ensure the idempotency of the request.
-        :param preserve_client_ip: Indicates whether the client IP address is preserved as the source. The following are the possible values. - ``true`` - Use the client IP address as the source. - ``false`` - Use the network interface IP address as the source. Default: ``false``
+        :param preserve_client_ip: Indicates whether the client IP address is preserved as the source. The following are the possible values. - ``true`` - Use the client IP address as the source. - ``false`` - Use the network interface IP address as the source. .. epigraph:: ``PreserveClientIp`` is only supported on IPv4 EC2 Instance Connect Endpoints. To use ``PreserveClientIp`` , the value for ``IpAddressType`` must be ``ipv4`` . Default: ``false``
         :param security_group_ids: One or more security groups to associate with the endpoint. If you don't specify a security group, the default security group for your VPC will be associated with the endpoint.
         :param tags: The tags to apply to the EC2 Instance Connect Endpoint during creation.
         '''
@@ -24597,7 +24597,7 @@ class CfnInstanceConnectEndpointProps:
 
         :param subnet_id: The ID of the subnet in which to create the EC2 Instance Connect Endpoint.
         :param client_token: Unique, case-sensitive identifier that you provide to ensure the idempotency of the request.
-        :param preserve_client_ip: Indicates whether the client IP address is preserved as the source. The following are the possible values. - ``true`` - Use the client IP address as the source. - ``false`` - Use the network interface IP address as the source. Default: ``false``
+        :param preserve_client_ip: Indicates whether the client IP address is preserved as the source. The following are the possible values. - ``true`` - Use the client IP address as the source. - ``false`` - Use the network interface IP address as the source. .. epigraph:: ``PreserveClientIp`` is only supported on IPv4 EC2 Instance Connect Endpoints. To use ``PreserveClientIp`` , the value for ``IpAddressType`` must be ``ipv4`` . Default: ``false``
         :param security_group_ids: One or more security groups to associate with the endpoint. If you don't specify a security group, the default security group for your VPC will be associated with the endpoint.
         :param tags: The tags to apply to the EC2 Instance Connect Endpoint during creation.
 
@@ -24670,6 +24670,10 @@ class CfnInstanceConnectEndpointProps:
         - ``true`` - Use the client IP address as the source.
         - ``false`` - Use the network interface IP address as the source.
 
+        .. epigraph::
+
+           ``PreserveClientIp`` is only supported on IPv4 EC2 Instance Connect Endpoints. To use ``PreserveClientIp`` , the value for ``IpAddressType`` must be ``ipv4`` .
+
         Default: ``false``
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-instanceconnectendpoint.html#cfn-ec2-instanceconnectendpoint-preserveclientip