Deleting a host group or the iSCSI target

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 deletes the WWN and LUN settings of a host group or of a host registered in a host group. Alternatively, the request deletes the LUN setting and iSCSI name of an iSCSI target or of a host (iSCSI initiator) registered for the iSCSI target. If the host group number of the host group to be deleted (target ID for the iSCSI port) is 0, the settings for the host group or iSCSI target are returned to their default values.

Execution permission

Storage Administrator (Provisioning)

Request line

DELETE base-URL/v1/objects/host-groups/object-ID

Request message

Object ID

Specify the hostGroupId value obtained by getting information about the host group or the iSCSI target. You can also specify the following attributes and connect them with commas:

portId,hostGroupNumber

Attribute

Type

Description

portId

string

(Required) Port number

hostGroupNumber

int

(Required) Host group number (target ID for an iSCSI port)

Query parameters
None.
Body
None.

Response message

Body

A job object is returned. For details on attributes other than affectedResources, see the section explaining job objects.

Attribute

Description

affectedResources

URL of the deleted host group or iSCSI target

Status codes

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

Coding example

curl -v -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization:Session d7b673af189048468c5af9bcf3bbbb6f" -X DELETE https://192.0.2.100/ConfigurationManager/v1/objects/host-groups/CL1-A,0