Obtener lista de cartuchos de cinta

Versión del producto: 10.11

Último modificado: 31 julio 2024

Obtiene una lista de cartuchos de cinta.

Punto final

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

Punto final inquilino

Para los inquilinos del producto multiinquilino, el punto final debe ser:
https://<Director_IP_address>:4443/t/<tenant_UUID>/c/router

Ejemplo de solicitud

Copiar 
curl--request POST\
--url https: //<Director_IP_address>:4443/c/router \
    --header "content-type: application/json"\
    --cookie @cookies.txt\
    --data '{
"action": "TapeCartridgeManagement",
"method": "getCartridges",
"data": [{
    "filter": {
        "start": 0,
        "count": 200,
        "sort": "NAME",
        "sortAsc": true,
        "criteria": [{
            "type": "LIKE",
            "name": "BACKUP_NAME",
            "value": "Centos7"
        }],
        "criteria": [{
            "type": "EQ",
            "name": "STATUS",
            "value": "ONLINE"
        }],
        "criteria": [{
            "type": "EQ",
            "name": "DEVICE_ID",
            "value": "3"
        }],
        "criteria": [{
            "type": "EQ",
            "name": "LOCATION_ID",
            "value": "1"
        }],
        "criteria": [{
            "type": "EQ",
            "name": "LAST_WRITTEN",
            "value": "2019-09-17T00:00:00+07:00"
        }]
    }
}],
"type": "rpc",
"tid": 1}'

Campos de solicitud

Campo
Tipo
Valor(es)
action string

TapeCartridgeManagement

method string

getCartridges

data array

Filtrar parámetros. Consulte la siguiente tabla filter
type string rpc
tid int 1

Filtrar

Campo
Tipo
Descripción

start

int

ID de inicio del cartucho de cinta a devolver

count

int

Número de cartuchos de cinta a devolver

sort

string

Parámetro de cartuchos de cinta para clasificar 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 significa el nombre del cartucho de cinta

type

string

Tipo de criterio. EQ significa el operador relacional de igualdad

value

string

Valor del criterio

Muestra de respuesta

