Get diagnostic cartridges lifetime metrics

Request syntax

Path parameters

volser (string)

The volume serial number (VOLSER) or bar code number of the cartridge.

internalAddress (string)

The unique identifier of the cartridge within the library represented by a 6-character hex string. If there are duplicate VOLSERs, this value is used to identify the cartridge. The value changes if the cartridge is assigned or unassigned from a logical library or if the cartridge is moved by the host or library. Query the value before you use.

Example

> GET /v1/dataCartridge/lifetimeMetrics
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 33330
[     {
             "volser": "SG1122L8",
             "internalAddress": "030403",
             "motionMeters": 4856140256,
             "mounts": 3401,
             "dataWrittenToCartridge": 4089050,
             "errorsCorrectedRead": 0,
             "errorsCorrectedWrite": 0,
             "errorsUncorrectedRead": 0,
             "errorsUncorrectedWrite": 0
      },   {
               . . .
      }
]

Attributes

volser (string)

The volume serial number (VOLSER) or bar code number of the cartridge.

internalAddress (string)

The unique identifier of the cartridge within the library represented by a 6-character hex string. If there are duplicate VOLSERs, this value is used to identify the cartridge. The value changes if the cartridge is assigned or unassigned from a logical library or if the cartridge is moved by the host or library. Query the value before you use.

motionMeters (number)

Meters the cartridge media has traveled over the tape drive head.

mounts (number)

Number of times this cartridge was mounted into a tape drive over the lifetime of the cartridge.

dataWrittenToCartridge (number)

Number of MB of data written to the cartridge over the lifetime of the cartridge.

errorsCorrectedRead (number)

Number of corrected read errors for this cartridge over its lifetime.

errorsCorrectedWrite (number)

Number of corrected write errors for this cartridge over its lifetime.

errorsUnorrectedRead (number)

Number of uncorrected read errors for this cartridge over its lifetime.

errorsUnorrectedWrite (number)

Number of uncorrected write errors for this cartridge over its lifetime.