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


Advanced Bucket Management Operations : Replication Target Operations : Modify Azure Target

Modify Azure Target
Description
Modify an Azure target.
Notes:
§
§
Requests
Syntax
PUT http[s]://{datapathDNSname}/_rest_/azure_target/{BlackPearl target instance UUID, name, or other unique attribute}
[?account_key={string}][&account_name={string}][&auto_verify_freqency_in_days={integer}][&cloud_bucket_prefix={string}][&cloud_bucket_suffix={string}]
[&default_read_preference=MINIMUM_LATENCY|AFTER_ONLINE_POOL|AFTER_NEARLINE_POOL|AFTER_NON_EJECTABLE_TAPE|LAST_RESORT|NEVER][&https=TRUE|FALSE][&name={string}][&permit_going_out_of_sync=TRUE|FALSE][&quiesced=NO|PENDING]
To determine the UUID for an Azure target instance, see Get Azure Targets.
Request Parameters 
When it is preferable to read from the Azure 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.
Values: TRUE, FALSE.
The name for the Azure target.
Request that the system prepare the target to go into an inactive state (PENDING) or return the target to an active state (NO).
Values: NO, PENDING
Responses
Response Elements
<Data>
   <AccountKey>{string}</AccountKey>
   <AccountName>{string}</AccountName>
   <AutoVerifyFrequencyInDays>
      {
integer}
   </AutoVerifyFrequencyInDays>
   <CloudBucketPrefix>{string}</CloudBucketPrefix>
   <CloudBucketSuffix>{string}</CloudBucketSuffix>
   <DefaultReadPreference>
     MINIMUM_LATENCY|AFTER_ONLINE_POOL|AFTER_NEARLINE_POOL|     AFTER_NON_EJECTABLE_TAPE|LAST_RESORT|NEVER
   </DefaultReadPreference>
   <Https>TRUE|FALSE</Https>
   <Id>{string}</Id>
   <LastFullyVerified>YYYY-MM-DDThh:mm:ss.xxxZ</LastFullyVerified>
   <Name>{string}</Name>
   <PermitGoingOutOfSync>TRUE|FASLE</PermitGoingOutOfSync>
   <Quiesced>NO|PENDING|YES</Quiesced>
   <State>ONLINE|OFFLINE</State>
</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.
Values: TRUE, FALSE.
The state of the Azure target.
Values: ONLINE, OFFLINE, LIMITED_ACCESS
Example
Sample Request
This request modifies the Azure target named ‘TargetAzure’ to have the default read preference MINIMUM_LATENCY.
PUT http[s]://blackpearl-hostname/_rest_/azure_target/TargetAzure?default_read_preference=MINIMUM_LATENCY HTTP/1.1
Sample Response
HTTP/1.1 200 OK
<Data>
   <AccountKey>c3b1YtRyYQ1z</AccountKey>
   <AccountName>BackupAdmin</AccountName>
   <AutoVerifyFrequencyInDays>365</AutoVerifyFrequencyInDays>
   <CloudBucketPrefix/>
   <CloudBucketSuffix/>
   <DefaultReadPreference>MINIMUM_LATENCY</DefaultReadPreference>
   <Https>TRUE</Https>
   <Id>4e5626a0-6733-4625-9ff2-3f89183b3474</Id>
   <LastFullyVerified/>
   <Name>TargetAzure</Name>
   <PermitGoingOutOfSync>FALSE</PermitGoingOutOfSync>
   <Quiesced>NO</Quiesced>
   <State>ONLINE</State>
</Data>