# Tape\_drives

## (By tape library) Lists all tape drives.

> \*\*API Key Scope\*\*: tape\_drives / index

```json
{"openapi":"3.0.1","info":{"title":"Nodeum API","version":"2.1.0"},"servers":[{"url":"{url}/api/v2","variables":{"url":{"default":"http://localhost","description":"URL of server"}}}],"security":[{"BasicAuth":[]},{"BearerAuth":[]},{"JWT":[]}],"components":{"securitySchemes":{"BasicAuth":{"type":"http","scheme":"basic","description":"Pass the username and password of a user in the authorization header.\nThis currently gives full access."},"BearerAuth":{"type":"apiKey","description":"Create an API Key associated to user.\nAccess can be restricted with the scope.\nEach API call described below has a scoped mentionned in its description.\n\nFor example :\n\n**API Key Scope**: files / index\n\nThis means that the API key should have a scope with controller as *files*\nand the action as *index*.","name":"Authorization","in":"header"},"JWT":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"responses":{"tape_drives_index":{"description":"List of tape drives.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/tape_drive_collection"}}}}},"schemas":{"tape_drive_collection":{"type":"object","properties":{"count":{"type":"integer","readOnly":true},"tape_drives":{"type":"array","readOnly":true,"items":{"$ref":"#/components/schemas/tape_drive"}}}},"tape_drive":{"allOf":[{"$ref":"#/components/schemas/tape_drive_device"},{"type":"object","properties":{"id":{"type":"integer","readOnly":true,"description":"This ID is not unique. Only unique among a tape library.","format":"int64"},"tape_library_id":{"type":"integer","readOnly":true,"format":"int64"},"name":{"type":"string"},"comment":{"type":"string"},"libso":{"type":"string"},"acs":{"type":"integer"},"lsm":{"type":"integer"},"panel":{"type":"integer"},"transport":{"type":"integer"},"status":{"type":"string","readOnly":true,"enum":["maintenance","online","locked","offline"]},"full":{"type":"integer","readOnly":true},"mount_count":{"type":"integer","readOnly":true},"use_to":{"type":"string","readOnly":true},"use_by":{"type":"string","readOnly":true},"barcode":{"type":"string","readOnly":true},"task_id":{"type":"integer","readOnly":true,"format":"int64"},"use_file_processed_size":{"type":"integer","readOnly":true,"format":"int64"},"use_file_size_to_process":{"type":"integer","readOnly":true,"format":"int64"},"use_file_name_processed":{"type":"string","readOnly":true,"format":"int64"},"bandwidth":{"type":"integer","readOnly":true,"format":"int64"}}}]},"tape_drive_device":{"type":"object","properties":{"serial":{"type":"string","readOnly":true},"scsi_address":{"type":"integer"},"vendor":{"type":"string"},"product":{"type":"string"},"firmware":{"type":"string"},"device":{"type":"string","description":"When saved, device may be prefixed by *n* (eg. `/dev/nst5`)"},"sgdevice":{"type":"string"}}}},"parameters":{"limit":{"name":"limit","in":"query","description":"The number of items to display for pagination.","schema":{"type":"integer"}},"offset":{"name":"offset","in":"query","description":"The number of items to skip for pagination.","schema":{"type":"integer"}},"sort_by":{"name":"sort_by","in":"query","description":"Sort results by attribute.\n\nCan sort on multiple attributes, separated by `|`.\nOrder direction can be suffixing the attribute by either `:asc` (default) or `:desc`.","style":"pipeDelimited","schema":{"type":"array","items":{"type":"string"}}},"filter_id":{"name":"id","in":"query","description":"Filter on id","schema":{"type":"string"}},"filter_name":{"name":"name","in":"query","description":"Filter on name","schema":{"type":"string"}},"filter_serial":{"name":"serial","in":"query","description":"Filter on serial","schema":{"type":"string"}},"filter_comment":{"name":"comment","in":"query","description":"Filter on comment","schema":{"type":"string"}},"filter_scsi_address":{"name":"scsi_address","in":"query","description":"Filter on scsi address","schema":{"type":"string"}},"filter_vendor":{"name":"vendor","in":"query","description":"Filter on vendor","schema":{"type":"string"}},"filter_product":{"name":"product","in":"query","description":"Filter on product","schema":{"type":"string"}},"filter_firmware":{"name":"firmware","in":"query","description":"Filter on firmware","schema":{"type":"string"}},"filter_device":{"name":"device","in":"query","description":"Filter on device","schema":{"type":"string"}},"filter_sgdevice":{"name":"sgdevice","in":"query","description":"Filter on sgdevice","schema":{"type":"string"}},"filter_libso":{"name":"libso","in":"query","description":"Filter on libso","schema":{"type":"string"}},"filter_acs":{"name":"acs","in":"query","description":"Filter on acs","schema":{"type":"string"}},"filter_lsm":{"name":"lsm","in":"query","description":"Filter on lsm","schema":{"type":"string"}},"filter_panel":{"name":"panel","in":"query","description":"Filter on panel","schema":{"type":"string"}},"filter_transport":{"name":"transport","in":"query","description":"Filter on transport","schema":{"type":"string"}},"filter_status":{"name":"status","in":"query","description":"Filter on status","schema":{"type":"string"}},"filter_full":{"name":"full","in":"query","description":"Filter on full","schema":{"type":"string"}},"filter_mount_count":{"name":"mount_count","in":"query","description":"Filter on mount count","schema":{"type":"string"}},"filter_use_to":{"name":"use_to","in":"query","description":"Filter on use to","schema":{"type":"string"}},"filter_use_by":{"name":"use_by","in":"query","description":"Filter on use by","schema":{"type":"string"}},"filter_barcode":{"name":"barcode","in":"query","description":"Filter on barcode","schema":{"type":"string"}},"filter_task_id":{"name":"task_id","in":"query","description":"Filter on task id","schema":{"type":"string"}},"filter_use_file_processed_size":{"name":"use_file_processed_size","in":"query","description":"Filter on use file processed size","schema":{"type":"string"}},"filter_use_file_size_to_process":{"name":"use_file_size_to_process","in":"query","description":"Filter on use file size to process","schema":{"type":"string"}},"filter_use_file_name_processed":{"name":"use_file_name_processed","in":"query","description":"Filter on use file name processed","schema":{"type":"string"}},"filter_bandwidth":{"name":"bandwidth","in":"query","description":"Filter on bandwidth","schema":{"type":"string"}}}},"paths":{"/tape_libraries/{tape_library_id}/tape_drives":{"get":{"summary":"(By tape library) Lists all tape drives.","operationId":"index_tape_drives_by_tape_library","description":"**API Key Scope**: tape_drives / index","tags":["tape_drives"],"responses":{"200":{"$ref":"#/components/responses/tape_drives_index"}},"parameters":[{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/offset"},{"$ref":"#/components/parameters/sort_by"},{"$ref":"#/components/parameters/filter_id"},{"$ref":"#/components/parameters/filter_name"},{"$ref":"#/components/parameters/filter_serial"},{"$ref":"#/components/parameters/filter_comment"},{"$ref":"#/components/parameters/filter_scsi_address"},{"$ref":"#/components/parameters/filter_vendor"},{"$ref":"#/components/parameters/filter_product"},{"$ref":"#/components/parameters/filter_firmware"},{"$ref":"#/components/parameters/filter_device"},{"$ref":"#/components/parameters/filter_sgdevice"},{"$ref":"#/components/parameters/filter_libso"},{"$ref":"#/components/parameters/filter_acs"},{"$ref":"#/components/parameters/filter_lsm"},{"$ref":"#/components/parameters/filter_panel"},{"$ref":"#/components/parameters/filter_transport"},{"$ref":"#/components/parameters/filter_status"},{"$ref":"#/components/parameters/filter_full"},{"$ref":"#/components/parameters/filter_mount_count"},{"$ref":"#/components/parameters/filter_use_to"},{"$ref":"#/components/parameters/filter_use_by"},{"$ref":"#/components/parameters/filter_barcode"},{"$ref":"#/components/parameters/filter_task_id"},{"$ref":"#/components/parameters/filter_use_file_processed_size"},{"$ref":"#/components/parameters/filter_use_file_size_to_process"},{"$ref":"#/components/parameters/filter_use_file_name_processed"},{"$ref":"#/components/parameters/filter_bandwidth"}]}}}}
```

