Interface CfnLocationSMBProps
- All Superinterfaces:
software.amazon.jsii.JsiiSerializable
- All Known Implementing Classes:
CfnLocationSMBProps.Jsii$Proxy
CfnLocationSMB.
Example:
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import software.amazon.awscdk.services.datasync.*;
CfnLocationSMBProps cfnLocationSMBProps = CfnLocationSMBProps.builder()
.agentArns(List.of("agentArns"))
// the properties below are optional
.authenticationType("authenticationType")
.cmkSecretConfig(CmkSecretConfigProperty.builder()
.kmsKeyArn("kmsKeyArn")
.secretArn("secretArn")
.build())
.customSecretConfig(CustomSecretConfigProperty.builder()
.secretAccessRoleArn("secretAccessRoleArn")
.secretArn("secretArn")
.build())
.dnsIpAddresses(List.of("dnsIpAddresses"))
.domain("domain")
.kerberosKeytab("kerberosKeytab")
.kerberosKrb5Conf("kerberosKrb5Conf")
.kerberosPrincipal("kerberosPrincipal")
.mountOptions(MountOptionsProperty.builder()
.version("version")
.build())
.password("password")
.serverHostname("serverHostname")
.subdirectory("subdirectory")
.tags(List.of(CfnTag.builder()
.key("key")
.value("value")
.build()))
.user("user")
.build();
- See Also:
-
Nested Class Summary
Nested ClassesModifier and TypeInterfaceDescriptionstatic final classA builder forCfnLocationSMBPropsstatic final classAn implementation forCfnLocationSMBProps -
Method Summary
Modifier and TypeMethodDescriptionstatic CfnLocationSMBProps.Builderbuilder()Specifies the DataSync agent (or agents) that can connect to your SMB file server.default StringThe authentication mode used to determine identity of user.default ObjectSpecifies configuration information for a DataSync-managed secret, such as an authentication token or secret key that DataSync uses to access a specific storage location, with a customer-managed AWS KMS key .default ObjectSpecifies configuration information for a customer-managed Secrets Manager secret where a storage location authentication token or secret key is stored in plain text.Specifies the IPv4 addresses for the DNS servers that your SMB file server belongs to.default StringSpecifies the Windows domain name that your SMB file server belongs to.default StringThe Base64 string representation of the Keytab file.default StringThe string representation of the Krb5Conf file, or the presigned URL to access the Krb5.conf file within an S3 bucket.default StringSpecifies 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.default ObjectSpecifies the version of the SMB protocol that DataSync uses to access your SMB file server.default StringSpecifies 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.default StringSpecifies the domain name or IP address (IPv4 or IPv6) of the SMB file server that your DataSync agent connects to.default StringSpecifies the name of the share exported by your SMB file server where DataSync will read or write data.getTags()Specifies labels that help you categorize, filter, and search for your AWS resources.default StringgetUser()Specifies the user that can mount and access the files, folders, and file metadata in your SMB file server.Methods inherited from interface software.amazon.jsii.JsiiSerializable
$jsii$toJson
-
Method Details
-
getAgentArns
Specifies the DataSync agent (or agents) that can connect to your SMB file server.You specify an agent by using its Amazon Resource Name (ARN).
- See Also:
-
getAuthenticationType
The authentication mode used to determine identity of user.- See Also:
-
getCmkSecretConfig
Specifies configuration information for a DataSync-managed secret, such as an authentication token or secret key that DataSync uses to access a specific storage location, with a customer-managed AWS KMS key .You can use either
CmkSecretConfigorCustomSecretConfigto provide credentials for aCreateLocationrequest. Do not provide both parameters for the same request.Returns union: either
IResolvableorCfnLocationSMB.CmkSecretConfigProperty- See Also:
-
getCustomSecretConfig
Specifies configuration information for a customer-managed Secrets Manager secret where a storage location authentication token or secret key is stored in plain text.This configuration includes the secret ARN, and the ARN for an IAM role that provides access to the secret.
You can use either
CmkSecretConfigorCustomSecretConfigto provide credentials for aCreateLocationrequest. Do not provide both parameters for the same request.Returns union: either
IResolvableorCfnLocationSMB.CustomSecretConfigProperty- See Also:
-
getDnsIpAddresses
Specifies the IPv4 addresses for the DNS servers that your SMB file server belongs to.This parameter applies only if AuthenticationType is set to KERBEROS. If you have multiple domains in your environment, configuring this parameter makes sure that DataSync connects to the right SMB file server.
- See Also:
-
getDomain
Specifies the Windows domain name that your SMB file server belongs to.This parameter applies only if
AuthenticationTypeis set toNTLM.If you have multiple domains in your environment, configuring this parameter makes sure that DataSync connects to the right file server.
- See Also:
-
getKerberosKeytab
The Base64 string representation of the Keytab file.Specifies your Kerberos key table (keytab) file, which includes mappings between your service principal name (SPN) and encryption keys. To avoid task execution errors, make sure that the SPN in the keytab file matches exactly what you specify for KerberosPrincipal and in your krb5.conf file.
- See Also:
-
getKerberosKrb5Conf
The string representation of the Krb5Conf file, or the presigned URL to access the Krb5.conf file within an S3 bucket. Specifies a Kerberos configuration file (krb5.conf) that defines your Kerberos realm configuration. To avoid task execution errors, make sure that the service principal name (SPN) in the krb5.conf file matches exactly what you specify for KerberosPrincipal and in your keytab file.- See Also:
-
getKerberosPrincipal
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.
- See Also:
-
getMountOptions
Specifies the version of the SMB protocol that DataSync uses to access your SMB file server.Returns union: either
IResolvableorCfnLocationSMB.MountOptionsProperty- See Also:
-
getPassword
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
AuthenticationTypeis set toNTLM.- See Also:
-
getServerHostname
Specifies the domain name or IP address (IPv4 or IPv6) of the SMB file server that your DataSync agent connects to.If you're using Kerberos authentication, you must specify a domain name.
- See Also:
-
getSubdirectory
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 .
- See Also:
-
getTags
Specifies labels that help you categorize, filter, and search for your AWS resources.We recommend creating at least a name tag for your location.
- See Also:
-
getUser
Specifies the user that can mount and access the files, folders, and file metadata in your SMB file server.This parameter applies only if
AuthenticationTypeis set toNTLM.For information about choosing a user with the right level of access for your transfer, see Providing DataSync access to SMB file servers .
- See Also:
-
builder
- Returns:
- a
CfnLocationSMBProps.BuilderofCfnLocationSMBProps
-