14.4.13 サーバと特定のポート間のパス情報を取得する
サーバID、HBAのWWN(またはiSCSIネーム)、およびポートIDを指定して、サーバと特定のポート間のパス情報を取得します。
実行権限
ストレージ管理者(参照)
リクエストライン
GET <ベースURL>/simple/v1/objects/servers/<オブジェクトID>/paths/<オブジェクトID>
リクエストメッセージ
- オブジェクトID
-
複数のオブジェクトIDを組み合わせて指定します。
サーバのパスの情報取得で取得したserverIdの値およびidの値を、次の形式で指定します。
<serverId>/paths/<id>
<id>の値には、hbaWwn(またはiscsiName)の値およびportIdの値を連結した形式でも指定できます。
- HBAのWWNを指定する場合
<serverId>/paths/<hbaWwn>,<portId>
属性
型
説明
serverId
int
(必須)サーバID
hbaWwn
string
(必須)HBAのWWN
portId
string
(必須)ポートID
- iSCSIネームを指定する場合
<serverId>/paths/<iscsiName>,<portId>
属性
型
説明
serverId
int
(必須)サーバID
iscsiName
string
(必須)iSCSIネーム
portId
string
(必須)ポートID
- HBAのWWNを指定する場合
- クエリパラメータ
- なし。
- ボディ
- なし。
レスポンスメッセージ
- ボディ
-
FC接続のサーバ(サーバID:10、HBAのWWN:000000102cceccc9)とポート間(ポートID:CL1-A)のパス情報を取得した出力例を次に示します。
{ "id": "000000102cceccc9,CL1-A", "serverId": 10, "hbaWwn": "000000102cceccc9", "portId": "CL1-A" }
iSCSI接続のサーバ(サーバID:11、iSCSIネーム:iqn.1994-05.com.redhat:496799ba93)とポート間(ポートID:CL1-B)のパス情報を取得した出力例を次に示します。
{ "id": "iqn.1994-05.com.redhat:496799ba93,CL1-B", "serverId": 11, "iscsiName": "iqn.1994-05.com.redhat:496799ba93", "portId": "CL1-B" }
取得する属性については、サーバのパス情報を取得するAPIの説明を参照してください。
ステータスコード
この操作のリクエストに対するステータスコードについては、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/000000102cceccc9,CL1-A