## (By tape library) Creates a new tape drive.

> \*\*API Key Scope\*\*: tape\_drives / create

```json
{"openapi":"3.0.1","info":{"title":"Nodeum API","version":"2.1.0"},"servers":[{"url":"{url}/api/v2","variables":{"url":{"default":"http://localhost","description":"URL of server"}}}],"security":[{"BasicAuth":[]},{"BearerAuth":[]},{"JWT":[]}],"components":{"securitySchemes":{"BasicAuth":{"type":"http","scheme":"basic","description":"Pass the username and password of a user in the authorization header.\nThis currently gives full access."},"BearerAuth":{"type":"apiKey","description":"Create an API Key associated to user.\nAccess can be restricted with the scope.\nEach API call described below has a scoped mentionned in its description.\n\nFor example :\n\n**API Key Scope**: files / index\n\nThis means that the API key should have a scope with controller as *files*\nand the action as *index*.","name":"Authorization","in":"header"},"JWT":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"responses":{"tape_drives_show":{"description":"A specific tape drive.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/tape_drive"}}}},"unprocessable_entity":{"description":"The received resource was not correctly formatted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}},"schemas":{"tape_drive":{"allOf":[{"$ref":"#/components/schemas/tape_drive_device"},{"type":"object","properties":{"id":{"type":"integer","readOnly":true,"description":"This ID is not unique. Only unique among a tape library.","format":"int64"},"tape_library_id":{"type":"integer","readOnly":true,"format":"int64"},"name":{"type":"string"},"comment":{"type":"string"},"libso":{"type":"string"},"acs":{"type":"integer"},"lsm":{"type":"integer"},"panel":{"type":"integer"},"transport":{"type":"integer"},"status":{"type":"string","readOnly":true,"enum":["maintenance","online","locked","offline"]},"full":{"type":"integer","readOnly":true},"mount_count":{"type":"integer","readOnly":true},"use_to":{"type":"string","readOnly":true},"use_by":{"type":"string","readOnly":true},"barcode":{"type":"string","readOnly":true},"task_id":{"type":"integer","readOnly":true,"format":"int64"},"use_file_processed_size":{"type":"integer","readOnly":true,"format":"int64"},"use_file_size_to_process":{"type":"integer","readOnly":true,"format":"int64"},"use_file_name_processed":{"type":"string","readOnly":true,"format":"int64"},"bandwidth":{"type":"integer","readOnly":true,"format":"int64"}}}]},"tape_drive_device":{"type":"object","properties":{"serial":{"type":"string","readOnly":true},"scsi_address":{"type":"integer"},"vendor":{"type":"string"},"product":{"type":"string"},"firmware":{"type":"string"},"device":{"type":"string","description":"When saved, device may be prefixed by *n* (eg. `/dev/nst5`)"},"sgdevice":{"type":"string"}}},"error":{"type":"object","properties":{"details":{"type":"object","additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/attribute_error"}},"description":"Parsable objects describing the errors. The key is the invalid attribute name."},"messages":{"type":"array","description":"English description of the errors.","items":{"type":"string"}}}},"attribute_error":{"required":["error"],"type":"object","properties":{"error":{"type":"string"}},"discriminator":{"propertyName":"error"}}},"requestBodies":{"tape_drive_body":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/tape_drive"}}},"required":true}}},"paths":{"/tape_libraries/{tape_library_id}/tape_drives":{"post":{"summary":"(By tape library) Creates a new tape drive.","operationId":"create_tape_drive_by_tape_library","description":"**API Key Scope**: tape_drives / create","tags":["tape_drives"],"responses":{"201":{"$ref":"#/components/responses/tape_drives_show"},"422":{"$ref":"#/components/responses/unprocessable_entity"}},"requestBody":{"$ref":"#/components/requestBodies/tape_drive_body"}}}}}
```

