REST API - GET Library Details

Updated

This operation returns the details associated with a library.

Request

Syntax

GET <webservice>/Library/{libraryId} HTTP/1.1

Host: <host name>

Accept: application/xml

Authtoken: <authentication token>

where <webservice> is the root path used to route the API requests to the Web Server.

For more information, see Available Web Services for REST API.

Request Parameters

Name

Description

Required

libraryId

The library ID for the library. If the library ID is not known, use the GET Library API to retrieve it.

Yes

Request Headers

Name

Description

Host

The host name of the Web Server or Web Console used in the API request.

Accept

The format of the response. Valid values are: application/xml or application/json.

Authtoken

The authentication token received after successfully logging on. For details on receiving an authentication token, see Authentication.

Response

Response Parameters

Parameter

Description

Element

model

Library model.

libraryInfo

manufacturer

Library manufacturer.

libraryInfo

libraryVendorId

Library vendor.

libraryInfo

libraryType

Library type.

1 - Tape

3 - Disk/Cloud

4 - Stand Alone Library

libraryInfo

description

Library description.

libraryInfo

totalNumberOfWriteReservations

Magnetic library number of write reservations.

magLibSummary

totalFreeSpace

Magnetic library total free space.

magLibSummary

totalCapacity

Magnetic library capacity.

magLibSummary

totalAvailableSpace

Magnetic library available space.

magLibSummary

onlineMountPaths

Magnetic library mount paths that are online.

magLibSummary

numOfMountPath

Magnetic library total number of mount paths.

magLibSummary

mountPathUsage

Magnetic library mount path usage details.

magLibSummary

lastRestoreTime

Magnetic library time of the most recent restore job.

magLibSummary

lastHourThroughput

Magnetic library throughput in the last 1 hour.

magLibSummary

lastDayThroughput

Magnetic library throughput in the last 1 day.

magLibSummary

lastBackupTime

Magnetic library time of the most recent backup job.

magLibSummary

isOnline

Magnetic library status.

magLibSummary

bytesBackedupInLast24H

Magnetic library total amount of backup in the last 24 hours.

magLibSummary

bytesBackedupInLast1H

Magnetic library total amount of backup in the last 1hour.

magLibSummary

backupReservations

Magnetic library status - current reservation for backup job.

magLibSummary

auxiliaryCopyWriteReservations

Magnetic library status - current reservations for auxiliary copy job.

magLibSummary

associatedMediaAgents

Magnetic library MediaAgent associations.

magLibSummary

status

Tape library current status.

tapeLibSummary

model

Tape library model.

tapeLibSummary

totalNumberOfWriteReservations

Tape library total number of current write reservations.

tapeLibSummary

lastRestoreTime

Tape library time of the most recent restore job.

tapeLibSummary

lastHourThroughput

Tape library throughput in the last 1 hour.

tapeLibSummary

lastDayThroughput

Tape library throughput in the last 1 day.

tapeLibSummary

lastBackupTime

Tape library time of the most recent backup job.

tapeLibSummary

isOnline

Tape library total amount of backup in the last 24 hours.

tapeLibSummary

bytesBackedupInLast24H

Tape library total amount of backup in the last 1hour.

tapeLibSummary

bytesBackedupInLast1H

Tape library status - current reservation for backup job.

tapeLibSummary

backupReservations

Tape library status - current reservations for auxiliary copy job.

tapeLibSummary

auxiliaryCopyWriteReservations

Tape library status - current reservations for auxiliary copy job.

tapeLibSummary

associatedMediaAgents

Tape library MediaAgent associations.

tapeLibSummary

vendor

Tape library vendor.

tapeLibSummary

serialNumber

Tape library serial number.

tapeLibSummary

offlineReason

Tape library offline reason.

tapeLibSummary

numOfSpareMedia

Tape library total number of spare media.

tapeLibSummary

numOfSlots

Tape library total number of slots

tapeLibSummary

numOfRegSlots

Tape library total number of registered slots.

tapeLibSummary

numOfRegSlotOccupied

Tape library total number of occupied slots.

tapeLibSummary

numOfMediaExporting

Tape library total number of exported media.

tapeLibSummary

numOfMedia

Tape library total number of media in the library.

tapeLibSummary

numOfIESlots

Tape library total number of mail slots.

tapeLibSummary

numOfIESlotOccupied

Tape library total number of mail slots occupied.

tapeLibSummary

numOfDrivesOffline

Tape library number of offline drives.

tapeLibSummary

numOfDrives

