View Source AWS.DataSync (aws-elixir v1.0.0)

DataSync

DataSync is an online data movement and discovery service that simplifies data migration and helps you quickly, easily, and securely transfer your file or object data to, from, and between Amazon Web Services storage services.

This API interface reference includes documentation for using DataSync programmatically. For complete information, see the * DataSync User Guide

*.

Summary

Functions

Creates an Amazon Web Services resource for an on-premises storage system that you want DataSync Discovery to collect information about.

Stops an DataSync task execution that's in progress.

Activates an DataSync agent that you've deployed in your storage environment.

Creates a transfer location for a Microsoft Azure Blob Storage container.

Creates a transfer location for an Amazon EFS file system.

Creates a transfer location for an Amazon FSx for Lustre file system.

Creates a transfer location for an Amazon FSx for NetApp ONTAP file system.

Creates a transfer location for an Amazon FSx for OpenZFS file system.

Creates a transfer location for an Amazon FSx for Windows File Server file system.

Creates a transfer location for a Hadoop Distributed File System (HDFS).

Creates a transfer location for a Network File System (NFS) file server.

Creates a transfer location for an object storage system.

Creates a transfer location for an Amazon S3 bucket.

Creates a transfer location for a Server Message Block (SMB) file server.

Configures a transfer task, which defines where and how DataSync moves your data.

Removes an DataSync agent resource from your Amazon Web Services account.

Deletes a transfer location resource from DataSync.

Deletes a transfer task resource from DataSync.

Returns information about an DataSync agent, such as its name, service endpoint type, and status.

Returns information about a DataSync discovery job.

Provides details about how an DataSync transfer location for Microsoft Azure Blob Storage is configured.

Provides details about how an DataSync transfer location for an Amazon EFS file system is configured.

Provides details about how an DataSync transfer location for an Amazon FSx for Lustre file system is configured.

Provides details about how an DataSync transfer location for an Amazon FSx for NetApp ONTAP file system is configured.

Provides details about how an DataSync transfer location for an Amazon FSx for OpenZFS file system is configured.

Provides details about how an DataSync transfer location for an Amazon FSx for Windows File Server file system is configured.

Provides details about how an DataSync transfer location for a Hadoop Distributed File System (HDFS) is configured.

Provides details about how an DataSync transfer location for a Network File System (NFS) file server is configured.

Provides details about how an DataSync transfer location for an object storage system is configured.

Provides details about how an DataSync transfer location for an S3 bucket is configured.

Provides details about how an DataSync transfer location for a Server Message Block (SMB) file server is configured.

Returns information about an on-premises storage system that you're using with DataSync Discovery.

Returns information, including performance data and capacity usage, which DataSync Discovery collects about a specific resource in your-premises storage system.

Returns information that DataSync Discovery collects about resources in your on-premises storage system.

Provides information about an DataSync transfer task.

Provides information about an execution of your DataSync task.

Creates recommendations about where to migrate your data to in Amazon Web Services.

Returns a list of DataSync agents that belong to an Amazon Web Services account in the Amazon Web Services Region specified in the request.

Provides a list of the existing discovery jobs in the Amazon Web Services Region and Amazon Web Services account where you're using DataSync Discovery.

Returns a list of source and destination locations.

Lists the on-premises storage systems that you're using with DataSync Discovery.

Returns all the tags associated with an Amazon Web Services resource.

Returns a list of executions for an DataSync transfer task.

Returns a list of the DataSync tasks you created.

Permanently removes a storage system resource from DataSync Discovery, including the associated discovery jobs, collected data, and recommendations.

Runs a DataSync discovery job on your on-premises storage system.

Starts an DataSync transfer task.

Stops a running DataSync discovery job.

Applies a tag to an Amazon Web Services resource.

Removes tags from an Amazon Web Services resource.

Updates the name of an DataSync agent.

Edits a DataSync discovery job configuration.

Modifies some configurations of the Microsoft Azure Blob Storage transfer location that you're using with DataSync.

Updates some parameters of a previously created location for a Hadoop Distributed File System cluster.

Modifies some configurations of the Network File System (NFS) transfer location that you're using with DataSync.

Updates some parameters of an existing object storage location that DataSync accesses for a transfer.

Updates some of the parameters of a Server Message Block (SMB) file server location that you can use for DataSync transfers.

Modifies some configurations of an on-premises storage system resource that you're using with DataSync Discovery.

Updates the configuration of an DataSync transfer task.

Updates the configuration of a running DataSync task execution.

Functions

Link to this function