## Lists tape drives devices.

> \*\*API Key Scope\*\*: tape\_drives / devices

```json
{"openapi":"3.0.1","info":{"title":"Nodeum API","version":"2.1.0"},"servers":[{"url":"{url}/api/v2","variables":{"url":{"default":"http://localhost","description":"URL of server"}}}],"security":[{"BasicAuth":[]},{"BearerAuth":[]},{"JWT":[]}],"components":{"securitySchemes":{"BasicAuth":{"type":"http","scheme":"basic","description":"Pass the username and password of a user in the authorization header.\nThis currently gives full access."},"BearerAuth":{"type":"apiKey","description":"Create an API Key associated to user.\nAccess can be restricted with the scope.\nEach API call described below has a scoped mentionned in its description.\n\nFor example :\n\n**API Key Scope**: files / index\n\nThis means that the API key should have a scope with controller as *files*\nand the action as *index*.","name":"Authorization","in":"header"},"JWT":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"responses":{"tape_drives_devices":{"description":"List of tape drives devices.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/tape_drive_device_collection_or_active_job_status"}}}},"active_job_status":{"description":"An active job that may be queued, working, completed or failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/active_job_status"}}}}},"schemas":{"tape_drive_device_collection_or_active_job_status":{"oneOf":[{"$ref":"#/components/schemas/tape_drive_device_collection"},{"$ref":"#/components/schemas/active_job_status"}]},"tape_drive_device_collection":{"type":"object","properties":{"tape_drives":{"type":"array","items":{"$ref":"#/components/schemas/tape_drive_device"}}}},"tape_drive_device":{"type":"object","properties":{"serial":{"type":"string","readOnly":true},"scsi_address":{"type":"integer"},"vendor":{"type":"string"},"product":{"type":"string"},"firmware":{"type":"string"},"device":{"type":"string","description":"When saved, device may be prefixed by *n* (eg. `/dev/nst5`)"},"sgdevice":{"type":"string"}}},"active_job_status":{"type":"object","properties":{"job_id":{"type":"string","readOnly":true},"status":{"type":"string","readOnly":true,"enum":["queued","working","completed","failed"]},"progress":{"type":"integer","readOnly":true},"total":{"type":"integer","readOnly":true}}}},"parameters":{"job_id_optional":{"name":"job_id","in":"query","description":"ID of active job","schema":{"type":"string"}}}},"paths":{"/tape_libraries/{tape_library_id}/tape_drives/-/devices":{"get":{"summary":"Lists tape drives devices.","operationId":"index_tape_drive_devices","tags":["tape_drives"],"description":"**API Key Scope**: tape_drives / devices","responses":{"200":{"$ref":"#/components/responses/tape_drives_devices"},"202":{"$ref":"#/components/responses/active_job_status"},"500":{"$ref":"#/components/responses/active_job_status"}},"parameters":[{"$ref":"#/components/parameters/job_id_optional"}]}}}}
```

## Lists all tape drives.

> \*\*API Key Scope\*\*: tape\_drives / index

