Host Connection情報の取得

GET /connection/host/{host_id}/volume/{volume_id}

概要説明

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

リクエスト例

  • Host ID 2 のHostについて、Volume ID 100000のConnection情報を取得する場合の例です。

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

レスポンス例

{
  "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。
volume_id

(required)

integer

Volume ID。

QUERY PARAMETERS

fields

Array of strings

表示したいParameter。

指定したParameter名(Response Body Parameter)の情報のみを抜き出して取得します。

指定方法の詳細は、表示する項目の絞り込みを参照してください。

Responses

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

RESPONSE BODY

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が存在しない場合、またはテナントユーザーの場合は応答しません。