Skip to content
v2.274.0

AWS::DataSync Construct Library ​

This module is part of the AWS Cloud Development Kit project.

ts
import * as datasync from 'aws-cdk-lib/aws-datasync';
python
import aws_cdk.aws_datasync as datasync
java
import software.amazon.awscdk.services.datasync.*;
csharp
using Amazon.CDK.AWS.DataSync;
go
import datasync "github.com/aws/aws-cdk-go/awscdk"

There are no official hand-written (L2) constructs for this service yet. Here are some suggestions on how to proceed:

There are no hand-written (L2) constructs for this service yet. However, you can still use the automatically generated L1 constructs, and use this service exactly as you would using CloudFormation directly.

For more information on the resources and properties available for this service, see the CloudFormation documentation for AWS::DataSync.

(Read the CDK Contributing Guide and submit an RFC if you are interested in contributing to this construct library.)

Types ​

NameKindSummary
CfnAgentConstruct (L1)The AWS::DataSync::Agent resource activates an AWS DataSync agent that you've deployed for storage discovery or data transfers.
CfnLocationAzureBlobConstruct (L1)Creates a transfer location for a Microsoft Azure Blob Storage container.
CfnLocationEFSConstruct (L1)The AWS::DataSync::LocationEFS resource creates an endpoint for an Amazon EFS file system.
CfnLocationFSxLustreConstruct (L1)The AWS::DataSync::LocationFSxLustre resource specifies an endpoint for an Amazon FSx for Lustre file system.
CfnLocationFSxONTAPConstruct (L1)The AWS::DataSync::LocationFSxONTAP resource creates an endpoint for an Amazon FSx for NetApp ONTAP file system.
CfnLocationFSxOpenZFSConstruct (L1)The AWS::DataSync::LocationFSxOpenZFS resource specifies an endpoint for an Amazon FSx for OpenZFS file system.
CfnLocationFSxWindowsConstruct (L1)The AWS::DataSync::LocationFSxWindows resource specifies an endpoint for an Amazon FSx for Windows Server file system.
CfnLocationHDFSConstruct (L1)The AWS::DataSync::LocationHDFS resource specifies an endpoint for a Hadoop Distributed File System (HDFS).
CfnLocationNFSConstruct (L1)The AWS::DataSync::LocationNFS resource specifies a Network File System (NFS) file server that AWS DataSync can use as a transfer source or destination.
CfnLocationObjectStorageConstruct (L1)The AWS::DataSync::LocationObjectStorage resource specifies an endpoint for a self-managed object storage bucket.
CfnLocationS3Construct (L1)The AWS::DataSync::LocationS3 resource specifies an endpoint for an Amazon S3 bucket.
CfnLocationSMBConstruct (L1)The AWS::DataSync::LocationSMB resource specifies a Server Message Block (SMB) location that AWS DataSync can use as a transfer source or destination.
CfnTaskConstruct (L1)The AWS::DataSync::Task resource specifies a task.
CfnAgentPropsStructProperties for defining a CfnAgent.
CfnLocationAzureBlob.AzureBlobSasConfigurationPropertyStructThe shared access signature (SAS) configuration that allows AWS DataSync to access your Microsoft Azure Blob Storage.
CfnLocationAzureBlob.AzureFederatedIdentityConfigPropertyStructSpecifies the identity federation configuration that DataSync uses to access your Azure Blob Storage container using an OpenID Connect (OIDC) token.
CfnLocationAzureBlob.AzureOidcConfigPropertyStructSpecifies the Microsoft Entra (Azure AD) identity that DataSync federates with to obtain an access token for your Azure Blob Storage container.
CfnLocationAzureBlob.CmkSecretConfigPropertyStructSpecifies configuration information for a DataSync-managed secret, such as an authentication token, secret key, password, or Kerberos keytab that DataSync uses to access a specific storage location, with a customer-managed AWS KMS key .
CfnLocationAzureBlob.CustomSecretConfigPropertyStructSpecifies configuration information for a customer-managed Secrets Manager secret where a storage location credentials is stored in Secrets Manager as plain text (for authentication token, secret key, or password) or as binary (for Kerberos keytab).
CfnLocationAzureBlob.ManagedSecretConfigPropertyStructSpecifies configuration information for a DataSync-managed secret, such as an authentication token or set of credentials that DataSync uses to access a specific transfer location.
CfnLocationAzureBlobPropsStructProperties for defining a CfnLocationAzureBlob.
CfnLocationEFS.Ec2ConfigPropertyStructThe subnet and security groups that AWS DataSync uses to connect to one of your Amazon EFS file system's mount targets .
CfnLocationEFSPropsStructProperties for defining a CfnLocationEFS.
CfnLocationFSxLustrePropsStructProperties for defining a CfnLocationFSxLustre.
CfnLocationFSxONTAP.CmkSecretConfigPropertyStructSpecifies configuration information for a DataSync-managed secret, such as an authentication token or set of credentials that DataSync uses to access a specific transfer location, and a customer-managed AWS KMS key.
CfnLocationFSxONTAP.CustomSecretConfigPropertyStructSpecifies configuration information for a customer-managed secret, such as an authentication token or set of credentials that DataSync uses to access a specific transfer location, and an IAM role that DataSync can assume and access the customer-managed secret.
CfnLocationFSxONTAP.ManagedSecretConfigPropertyStructSpecifies configuration information for a DataSync-managed secret, such as an authentication token or set of credentials that DataSync uses to access a specific transfer location.
CfnLocationFSxONTAP.NfsMountOptionsPropertyStructSpecifies how DataSync can access a location using the NFS protocol.
CfnLocationFSxONTAP.NFSPropertyStructSpecifies the Network File System (NFS) protocol configuration that AWS DataSync uses to access a storage virtual machine (SVM) on your Amazon FSx for NetApp ONTAP file system.
CfnLocationFSxONTAP.ProtocolPropertyStructSpecifies the data transfer protocol that AWS DataSync uses to access your Amazon FSx file system.
CfnLocationFSxONTAP.SmbMountOptionsPropertyStructSpecifies the version of the Server Message Block (SMB) protocol that AWS DataSync uses to access an SMB file server.
CfnLocationFSxONTAP.SMBPropertyStructSpecifies the Server Message Block (SMB) protocol configuration that AWS DataSync uses to access a storage virtual machine (SVM) on your Amazon FSx for NetApp ONTAP file system.
CfnLocationFSxONTAPPropsStructProperties for defining a CfnLocationFSxONTAP.
CfnLocationFSxOpenZFS.MountOptionsPropertyStructRepresents the mount options that are available for DataSync to access a Network File System (NFS) location.
CfnLocationFSxOpenZFS.NFSPropertyStructRepresents the Network File System (NFS) protocol that AWS DataSync uses to access your Amazon FSx for OpenZFS file system.
CfnLocationFSxOpenZFS.ProtocolPropertyStructRepresents the protocol that AWS DataSync uses to access your Amazon FSx for OpenZFS file system.
CfnLocationFSxOpenZFSPropsStructProperties for defining a CfnLocationFSxOpenZFS.
CfnLocationFSxWindows.CmkSecretConfigPropertyStructSpecifies configuration information for a DataSync-managed secret, such as an authentication token or set of credentials that DataSync uses to access a specific transfer location, and a customer-managed AWS KMS key.
CfnLocationFSxWindows.CustomSecretConfigPropertyStructSpecifies configuration information for a customer-managed secret, such as an authentication token or set of credentials that DataSync uses to access a specific transfer location, and an IAM role that DataSync can assume and access the customer-managed secret.
CfnLocationFSxWindows.ManagedSecretConfigPropertyStructSpecifies configuration information for a DataSync-managed secret, such as an authentication token or set of credentials that DataSync uses to access a specific transfer location.
CfnLocationFSxWindowsPropsStructProperties for defining a CfnLocationFSxWindows.
CfnLocationHDFS.CmkSecretConfigPropertyStructSpecifies configuration information for a DataSync-managed secret, such as an authentication token or set of credentials that DataSync uses to access a specific transfer location, and a customer-managed AWS KMS key.
CfnLocationHDFS.CustomSecretConfigPropertyStructSpecifies configuration information for a customer-managed secret, such as an authentication token or set of credentials that DataSync uses to access a specific transfer location, and an IAM role that DataSync can assume and access the customer-managed secret.
CfnLocationHDFS.ManagedSecretConfigPropertyStructSpecifies configuration information for a DataSync-managed secret, such as an authentication token or set of credentials that DataSync uses to access a specific transfer location.
CfnLocationHDFS.NameNodePropertyStructThe NameNode of the Hadoop Distributed File System (HDFS).
CfnLocationHDFS.QopConfigurationPropertyStructThe Quality of Protection (QOP) configuration specifies the Remote Procedure Call (RPC) and data transfer privacy settings configured on the Hadoop Distributed File System (HDFS) cluster.
CfnLocationHDFSPropsStructProperties for defining a CfnLocationHDFS.
CfnLocationNFS.MountOptionsPropertyStructSpecifies the options that DataSync can use to mount your NFS file server.
CfnLocationNFS.OnPremConfigPropertyStructThe AWS DataSync agents that can connect to your Network File System (NFS) file server.
CfnLocationNFSPropsStructProperties for defining a CfnLocationNFS.
CfnLocationObjectStorage.CmkSecretConfigPropertyStructSpecifies configuration information for a DataSync-managed secret, such as an authentication token, secret key, password, or Kerberos keytab that DataSync uses to access a specific storage location, with a customer-managed AWS KMS key .
CfnLocationObjectStorage.CustomSecretConfigPropertyStructSpecifies configuration information for a customer-managed Secrets Manager secret where a storage location credentials is stored in Secrets Manager as plain text (for authentication token, secret key, or password) or as binary (for Kerberos keytab).
CfnLocationObjectStorage.GoogleOidcConfigPropertyStructSpecifies the Google Cloud workload identity federation configuration that DataSync uses to obtain an access token for your Google Cloud Storage bucket.
CfnLocationObjectStorage.ManagedSecretConfigPropertyStructSpecifies configuration information for a DataSync-managed secret, such as an authentication token or set of credentials that DataSync uses to access a specific transfer location.
CfnLocationObjectStorage.ObjectStorageExternalIdentityConfigPropertyStructSpecifies the external (non-AWS) identity provider that DataSync federates with to access your object storage location.
CfnLocationObjectStorage.ObjectStorageFederatedIdentityConfigPropertyStructSpecifies the identity federation configuration that DataSync uses to access your object storage location using an OpenID Connect (OIDC) token.
CfnLocationObjectStoragePropsStructProperties for defining a CfnLocationObjectStorage.
CfnLocationS3.S3ConfigPropertyStructSpecifies the Amazon Resource Name (ARN) of the AWS Identity and Access Management (IAM) role that DataSync uses to access your S3 bucket.
CfnLocationS3PropsStructProperties for defining a CfnLocationS3.
CfnLocationSMB.CmkSecretConfigPropertyStructSpecifies configuration information for a DataSync-managed secret, such as an authentication token, secret key, password, or Kerberos keytab that DataSync uses to access a specific storage location, with a customer-managed AWS KMS key .
CfnLocationSMB.CustomSecretConfigPropertyStructSpecifies configuration information for a customer-managed Secrets Manager secret where a storage location credentials is stored in Secrets Manager as plain text (for authentication token, secret key, or password) or as binary (for Kerberos keytab).
CfnLocationSMB.ManagedSecretConfigPropertyStructSpecifies configuration information for a DataSync-managed secret, such as an authentication token or set of credentials that DataSync uses to access a specific transfer location.
CfnLocationSMB.MountOptionsPropertyStructSpecifies the version of the SMB protocol that DataSync uses to access your SMB file server.
CfnLocationSMBPropsStructProperties for defining a CfnLocationSMB.
CfnTask.DeletedPropertyStructSpecifies the level of reporting for the files, objects, and directories that Datasync attempted to delete in your destination location.
CfnTask.DestinationPropertyStructSpecifies where DataSync uploads your task report.
CfnTask.FilterRulePropertyStructSpecifies which files, folders, and objects to include or exclude when transferring files from source to destination.
CfnTask.ManifestConfigPropertyStructConfigures a manifest, which is a list of files or objects that you want AWS DataSync to transfer.
CfnTask.ManifestConfigSourceS3PropertyStructSpecifies the S3 bucket where you're hosting the manifest that you want AWS DataSync to use.
CfnTask.OptionsPropertyStructRepresents the options that are available to control the behavior of a StartTaskExecution operation. This behavior includes preserving metadata, such as user ID (UID), group ID (GID), and file permissions; overwriting files in the destination; data integrity verification; and so on.
CfnTask.OverridesPropertyStructCustomizes the reporting level for aspects of your task report.
CfnTask.S3PropertyStruct
CfnTask.SkippedPropertyStructSpecifies the level of reporting for the files, objects, and directories that Datasync attempted to skip during your transfer.
CfnTask.SourcePropertyStructSpecifies the manifest that you want DataSync to use and where it's hosted.
CfnTask.TaskReportConfigPropertyStructSpecifies how you want to configure a task report, which provides detailed information about for your AWS DataSync transfer.
CfnTask.TaskSchedulePropertyStructConfigures your AWS DataSync task to run on a schedule (at a minimum interval of 1 hour).
CfnTask.TransferredPropertyStructSpecifies the level of reporting for the files, objects, and directories that Datasync attempted to transfer.
CfnTask.VerifiedPropertyStructSpecifies the level of reporting for the files, objects, and directories that Datasync attempted to verify at the end of your transfer.
CfnTaskPropsStructProperties for defining a CfnTask.