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


Advanced Bucket Management Operations : Replication Target Operations : Create DS3 Target Read Preference

Create DS3 Target Read Preference
Description
Create a DS3 target read preference for a particular bucket, overriding the default defined in the DS3 target configuration.
Requests
Syntax
POST http[s]://{datapathDNSname}/_rest_/ds3_target_read_preference?bucket_id={string}&read_preference=LAST_RESORT|AFTER_ONLINE_POOL|​​AFTER_NEARLINE_POOL|​​AFTER_NON_EJECTABLE_TAPE|​​MINIMUM_LATENCY|​​NEVER&target_id={string}
Request Parameters 
§
LAST_RESORT — The target is only used to service a read request if it cannot be serviced locally. This setting should be used in most circumstances.
§
AFTER_ONLINE_POOL — If data is not available locally on cache or online pool, the target is used to read the data if possible.
§
AFTER_NEARLINE_POOL — If data is not available locally on cache, online pool, or nearline pool, the target is used to read the data if possible.
§
AFTER_NON_EJECTABLE_TAPE — If data is not available locally on cache, online pool, nearline pool, or non-ejectable tape, the target is used to read the data if possible.
§
MINIMUM_LATENCY — The source BlackPearl system dynamically determines the read preference based on whether the requested data resides in a pool or on tape. If, for example, the source has the data on tape, but the target has the data on pool, the source uses the target to service the request. If however, the source and target both have the data on pool, the source is used to service the request. Use this when
§
NEVER — The target is never allowed to service a read request. You may want to use this setting when the cost of the network link to the target is very high, or if for data integrity verification purposes, the administrator wants to ensure that all GET and VERIFY requests are serviced locally.
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:
Values: MINIMUM_LATENCY, AFTER_ONLINE_POOL, AFTER_NEARLINE_POOL, AFTER_NON_EJECTABLE_TAPE, LAST_RESORT, NEVER. See read_preference.
Example
Sample Request
This request overrides the read preference for the DS3 target with the UUID 26bbc55a-417a-49a9-90f5-dbc3920cb0fc to set the read preference for ‘bucket1’ to MINIMUM_LATENCY.
POST http[s]://blackpearl-hostname/_rest_/ds3_target_read_preference?bucket_id=bucket1&read_preference=MINIMUM_LATENCY&target_id=26bbc55a-417a-49a9-90f5-dbc3920cb0fc HTTP/1.1
Sample Response
HTTP/1.1 201 CREATED
<Data>
   <BucketId>502e2d43-fe83-491e-985c-5f4d8d2108c3</BucketId>
   <Id>4b90e88b-63ec-4784-96a3-8408e74ad3ec</Id>
   <ReadPreference>MINIMUM_LATENCY</ReadPreference>
   <TargetId>26bbc55a-417a-49a9-90f5-dbc3920cb0fc</TargetId>
</Data>