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:混在していない
詳細は、マニュアルシステム構築ガイドを参照してください。OSタイプのオプションは、RAID ManagerおよびDevice Manager - Storage Navigatorではホストモードオプションに対応します。
- hbaWwn(string)
ステータスコード
この操作のリクエストに対するステータスコードについては、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