14.4.12　サーバのパス情報の一覧を取得する

実行権限

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

リクエストライン

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