Getting information about a specific server

Execution permission

Storage Administrator (View Only)

Request line

GET base-URL/simple/v1/objects/servers/object-ID

Request message

Object ID

Specify the id value obtained by getting information about the server.

Attribute	Type	Description
id	int	(Required) Server ID

Query parameters

None.

Body

None.

Response message

Body

The following is an example of the output when getting information about a server (ID 10) that is connected by using Fibre Channel:

{
  "id": 10,
  "nickname": "hostA",
  "protocol": "FC",
  "osType": "Linux",
  "osTypeOptions":[2,22,25,68],
  "totalCapacity": 1024,
  "usedCapacity": 42,
  "numberOfVolumes": 2,
  "numberOfPaths": 2,
  "paths": [
    {
      "hbaWwn": "000000102cceccc9",
      "portIds": [
        "CL1-A"
      ]
    },
    {
      "hbaWwn": "1111111111111111",
      "portIds": [
        "CL1-A"
        ]
    }
  ],
  "isInconsistent": false,
  "modificationInProgress": false,
  "compatibility": "DKCMAIN_8802010000",
  "isReserved": false,
  "hasNonFullmeshLuPaths": false,
  "hasUnalignedOsTypes": false,
  "hasUnalignedOsTypeOptions": false
}

The following is an example of the output when getting information about a server (server ID: 11) that is connected by using iSCSI:

{
  "id": 11,
  "nickname": "hostB",
  "protocol": "iSCSI",
  "osType": "Linux",
  "osTypeOptions": [2,22,25,68],
  "totalCapacity": 1024,
  "usedCapacity": 42,
  "numberOfPaths": 2,
  "paths": [
    {
      "iscsiName": "iqn.1994-05.com.redhat:496799ba93",
      "portIds": [
        "CL1-B"
      ]
    },
    {
      "iscsiName": "iqn.1994-05.com.redhat:a7526e46aa",
      "portIds": [
        "CL1-B"
        ]
    }
  ],
  "isInconsistent": false,
  "modificationInProgress": false,
  "compatibility": "DKCMAIN_8802010000",
  "isReserved": false,
  "hasNonFullmeshLuPaths": false,
  "hasUnalignedOsTypes": false,
  "hasUnalignedOsTypeOptions": false
}

This operation obtains the values of attributes obtained as part of server information, as well as the values of the following attributes.

Attribute	Type	Description
osTypeOptions	int[]	Option for the OS type
numberOfVolumes	int	Number of attached volumes
paths	object[]	Path information defined in the WWN of the HBA: hbaWwn (string) WWN of the HBA Appears when the protocol is FC. iscsiName (string) iSCSI name Appears when the protocol is iSCSI. portIds (string[]) Port IDs of assigned ports
hasNonFullmeshLuPaths	boolean	The following information appears: whether there are any volumes for which paths are not defined between all ports registered on the specified server and all volumes connected to the server: true: There is at least one volume for which paths are not defined with all ports registered on the specified server. false: All volume paths are defined with all ports registered on the specified server.
hasUnalignedOsTypeOptions	boolean	The following information appears: whether inconsistencies exist in the information on the server if a host group (or an iSCSI target) is added to a server for which the OS type option is defined, and if the value of the host mode option defined for the host group differs from the value of the server's OS type option. true: Inconsistencies exist false: Inconsistencies do not exist For details, see the Provisioning Guide for your storage system. The OS type option corresponds to the host mode option in Command Control Interface and in Device Manager - Storage Navigator.

Status codes

See HTTP status codes.

Coding example

curl -v -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization:Session b74777a3f9f04ea8bd8f09847fac48d3" -X GET https://192.0.2.100/ConfigurationManager/simple/v1/objects/servers/10