If your user account has the Read permission level on various collections, you can download one or more of those collections, from DME to an Amazon Web Services (AWS) S3 bucket.
To download one or more collections to S3:
Prepare an S3 bucket, as described in Preparing to Use AWS S3 Bucket for the CLU.
Consider whether you want to download a single collection or multiple collections:
Run the following command:
|
The following table describes each parameter:
Parameter | Description |
---|---|
[-D <REST-response>] | An optional parameter, specifying a path and filename in your local system. The system always creates a response file:
|
[-o <output-json-file>] | An optional parameter, specifying a path and filename in your local system. The system always creates an output file:
If the command is successful, the output file is empty. |
[-f <paths-file>] or [DME data path] | One or more paths within DME. Select one of the following methods to specify the collection or collections that you want to download:
|
<destination S3 bucket> | The name of the destination S3 bucket. |
<destination path> | The path to and the name of the folder in the destination bucket. Do not begin the path with a slash. If the destination folder structure you specify does not already exist, DME creates it. |
[AWS credentials file path] | The location of the credentials file. If your credentials file is in the default location, as noted in Preparing to Use AWS S3 Bucket for the CLU, you can omit this parameter. |
For some examples, consider the following code specified in a credentials file:
[default] aws_access_key_id = SAMPLEACCESSKEY aws_secret_access_key = SampleSecretAccessKey region = us-east-1 |
Single Collection Example
The following example uses the credentials file in a non-default location to download a collection from DME.
|
In this example, the command performs the following:
Multiple Collections Example
For another example, consider the following command.
|
With the following code in the specified collection-list.txt file, the above command uses the credentials file in a default location to download multiple collections from various locations in DME.
/Example_Archive/PI_Lab2/Project_1 /Example_Archive/PI_Lab2/Project_2 /Example_Archive/PI_Lab3/Project_1 |
In this example, the command performs the following: