14.4.1 サーバの情報を取得する
Storage Advisor Embeddedで管理しているサーバに関する情報を取得します。条件を指定して、絞り込んだ情報を取得したりできます。
実行権限
ストレージ管理者(参照)
リクエストライン
GET <ベースURL>/simple/v1/objects/servers
リクエストメッセージ
- オブジェクトID
- なし。
- クエリパラメータ
-
パラメータ
型
フィルタ条件
nickname
string
(任意)サーバのニックネーム
指定した値と完全に一致するサーバの情報が取得されます。
hbaWwn
string
(任意)HBAのWWN
指定した値と完全に一致するサーバの情報が取得されます。
iscsiName
string
(任意)iSCSIネーム
指定した値と完全に一致するサーバの情報が取得されます。
- ボディ
- なし。
レスポンスメッセージ
- ボディ
-
サーバに関する情報を取得した出力例を次に示します。
{ "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」のサーバ(クエリパラメータnicknameにhostCを指定)に関する情報を取得した出力例を次に示します。
この例では属性isReservedにtrueが出力されているので、ホストグループを追加するサーバであることを示しています。
{ "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 } ], "count": 1 }
属性
型
説明
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