add_storage_system(client, input, options \\ [])

View Source

Creates an Amazon Web Services resource for an on-premises storage system that you want DataSync Discovery to collect information about.

Link to this function

cancel_task_execution(client, input, options \\ [])

View Source

Stops an DataSync task execution that's in progress.

The transfer of some files are abruptly interrupted. File contents that're transferred to the destination might be incomplete or inconsistent with the source files.

However, if you start a new task execution using the same task and allow it to finish, file content on the destination will be complete and consistent. This applies to other unexpected failures that interrupt a task execution. In all of these cases, DataSync successfully completes the transfer when you start the next task execution.

Link to this function

create_agent(client, input, options \\ [])

View Source

Activates an DataSync agent that you've deployed in your storage environment.

The activation process associates the agent with your Amazon Web Services account.

If you haven't deployed an agent yet, see the following topics to learn more:

*

Agent requirements

*

Create an agent

If you're transferring between Amazon Web Services storage services, you don't need a DataSync agent.

Link to this function

create_location_azure_blob(client, input, options \\ [])

View Source

Creates a transfer location for a Microsoft Azure Blob Storage container.

DataSync can use this location as a transfer source or destination.

Before you begin, make sure you know how DataSync accesses Azure Blob Storage and works with access tiers and blob types. You also need a DataSync agent that can connect to your container.

Link to this function

create_location_efs(client, input, options \\ [])

View Source

Creates a transfer location for an Amazon EFS file system.

DataSync can use this location as a source or destination for transferring data.

Before you begin, make sure that you understand how DataSync accesses Amazon EFS file systems.

Link to this function

create_location_fsx_lustre(client, input, options \\ [])

View Source

Creates a transfer location for an Amazon FSx for Lustre file system.

DataSync can use this location as a source or destination for transferring data.

Before you begin, make sure that you understand how DataSync accesses FSx for Lustre file systems.

Link to this function

create_location_fsx_ontap(client, input, options \\ [])

View Source

Creates a transfer location for an Amazon FSx for NetApp ONTAP file system.

DataSync can use this location as a source or destination for transferring data.

Before you begin, make sure that you understand how DataSync accesses FSx for ONTAP file systems.

Link to this function

create_location_fsx_open_zfs(client, input, options \\ [])

View Source

Creates a transfer location for an Amazon FSx for OpenZFS file system.

DataSync can use this location as a source or destination for transferring data.

Before you begin, make sure that you understand how DataSync accesses FSx for OpenZFS file systems.

Request parameters related to SMB aren't supported with the CreateLocationFsxOpenZfs operation.

Link to this function

create_location_fsx_windows(client, input, options \\ [])

View Source

Creates a transfer location for an Amazon FSx for Windows File Server file system.

DataSync can use this location as a source or destination for transferring data.

Before you begin, make sure that you understand how DataSync accesses FSx for Windows File Server file systems.

Link to this function

create_location_hdfs(client, input, options \\ [])

View Source

Creates a transfer location for a Hadoop Distributed File System (HDFS).

DataSync can use this location as a source or destination for transferring data.

Before you begin, make sure that you understand how DataSync accesses HDFS clusters.

Link to this function

create_location_nfs(client, input, options \\ [])

View Source

Creates a transfer location for a Network File System (NFS) file server.

DataSync can use this location as a source or destination for transferring data.

Before you begin, make sure that you understand how DataSync accesses NFS file servers.

If you're copying data to or from an Snowcone device, you can also use CreateLocationNfs to create your transfer location. For more information, see Configuring transfers with Snowcone.

Link to this function

create_location_object_storage(client, input, options \\ [])

View Source

Creates a transfer location for an object storage system.

DataSync can use this location as a source or destination for transferring data.

Before you begin, make sure that you understand the prerequisites for DataSync to work with object storage systems.

Link to this function

create_location_s3(client, input, options \\ [])

View Source

Creates a transfer location for an Amazon S3 bucket.

DataSync can use this location as a source or destination for transferring data.

Before you begin, make sure that you read the following topics:

Storage class considerations with Amazon S3 locations

Evaluating S3 request costs when using DataSync

For more information, see Configuring transfers with Amazon S3.

Link to this function

create_location_smb(client, input, options \\ [])

View Source

Creates a transfer location for a Server Message Block (SMB) file server.

DataSync can use this location as a source or destination for transferring data.

Before you begin, make sure that you understand how DataSync accesses SMB file servers.

Link to this function

create_task(client, input, options \\ [])

View Source

Configures a transfer task, which defines where and how DataSync moves your data.

