Deleting a Host Connection

Introduction

Deletes the Connections for the Host specified by host_id and volume_id.

Caution

If the specified Host has more than one LUN Group set with Affinity, the RESTful API will respond with an error due to an unsupported configuration.
If the Connection setting is changed for a Host where shared_host_href_list is returned as the Host information, the Connection settings for the other hosts are also changed. If you still want to set the Connection, you must set the force parameter to true.
You cannot delete a Connection with the Host described below. If you want to delete it, use ETERNUS SF Storage Cruiser.
- Host with Storage Cluster settings
- Host with VVOL Access Path settings
Use DELETE /connection/host/{host_id} to delete all Connections for the specified Host.
For tenant users, only a Host and Volume that belong to the tenant of the current user can be specified.

This is an example of forcibly deleting a Connection to Volume ID 100000 from the Host with Host ID 2.

$ curl -i -H "Authorization: Bearer g17e4umvwYoHuhkG7yCSee.." -X DELETE "https://192.168.1.1:5665/api/v1/connection/host/2/volume/100000?force=true"

{
  "job_id": 8192001,
  "job_href": "/api/v1/job/8192001"
}

host_id

(required)

integer

Host ID.

volume_id

(required)

integer

Volume ID.

force

boolean

Whether the operation is forced.

Input criteria:

If a Connection setting is deleted from a Host where shared_host_href_list is returned as the Host information, the specified Volume will not be accessible from other Hosts in the list.

In this case, to add the Connection, the force parameter must be set to true. If not specified or false, an error is returned.

If successful, the HTTP status code is 202 (Accepted) and the response body is returned.

job_id

integer

Job ID.

job_href

string

Resource link of the job.