1-800-833-1132 : 1-303-449-6400


Spectra BlackPearl Converged Storage System : Advanced Bucket Management Operations : Replication Target Operations : Amazon S3 Replication Target Commands : Create Amazon S3 Target Bucket Name
Create Amazon S3 Target Bucket Name
Description
Defines a custom bucket name mapping between the BlackPearl bucket and an Amazon S3 target bucket.
Requests
Syntax
POST http[s]://{datapathDNSname}/_rest_/s3_target_bucket_name​?bucket_id={string}​&name={string}​&target_id={string}
Request Parameters 
Parameter
Description
Required
bucket_id
The BlackPearl bucket UUID, name, or other unique attribute.
yes
name
The name for the new bucket in the Amazon S3 target.
yes
target_id
The Amazon S3 target UUID, name, or other unique attribute.
yes
Responses
Response Elements
<Data>
   <BucketId>{string}</BucketId>
   <Id>{string}</Id>
   <Name>{string}</Name>
   <TargetId>{string}</TargetId>
</Data>
where the response elements are defined as follows:
Parameter
Description
Data
The container for the response.
BucketId
The UUID for the bucket.
Id
The UUID for the bucket mapping.
Name
The name of the Amazon S3 bucket.
TargetId
The UUID for the Amazon S3 replication target.
Example
Sample Request
This request maps the BlackPearl bucket named bucket1 to an Amazon S3 bucket named bucketname .
POST http[s]://blackpearl-hostname/_rest_/s3_target_bucket_name​?bucket_id=bucket1​&name=bucketname​&target_id=26bbc55a-417a-49a9-90f5-dbc3920cb0fc HTTP/1.1
Sample Response
HTTP/1.1 201 CREATED
<Data>
   <BucketId>b9c3e3ec-a316-4532-bf82-d5e07141df64</BucketId>
   <Id>67c60982-aa75-4378-ad48-187f66a3917c</Id>
   <Name>bucketname</Name>
   <TargetId>26bbc55a-417a-49a9-90f5-dbc3920cb0fc</TargetId>
</Data>