```json
{"openapi":"3.0.1","info":{"title":"Nodeum API","version":"2.1.0"},"servers":[{"url":"{url}/api/v2","variables":{"url":{"default":"http://localhost","description":"URL of server"}}}],"security":[{"BasicAuth":[]},{"BearerAuth":[]},{"JWT":[]}],"components":{"securitySchemes":{"BasicAuth":{"type":"http","scheme":"basic","description":"Pass the username and password of a user in the authorization header.\nThis currently gives full access."},"BearerAuth":{"type":"apiKey","description":"Create an API Key associated to user.\nAccess can be restricted with the scope.\nEach API call described below has a scoped mentionned in its description.\n\nFor example :\n\n**API Key Scope**: files / index\n\nThis means that the API key should have a scope with controller as *files*\nand the action as *index*.","name":"Authorization","in":"header"},"JWT":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"responses":{"tape_drives_index":{"description":"List of tape drives.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/tape_drive_collection"}}}}},"schemas":{"tape_drive_collection":{"type":"object","properties":{"count":{"type":"integer","readOnly":true},"tape_drives":{"type":"array","readOnly":true,"items":{"$ref":"#/components/schemas/tape_drive"}}}},"tape_drive":{"allOf":[{"$ref":"#/components/schemas/tape_drive_device"},{"type":"object","properties":{"id":{"type":"integer","readOnly":true,"description":"This ID is not unique. Only unique among a tape library.","format":"int64"},"tape_library_id":{"type":"integer","readOnly":true,"format":"int64"},"name":{"type":"string"},"comment":{"type":"string"},"libso":{"type":"string"},"acs":{"type":"integer"},"lsm":{"type":"integer"},"panel":{"type":"integer"},"transport":{"type":"integer"},"status":{"type":"string","readOnly":true,"enum":["maintenance","online","locked","offline"]},"full":{"type":"integer","readOnly":true},"mount_count":{"type":"integer","readOnly":true},"use_to":{"type":"string","readOnly":true},"use_by":{"type":"string","readOnly":true},"barcode":{"type":"string","readOnly":true},"task_id":{"type":"integer","readOnly":true,"format":"int64"},"use_file_processed_size":{"type":"integer","readOnly":true,"format":"int64"},"use_file_size_to_process":{"type":"integer","readOnly":true,"format":"int64"},"use_file_name_processed":{"type":"string","readOnly":true,"format":"int64"},"bandwidth":{"type":"integer","readOnly":true,"format":"int64"}}}]},"tape_drive_device":{"type":"object","properties":{"serial":{"type":"string","readOnly":true},"scsi_address":{"type":"integer"},"vendor":{"type":"string"},"product":{"type":"string"},"firmware":{"type":"string"},"device":{"type":"string","description":"When saved, device may be prefixed by *n* (eg. `/dev/nst5`)"},"sgdevice":{"type":"string"}}}},"parameters":{"limit":{"name":"limit","in":"query","description":"The number of items to display for pagination.","schema":{"type":"integer"}},"offset":{"name":"offset","in":"query","description":"The number of items to skip for pagination.","schema":{"type":"integer"}},"sort_by":{"name":"sort_by","in":"query","description":"Sort results by attribute.\n\nCan sort on multiple attributes, separated by `|`.\nOrder direction can be suffixing the attribute by either `:asc` (default) or `:desc`.","style":"pipeDelimited","schema":{"type":"array","items":{"type":"string"}}},"filter_id":{"name":"id","in":"query","description":"Filter on id","schema":{"type":"string"}},"filter_tape_library_id":{"name":"tape_library_id","in":"query","description":"Filter on tape library id","schema":{"type":"string"}},"filter_name":{"name":"name","in":"query","description":"Filter on name","schema":{"type":"string"}},"filter_serial":{"name":"serial","in":"query","description":"Filter on serial","schema":{"type":"string"}},"filter_comment":{"name":"comment","in":"query","description":"Filter on comment","schema":{"type":"string"}},"filter_scsi_address":{"name":"scsi_address","in":"query","description":"Filter on scsi address","schema":{"type":"string"}},"filter_vendor":{"name":"vendor","in":"query","description":"Filter on vendor","schema":{"type":"string"}},"filter_product":{"name":"product","in":"query","description":"Filter on product","schema":{"type":"string"}},"filter_firmware":{"name":"firmware","in":"query","description":"Filter on firmware","schema":{"type":"string"}},"filter_device":{"name":"device","in":"query","description":"Filter on device","schema":{"type":"string"}},"filter_sgdevice":{"name":"sgdevice","in":"query","description":"Filter on sgdevice","schema":{"type":"string"}},"filter_libso":{"name":"libso","in":"query","description":"Filter on libso","schema":{"type":"string"}},"filter_acs":{"name":"acs","in":"query","description":"Filter on acs","schema":{"type":"string"}},"filter_lsm":{"name":"lsm","in":"query","description":"Filter on lsm","schema":{"type":"string"}},"filter_panel":{"name":"panel","in":"query","description":"Filter on panel","schema":{"type":"string"}},"filter_transport":{"name":"transport","in":"query","description":"Filter on transport","schema":{"type":"string"}},"filter_status":{"name":"status","in":"query","description":"Filter on status","schema":{"type":"string"}},"filter_full":{"name":"full","in":"query","description":"Filter on full","schema":{"type":"string"}},"filter_mount_count":{"name":"mount_count","in":"query","description":"Filter on mount count","schema":{"type":"string"}},"filter_use_to":{"name":"use_to","in":"query","description":"Filter on use to","schema":{"type":"string"}},"filter_use_by":{"name":"use_by","in":"query","description":"Filter on use by","schema":{"type":"string"}},"filter_barcode":{"name":"barcode","in":"query","description":"Filter on barcode","schema":{"type":"string"}},"filter_task_id":{"name":"task_id","in":"query","description":"Filter on task id","schema":{"type":"string"}},"filter_use_file_processed_size":{"name":"use_file_processed_size","in":"query","description":"Filter on use file processed size","schema":{"type":"string"}},"filter_use_file_size_to_process":{"name":"use_file_size_to_process","in":"query","description":"Filter on use file size to process","schema":{"type":"string"}},"filter_use_file_name_processed":{"name":"use_file_name_processed","in":"query","description":"Filter on use file name processed","schema":{"type":"string"}},"filter_bandwidth":{"name":"bandwidth","in":"query","description":"Filter on bandwidth","schema":{"type":"string"}}}},"paths":{"/tape_drives":{"get":{"summary":"Lists all tape drives.","tags":["tape_drives"],"operationId":"index_tape_drives","description":"**API Key Scope**: tape_drives / index","responses":{"200":{"$ref":"#/components/responses/tape_drives_index"}},"parameters":[{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/offset"},{"$ref":"#/components/parameters/sort_by"},{"$ref":"#/components/parameters/filter_id"},{"$ref":"#/components/parameters/filter_tape_library_id"},{"$ref":"#/components/parameters/filter_name"},{"$ref":"#/components/parameters/filter_serial"},{"$ref":"#/components/parameters/filter_comment"},{"$ref":"#/components/parameters/filter_scsi_address"},{"$ref":"#/components/parameters/filter_vendor"},{"$ref":"#/components/parameters/filter_product"},{"$ref":"#/components/parameters/filter_firmware"},{"$ref":"#/components/parameters/filter_device"},{"$ref":"#/components/parameters/filter_sgdevice"},{"$ref":"#/components/parameters/filter_libso"},{"$ref":"#/components/parameters/filter_acs"},{"$ref":"#/components/parameters/filter_lsm"},{"$ref":"#/components/parameters/filter_panel"},{"$ref":"#/components/parameters/filter_transport"},{"$ref":"#/components/parameters/filter_status"},{"$ref":"#/components/parameters/filter_full"},{"$ref":"#/components/parameters/filter_mount_count"},{"$ref":"#/components/parameters/filter_use_to"},{"$ref":"#/components/parameters/filter_use_by"},{"$ref":"#/components/parameters/filter_barcode"},{"$ref":"#/components/parameters/filter_task_id"},{"$ref":"#/components/parameters/filter_use_file_processed_size"},{"$ref":"#/components/parameters/filter_use_file_size_to_process"},{"$ref":"#/components/parameters/filter_use_file_name_processed"},{"$ref":"#/components/parameters/filter_bandwidth"}]}}}}
```

