Spectra Logic

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

Get Tape Partition Failures

Description

Get a list of all tape partition failures. Use parameters as selection criteria to return a subset of the list.

Requests

Syntax

GET http[s]://{datapathDNSname}/_rest_/tape_partition_failure​[?error_message={string}][&last_page][&page_length={32‑bit integer}][&page_offset={32‑bit integer}]​[&page_start_marker={string}][&partition_id={string}]​[&type=CLEANING_TAPE_REQUIRED|DUPLICATE_TAPE_BAR_CODES_DETECTED|​EJECT_STALLED_DUE_TO_OFFLINE_TAPES|MINIMUM_DRIVE_COUNT_NOT_MET|​MOVE_FAILED|MOVE_FAILED_DUE_TO_PREPARE_TAPE_FOR_REMOVAL_FAILURE|​NO_USABLE_DRIVES|ONLINE_STALLED_DUE_TO_NO_STORAGE_SLOTS|​TAPE_DRIVE_IN_ERROR|TAPE_DRIVE_QUIESCED|TAPE_DRIVE_TYPE_MISMATCH|​TAPE_EJECTION_BY_OPERATOR_REQUIRED|TAPE_MEDIA_TYPE_INCOMPATIBLE]

Request Parameters

Parameter	Description	Required
error_message a	A description of an error.	no
last_page	If included, only the last page of results is returned.	no
page_length	The maximum number of failures to list. The default is all items after page_offset.	no
page_offset	The starting point for the first failure to list. The default is 0.	no
page_start_marker	The UUID or other unique attribute for the item just before the first item to list. Notes:   § Specifying both page_offset and page_start_marker causes an error. § If neither page_offset, nor page_start_marker are specified, the page_offset default is used.	no
partition_id	The UUID for the partition.	no
type	The type of tape partition error message. Values: CLEANING_TAPE_REQUIRED, DUPLICATE_TAPE_BAR_CODES_DETECTED, EJECT_STALLED_DUE_TO_OFFLINE_TAPES, MINIMUM_DRIVE_COUNT_NOT_MET, MOVE_FAILED, MOVE_FAILED_DUE_TO_PREPARE_TAPE_FOR_REMOVAL_FAILURE, NO_USABLE_DRIVES, ONLINE_STALLED_DUE_TO_NO_STORAGE_SLOTS, TAPE_DRIVE_IN_ERROR, TAPE_DRIVE_QUIESCED, TAPE_DRIVE_TYPE_MISMATCH, TAPE_EJECTION_BY_OPERATOR_REQUIRED, TAPE_MEDIA_TYPE_INCOMPATIBLE	no

a.	Parameter values can use wild cards (see Wild Card Syntax).

Responses

Response Elements

<Data>
   <TapePartitionFailure>
      <Date>{YYYY-MM-DDThh:mm:ss.xxxZ}</Date>
      <ErrorMessage>{string}</ErrorMessage>
      <Id>{string}</Id>
      <PartitionId>{string}</PartitionId>
      <Type>
         CLEANING_TAPE_REQUIRED|DUPLICATE_TAPE_BAR_CODES_DETECTED|
         EJECT_STALLED_DUE_TO_OFFLINE_TAPES|
         MINIMUM_DRIVE_COUNT_NOT_MET|​MOVE_FAILED|
         MOVE_FAILED_DUE_TO_PREPARE_TAPE_FOR_REMOVAL_FAILURE|
         NO_USABLE_DRIVES|ONLINE_STALLED_DUE_TO_NO_STORAGE_SLOTS|
         TAPE_DRIVE_IN_ERROR|TAPE_DRIVE_QUIESCED|          TAPE_DRIVE_TYPE_MISMATCH|
         TAPE_EJECTION_BY_OPERATOR_REQUIRED|
         TAPE_MEDIA_TYPE_INCOMPATIBLE
      </Type>
   </TapePartitionFailure>
   ...
</Data>

where the response elements are defined as follows:

Parameter	Description
Data	The container for the response.
TapePartition Failure	The container for information for each failure.
Date	The date and time the failure occurred in the format YYYY-MM-DDThh:mm:ss.xxxZ.
ErrorMessage	The full exception output for the error.
Id	The UUID for the error message.
PartitionId	The UUID for the partition.
Type	The type of tape partition failure message. Values: CLEANING_TAPE_REQUIRED, DUPLICATE_TAPE_BAR_CODES_DETECTED, EJECT_STALLED_DUE_TO_OFFLINE_TAPES, MINIMUM_DRIVE_COUNT_NOT_MET, MOVE_FAILED, MOVE_FAILED_DUE_TO_PREPARE_TAPE_FOR_REMOVAL_FAILURE, NO_USABLE_DRIVES, ONLINE_STALLED_DUE_TO_NO_STORAGE_SLOTS, TAPE_DRIVE_IN_ERROR, TAPE_DRIVE_QUIESCED, TAPE_DRIVE_TYPE_MISMATCH, TAPE_EJECTION_BY_OPERATOR_REQUIRED, TAPE_MEDIA_TYPE_INCOMPATIBLE

Example

Sample Request

This request retrieves a list of tape partition failures.

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

Sample Response

HTTP/1.1 200 OK
<Data>
   <TapePartitionFailure>
      <Date>2014-10-02 11:40:10.621</Date>
      <ErrorMessage>{Full Exception Output}</ErrorMessage>
      <Id>a92bd5a6-eb56-44c8-9a08-1f896c3eab0e</Id>
      <PartitionId>
         c95f253e-d56c-4ce5-a882-46f213ac9e34
      </PartitionId>
      <Type>MOVE_FAILED</Type>
   </TapePartitionFailure>
   ...
</Data>