14.5.7　ボリュームとサーバの接続情報を取得する : Hitachi Storage Advisor Embedded ガイド

実行権限

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

リクエストライン

GET ＜ベースURL＞/simple/v1/objects/volume-server-connections

リクエストメッセージ

オブジェクトID: なし。

クエリパラメータ

1回のリクエストで取得できるボリュームとサーバの接続情報は最大で2048個です。2049個以上のボリュームとサーバの接続情報を取得する場合は、countパラメータとstartVolumeIdパラメータを組み合わせて複数回に分けてAPIを実行してください。countパラメータを指定することで取得するボリュームとサーバの接続情報をフィルタリングすることもできます。

パラメータ	型	フィルタ条件
serverId	int	（任意）ボリュームと接続されているサーバのサーバIDを指定します。指定したサーバIDの接続情報を取得します。 `serverId`または`serverNickname`のどちらか一方を必ず指定してください。また、これらのパラメータを同時には指定しないでください。
serverNickname	string	（任意）ボリュームと接続されているサーバのニックネームを指定します。指定したサーバのニックネームの接続情報を取得します。 `serverId`または`serverNickname`のどちらか一方を必ず指定してください。また、これらのパラメータを同時には指定しないでください。
startVolumeId	int	（任意）ボリュームとサーバの接続情報の取得を開始するボリュームIDを`0`～`65279`の値で指定します。
count	int	（任意）ボリュームとサーバの接続情報を取得する個数を`1`～`2048`の値で指定します。省略した場合、`2048`が指定されたと見なされます。

ボディ: なし。

レスポンスメッセージ

ボディ

サーバIDが10（クエリパラメータserverIdに10を指定）のサーバのボリュームとサーバの接続情報を取得した出力例を次に示します。

{
  "data": [
    {
      "id": "100,10",
      "volumeId": 100,
      "serverId": 10,
      "luns": [
        {
          "lun": 1,
          "portId": "CL1-A"
        }
      ]
    },
    {
      "id": "101,10",
      "volumeId": 101,
      "serverId": 10,
      "luns": [
        {
          "lun": 2,
          "portId": "CL1-A"
        }
      ]
    }
  ],
  "count": 2,
  "totalCount": 2,
  "hasNext": false
}

属性	型	説明
id	string	ボリュームIDとサーバIDがコンマで連結した形式で出力されます。
volumeId	int	ボリュームID
serverId	int	サーバID
luns	object[]	LUNの設定情報 `lun`（int） LU番号 `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/volume-server-connections?serverId=10

14.5.7 ボリュームとサーバの接続情報を取得する

14.5.7　ボリュームとサーバの接続情報を取得する