Spectra Logic

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

Get Tape Failures

Description

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

Requests

Syntax

GET http[s]://{datapathDNSname}/_rest_/tape_failure​[?error_message={string}][&last_page]
[&page_length={32‑bit integer}][&page_offset={32‑bit integer}]​[&page_start_marker={string}][&tape_drive_id={string}]​[&tape_id={string}]​[&type=BAR_CODE_CHANGED|BAR_CODE_DUPLICATE|​BLOB_READ_FAILED|DATA_CHECKPOINT_FAILURE|​DATA_CHECKPOINT_FAILURE_DUE_TO_READ_ONLY|​DATA_CHECKPOINT_MISSING|​DELAYED_OWNERSHIP_FAILURE|DRIVE_CLEAN_FAILED|DRIVE_CLEANED|​FORMAT_FAILED|​GET_TAPE_INFORMATION_FAILED|IMPORT_FAILED|​IMPORT_INCOMPLETE|IMPORT_FAILED_DUE_TO_TAKE_OWNERSHIP_FAILURE|​IMPORT_FAILED_DUE_TO_DATA_INTEGRITY|INSPECT_FAILED|READ_FAILED|​REIMPORT_REQUIRED|SERIAL_NUMBER_MISMATCH|VERIFY_FAILED|​WRITE_FAILED]

Request Parameters

Parameter	Description	Required
error_message a	The 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
tape_drive_id	The UUID or other unique attribute for the tape drive.	no
tape_id	The UUID, barcode, or other unique attribute for the tape.	no
type	The type of tape error message. Values: BAR_CODE_CHANGED, BAR_CODE_DUPLICATE, BLOB_READ_FAILED, DATA_CHECKPOINT_FAILURE, DATA_CHECKPOINT_FAILURE_DUE_TO_READ_ONLY, DATA_CHECKPOINT_MISSING, DELAYED_OWNERSHIP_FAILURE, DRIVE_CLEAN_FAILED, DRIVE_CLEANED, FORMAT_FAILED, GET_TAPE_INFORMATION_FAILED, IMPORT_FAILED, IMPORT_INCOMPLETE, IMPORT_FAILED_DUE_TO_TAKE_OWNERSHIP_FAILURE, IMPORT_FAILED_DUE_TO_DATA_INTEGRITY, INSPECT_FAILED, READ_FAILED, REIMPORT_REQUIRED, SERIAL_NUMBER_MISMATCH, VERIFY_FAILED, WRITE_FAILED	no

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

Responses

Response Elements

<Data>
   <TapeFailure>
      <Date>{YYYY-MM-DDThh:mm:ss.xxxZ}</Date>
      <ErrorMessage>{string}</ErrorMessage>
      <Id>{string}</Id>
      <TapeDriveId>{string}</TapeDriveId>
      <TapeId>{string}</TapeId>
      <Type>
         BAR_CODE_CHANGED|BAR_CODE_DUPLICATE|BLOB_READ_FAILED|
         DATA_CHECKPOINT_FAILURE|
         DATA_CHECKPOINT_FAILURE_DUE_TO_READ_ONLY|
         DATA_CHECKPOINT_MISSING|DELAYED_OWNERSHIP_FAILURE|
         DRIVE_CLEAN_FAILED|DRIVE_CLEANED|FORMAT_FAILED|
         GET_TAPE_INFORMATION_FAILED|IMPORT_FAILED|
         IMPORT_INCOMPLETE|
         IMPORT_FAILED_DUE_TO_TAKE_OWNERSHIP_FAILURE|
         IMPORT_FAILED_DUE_TO_DATA_INTEGRITY|INSPECT_FAILED|
         READ_FAILED|​REIMPORT_REQUIRED|SERIAL_NUMBER_MISMATCH|
         VERIFY_FAILED|​WRITE_FAILED
      </Type>
   </TapeFailure>
   ...
</Data>

where the response elements are defined as follows:

Parameter	Description
Data	A container for the response.
TapeFailure	A container for information about a single tape failure.
Date	The date and time the error occurred in the format YYYY-MM-DDThh:mm:ss.xxxZ.
ErrorMessage	A description of the error.
Id	The UUID for the error message.
TapeDriveId	The UUID for the tape drive.
TapeId	The UUID for the tape.
Type	The type of tape error message. Values: BAR_CODE_CHANGED, BAR_CODE_DUPLICATE, BLOB_READ_FAILED, DATA_CHECKPOINT_FAILURE, DATA_CHECKPOINT_FAILURE_DUE_TO_READ_ONLY, DATA_CHECKPOINT_MISSING, DELAYED_OWNERSHIP_FAILURE, DRIVE_CLEAN_FAILED, DRIVE_CLEANED, FORMAT_FAILED, GET_TAPE_INFORMATION_FAILED, IMPORT_FAILED, IMPORT_INCOMPLETE, IMPORT_FAILED_DUE_TO_TAKE_OWNERSHIP_FAILURE, IMPORT_FAILED_DUE_TO_DATA_INTEGRITY, INSPECT_FAILED, READ_FAILED, REIMPORT_REQUIRED, SERIAL_NUMBER_MISMATCH, VERIFY_FAILED, WRITE_FAILED

Example

Sample Request

This request retrieves a list of all tape failures.

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

Sample Response

HTTP/1.1 200 OK
<Data>
   <TapeFailure>
      <Date>2014-10-02 11:40:23.851</Date>
      <ErrorMessage>{Full Exception Output}</ErrorMessage>
      <Id>1e41b332-5db8-4080-87c1-d7e00b170a18</Id>
      <TapeDriveId>
         eea2ee27-05ef-4b15-b8f8-c2f897c892e6
      </TapeDriveId>
      <TapeId>1793a19b-a701-4709-98b1-3bd3f75c739b</TapeId>
      <Type>FORMAT_FAILED</Type>

   </TapeFailure>

</Data>