Obtener lista de dispositivos de cintas

Versión del producto: 10.11

Último modificado: 31 julio 2024

Obtiene la lista de dispositivos de cinta.

Punto final

https://<Director_IP_address>:4443/c/router

Punto final inquilino

Para los inquilinos del producto multi-tenant el punto final debe ser:

https://<Director_IP_address>:4443/t/<tenant_UUID>/c/router

Ejemplo de solicitud

rizo

Copiar

 curl--request POST\
 --url https: //<Director_IP_address>:4443/c/router \
     --header "content-type: application/json"\
     --cookie @cookies.txt\
     --data '{
 "action": "TapeDeviceManagement",
 "method": "getDevices",
 "data": [{
     "filter": {
         "start": 0,
         "count": 200,
         "sort": "NAME",
         "sortAsc": true
     }
 }],
 "type": "rpc",
 "tid": 1}'

Campos de solicitud

Campo	Tipo	Valor(es)
`action`	string	Gestión de dispositivos de cinta
`method`	string	getDevices
`data`	Json	Filtrar parámetros. Consulte la siguiente tabla `filter`
`type`	string	`rpc`
`tid`	integer	1

filtrar

Campo	Tipo	Descripción
`start`	int	Un ID de inicio del dispositivo de cintas a devolver
`count`	int	Número de dispositivos de cinta a devolver
`sort`	string	Parámetro del dispositivo de cintas que debe ordenarse con
`sortAsc`	boolean	`true` si el orden es ascendente
`criteria`	array	Filtrar criterios. Véanse las filas siguientes
`type`	string	Tipo de criterio
`name`	string	Nombre del criterio. `NAME` nombre del dispositivo de cintas
`type`	string	Tipo de criterio. `EQ` significa el operador relacional de igualdad
`value`	string	Valor del criterio

Muestra de respuesta

rizo

Copiar

{
    "action": "TapeDeviceManagement",
    "method": "getDevices",
    "tid": "1",
    "type": "rpc",
    "message": null,
    "where": null,
    "cause": null,
    "data": {
        "children": [{
                "alertDescription": null 
                "alertErrorCode": null 
                "alertTitle": null 
                "attached": true 
                "blockSize": 524288 
                "changeStatus": "NONE"
                "changers": null 
                "compression": "HARDWARE_BASED"
                "deviceName": "IBM"
                "driveCount": 1 
                "drives": null 
                "freeCapacity": null 
                "id": 67 
                "locationId": 1 
                "locationName": "My office"
                "lockReasons": []
                "lockedExclusive": false 
                "lockedShared": false 
                "mediaPoolId": null 
                "mediaPoolName": null "name": "VT"
                "offlineLocationId": 1 
                "offlineLocationName": "My office"
                "operationStart": null
                "operationStartRelative": 0 
                "path": "/dev/sg0"
                "preventModification": false 
                "progress": 0 
                "slotCount": 3200 
                "state": "OK"
                "status": "NONE"
                "tapeCartridgeCount": 1 
                "tapeCartridgeId": 225 
                "tapeCartridgeName": null 
                "transporterId": 33 
                "transporterName": "13.234.155.61"
                "type": "TAPE_LIBRARY"
                "updateChangers": false 
                "updateDrives": false 
                "uuid": "b1704a03-ea44-34ac-b0b-e86cbb2349f5"
                "vid": "TAPE_LIBRARY-67"
                "wasCreated": false 
                "wasDiscoveredOnce": true 
                "wasEdited": false
            },
            {
                "alertDescription": null 
                "alertErrorCode": null 
                "alertTitle": null 
                "attached": true 
                "blockSize": 262144 
                "changeStatus": "NONE"
                "changers": null 
                "compression": "HARDWARE_BASED"
                "deviceName": "stdrive_2"
                "driveCount": 0 
                "drives": null 
                "freeCapacity": null 
                "id": 1 
                "locationId:"1 
                "locationName": "My office"
                "lockReasons": []
                "lockedExclusive": false 
                "lockedShared": false 
                "mediaPoolId": null 
                "mediaPoolName": null 
                "name": "st2"
                "offlineLocationId": 1 
                "offlineLocationName": 
                "My office"
                "operationStart": null
                "operationStartRelative": 0 
                "path": "stdrive_2"
                "preventModification": false 
                "progress": 0 
                "slotCount": 0 
                "state": "OK"
                "status": "NONE"
                "tapeCartridgeCount": 1 
                "tapeCartridgeId": 1 
                "tapeCartridgeName": "ST002"
                "transporterId": 1 
                "transporterName": "1.1.1.1"
                "type": "TAPE_STANDALONE_DRIVE"
                "updateChangers": false 
                "updateDrives": false 
                "uuid": "17453fce-e58d-4ed1-a926-65b8ff171002"
                "vid": "TAPE_STANDALONE_DRIVE-1"
                "wasCreated": false 
                "wasDiscoveredOnce": true 
                "wasEdited": false
            }
        ],
        "totalCount": 2
    }
}

