指定Hostに関するHost Connection情報の取得

概要説明

host_idで指定したHostに関するConnectionを取得します。

volume_idの昇順で応答します。

リクエスト例

Host ID 2 のHostについて、設定されているConnectionを取得する場合の例です。

$ curl -i -H "Authorization: Bearer g17e4umvwYoHuhkG7yCSee.." -X GET "https://192.168.1.1:5665/api/v1/connection/host/2"

レスポンス例

{
  "total_count": 512,
  "list_count": 1,
  "connection_list": [
    {
      "connection_href": "/api/v1/connection/host/1/volume/100001",
      "host_href": "/api/v1/host/1",
      "hostresponse_name": "Default",
      "volume_href": "/api/v1/volume/100001",
      "hlun": 0,
      "lungroup_number": 0,
      "is_unexpected_connection": false,
      "caport_href_list": [
        "/api/v1/caport/0000",
        "/api/v1/caport/0100"
      ],
      "shared_host_href_list": [
        "/api/v1/host/2",
        "/api/v1/host/3"
      ]
    }
  ]
}

Parameters

PATH PARAMETERS

host_id

(required)

integer

Host ID。

QUERY PARAMETERS

fields	Array of strings 表示したいParameter。指定したParameter名(Response Body Parameter)の情報のみを抜き出して取得します。指定方法の詳細は、表示する項目の絞り込みを参照してください。
volume_id	Array of integers Volume ID。情報を取得したいVolumeのIDを指定します。入力条件： 256個まで指定可能です。
hlun	Array of integers Hostから見えるVolumeの番号。情報を取得したいhlunを指定します。入力条件： 256個まで指定可能です。
max_records	integer 情報を取得したいリソースの最大数。応答する情報数を制限したい場合に指定してください。入力条件指定可能な範囲は1～512です。
last_get_id	integer 続きの情報を取得するためのリソースの識別子。一度に応答条件に合致するすべてのリソースを応答できなかった場合、next_hrefが返却されます。 last_get_idはnext_hrefに付与される、続きの情報を取得するための情報です。

Responses

正常に取得できた場合、HTTPステータスコードが200 (OK)となりレスポンスボディを応答します。

RESPONSE BODY

total_count

integer

装置に存在するResourceの総数。

フィルタリングしている場合は、条件に合致するResourceの総数です。

list_count

integer

応答するListの個数。

connection_list

Array of objects

connection_href	string Connection ResourceへのLink。必ず応答します。
host_href	string Host ResourceへのLink。
host_name	string Host Name。
hostresponse_name	string Host Response Name。
volume_href	string Volume ResourceへのLink。
volume_name	string 指定HostがConnectされているVolume Name。
hlun	integer Hostから見えるVolumeの番号。
lungroup_number	integer Lun Group Number。
is_unexpected_connection	boolean このConnectionのHostが複数LUN Groupに接続されている場合にtrueになります。 trueの場合、同じVolumeが複数のCA Portごとに異なったHost Affinityで設定されてる場合があります。そのため、応答したcaport_href_listのCA Portから異なるhlunで同じVolumeを参照できる可能性があります。
caport_href_list	Array of strings CA Port ResourceへのLink。
shared_host_href_list	Array of strings 該当Volumeが所属するLUN Groupを共有するHostへのLink。
shared_host_name_list	Array of strings 該当Volumeが所属するLUN Groupを共有するHostの名前。 LUN Groupを共有するHostが存在しない場合、またはテナントユーザーの場合は応答しません。

next_href

string

続きの情報を取得するためのLink。

一度にすべての情報を応答しきることができなかった場合に限り応答します。

例えば、max_recordsで指定した個数以上に応答条件に合致するResourceが存在する場合などに応答します。