14.4.13　サーバと特定のポート間のパス情報を取得する

実行権限

ストレージ管理者（参照）

リクエストライン

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

クエリパラメータ

なし。

ボディ

なし。

レスポンスメッセージ

ボディ

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