Campos de respuesta

Campo	Valor	Descripción
`message`	string	Mensaje si la solicitud ha fallado
`where`	string	Referencia al método en el que se produjo el problema
`cause`	string	Causa del fallo
`data`	Json	Información sobre dispositivos de cintas

datos.hijos

Campo	Valor	Descripción
`alertErrorCode`	largo	Código de error de la alerta (si existe)
`alertDescription`	string	Descripción de la descripción (si procede)
`alertTitle`	string	Título de la descripción (si procede)
`attached`	boolean	Comprueba si el dispositivo de cintas está conectado.
`blockSize`	int	Tamaño de bloque del dispositivo de cintas actual
`changeStatus`	string	Cambia de estado. Valores posibles: NONE, CREATE_PENDING (elemento nuevo, se necesita detección), CHANGE_PENDING (algunos atributos han cambiado, se necesita detección), RECREATE_PENDING (el elemento se ha destruido y necesita volver a crearse)
`changers`	Json	Cambiadores de soportes de la biblioteca de cintas
`compression`	string	Tipo de compresión
`deviceName`	string	Nombre del dispositivo de cintas
`driveCount`	int	Número de unidades de la biblioteca de cintas
`drives`	Json	Cintas de la biblioteca de cintas
`freeCapacity`	largo	Capacidad libre del dispositivo de cintas
`id`	largo	ID del dispositivo de cintas
`locationId`	int	ID de ubicación del dispositivo de cintas
`locationName`	string	Nombre de ubicación del dispositivo de cintas
`mediaPoolId`	int	ID del Grupo de medios del dispositivo de cintas
`mediaPoolName`	string	Nombre del Grupo de medios del dispositivo de cintas
`lockReasons`	array	Motivos de bloqueo
`lockedExclusive`	boolean	`true` si no se pueden realizar varias actualizaciones en el dispositivo de cintas al mismo tiempo`.`
`lockedShared`	boolean	`true` si no se pueden ejecutar varias operaciones de lectura en el mismo dispositivo de cintas al mismo tiempo`.`
`name`	string	Nombre del dispositivo de cintas
`offlineLocationId`	int	ID de la ubicación de las cintas expulsadas de este dispositivo de cintas.
`offlineLocationName`	string	Nombre de la ubicación de las cintas expulsadas de este dispositivo de cintas.
`operationStart`	string	Marca de tiempo del inicio de la operación actual
`operationStartRelative`	largo	Marca de tiempo relativa (por ejemplo, hora desde el inicio) del comienzo de la operación actual
`path`	string	Ruta al dispositivo de cintas
`preventModification`	boolean	Si `true`, impide la modificación manual del elemento
`progress`	int	Progreso de la operación en curso
`slotCount`	int	Número de ranuras de la biblioteca de cintas
`state`	string	Estado del dispositivo de cintas
`status`	string	Estado de la operación actual en el dispositivo de cintas. `NONE` si no se está ejecutando ninguna operación. Valores posibles: `NONE, UPDATING, READING, WRITING`
`tapeCartridgeCount`	int	Número de cartuchos de dispositivos de cinta
`tapeCartridgeId`	largo	ID de cartucho de cinta
`tapeCartridgeName`	string	Nombre del cartucho de cinta
`transporterId`	largo	ID del transportador asignado
`transporterName`	string	Nombre del transportador asignado
`type`	string	Tipo de dispositivo de cinta. Valores posibles: `%s` `dfsdf` `%948%lkjlkj%TAPE_STANDALONE_DRIVE`
`updateChangers`	boolean	Comprueba si se han actualizado los cambiadores de la biblioteca de cintas.
`updateDrives`	boolean	Comprueba si se han actualizado las unidades de la biblioteca de cintas.
`uuid`	string	UUID del dispositivo de cintas
`vid`	string	VID del dispositivo de cintas
`wasCreated`	boolean	Comprueba si se ha creado el dispositivo de cintas.
`wasDiscoveredOnce`	boolean	Comprueba si el dispositivo de cintas fue detectado una vez.
`wasEdited`	boolean	Comprueba si se ha editado el dispositivo de cinta.