Add VOLSER Range to a Logical Library

Edit online

Adds or removes the given volume serial (VOLSER) ranges that define how cartridges are automatically assigned to the logical library when inserted into the library.

Any cartridges inserted into the library will be assigned to the logical library

Request syntax

POST /v1/logicalLibraries/{name}/volserRanges {"start": <starting VOLSER>, "end": <ending VOLSER>, "applyNow": <"yes"|"no">}
Adds the given volume serial (VOLSER) ranges to a logical library.

Path parameters

start (string, required): The starting VOLSER, inclusive, of the VOLSER range added to or removed from the logical library.
end (string, required): The end VOLSER, inclusive, of the VOLSER range added to or removed from the logical library.
applyNow (string): Whether the cartridges within the VOLSER ranges affected will be assigned or unassigned from the library after this command completes. If “yes” is selected, then the assigned cartridges for the logical library will match the VOLSER ranges. If “no” is selected, no cartridges will be assigned or unassigned as part of this action and these settings will only be applied to newly inserted cartridges. The default is “yes”.

Example

> POST /v1/logicalLibraries/myLL1/volserRanges {"volserRanges": [{"start": "000000", "end": "000ZZZ}]}
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 0

Error handling

Returns 400 Bad Request if invalid start/end VOLSERs are given including start being greater than end.