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

Get Amazon S3 Target Read Preference

Description

Get the specified Amazon S3 target default read preference.

Requests

Syntax

GET http[s]://{datapathDNSname}/_rest_/s3_target_read_preference/{Amazon S3 target read preference UUID or other unique attribute}/

To determine the UUID for the Amazon S3 target read preference, see Get Amazon S3 Target Read Preferences.

Responses

Response Elements

<Data>
   <BucketId>{string}</BucketId>
   <Id>{string}</Id>
   <ReadPreference>
      MINIMUM_LATENCY|AFTER_ONLINE_POOL|AFTER_NEARLINE_POOL
      |AFTER_NON_EJECTABLE_TAPE|LAST_RESORT|NEVER
   </ReadPreference>
   <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 read preference.
ReadPreference	When it is preferable to read from the Amazon S3 target rather than the replication source. Values: MINIMUM_LATENCY, AFTER_ONLINE_POOL, AFTER_NEARLINE_POOL, AFTER_NON_EJECTABLE_TAPE, LAST_RESORT, NEVER. See read_preference.
TargetId	The UUID for the replication target.

Example

Sample Request

This request gets information about the read preference for the Amazon S3 target with the 5cbf1b35-0d06-43f5-aef8-c31e6af14f17.

GET http://blackpearl-hostname/_rest_/s3_target_read_preference/5cbf1b35-0d06-43f5-aef8-c31e6af14f17/ HTTP/1.1

Sample Response

HTTP/1.1 200 OK
<Data>
   <BucketId>b0a6249d-d096-4c05-a428-548f65214fb8</BucketId>
   <Id>6e91318c-8a1a-4b1a-85b4-077c901554bb</Id>
   <ReadPreference>MINIMUM_LATENCY</ReadPreference>
   <TargetId>5cbf1b35-0d06-43f5-aef8-c31e6af14f17</TargetId>
</Data>