Obtaining Connection Information About the Specified Volume

GET /connection/volume/{volume_id}

Introduction

Obtains the Connection for the Host specified by host_id.

Request Examples

  • This is an example of obtaining only the Volume ID and Host List for the Connection information that is set to Volume with Volume ID 100000.

    $ curl -i -H "Authorization: Bearer g17e4umvwYoHuhkG7yCSee.." -X GET "https://192.168.1.1:5665/api/v1/connection/volume/100000?fields=host_href_list"

Response Examples

{
  "volume_id": 100001,
  "volume_href": "/api/v1/volume/100001",
  "host_href_list": [
    "/api/v1/host/1",
    "/api/v1/host/2",
    "/api/v1/host/3"
  ],
  "connection_href_list": [
    "/api/v1/connection/host/1/volume/100001",
    "/api/v1/connection/host/3/volume/100001"
  ]
}

Parameters

PATH PARAMETERS

volume_id

(required)

integer

Volume ID.

QUERY PARAMETERS

fields

Array of strings

Parameter to display.

Only the information of the specified Parameter name (Response Body Parameter) is extracted and retrieved.

For details about the specification methods, see Property Filter.

Responses

If successful, the HTTP status code is 200 (OK) and the response body is returned.

RESPONSE BODY

volume_id

integer

Volume ID.
volume_href

string

Resource link of the volume.
volume_name

string

A Volume Friendly Name.
host_href_list

Array of strings

Link to Host Resource.
connection_href_list

Array of strings

Resource link of the connection.

Host Connections that reference the same LUN Group are unified.

To delete all the Connections to the specified Volume, specify the force=true parameter to this Link and execute DELETE.