Spectra Logic

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

Get Data Path Backend

Description

Get information about the data path backend.

Requests

Syntax

GET http[s]://{datapathDNSname}/_rest_/data_path_backend/

Responses

Response Elements

<Data>
   <Activated>TRUE|FALSE</Activated>
   <AutoActivateTimeoutInMins>
      {32-bit integer}
   </AutoActivateTimeoutInMins>
   <AutoInspect>DEFAULT|MINIMAL|NEVER</AutoInspect>
   <DefaultImportConflictResolutionMode>
      ACCEPT_EXISTING| ACCEPT_IMPORT|ACCEPT_HIGHEST_VERSION|
      ACCEPT_MOST_RECENT|CANCEL
   </DefaultImportConflictResolutionMode>
   <Id>{string}</Id>
   <LastHeartbeat>YYYY-MM-DDThh:mm:ss.xxxZ</LastHeartbeat>
   <UnavailableMediaPolicy>
       ALLOW|DISCOURAGED|DISALLOW
   </UnavailableMediaPolicy>
   <UnavailablePoolMaxJobRetryInMins>
      {32-bit integer}
   </UnavailablePoolMaxJobRetryInMins>
   <UnavailableTapePartitionMaxJobRetryInMins>
      {32-bit integer}
   </UnavailableTapePartitionMaxJobRetryInMins>
</Data>

where the response elements are defined as follows:

Parameter	Description
Data	The container for the response.
Activated	Whether the BlackPearl gateway is allowed to send to the data path backend (pool or tape partitions). Values: TRUE, FALSE
AutoActivate TimeoutInMins	The number of minutes allowed for the data planner to take between when it is shut down and when it comes back up, and have the data path back end automatically activate. If the data planner remains shutdown for longer than this number of minutes, the data path backend will not automatically activate. If this parameter is null, the data path backend will never automatically activate.
AutoInspect	Whether tape inspections are automatically scheduled whenever the data planner starts. Values: DEFAULT, MINIMAL, NEVER See auto_inspect.
DefaultImport ConflictResolution	How the data path backend handles object name conflicts. Values: ACCEPT_EXISTING, ACCEPT_IMPORT, ACCEPT_HIGHEST_VERSION, ACCEPT_MOST_RECENT, CANCEL See default_import_ conflict_resolution_mode.
Id	The UUID for the record. This is only useful to the gateway.
LastHeartbeat	The date and time that the gateway last sent a heartbeat in the format YYYY-MM-DDThh:mm:ss.xxxZ.
UnavailableMedia Policy	Whether new job requests are allowed to use partitions that are currently unavailable. Values: ALLOW, DISCOURAGE, DISALLOW See unavailable_media_policy.
UnavailablePool MaxJobRetryIn Mins	How long job requests using unavailable pools will retry before being re-chunked or failing if re-chunking cannot solve the problem.
UnavailableTape PartitionMaxJob RetryInMins	How long job requests using unavailable tape partitions will retry before being re-chunked or failing if re-chunking cannot solve the problem.

Example

Sample Request

This request gets information about the data path backend.

GET http://blackpearl-hostname/_rest_/data_path_backend/ HTTP/1.1

Sample Response

HTTP/1.1 200 OK
<Data>
   <Activated>TRUE</Activated>

   <AutoActivateTimeoutInMins>30</AutoActivateTimeoutInMins>

   <AutoInspect>DEFAULT</AutoInspect>
   <DefaultImportConflictResolutionMode>
      CANCEL
   </DefaultImportConflictResolutionMode>
   <Id>7d7601d0-4dba-47a4-8235-8a1ceefe91fa</Id>
   <LastHeartbeat>2016-01-21T18:53:55.000Z</LastHeartbeat>
   <UnavailableMediaPolicy>DISCOURAGED</UnavailableMediaPolicy>
   <UnavailablePoolMaxJobRetryInMins>
      20
   </UnavailablePoolMaxJobRetryInMins>
   <UnavailableTapePartitionMaxJobRetryInMins>
      20
   </UnavailableTapePartitionMaxJobRetryInMins>
</Data>