Create Logical Library

Edit online

Creates a logical library in the library.

Encryption and media verification is disabled by default. This can be modified after partitioning. Also, queuedExports is set to show and volserReporting is set to all The maximum number of configured Syslog servers is five.

The volume serial (VOLSER) ranges must be assigned separately using the POST /v1/logicalLibraries/{name}/volserRanges command. By default, no VOLSER ranges will be assigned and thus no cartridges will be assigned to this logical library

Request syntax

POST /v1/logicalLibraries {"name": <LL name>, "drives": {<locationOrSN|sn>, ...], "mediaType": <LTO"|"3592">}
Creates a logical library in the library.

Request body parameters

name (string), required

The unique name for the new logical library.

drives(array), optional
An array of drives to assign to the logical library. If not specified, no drives will be assigned.

  • locationOrSN (string, required): The unique location of the drive. Optionally, the globally unique serial number of the drive. The library will automatically differentiate these

mediaType(string), optional

The media type being serviced by this library which is either “LTO” or “3592”.

This is not required if the library supports only one media type.

Example

> POST /v1/logicalLibraries {"name": "myLL1", "drives": ["1097001236",
"1013001930"]}
HTTP/1.1 201 Created
Location: /v1/logicalLibraries/myLL1
Content-Type: application/json
Content-Length: 10
{"ID": 42}

Error handling

  • Returns 501 Not implemented if this command is sent down to a TS4500 with more than one media type.
  • Returns 404 Not found if the tape drive does not exist for the given location or serial number.
  • Returns 422 Unprocessable Entry if the logical library mediaType does not match that of the tape drive.
  • Returns 400 Bad Request if invalid mediaType given does not match a supported media type of the library.