Tape library total number of drives.

tapeLibSummary

numOfCleaningMedia

Tape library total number of cleaning media.

tapeLibSummary

numOfAppendableMedia

Tape library total number of appendable media.

tapeLibSummary

numOfAgedMedia

Tape library total number of aged media.

tapeLibSummary

numOfActiveMedia

Tape library total number of active media.

tapeLibSummary

isEnabled

Tape library availability.

tapeLibSummary

firmwareRevision

Tape library firmware version.

tapeLibSummary

controller

Tape library controller.

tapeLibSummary

barcodeReader

Tape library - does it have a barcode reader.

tapeLibSummary

attribute

Tape library attribute.

tapeLibSummary

numOfSpareMediaInLib

Tape library number of spare media in library

tapeLibSummary

status

Drive online/offline status.

DriveList

mountStatus

Drive mount status.

DriveList

jobIds

Drive - job IDS of the current job accessing the drive.

DriveList

driveType

Drive type.

DriveList

drivePoolName

Drive pool name to which the drive is attached.

DriveList

drivePoolId

Drive pool ID to which the drive is attached.

DriveList

driveName

Drive name.

DriveList

driveId

Drive ID.

DriveList

barcode

Drive - barcode of the media in the drive.

DriveList

activeMediaAgent

Drive  - MediaAgent associated with the current job accessing the drive.

DriveList

access

Drive - whether it is currently accessed.

DriveList

status

Drive status.

driveSummary

model

Drive model.

driveSummary

lastHourThroughput

Drive throughput in the last hour.

driveSummary

lastDayThroughput

Drive throughput in the last day.

driveSummary

isOnline

Whether the drive is online.

driveSummary

vendor

Drive vendor.

driveSummary

serialNumber

Drive serial number.

driveSummary

offlineReason

Drive offline reason.

driveSummary

isEnabled

Whether the drive is enabled.

driveSummary

firmwareRevision

Drive firmware version.

driveSummary

controller

Name of the drive controller.

driveSummary

attribute

Drive attribute.

driveSummary

driveName

Name of the drive.

driveSummary

readWriteErrosSinceLastClean

Number of read errors after the last drive cleaning operation.

driveSummary

numberOfRunningJobs

Number of jobs accessing the drive.

driveSummary

mountUnmountErrosSinceLastClean

Number of mount/unmount errors after the last drive cleaning operation.

driveSummary

library

Library in which the drive is located.

driveSummary

lastUseTime

The most recent time that the drive was accessed.

driveSummary

hoursUsedSinceLastClean

Total number of hours used since the most recent cleaning operation.

driveSummary

bytesBackedupInLast24Hour

Total amount of backup in the last 24 hours.

driveSummary

bytesBackedupInLast1Hour

Total amount of backup in the last 1 hour.

driveSummary

libraryName

Name of the library.

library

libraryId

System generated ID for the library.

library

Examples

Sample Request

GET <webservice>/Library/2 HTTP/1.1

Host: client.mydomain.com

Accept: application/xml

Authtoken: QSDK 38568012f4d1e8ee1841d283a47aa3ba78e124ea58354b5fc6

0f4dab8a63347d05cf5552484dafda3bfa4c5db84e580b1cb37bcf8e65b39f7f

8549a443e6f78a2c7be3f31b3d845e24776c835e498e8e883bb40c46bd15af4f

40ca94e823acedcdd4e9659e74b34a07a85c4586cd2ed914b6dce015874783ef7

68fda78183a4208930954a377f66eb56c8b92cexampl4s437a19317ca6ce7f323

3d5a01aca35dbad93468b833f2cf71010809006a937670adce711ca8be46638e8

Sample Response

Note: The GET Library Details operation can not return the mount path information in the response. The mountPathSummary in the response for a cloud library or a disk library displays zero values for all parameters.

Tape Library

<?xml version="1.0" encoding="UTF-8"?> 

