Hitachi

Hitachi Storage Advisor Embedded ガイド 


14.4.1 サーバの情報を取得する

Storage Advisor Embeddedで管理しているサーバに関する情報を取得します。条件を指定して、絞り込んだ情報を取得したりできます。

実行権限

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

リクエストライン

GET <ベースURL>/simple/v1/objects/servers

リクエストメッセージ

オブジェクトID
なし。
クエリパラメータ

パラメータ

フィルタ条件

nickname

string

(任意)サーバのニックネーム

指定した値と完全に一致するサーバの情報が取得されます。

hbaWwn

string

(任意)HBAのWWN

指定した値と完全に一致するサーバの情報が取得されます。

iscsiName

string

(任意)iSCSIネーム

指定した値と完全に一致するサーバの情報が取得されます。

ボディ
なし。

レスポンスメッセージ

ボディ

サーバのニックネームが「hostA」および「hostB」のサーバ(クエリパラメータnicknamehostAおよびhostBを指定)に関する情報を取得した出力例を次に示します。

{
  "data": [
    {
      "id": 10,
      "nickname": "hostA",
      "protocol": "FC",
      "osType": "Linux",
      "totalCapacity": 1024,
      "usedCapacity": 42,
      "numberOfPaths": 2,
      "isInconsistent": false,
      "modificationInProgress": false,
      "compatibility": "DKCMAIN_8802010000",
      "isReserved": false,
      "hasUnalignedOsTypes": false
    },
    {
      "id": 11,
      "nickname": "hostB",
      "protocol": "iSCSI",
      "osType": "Linux",
      "totalCapacity": 1024,
      "usedCapacity": 42,
      "numberOfPaths": 2,
      "isInconsistent": false,
      "modificationInProgress": false,
      "compatibility": "DKCMAIN_8802010000",
      "isReserved": false,
      "hasUnalignedOsTypes": false
    }
  ],
  "count": 2
}

サーバのニックネームが「hostC」および「hostD」のホストグループを追加するサーバ(クエリパラメータnicknamehostCおよびhostDを指定)に関する情報を取得した出力例を次に示します。

{
  "data": [
    {
      "id": 8,
      "nickname": "hostC",
      "protocol": "Undefined",
      "osType": "Undefined",
      "totalCapacity": 0,
      "usedCapacity": 0,
      "numberOfPaths": 0,
      "isInconsistent": false,
      "modificationInProgress": false,
      "compatibility": "DKCMAIN_8802010000",
      "isReserved": true,
      "hasUnalignedOsTypes": false
    },
    {
      "id": 9,
      "nickname": "hostD",
      "protocol": "Undefined",
      "osType": "Undefined",
      "totalCapacity": 0,
      "usedCapacity": 0,
      "numberOfPaths": 0,
      "isInconsistent": false,
      "modificationInProgress": false,
      "compatibility": "DKCMAIN_8802010000",
      "isReserved": true,
      "hasUnalignedOsTypes": false
    }
  ],
  "count": 2
}

属性

説明

id

int

サーバID

nickname

string

サーバのニックネーム

protocol

string

プロトコル

次に示す値が出力されます。

  • FC
  • iSCSI
  • Undefined

    ホストグループを追加するサーバの場合に出力されます。

osType

string

OSタイプ

次に示す値が出力されます。

  • Linux
  • DeprecatedVMware
  • HP-UX
  • OpenVMS
  • Tru64
  • Solaris
  • NetWare
  • DeprecatedWindows
  • AIX
  • VMware
  • Windows
  • Undefined

    ホストグループを追加するサーバの場合に出力されます。

  • Unknown

totalCapacity

long

割り当てられているボリュームの総容量(MiB)

usedCapacity

long

割り当てられているボリュームの使用済み容量(MiB)

numberOfPaths

int

サーバに登録されているHBAの数

isInconsistent

boolean

サーバの構成情報が矛盾しているかどうかが出力されます。

  • true:矛盾している
  • false:矛盾していない

modificationInProgress

boolean

現在、使用しない属性です。

compatibility

string

現在、使用しない属性です。

isReserved

boolean

ホストグループを追加するサーバかどうかが出力されます。

  • true:ホストグループを追加するサーバである
  • false:ホストグループを追加するサーバでない

hasUnalignedOsTypes

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