## Displays a specific tape drive.

> \*\*API Key Scope\*\*: tape\_drives / show

```json
{"openapi":"3.0.1","info":{"title":"Nodeum API","version":"2.1.0"},"servers":[{"url":"{url}/api/v2","variables":{"url":{"default":"http://localhost","description":"URL of server"}}}],"security":[{"BasicAuth":[]},{"BearerAuth":[]},{"JWT":[]}],"components":{"securitySchemes":{"BasicAuth":{"type":"http","scheme":"basic","description":"Pass the username and password of a user in the authorization header.\nThis currently gives full access."},"BearerAuth":{"type":"apiKey","description":"Create an API Key associated to user.\nAccess can be restricted with the scope.\nEach API call described below has a scoped mentionned in its description.\n\nFor example :\n\n**API Key Scope**: files / index\n\nThis means that the API key should have a scope with controller as *files*\nand the action as *index*.","name":"Authorization","in":"header"},"JWT":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"responses":{"tape_drives_show":{"description":"A specific tape drive.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/tape_drive"}}}}},"schemas":{"tape_drive":{"allOf":[{"$ref":"#/components/schemas/tape_drive_device"},{"type":"object","properties":{"id":{"type":"integer","readOnly":true,"description":"This ID is not unique. Only unique among a tape library.","format":"int64"},"tape_library_id":{"type":"integer","readOnly":true,"format":"int64"},"name":{"type":"string"},"comment":{"type":"string"},"libso":{"type":"string"},"acs":{"type":"integer"},"lsm":{"type":"integer"},"panel":{"type":"integer"},"transport":{"type":"integer"},"status":{"type":"string","readOnly":true,"enum":["maintenance","online","locked","offline"]},"full":{"type":"integer","readOnly":true},"mount_count":{"type":"integer","readOnly":true},"use_to":{"type":"string","readOnly":true},"use_by":{"type":"string","readOnly":true},"barcode":{"type":"string","readOnly":true},"task_id":{"type":"integer","readOnly":true,"format":"int64"},"use_file_processed_size":{"type":"integer","readOnly":true,"format":"int64"},"use_file_size_to_process":{"type":"integer","readOnly":true,"format":"int64"},"use_file_name_processed":{"type":"string","readOnly":true,"format":"int64"},"bandwidth":{"type":"integer","readOnly":true,"format":"int64"}}}]},"tape_drive_device":{"type":"object","properties":{"serial":{"type":"string","readOnly":true},"scsi_address":{"type":"integer"},"vendor":{"type":"string"},"product":{"type":"string"},"firmware":{"type":"string"},"device":{"type":"string","description":"When saved, device may be prefixed by *n* (eg. `/dev/nst5`)"},"sgdevice":{"type":"string"}}}}},"paths":{"/tape_drives/{tape_drive_serial}":{"get":{"summary":"Displays a specific tape drive.","operationId":"show_tape_drive","description":"**API Key Scope**: tape_drives / show","tags":["tape_drives"],"responses":{"200":{"$ref":"#/components/responses/tape_drives_show"}}}}}}
```