A task includes a source location, destination location, and the options for how and when you want to transfer your data (such as bandwidth limits, scheduling, among other options).

If you're planning to transfer data to or from an Amazon S3 location, review how DataSync can affect your S3 request charges and the DataSync pricing page before you begin.

Link to this function

delete_agent(client, input, options \\ [])

View Source

Removes an DataSync agent resource from your Amazon Web Services account.

Keep in mind that this operation (which can't be undone) doesn't remove the agent's virtual machine (VM) or Amazon EC2 instance from your storage environment. For next steps, you can delete the VM or instance from your storage environment or reuse it to activate a new agent.

Link to this function

delete_location(client, input, options \\ [])

View Source

Deletes a transfer location resource from DataSync.

Link to this function

delete_task(client, input, options \\ [])

View Source

Deletes a transfer task resource from DataSync.

Link to this function

describe_agent(client, input, options \\ [])

View Source

Returns information about an DataSync agent, such as its name, service endpoint type, and status.

Link to this function

describe_discovery_job(client, input, options \\ [])

View Source

Returns information about a DataSync discovery job.

Link to this function

describe_location_azure_blob(client, input, options \\ [])

View Source

Provides details about how an DataSync transfer location for Microsoft Azure Blob Storage is configured.

Link to this function

describe_location_efs(client, input, options \\ [])

View Source

Provides details about how an DataSync transfer location for an Amazon EFS file system is configured.

Link to this function

describe_location_fsx_lustre(client, input, options \\ [])

View Source

Provides details about how an DataSync transfer location for an Amazon FSx for Lustre file system is configured.

Link to this function

describe_location_fsx_ontap(client, input, options \\ [])

View Source

Provides details about how an DataSync transfer location for an Amazon FSx for NetApp ONTAP file system is configured.

If your location uses SMB, the DescribeLocationFsxOntap operation doesn't actually return a Password.

Link to this function

describe_location_fsx_open_zfs(client, input, options \\ [])

View Source

Provides details about how an DataSync transfer location for an Amazon FSx for OpenZFS file system is configured.

Response elements related to SMB aren't supported with the DescribeLocationFsxOpenZfs operation.

Link to this function

describe_location_fsx_windows(client, input, options \\ [])

View Source

Provides details about how an DataSync transfer location for an Amazon FSx for Windows File Server file system is configured.

Link to this function

describe_location_hdfs(client, input, options \\ [])

View Source

Provides details about how an DataSync transfer location for a Hadoop Distributed File System (HDFS) is configured.

Link to this function

describe_location_nfs(client, input, options \\ [])

View Source

Provides details about how an DataSync transfer location for a Network File System (NFS) file server is configured.

Link to this function

describe_location_object_storage(client, input, options \\ [])

View Source

Provides details about how an DataSync transfer location for an object storage system is configured.

Link to this function

describe_location_s3(client, input, options \\ [])

View Source

Provides details about how an DataSync transfer location for an S3 bucket is configured.

Link to this function

describe_location_smb(client, input, options \\ [])

View Source

Provides details about how an DataSync transfer location for a Server Message Block (SMB) file server is configured.

Link to this function

describe_storage_system(client, input, options \\ [])

View Source

Returns information about an on-premises storage system that you're using with DataSync Discovery.

Link to this function

describe_storage_system_resource_metrics(client, input, options \\ [])

View Source

Returns information, including performance data and capacity usage, which DataSync Discovery collects about a specific resource in your-premises storage system.

Link to this function

describe_storage_system_resources(client, input, options \\ [])

View Source

Returns information that DataSync Discovery collects about resources in your on-premises storage system.

Link to this function

describe_task(client, input, options \\ [])

View Source

Provides information about an DataSync transfer task.

Link to this function

describe_task_execution(client, input, options \\ [])

View Source

Provides information about an execution of your DataSync task.

You can use this operation to help monitor the progress of an ongoing transfer or check the results of the transfer.

Link to this function

generate_recommendations(client, input, options \\ [])

View Source

Creates recommendations about where to migrate your data to in Amazon Web Services.

Recommendations are generated based on information that DataSync Discovery collects about your on-premises storage system's resources. For more information, see Recommendations provided by DataSync Discovery.

Once generated, you can view your recommendations by using the DescribeStorageSystemResources operation.

Link to this function

list_agents(client, input, options \\ [])

View Source

Returns a list of DataSync agents that belong to an Amazon Web Services account in the Amazon Web Services Region specified in the request.

With pagination, you can reduce the number of agents returned in a response. If you get a truncated list of agents in a response, the response contains a marker that you can specify in your next request to fetch the next page of agents.

ListAgents is eventually consistent. This means the result of running the operation might not reflect that you just created or deleted an agent. For example, if you create an agent with CreateAgent and then immediately run ListAgents, that agent might not show up in the list right away. In situations like this, you can always confirm whether an agent has been created (or deleted) by using DescribeAgent.

Link to this function

list_discovery_jobs(client, input, options \\ [])

View Source

Provides a list of the existing discovery jobs in the Amazon Web Services Region and Amazon Web Services account where you're using DataSync Discovery.

Link to this function

list_locations(client, input, options \\ [])

View Source

Returns a list of source and destination locations.

If you have more locations than are returned in a response (that is, the response returns only a truncated list of your agents), the response contains a token that you can specify in your next request to fetch the next page of locations.

Link to this function

list_storage_systems(client, input, options \\ [])

View Source

Lists the on-premises storage systems that you're using with DataSync Discovery.

Link to this function

list_tags_for_resource(client, input, options \\ [])

View Source

Returns all the tags associated with an Amazon Web Services resource.

Link to this function

list_task_executions(client, input, options \\ [])

View Source

Returns a list of executions for an DataSync transfer task.

Link to this function

list_tasks(client, input, options \\ [])

View Source

Returns a list of the DataSync tasks you created.

Link to this function

remove_storage_system(client, input, options \\ [])

View Source

Permanently removes a storage system resource from DataSync Discovery, including the associated discovery jobs, collected data, and recommendations.

Link to this function

start_discovery_job(client, input, options \\ [])

View Source

Runs a DataSync discovery job on your on-premises storage system.

If you haven't added the storage system to DataSync Discovery yet, do this first by using the AddStorageSystem operation.

Link to this function

start_task_execution(client, input, options \\ [])

View Source

Starts an DataSync transfer task.

For each task, you can only run one task execution at a time.

There are several phases to a task execution. For more information, see Task execution statuses.

If you're planning to transfer data to or from an Amazon S3 location, review how DataSync can affect your S3 request charges and the DataSync pricing page before you begin.

Link to this function

stop_discovery_job(client, input, options \\ [])

View Source

Stops a running DataSync discovery job.

You can stop a discovery job anytime. A job that's stopped before it's scheduled to end likely will provide you some information about your on-premises storage system resources. To get recommendations for a stopped job, you must use the GenerateRecommendations operation.

Link to this function

tag_resource(client, input, options \\ [])

View Source

Applies a tag to an Amazon Web Services resource.

Tags are key-value pairs that can help you manage, filter, and search for your resources.

These include DataSync resources, such as locations, tasks, and task executions.

Link to this function

untag_resource(client, input, options \\ [])

View Source

Removes tags from an Amazon Web Services resource.

Link to this function

update_agent(client, input, options \\ [])

View Source

Updates the name of an DataSync agent.

Link to this function

update_discovery_job(client, input, options \\ [])

View Source

Edits a DataSync discovery job configuration.

Link to this function

update_location_azure_blob(client, input, options \\ [])

View Source

Modifies some configurations of the Microsoft Azure Blob Storage transfer location that you're using with DataSync.

Link to this function

update_location_hdfs(client, input, options \\ [])

View Source

Updates some parameters of a previously created location for a Hadoop Distributed File System cluster.

Link to this function

update_location_nfs(client, input, options \\ [])

View Source

Modifies some configurations of the Network File System (NFS) transfer location that you're using with DataSync.

For more information, see Configuring transfers to or from an NFS file server.

Link to this function

update_location_object_storage(client, input, options \\ [])

View Source

Updates some parameters of an existing object storage location that DataSync accesses for a transfer.

For information about creating a self-managed object storage location, see Creating a location for object storage.

Link to this function

update_location_smb(client, input, options \\ [])

View Source

Updates some of the parameters of a Server Message Block (SMB) file server location that you can use for DataSync transfers.

Link to this function

update_storage_system(client, input, options \\ [])

View Source

Modifies some configurations of an on-premises storage system resource that you're using with DataSync Discovery.

Link to this function

update_task(client, input, options \\ [])

View Source

Updates the configuration of an DataSync transfer task.

Link to this function

update_task_execution(client, input, options \\ [])

View Source

Updates the configuration of a running DataSync task execution.

Currently, the only Option that you can modify with UpdateTaskExecution is


[BytesPerSecond](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-BytesPerSecond)

, which throttles bandwidth for a running or queued task execution.