POST copy?overwrite={overwrite}&key={key}&requestTime={requestTime}&signature={signature}
Copies files from the specified source bucket and paths to the destination bucket and paths.
Request Information
URI Parameters
Name | Description | Type | Additional information |
---|---|---|---|
overwrite |
Should destination files be overwritten if they already exist? |
boolean |
Required |
key |
The key that was used to sign this request. |
string |
Required |
requestTime |
The time the request was made. |
integer |
Required |
signature |
The signature that proves that you are who you say you are. |
string |
Required |
Body Parameters
A request describing the copy.
CopyFilesRequestName | Description | Type | Additional information |
---|---|---|---|
Files | Collection of CopyFileRequest |
None. |
Request Formats
application/xml, text/xml
Sample:
<CopyFilesRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <Files> <CopyFileRequest> <DestinationBucket>sample string 3</DestinationBucket> <DestinationPath>sample string 4</DestinationPath> <SourceBucket>sample string 1</SourceBucket> <SourcePath>sample string 2</SourcePath> </CopyFileRequest> <CopyFileRequest> <DestinationBucket>sample string 3</DestinationBucket> <DestinationPath>sample string 4</DestinationPath> <SourceBucket>sample string 1</SourceBucket> <SourcePath>sample string 2</SourcePath> </CopyFileRequest> </Files> </CopyFilesRequest>
application/json, text/json
Sample:
{ "Files": [ { "SourceBucket": "sample string 1", "SourcePath": "sample string 2", "DestinationBucket": "sample string 3", "DestinationPath": "sample string 4" }, { "SourceBucket": "sample string 1", "SourcePath": "sample string 2", "DestinationBucket": "sample string 3", "DestinationPath": "sample string 4" } ] }
Response Information
Resource Description
A response indicating whether the call was successful or not, along with a list of which files failed, and for what reason.
CopyFilesResponseName | Description | Type | Additional information |
---|---|---|---|
Failures | Collection of CopyFileFailure |
None. |
|
Success | boolean |
None. |
|
Error | string |
None. |
Response Formats
application/xml, text/xml
Sample:
<CopyFilesResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Xss.Busi"> <Error xmlns="">sample string 2</Error> <Success xmlns="">true</Success> <Failures xmlns:d2p1="http://schemas.datacontract.org/2004/07/Xss.Busi.DataContracts"> <d2p1:CopyFileFailure> <DestinationBucket xmlns="">sample string 4</DestinationBucket> <DestinationPath xmlns="">sample string 5</DestinationPath> <SourceBucket xmlns="">sample string 2</SourceBucket> <SourcePath xmlns="">sample string 3</SourcePath> <d2p1:Reason>sample string 1</d2p1:Reason> </d2p1:CopyFileFailure> <d2p1:CopyFileFailure> <DestinationBucket xmlns="">sample string 4</DestinationBucket> <DestinationPath xmlns="">sample string 5</DestinationPath> <SourceBucket xmlns="">sample string 2</SourceBucket> <SourcePath xmlns="">sample string 3</SourcePath> <d2p1:Reason>sample string 1</d2p1:Reason> </d2p1:CopyFileFailure> </Failures> </CopyFilesResponse>
application/json, text/json
Sample:
{ "Failures": [ { "Reason": "sample string 1", "SourceBucket": "sample string 2", "SourcePath": "sample string 3", "DestinationBucket": "sample string 4", "DestinationPath": "sample string 5" }, { "Reason": "sample string 1", "SourceBucket": "sample string 2", "SourcePath": "sample string 3", "DestinationBucket": "sample string 4", "DestinationPath": "sample string 5" } ], "Success": true, "Error": "sample string 2" }