14.4.12 サーバのパス情報の一覧を取得する
サーバIDを指定して、特定のサーバのパス情報を取得します。条件を指定して、絞り込んだ情報を取得したりできます。
実行権限
ストレージ管理者(参照)
リクエストライン
GET <ベースURL>/simple/v1/objects/servers/<オブジェクトID>/paths
リクエストメッセージ
- オブジェクトID
-
サーバの情報取得で取得したidの値を指定します。
属性
型
説明
id
int
(必須)サーバID
- クエリパラメータ
-
パラメータ
型
フィルタ条件
hbaWwn
string
(任意)HBAのWWN
指定した値と完全に一致するサーバのパス情報が取得されます。
iscsiName
string
(任意)iSCSIネーム
指定した値と完全に一致するサーバのパス情報が取得されます。
portId
string
(任意)割り当て先のポートID
指定した値と完全に一致するサーバのパス情報が取得されます。
- ボディ
- なし。
レスポンスメッセージ
- ボディ
-
FC接続のサーバ(サーバID:10)のパス情報を取得した出力例を次に示します。
{ "data": [ { "id": "000000102cceccc9,CL1-A", "serverId": 10, "hbaWwn": "000000102cceccc9", "portId": "CL1-A" }, { "id": "1111111111111111,CL1-A", "serverId": 10, "hbaWwn": "1111111111111111", "portId": "CL1-A" } ], "count": 2 }
iSCSI接続のサーバ(サーバID:11)のパス情報を取得した出力例を次に示します。
{ "data": [ { "id": "iqn.1994-05.com.redhat:496799ba93,CL1-B", "serverId": 11, "iscsiName": "iqn.1994-05.com.redhat:496799ba93", "portIds": "CL1-B" }, { "id": "iqn.1994-05.com.redhat:a7526e46aa,CL1-B", "serverId": 11, "iscsiName": "iqn.1994-05.com.redhat:a7526e46aa", "portIds": "CL1-B" } ], "count": 2 }
属性
型
説明
id
string
HBAのWWN(またはiSCSIネーム)および割り当て先のポートIDがコンマで連結した形式で出力されます。
serverId
int
サーバID
hbaWwn
string
HBAのWWN
iscsiName
string
iSCSIネーム
portId
string
割り当て先のポートID
ステータスコード
この操作のリクエストに対するステータスコードについては、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/paths