Get node cards

Request syntax

Path parameters

ID (number)

The ID of the node card.

TS4500 example

> GET /v1/nodeCards
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1059

[
     {
          "ID": 17, 
          "type": "MDA", 
          "location": "accessor_Aa", 
          "state": "online", 
          "partNum": "38L7590", 
          "sn": "Y010MY83W62Y", 
          "barcode": "11S38L7590Y010MY83W62Y", 
          "ec": 0, 
          "firmware": "0066", 
          "cfBarcode": null, 
          "cfPartNum": null, 
          "cfVendor": null,
          "reportingLCC": null,
          "primaryLCC": null,
          "lastRestart": null
     }, {
          "ID": 49, 
          "type": "ACC", 
          "location": "accessor_Aa", 
          "state": "online", 
          "partNum": "38L7353", 
          "sn": "Y010MY773848", 
          "barcode": "11S38L7353Y010MY773848", 
          "ec": 0, 
          "firmware": "0066", 
          "cfBarcode": null, 
          "cfPartNum": null, 
          "cfVendor": null,
          "reportingLCC": null,
          "primaryLCC": null,
          "lastRestart": null
     }, {
          "ID": 65, 
          "type": "LCC", 
          "location": "frame_F1", 
          "state": "online", 
          "partNum": "38L6415", 
          "sn": "Y1Y01063W00J", 
          "barcode": "11S38L6415Y1Y01063W00J", 
          "ec": 0, 
          "firmware": "1.5.0.3-40B.A4", 
          "cfBarcode": "P1T0100387520308040", 
          "cfPartNum": "VTDCFAPC016G-1A1", 
          "cfVendor": "Virtium",
          "reportingLCC": "yes",
          "primaryLCC": "yes",
          "lastRestart": "2019-04-03T11:33:37-0700"
     }
]

Attributes

ID (number)

The ID of the node card.

type (string)

Type of the node card. For TS4500, values include: MDA (motor driver assembly), ACC (accessor control card), or LCC (library control card). For Diamondback, values include RCC(robot control card) and LCC (library control card).

location (string)

The location of the node card in the library.

state (string)

The health status of the node card. Values include:

State	Description
unknown	The state that is recorded by firmware for this resource is unknown. Reset the associated LCC node card and contact IBM for support if issue persists.
restarting	Node card library-controlled restart in progress due to firmware update or manual restart.
inServiceMode	The accessor that is associated with the node card is in service. To end this state, initiate completeAccessorService task on the accessor on which the node card is located.
unreachable	The node card is not answering network ping by the library through Ethernet or CAN.
noEthernet	The node card is not communicating with the reporting LCC card on the internal LCC-to-LCC Ethernet network. Try to reset the node card. If the issue persists, service needs to check cables.
noCAN	The node card is not communicating with the reporting LCC on CAN. Try to reset the node card. If the issue persists, service needs to check cables.
online	The node card is in a running state.

partNum (string)

The part number of the node card.

sn (string)

The globally unique serial number of the node card.

barcode (string)

The bar code found on the node card. This is a 22-character string with the following format:

ec (number)

The EC number of the node card.

firmware (string)

The current firmware level of the node card.

cfBarcode (string)

The serial number bar code of the compact flash card installed on the LCC. Returns null if this is not an LCC.

SMART compact flash card	Virtium compact flash card

cfPartNum (string)

The part number of the compact flash card installed on the LCC. If this is not an LCC, this value is null.

cfVendor (string)

The vendor name of the compact flash card installed on the LCC. If this is not an LCC card, this value is null. The two supported values are SMART and Virtium.

reportingLCC (string)

Whether this LCC is reporting the information for this GET command or not. This returns yes if this LCC is reporting the status, no if this LCC’s status is being reported by another LCC, or null if this is not an LCC card.

primaryLCC (string)

Whether this LCC is acting as the primary LCC or the secondary LCC. This returns yes if this LCC is the primary, no if this LCC is the secondary, or null if this is not an LCC card.

lastRestart (string)

Time and date of last power on or restart of the node card. This also includes if the node card had a momentary interruption in Ethernet communication with the LCC node card. This returns null for node cards other than the LCC.