<EVGui_GetLibraryInfoWCResp>

 <libraryInfo status="" model="Scalar i2000" manufacturer="QUANTUM" libraryVendorId="0" libraryType="1" description="">

  <magLibSummary totalNumberOfWriteReservations="0" totalFreeSpace="" totalCapacity="" totalAvailableSpace="" onlineMountPaths="" numOfMountPath="0" mountPathUsage="" lastRestoreTime="" lastHourThroughput="" lastDayThroughput="" lastBackupTime="" isOnline="" bytesBackedupInLast24H="" bytesBackedupInLast1H="" backupReservations="0" auxiliaryCopyWriteReservations="0" associatedMediaAgents=""/>

  <tapeLibSummary status="0" model="Scalar i2000" totalNumberOfWriteReservations="0" lastRestoreTime="Feb 13 2017 5:06PM" lastHourThroughput="0" lastDayThroughput="0" lastBackupTime="Jan 17 2017 4:35PM" isOnline="No" bytesBackedupInLast24H="" bytesBackedupInLast1H="" backupReservations="0" auxiliaryCopyWriteReservations="0" associatedMediaAgents=" mmtest1" vendor="QUANTUM" serialNumber="QUANTUM203100404_LL1" offlineReason="The SCSI device is not ready. Manual intervention is required. SCSI Error - ASC[0x04], ASCQ[0x03]" numOfSpareMedia="4" numOfSlots="0" numOfRegSlots="48" numOfRegSlotOccupied="4" numOfMediaExporting="0" numOfMedia="5" numOfIESlots="6" numOfIESlotOccupied="0" numOfDrivesOffline="0" numOfDrives="2" numOfCleaningMedia="0" numOfAppendableMedia="0" numOfAgedMedia="1" numOfActiveMedia="0" isEnabled="1" firmwareRevision="653Q" controller="" barcodeReader="Yes" attribute="10" numOfSpareMediaInLib=”0”/>

  <DriveList status="Ready" mountStatus="" jobIds="" driveType="ULTRIUM-V2" drivePoolName="" drivePoolId="0" driveName="IBM ULTRIUM-TD2_1" driveId="539" barcode="948ADY" activeMediaAgent="" access="Drive Fully Accessible">

<driveSummary status="0" model="" lastHourThroughput="" lastDayThroughput="" isOnline="" vendor="" serialNumber="" offlineReason="" isEnabled="0" firmwareRevision="" controller="" attribute="0" driveName="" readWriteErrosSinceLastClean="0" numberOfRunningJobs="0" mountUnmountErrosSinceLastClean="0" library="" lastUseTime="" hoursUsedSinceLastClean="0" bytesBackedupInLast24Hour="" bytesBackedupInLast1Hour=""/>

  </DriveList>

   <DriveList status="Ready" mountStatus="" jobIds="" driveType="ULTRIUM-V2" drivePoolName="" drivePoolId="0" driveName="IBM ULTRIUM-TD2_2" driveId="540" barcode="" activeMediaAgent="" access="Drive Fully Accessible">

        <driveSummary status="0" model="" lastHourThroughput="" lastDayThroughput="" isOnline="" vendor="" serialNumber="" offlineReason="" isEnabled="0" firmwareRevision="" controller="" attribute="0" driveName="" readWriteErrosSinceLastClean="0" numberOfRunningJobs="0" mountUnmountErrosSinceLastClean="0" library="" lastUseTime="" hoursUsedSinceLastClean="0" bytesBackedupInLast24Hour="" bytesBackedupInLast1Hour=""/>

  </DriveList>

  <library libraryName="QUANTUM Scalar i2000 234" libraryId="234" _type_="9"/>

 </libraryInfo>

</EVGui_GetLibraryInfoWCResp>

Disk Library

<?xml version="1.0" encoding="UTF-8"?> 

