Delete VOLSER range
Delete the existing VOLSER range. This request must indicate an existing VOLSER range and match the starting and ending VOLSER of that range.
Request Syntax
Note: Deleting a VOLSER range will reassign all cartridges in the range to the unassigned category.
This action may cause a synchronization problem with the host application.
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.
Cartridge Unassignment Behavior
When a VOLSER range is deleted, all cartridges that fall within the range are automatically unassigned from their logical library and moved to the unassigned category. This behavior occurs regardless of whether the cartridges were assigned through the VOLSER range's assignOnImportTo policy or manually assigned.
CAUTION:
Deleting a VOLSER range that contains assigned cartridges may cause synchronization issues with host applications that expect those cartridges to remain in their logical library. Ensure host applications are prepared for this change before deleting a VOLSER range with assigned cartridges.
Safeguarded Logical Library Considerations
Important: When deleting a VOLSER range that targets a safeguarded logical library (either through
assignOnImportTo or reassignOnExportTo), the following restrictions apply:
- A local session is required to delete VOLSER ranges associated with safeguarded logical libraries. Remote sessions will be rejected.
- Cartridges assigned to safeguarded logical libraries through the VOLSER range will be unassigned when the range is deleted. This unassignment operation also requires a local session.
- 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/delete {"mediaType": "LTO", "start": "000000", "end": "000ZZZ"}
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 10