## Updates a specific tape drive.

> \*\*API Key Scope\*\*: tape\_drives / update

```json
{"openapi":"3.0.1","info":{"title":"Nodeum API","version":"2.1.0"},"servers":[{"url":"{url}/api/v2","variables":{"url":{"default":"http://localhost","description":"URL of server"}}}],"security":[{"BasicAuth":[]},{"BearerAuth":[]},{"JWT":[]}],"components":{"securitySchemes":{"BasicAuth":{"type":"http","scheme":"basic","description":"Pass the username and password of a user in the authorization header.\nThis currently gives full access."},"BearerAuth":{"type":"apiKey","description":"Create an API Key associated to user.\nAccess can be restricted with the scope.\nEach API call described below has a scoped mentionned in its description.\n\nFor example :\n\n**API Key Scope**: files / index\n\nThis means that the API key should have a scope with controller as *files*\nand the action as *index*.","name":"Authorization","in":"header"},"JWT":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"responses":{"tape_drives_show":{"description":"A specific tape drive.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/tape_drive"}}}},"unprocessable_entity":{"description":"The received resource was not correctly formatted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}},"schemas":{"tape_drive":{"allOf":[{"$ref":"#/components/schemas/tape_drive_device"},{"type":"object","properties":{"id":{"type":"integer","readOnly":true,"description":"This ID is not unique. Only unique among a tape library.","format":"int64"},"tape_library_id":{"type":"integer","readOnly":true,"format":"int64"},"name":{"type":"string"},"comment":{"type":"string"},"libso":{"type":"string"},"acs":{"type":"integer"},"lsm":{"type":"integer"},"panel":{"type":"integer"},"transport":{"type":"integer"},"status":{"type":"string","readOnly":true,"enum":["maintenance","online","locked","offline"]},"full":{"type":"integer","readOnly":true},"mount_count":{"type":"integer","readOnly":true},"use_to":{"type":"string","readOnly":true},"use_by":{"type":"string","readOnly":true},"barcode":{"type":"string","readOnly":true},"task_id":{"type":"integer","readOnly":true,"format":"int64"},"use_file_processed_size":{"type":"integer","readOnly":true,"format":"int64"},"use_file_size_to_process":{"type":"integer","readOnly":true,"format":"int64"},"use_file_name_processed":{"type":"string","readOnly":true,"format":"int64"},"bandwidth":{"type":"integer","readOnly":true,"format":"int64"}}}]},"tape_drive_device":{"type":"object","properties":{"serial":{"type":"string","readOnly":true},"scsi_address":{"type":"integer"},"vendor":{"type":"string"},"product":{"type":"string"},"firmware":{"type":"string"},"device":{"type":"string","description":"When saved, device may be prefixed by *n* (eg. `/dev/nst5`)"},"sgdevice":{"type":"string"}}},"error":{"type":"object","properties":{"details":{"type":"object","additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/attribute_error"}},"description":"Parsable objects describing the errors. The key is the invalid attribute name."},"messages":{"type":"array","description":"English description of the errors.","items":{"type":"string"}}}},"attribute_error":{"required":["error"],"type":"object","properties":{"error":{"type":"string"}},"discriminator":{"propertyName":"error"}}},"requestBodies":{"tape_drive_body":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/tape_drive"}}},"required":true}}},"paths":{"/tape_drives/{tape_drive_serial}":{"put":{"summary":"Updates a specific tape drive.","operationId":"update_tape_drive","description":"**API Key Scope**: tape_drives / update","tags":["tape_drives"],"responses":{"200":{"$ref":"#/components/responses/tape_drives_show"},"422":{"$ref":"#/components/responses/unprocessable_entity"}},"requestBody":{"$ref":"#/components/requestBodies/tape_drive_body"}}}}}
```

## Destroys a specific tape drive.

> \*\*API Key Scope\*\*: tape\_drives / destroy

```json
{"openapi":"3.0.1","info":{"title":"Nodeum API","version":"2.1.0"},"servers":[{"url":"{url}/api/v2","variables":{"url":{"default":"http://localhost","description":"URL of server"}}}],"security":[{"BasicAuth":[]},{"BearerAuth":[]},{"JWT":[]}],"components":{"securitySchemes":{"BasicAuth":{"type":"http","scheme":"basic","description":"Pass the username and password of a user in the authorization header.\nThis currently gives full access."},"BearerAuth":{"type":"apiKey","description":"Create an API Key associated to user.\nAccess can be restricted with the scope.\nEach API call described below has a scoped mentionned in its description.\n\nFor example :\n\n**API Key Scope**: files / index\n\nThis means that the API key should have a scope with controller as *files*\nand the action as *index*.","name":"Authorization","in":"header"},"JWT":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}}},"paths":{"/tape_drives/{tape_drive_serial}":{"delete":{"summary":"Destroys a specific tape drive.","operationId":"destroy_tape_drive","description":"**API Key Scope**: tape_drives / destroy","tags":["tape_drives"],"responses":{"204":{"description":"Tape drive destroyed."}}}}}}
```

## Display statistic for a specific tape drive.

> \*\*API Key Scope\*\*: tape\_drive\_stats / show