<EVGui_GetLibraryInfoWCResp>

 <libraryInfo status="" model="Disk" manufacturer="Disk" libraryVendorId="0" libraryType="3" description="">

 <magLibSummary totalNumberOfWriteReservations="0" totalFreeSpace=" 8.70 GB" totalCapacity=" 227.94 GB" totalAvailableSpace=" 6.70 GB" onlineMountPaths="1 out of 1" numOfMountPath="1" mountPathUsage="Fill and Spill" lastRestoreTime="Mar 22 2017 5:17PM" lastHourThroughput="0" lastDayThroughput="0" lastBackupTime="Mar 20 2017 12:09PM" isOnline="Ready" bytesBackedupInLast24H="" bytesBackedupInLast1H="" backupReservations="0" auxiliaryCopyWriteReservations="0" associatedMediaAgents=" mmtest1"/>

 <tapeLibSummary status="0" model="" totalNumberOfWriteReservations="0" lastRestoreTime="" lastHourThroughput="" lastDayThroughput="" lastBackupTime="" isOnline="" bytesBackedupInLast24H="" bytesBackedupInLast1H="" backupReservations="0" auxiliaryCopyWriteReservations="0" associatedMediaAgents="" vendor="" serialNumber="" offlineReason="" numOfSpareMedia="0" numOfSlots="0" numOfRegSlots="0" numOfRegSlotOccupied="0" numOfMediaExporting="0" numOfMedia="0" numOfIESlots="0" numOfIESlotOccupied="0" numOfDrivesOffline="0" numOfDrives="0" numOfCleaningMedia="0" numOfAppendableMedia="0" numOfAgedMedia="0" numOfActiveMedia="0" isEnabled="0" firmwareRevision="" controller="" barcodeReader="" attribute="0" numOfSpareMediaInLib=”0”/>

 <MountPathList status="Ready" mountPathName="[mmtest1] D:\MeGaLib\Adisk" mountPathId="66" mediaAgents="" jobIds="" dataServerType="0">

 <deviceInfo name="Device_63" id="63"/>

 <mountPathSummary totalFreeSpace="0" attribute="0" warningWaterMark="0" totalValidData="0" totalSpace="0" totalReserveSpaceMB="0" totalDeduplicationDataWritten="0" totalDeduplicationAppSize="0" totalDataWritten="0" totalAppSize="0" numberOfWriters="0" lowWaterMark="0" libraryName="ADisk" libraryId="108" lastNumDays="0" estimatedSpaceRunoutDays="0" avgMediaFreedPerDay="0" avgMediaConsumedPerDay="0" avgDataWrittenPerDayMB="0" avgCapacityFreedMB="0"/>

 </MountPathList>

 <library libraryName="ADisk" libraryId="108" _type_="9"/>

</libraryInfo>

</EVGui_GetLibraryInfoWCResp>

Cloud Library

<?xml version="1.0" encoding="UTF-8"?> 

<EVGui_GetLibraryInfoWCResp>

 <libraryInfo status="" model="Cloud" manufacturer="Cloud" libraryVendorId="0" libraryType="3" description="">

 <magLibSummary totalNumberOfWriteReservations="0" totalFreeSpace="N/A" totalCapacity="N/A" totalAvailableSpace=" 0.00 Bytes" onlineMountPaths="1 out of 1" numOfMountPath="1" mountPathUsage="Fill and Spill" lastRestoreTime="N/A" lastHourThroughput="0" lastDayThroughput="0" lastBackupTime="Mar 17 2017 10:23AM" isOnline="Ready" bytesBackedupInLast24H="" bytesBackedupInLast1H="" backupReservations="0" auxiliaryCopyWriteReservations="0" associatedMediaAgents=" matador12_2,bluejay_2,mmtest1,Orion1"/>

 <tapeLibSummary status="0" model="" totalNumberOfWriteReservations="0" lastRestoreTime="" lastHourThroughput="" lastDayThroughput="" lastBackupTime="" isOnline="" bytesBackedupInLast24H="" bytesBackedupInLast1H="" backupReservations="0" auxiliaryCopyWriteReservations="0" associatedMediaAgents="" vendor="" serialNumber="" offlineReason="" numOfSpareMedia="0" numOfSlots="0" numOfRegSlots="0" numOfRegSlotOccupied="0" numOfMediaExporting="0" numOfMedia="0" numOfIESlots="0" numOfIESlotOccupied="0" numOfDrivesOffline="0" numOfDrives="0" numOfCleaningMedia="0" numOfAppendableMedia="0" numOfAgedMedia="0" numOfActiveMedia="0" isEnabled="0" firmwareRevision="" controller="" barcodeReader="" attribute="0" numOfSpareMediaInLib=”0”/>

 <MountPathList status="Ready" mountPathName="[matador12_2] Manoj" mountPathId="169" mediaAgents="" jobIds="" dataServerType="0">

  <deviceInfo name="Device_171" id="171"/>

  <mountPathSummary totalFreeSpace="0" attribute="0" warningWaterMark="0" totalValidData="0" totalSpace="0" totalReserveSpaceMB="0" totalDeduplicationDataWritten="0" totalDeduplicationAppSize="0" totalDataWritten="0" totalAppSize="0" numberOfWriters="0" lowWaterMark="0" libraryName="Core_Cloud_Amazon" libraryId="269" lastNumDays="0" estimatedSpaceRunoutDays="0" avgMediaFreedPerDay="0" avgMediaConsumedPerDay="0" avgDataWrittenPerDayMB="0" avgCapacityFreedMB="0"/>

 </MountPathList>

 <library libraryName="Core_Cloud_Amazon" libraryId="269" _type_="9"/>

</libraryInfo>

</EVGui_GetLibraryInfoWCResp>