Spectra Logic

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

Get Tape Libraries

Description

Get a list of all tape libraries available to the BlackPearl Converged Storage System. Use parameters as selection criteria to return a subset of the list.

Requests

Syntax

GET http[s]://{datapathDNSname}/_rest_/tape_library[?last_page][&management_url={string}][&name={string}]​[&page_length={32‑bit integer}][&page_offset={32‑bit integer}]​[&page_start_marker={string}][&serial_number={string}]

Request Parameters

Parameter	Description	Required
last_page	If included, only the last page of results is returned.	no
management_url	The IP address to access the library’s BlueScale web server.	no
name a	The name of the library.	no
page_length	The maximum number of libraries to list. The default is all items after page_offset.	no
page_offset	The starting point for the first library 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
serial_number a	The serial number of the library.	no

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

Responses

Response Elements

<Data>
   <TapeLibrary>
      <Id>{string}</Id>
      <ManagementUrl>{string}</ManagementUrl>
      <Name>{string}</Name>
      <SerialNumber>{string}</SerialNumber>
   </TapeLibrary>
   ...
</Data>

where the response elements are defined as follows:

Parameter	Description
Data	The container for the response.
TapeLibrary	The container for information about a single library
Id	The UUID for the library.
ManagementUrl	The IP address to access the library’s BlueScale web server.
Name	The name for the library.
SerialNumber	The serial number for the library.

Example

Sample Request

This request retrieves a list of all tape libraries available to the BlackPearl Converged Storage System.

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

Sample Response

HTTP/1.1 200 OK
<Data>
   <TapeLibrary>
      <Id>836e1079-c726-4eae-aee4-0472d75bbae4</Id>
      <ManagementUrl>10.10.11.10</ManagementUrl>
      <Name>T950Library</Name>
      <SerialNumber>0918401</SerialNumber>
   </TapeLibrary>
   ...
</Data>