Hitachi

Hitachi Storage Advisor Embedded ガイド 


14.4.2 特定のサーバの情報を取得する

サーバIDを指定して、特定のサーバの情報を取得します。

実行権限

ストレージ管理者(参照)

リクエストライン

GET <ベースURL>/simple/v1/objects/servers/<オブジェクトID

リクエストメッセージ

オブジェクトID

サーバの情報取得で取得したidの値を指定します。

属性

説明

id

int

(必須)サーバID

クエリパラメータ
なし。
ボディ
なし。

レスポンスメッセージ

ボディ

FC接続のサーバ(サーバID:10)の情報を取得した出力例を次に示します。

{
  "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
}

iSCSI接続のサーバ(サーバID:11)の情報を取得した出力例を次に示します。

{
  "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
}

取得する属性については、サーバの情報を取得する場合の属性に加えて、次に示す属性が取得されます。

属性

説明

osTypeOptions

int[]

OSタイプのオプション

numberOfVolumes

int

割り当てられているボリュームの数

paths

object[]

HBAのWWNに定義されているパスの情報

  • hbaWwn(string)

    HBAのWWN

    プロトコルがFCの場合に出力されます。

  • iscsiName(string)

    iSCSIネーム

    プロトコルがiSCSIの場合に出力されます。

  • portIds(string[])

    割り当て先のポートID

hasNonFullmeshLuPaths

boolean

指定したサーバ内において登録されているすべてのポートと、サーバに接続されているすべてのボリューム間で、パスが定義されていないボリュームがあるかどうかが出力されます。

  • true:パスが定義されていないボリュームが1つでもある
  • false:すべてのボリュームにパスが定義されている

hasUnalignedOsTypeOptions

boolean

OSタイプのオプションが定義されているサーバに、この値と異なるホストモードオプションが定義されているホストグループ(またはiSCSIターゲット)を登録した場合に、サーバ側の情報が混在しているかどうかが出力されます。

  • true:混在している
  • false:混在していない

ステータスコード

この操作のリクエストに対するステータスコードについては、HTTPステータスコードの説明を参照してください。

コード例

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