Create VOLSER range

Edit online

Creates a VOLSER range and define its import and export policies. No cartridge assignments are modified by this action.

Request Syntax

POST /v1/volserRanges {"mediaType": <"LTO"|"3592">, "start": <starting VOLSER>, "end": <ending VOLSER>, "assignOnImportTo": <null|<LL name>> "reassignOnExportTo": <null|<LL name>>,}

Request Body Parameters

mediaType (string, required)

Cartridge media type supported by the VOLSER range. One of “LTO” or “3592”.

start (string, required)

The starting VOLSER, inclusive, of the VOLSER range added.

end (string, required)

The starting VOLSER, inclusive, of the VOLSER range added.

assignOnImportTo (string, optional)

This is either null (default) if no assignment should be done when a cartridge in this range is inserted into the library, or the name of the logical library to assign newly imported cartridges to in this range. Both assignOnImportTo or reassignOnExportTo cannot be null. One must be filled out.

reassignOnExportTo (string)

This is either null (default) if no reassignment should be done when a cartridge in this range is exported to an I/O station by a host, or the name of the logical library to reassign cartridges exported by a host to in this range instead of exporting them. Both assignOnImportTo or reassignOnExportTo cannot be null. One must be filled out.

Safeguarded Logical Library Considerations

Important: When creating a VOLSER range that targets a safeguarded logical library (either through assignOnImportTo or reassignOnExportTo), the following restrictions apply:
  • A local session is required to create VOLSER ranges that assign or reassign cartridges to safeguarded logical libraries. Remote sessions will be rejected.
  • Safeguarded logical libraries enforce on-site cartridge management to ensure data protection and compliance requirements are met.
  • If the operation fails due to remote session restrictions, ensure you are connected through a local network interface before retrying.

Example

> POST /v1/volserRanges {"mediaType": "LTO", "start": "000000", "end": "000ZZZ", "assignOnImportTo": "myLL1"}
HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 10