Releasing the host reservation status by specifying a host group

REST API Reference Guide for Virtual Storage Platform 5000, Virtual Storage Platform E Series, and Virtual Storage Platform G/F Series

Version
93-07-0x
90-09-0x
88-08-10
Audience
anonymous
Part Number
MK-98RD9014-17
The following request releases the host reservation status for all LUs mapped to the specified host group or iSCSI target. Use this API in situations such as when the host reservation status on LUs could not be released because of some reason, such as a failure.

Execution permission

Storage Administrator (System Resource Management)

Request line

POST base-URL/v1/objects/host-groups/object-ID/actions/release-lu-host-reserves/invoke

Request message

Object ID

Specify the hostGroupId value obtained by the processing to obtain information about host groups or about iSCSI targets. You can also specify a combination of attribute values in the following format:

portId,hostGroupNumber

Attribute

Type

Description

portId

string

(Required) Port number

hostGroupNumber

int

(Required) Host group number for the port (For an iSCSI target, this is the target ID.)

Query parameters
None.
Body

None.

Response message

Body

A job object is returned. See the description for the job object. affectedResources is not displayed for this API. To check whether the host reservation status has been released, use the following URL. For port-number and host-group-number, specify the port number and the host group number (or the target ID) specified for the object ID.

GET base-URL/v1/objects/luns?portId=port-number&hostGroupNumber=host-group-number

Action template

None.

Status codes

For details on the status codes of the request for this operation, see the section explaining HTTP status codes.

Coding example

curl -v -H "Content-type:application/json" -H "Accept:application/json" -H "Authorization:Session d7b673af189048468c5af9bcf3bbbb6f" -X POST https://192.0.2.100/ConfigurationManager/v1/objects/host-groups/CL1-A,1/actions/release-lu-host-reserves/invoke -d ""