```json
{"openapi":"3.0.1","info":{"title":"Nodeum API","version":"2.1.0"},"servers":[{"url":"{url}/api/v2","variables":{"url":{"default":"http://localhost","description":"URL of server"}}}],"security":[{"BasicAuth":[]},{"BearerAuth":[]},{"JWT":[]}],"components":{"securitySchemes":{"BasicAuth":{"type":"http","scheme":"basic","description":"Pass the username and password of a user in the authorization header.\nThis currently gives full access."},"BearerAuth":{"type":"apiKey","description":"Create an API Key associated to user.\nAccess can be restricted with the scope.\nEach API call described below has a scoped mentionned in its description.\n\nFor example :\n\n**API Key Scope**: files / index\n\nThis means that the API key should have a scope with controller as *files*\nand the action as *index*.","name":"Authorization","in":"header"},"JWT":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"responses":{"tape_drive_stat_show":{"description":"A specific tape drive statistic.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/tape_drive_stat"}}}},"not_found":{"description":"The requested resource was not found. The detailed error will be of type `not_found`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}},"schemas":{"tape_drive_stat":{"type":"object","properties":{"log_time":{"type":"string","readOnly":true},"serial":{"type":"string","readOnly":true},"total_corrected_write_errors":{"type":"integer","readOnly":true},"total_write_retries":{"type":"integer","readOnly":true},"total_write_kbytes_processed":{"type":"integer","readOnly":true},"total_uncorrected_write_errors":{"type":"integer","readOnly":true},"total_corrected_read_errors":{"type":"integer","readOnly":true},"total_read_retries":{"type":"integer","readOnly":true},"total_read_kbytes_processed":{"type":"integer","readOnly":true},"total_uncorrected_read_errors":{"type":"integer","readOnly":true},"total_channel_write_bytes":{"type":"integer","readOnly":true},"total_device_write_bytes":{"type":"integer","readOnly":true},"total_device_read_bytes":{"type":"integer","readOnly":true},"total_channel_read_bytes":{"type":"integer","readOnly":true},"cleaning_requested":{"type":"integer","readOnly":true},"total_mbytes_processed_since_cleaning":{"type":"integer","readOnly":true},"lifetime_load_cycles":{"type":"integer","readOnly":true},"lifetime_cleaning_cycles":{"type":"integer","readOnly":true},"lifetime_power_on_time":{"type":"integer","readOnly":true},"lifetime_volume_loads":{"type":"integer","readOnly":true},"lifetime_cleaning_operations":{"type":"integer","readOnly":true},"lifetime_power_on_hours":{"type":"integer","readOnly":true},"lifetime_medium_motion":{"type":"integer","readOnly":true},"lifetime_meters_of_tape_processed":{"type":"integer","readOnly":true},"lifetime_medium_motion_when_incompatible_medium_was_loaded":{"type":"integer","readOnly":true},"lifetime_power_on_hours_when_temperature_cond_occured":{"type":"integer","readOnly":true},"lifetime_power_on_hours_when_power_consumption_cond_occured":{"type":"integer","readOnly":true},"medium_motion_hours_last_success_cleaning":{"type":"integer","readOnly":true},"medium_motion_hours_second_success_cleaning":{"type":"integer","readOnly":true},"medium_motion_hours_third_success_cleaning":{"type":"integer","readOnly":true},"lifetime_power_on_emergency_eject_occured":{"type":"integer","readOnly":true},"lifetime_power_cycles":{"type":"integer","readOnly":true},"volume_loads_last_param_reset":{"type":"integer","readOnly":true},"hard_write_errors":{"type":"integer","readOnly":true},"hard_read_errors":{"type":"integer","readOnly":true},"read_duty_cycle":{"type":"integer","readOnly":true},"write_duty_cycle":{"type":"integer","readOnly":true},"activity_duty_cycle":{"type":"integer","readOnly":true},"volume_not_present_duty_cycle":{"type":"integer","readOnly":true},"ready_duty_cycle":{"type":"integer","readOnly":true},"accumulated_transitions_to_active":{"type":"integer","readOnly":true},"accumulated_transitions_to_idle":{"type":"integer","readOnly":true}}},"error":{"type":"object","properties":{"details":{"type":"object","additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/attribute_error"}},"description":"Parsable objects describing the errors. The key is the invalid attribute name."},"messages":{"type":"array","description":"English description of the errors.","items":{"type":"string"}}}},"attribute_error":{"required":["error"],"type":"object","properties":{"error":{"type":"string"}},"discriminator":{"propertyName":"error"}}}},"paths":{"/tape_drives/{tape_drive_serial}/tape_drive_stat":{"get":{"summary":"Display statistic for a specific tape drive.","operationId":"show_tape_drive_stat","description":"**API Key Scope**: tape_drive_stats / show","tags":["tape_drives"],"responses":{"200":{"$ref":"#/components/responses/tape_drive_stat_show"},"404":{"$ref":"#/components/responses/not_found"}}}}}}
```

## List all tape drive statistics.

> \*\*API Key Scope\*\*: tape\_drive\_stats / index