Copiar 
{
    "action": "TapeCartridgeManagement",
    "method": "getCartridges",
    "tid": "1",
    "type": "rpc",
    "message": null,
    "where": null,
    "cause": null,
    "data": {
        "countTapeDevices": 3,
        "children": [{
                "uuid": null,
                "vid": "TAPE_CARTRIDGE-6",
                "name": "DRI01",
                "barcode": "DRI01",
                "label": null,
                "contents": "EMPTY",
                "status": "ONLINE",
                "state": "AVAILABLE",
                "stateInfo": "OK",
                "type": "RW",
                "protectedDate": null,
                "retiredDate": null,
                "markedAsFreeDate": null,
                "markedAsCleaningDate": null,
                "overWritable": null,
                "lastWritten": "2019-09-17T00:00:00+07:00",
                "numberOfBackups": 0,
                "numberOfSavePoints": 0,
                "deviceId": 3,
                "deviceName": "HP-Compag-5000",
                "deviceType": "TAPE_LIBRARY",
                "deviceCustomName": "VTl",
                "containerIndex": 4,
                "containerType": "NORMAL_SLOT",
                "attachedDevice": true,
                "locationId": 1,
                "locationName": "My office",
                "mediaPoolId": -1,
                "mediaPoolName": "",
                "lockedShared": false,
                "lockedExclusive": false,
                "lockReasons": [],
                "lockDeviceReasons": [],
                "moveFromContainerType": null,
                "moveFromContainerIndex": null,
                "moveToContainerType": null,
                "moveToContainerIndex": null
            },
            {
                "uuid": "28c9afb2-82ac-4a7b-8482-5275e1bb54b4",
                "vid": "TAPE_CARTRIDGE-4",
                "name": "SLOT03",
                "barcode": "SLOT03",
                "label": null,
                "contents": "SUPPORTED",
                "status": "ONLINE",
                "state": "BACKUP",
                "stateInfo": "OK",
                "type": "RW",
                "protectedDate": null,
                "retiredDate": "2019-09-18T09:55:22.959+07:00",
                "markedAsFreeDate": "2019-09-18T10:03:11.919+07:00",
                "markedAsCleaningDate": null,
                "overWritable": null,
                "lastWritten": "2019-09-17T00:00:00+07:00",
                "numberOfBackups": 1,
                "numberOfSavePoints": 4,
                "deviceId": 3,
                "deviceName": "HP-Compag-5000",
                "deviceType": "TAPE_LIBRARY",
                "deviceCustomName": "VTl",
                "containerIndex": 0,
                "containerType": "DRIVE",
                "attachedDevice": true,
                "locationId": 1,
                "locationName": "My office",
                "mediaPoolId": -1,
                "mediaPoolName": "",
                "lockedShared": false,
                "lockedExclusive": false,
                "lockReasons": [],
                "lockDeviceReasons": [],
                "moveFromContainerType": null,
                "moveFromContainerIndex": null,
                "moveToContainerType": null,
                "moveToContainerIndex": null
            }
        ],
        "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 cartuchos de cinta. Véase el cuadro siguiente

datos.hijos

Información sobre cartuchos de cinta individuales.

Campo

Tipo

Descripción

attachedDevice

boolean

Comprueba si el dispositivo de cintas está conectado.

barcode

string

Código de barras del cartucho de cinta

containerIndex

integer

Índice de la ranura o unidad. Sólo para biblioteca de cintas

containerType

string

Tipo de la biblioteca de cintas que contiene el cartucho de cintas. Valores posibles: %s dfsdf %612%lkjlkj%, NORMAL_SLOT, MAIL_SLOT

contents

string

Contenido de los cartuchos de cinta. Valores posibles: EMPTY, ALIEN, SUPPORTED, UNKNOWN

deviceCustomName

string

Nombre del dispositivo de cintas

deviceId

largo

ID del dispositivo de cintas

deviceType

string

Tipo de dispositivo de cinta. Valores posibles: %s dfsdf %620%lkjlkj%, TAPE_STANDALONE_DRIVE

label

string

Etiqueta de cartucho de cinta

lastWritten

FechaHora

Fecha de la última operación de escritura

locationId

integer

ID de ubicación del dispositivo de cintas

locationName

string

Nombre de ubicación del dispositivo de cintas

lockDeviceReasons

array

Motivos del dispositivo de bloqueo

lockReasons

array

Motivos de bloqueo

lockedExclusive

boolean

true si no se pueden realizar varias actualizaciones en el cartucho de cinta al mismo tiempo.

lockedShared

boolean

true si no se pueden ejecutar varias operaciones de lectura en el mismo cartucho de cinta al mismo tiempo.

markedAsCleaningDate

FechaHora

Fecha en la que la cinta se marcó como cinta de limpieza

markedAsFreeDate

FechaHora

Fecha en la que la cinta se marcó como cinta libre

mediaPoolId

integer

ID del Grupo de medios del dispositivo de cintas

mediaPoolName

string

Nombre del Grupo de medios del dispositivo de cintas

moveFromContainerIndex

integer

Índice del contenedor del que se moverá el cartucho de cinta

moveFromContainerType

string

Tipo de contenedor del que se moverá el cartucho de cintas. Valores posibles: %s dfsdf %612%lkjlkj%, NORMAL_SLOT, MAIL_SLOT

moveToContainerIndex

integer

Índice del contenedor al que se trasladará el cartucho de cinta

moveToContainerType

string

Tipo de contenedor al que se trasladará el cartucho de cinta. Valores posibles: %s dfsdf %612%lkjlkj%, NORMAL_SLOT, MAIL_SLOT

name

string

Nombre del cartucho de cinta

numberOfBackups

largo

Número de backups en el cartucho de cinta

numberOfSavePoints

largo

Número de puntos de retorno en el cartucho de cinta

overWritable

FechaHora

Fecha en la que caducarán todos los puntos de recuperación de la cinta.

protectedDate

FechaHora

Fecha de protección de la cinta

retiredDate

FechaHora

Fecha de retirada de la cinta

state

string

Estado de los cartuchos de cinta. Valores posibles: NEW, ALIEN_DATA, AVAILABLE, UNKNOWN, BACKUP_OLD, BACKUP_EMPTY, BACKUP, BACKUP_FULL

stateInfo

string

Información sobre el estado de los cartuchos de cinta. Valores posibles: OK, WARNING, ERROR

status

string

Estado del cartucho de cinta. Valores posibles: OFFLINE, ONLINE, SCANNING, ERASING, READING, WRITING, MOVING, ERROR

type

string

Tipo de cartucho de cinta. Valores posibles: RW, READ_ONLY, CLEANING

uuid

string

UUID del cartucho de cinta

vid

string

Cartucho de cinta VID