Configuring DataSync transfers with an object storage system

Open the Amazon DataSync console at https://console.amazonaws.cn/datasync/.

In the left navigation pane, expand Data transfer, then choose Locations and Create location.

For Location type, choose Object storage.

You configure this location as a source or destination later.

For Agents, choose the DataSync agent that can connect to your object storage system.

You can choose more than one agent. For more information, see Using multiple DataSync agents.

For Server, provide the domain name or IP address of the object storage server.

For Bucket name, enter the name of the object storage bucket involved in the transfer.

For Folder, enter an object prefix.

DataSync only copies objects with this prefix.

To configure the connection to the object storage server, expand Additional settings and do the following:

1. For Server protocol, choose HTTP or HTTPS.

2. For Server port, use a default port (80 for HTTP or 443 for HTTPS) or specify a custom port if needed.

3. For Certificate, if your object storage system uses a private or self-signed certificate authority (CA), select Choose file and specify a single .pem file with a full certificate chain.

   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

If credentials are required to access the object storage server, select Requires credentials and enter the Access key and Secret key for accessing the bucket.

The access key and secret key can be a user name and password, respectively.

(Optional) Choose Add tag to tag your object storage location.

Tags are key-value pairs that help you manage, filter, and search for your locations. We recommend creating at least a name tag for your location.

Choose Create location.

Copy the following create-location-object-storage command:

aws datasync create-location-object-storage \
    --server-hostname object-storage-server.example.com \
    --bucket-name your-bucket \
    --agent-arns arn:aws-cn:datasync:us-east-1:123456789012:agent/agent-01234567890deadfb

Specify the following required parameters in the command:

(Optional) Add any of the following parameters to the command:

Run the create-location-object-storage command.

You get a response that shows you the location ARN that you just created.

{
    "LocationArn": "arn:aws-cn:datasync:us-east-1:123456789012:location/loc-01234567890abcdef"
}