```json
{"openapi":"3.0.1","info":{"title":"Nodeum API","version":"2.1.0"},"servers":[{"url":"{url}/api/v2","variables":{"url":{"default":"http://localhost","description":"URL of server"}}}],"security":[{"BasicAuth":[]},{"BearerAuth":[]},{"JWT":[]}],"components":{"securitySchemes":{"BasicAuth":{"type":"http","scheme":"basic","description":"Pass the username and password of a user in the authorization header.\nThis currently gives full access."},"BearerAuth":{"type":"apiKey","description":"Create an API Key associated to user.\nAccess can be restricted with the scope.\nEach API call described below has a scoped mentionned in its description.\n\nFor example :\n\n**API Key Scope**: files / index\n\nThis means that the API key should have a scope with controller as *files*\nand the action as *index*.","name":"Authorization","in":"header"},"JWT":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"responses":{"tape_drive_stats_index":{"description":"List of tape drive statistics.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/tape_drive_stat_collection"}}}},"not_found":{"description":"The requested resource was not found. The detailed error will be of type `not_found`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}},"schemas":{"tape_drive_stat_collection":{"type":"object","properties":{"count":{"type":"integer","readOnly":true},"tape_drive_stats":{"type":"array","readOnly":true,"items":{"$ref":"#/components/schemas/tape_drive_stat"}}}},"tape_drive_stat":{"type":"object","properties":{"log_time":{"type":"string","readOnly":true},"serial":{"type":"string","readOnly":true},"total_corrected_write_errors":{"type":"integer","readOnly":true},"total_write_retries":{"type":"integer","readOnly":true},"total_write_kbytes_processed":{"type":"integer","readOnly":true},"total_uncorrected_write_errors":{"type":"integer","readOnly":true},"total_corrected_read_errors":{"type":"integer","readOnly":true},"total_read_retries":{"type":"integer","readOnly":true},"total_read_kbytes_processed":{"type":"integer","readOnly":true},"total_uncorrected_read_errors":{"type":"integer","readOnly":true},"total_channel_write_bytes":{"type":"integer","readOnly":true},"total_device_write_bytes":{"type":"integer","readOnly":true},"total_device_read_bytes":{"type":"integer","readOnly":true},"total_channel_read_bytes":{"type":"integer","readOnly":true},"cleaning_requested":{"type":"integer","readOnly":true},"total_mbytes_processed_since_cleaning":{"type":"integer","readOnly":true},"lifetime_load_cycles":{"type":"integer","readOnly":true},"lifetime_cleaning_cycles":{"type":"integer","readOnly":true},"lifetime_power_on_time":{"type":"integer","readOnly":true},"lifetime_volume_loads":{"type":"integer","readOnly":true},"lifetime_cleaning_operations":{"type":"integer","readOnly":true},"lifetime_power_on_hours":{"type":"integer","readOnly":true},"lifetime_medium_motion":{"type":"integer","readOnly":true},"lifetime_meters_of_tape_processed":{"type":"integer","readOnly":true},"lifetime_medium_motion_when_incompatible_medium_was_loaded":{"type":"integer","readOnly":true},"lifetime_power_on_hours_when_temperature_cond_occured":{"type":"integer","readOnly":true},"lifetime_power_on_hours_when_power_consumption_cond_occured":{"type":"integer","readOnly":true},"medium_motion_hours_last_success_cleaning":{"type":"integer","readOnly":true},"medium_motion_hours_second_success_cleaning":{"type":"integer","readOnly":true},"medium_motion_hours_third_success_cleaning":{"type":"integer","readOnly":true},"lifetime_power_on_emergency_eject_occured":{"type":"integer","readOnly":true},"lifetime_power_cycles":{"type":"integer","readOnly":true},"volume_loads_last_param_reset":{"type":"integer","readOnly":true},"hard_write_errors":{"type":"integer","readOnly":true},"hard_read_errors":{"type":"integer","readOnly":true},"read_duty_cycle":{"type":"integer","readOnly":true},"write_duty_cycle":{"type":"integer","readOnly":true},"activity_duty_cycle":{"type":"integer","readOnly":true},"volume_not_present_duty_cycle":{"type":"integer","readOnly":true},"ready_duty_cycle":{"type":"integer","readOnly":true},"accumulated_transitions_to_active":{"type":"integer","readOnly":true},"accumulated_transitions_to_idle":{"type":"integer","readOnly":true}}},"error":{"type":"object","properties":{"details":{"type":"object","additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/attribute_error"}},"description":"Parsable objects describing the errors. The key is the invalid attribute name."},"messages":{"type":"array","description":"English description of the errors.","items":{"type":"string"}}}},"attribute_error":{"required":["error"],"type":"object","properties":{"error":{"type":"string"}},"discriminator":{"propertyName":"error"}}},"parameters":{"limit":{"name":"limit","in":"query","description":"The number of items to display for pagination.","schema":{"type":"integer"}},"offset":{"name":"offset","in":"query","description":"The number of items to skip for pagination.","schema":{"type":"integer"}}}},"paths":{"/tape_drive_stats":{"get":{"summary":"List all tape drive statistics.","operationId":"index_tape_drive_stats","description":"**API Key Scope**: tape_drive_stats / index","tags":["tape_drives"],"responses":{"200":{"$ref":"#/components/responses/tape_drive_stats_index"},"404":{"$ref":"#/components/responses/not_found"}},"parameters":[{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/offset"}]}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nodeum.io/data-archiving/api-developers/api-reference-nodeum-data-archiving/tape_drives.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.