Get SAS ports

Retrieves information about the SAS ports in the library. Querying ports for a specific drive is accomplished by using filters. The supported filters include driveLocation and driveSn.

Request syntax

GET /v1/sasPorts
Retrieves information about all SAS ports in the tape library.

GET /v1/sasPorts/{location}
Retrieves information about the SAS ports in the specified location.

Path parameters

location (string): The unique location of SAS port in the library.

Query parameters

driveLocation (string, optional): The drive location of the ports to be returned.

driveSn (string, optional): The drive serial number of the ports to be returned.

Example

> GET /v1/sasPorts
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 45992

[
     {
          "location": "sasPort_F1C4R2P1", 
          "driveLocation": "drive_F1C4R2", 
          "driveSn": "YD1068012621",  
          "portNumber": 0, 
          "state": "communicationEstablished", 
          "address": "500507604440001E", 
          "hashedAddress": 31,  
          "speedActual": "12Gbps"
     }, {
          ...
     }
]

Attributes

location (string)

The unique location of SAS port in the library.

driveLocation (string)

The unique location of the drive the port is installed on in the library.

driveSn (string)

The globally unique serial number of the drive the port is installed on.

portNumber (number)

The port number on the drive this port represents.

state (string)

The health status of the SAS port. Values include:

State	Description/user action
`unknown`	Drive or LCC Node Card that is associated with this port might be unreachable or 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.
`noDeviceDetected`	No connected device detected.
`communicationEstablished`	Communication established with device.

address (string)

The unique identifier for the port.

hashedAddress (number)

A short ("hashed") version of the port address.

speedActual (string)

The actual speed of data transmission over the port. The speed is auto negotiated to the highest available speed and cannot be changed. Values include 3Gbps, 6Gbps, and 12Gbps.