|
The delete-storage-group operation destroys an association between a LUN, a host and a controller port.
 This operation is to be used cautiously as hosts members of the specified Storage Group may no longer be able to access the associated LUNs.
 No data is destroyed in the process.
Adapter Request Elements for 'delete-storage-group' Operation
|
|
|
|
operation-name
|
Specifies the name of the operation you want to perform.
| • | Valid value: delete-storage-group. |
|
Yes
|
arguments
|
Parent element for <argument> element.
|
Yes
|
argument
|
Specifies a list of arguments that is required for this operation
|
Yes
|
target
|
Specifies the connection information for an EMC SMI-S Provider.
| • | Valid value: The value specified for <target> element must be the same as the value that has been specified for the name attribute of <config> element in the adapter configuration. You can skip this element. In this case the request will be executed on the first defined adapter configuration. You can leave this element empty. In this case the request will be executed on the first defined adapter configuration. |
| • | Default value: The first defined adapter configuration. |
|
No
|
timeout-secs
|
Specifies the time in seconds after which the attempt to connect to the EMC SMI-S Provider times out. The "timeout-secs" specified in adapter request overrides the value specified in adapter configuration.
| • | Valid value: A numeric value which specifies the time in seconds. |
| • | Default Value: 180, if no "timeout-secs" is provided in adapter configuration. |
|
No
|
You can specify one or more of the following elements to retrieve specific information. If none of the elements is specified, then all the details are fetched.
|
storage-system-name
|
Specifies the user defined storage system name.
| • | Valid value: Please refer to the get-storage-system operation to list the valid values of this field. |
|
Yes
|
synchronous
|
Specifies whether to wait until the job completes. Any action performed by EMC SMI-S provider results in creating a job. If the 'synchronous' element is set to yes, the adapter will wait until the job completes. Otherwise the job will be queued.
|
No
|
job-completion-timeout-secs
|
Specifies the time in seconds after which the attempt to complete the job times out.
| • | Valid value: A numeric value which specifies the time in seconds. |
| • | Default value: 180 seconds |
|
No
|
storage-group-name or wwn or iqn
|
Specifies the name of the storage group that must be deleted or the host (wwn/iqn) that must be unassociated from the host group. if no other host is associated to this host group then the host group itself will be deleted.
|
Yes
|
delete-device-group
|
Specifies whether the associated device group must be deleted or not. This element is applicable only on Symmetrix arrays running Enginuity 5874 or above.
| • | Valid value: true or false. |
|
No
|
delete-initiator-group
|
Specifies whether the associated initiator group must be deleted or not. This element is applicable only on Symmetrix arrays running Enginuity 5874 or above.
| • | Valid value: true or false. |
|
No
|
delete-port-group
|
Specifies whether the associated port group must be deleted or not. This element is applicable only on Symmetrix arrays running Enginuity 5874 or above.
| • | Valid value: true or false. |
|
No
|
If the host (wwn/iqn) name is provided then the specified host will be deleted from all the host groups.
- If the host group name is provided then the specified host group will be deleted
- If both host (wwn/iqn) and host group name are provided then the specified host (wwn/iqn) will be considered.
Sample Adapter Request for 'delete-storage-group' Operation
Sample 1: Deleting a Storage Group (Clariion Arrays)
<emc-storage-request>
<operation-name>delete-storage-group</operation-name>
<arguments>
<argument>
<storage-system-name>CLARiiON+CKM00083900053</storage-system-name>
<storage-group-name>PC02 Group 4</storage-group-name>
</wwn>
</argument>
</arguments>
</emc-storage-request>
</request-data>
Sample 2: Deleting a Storage Group (Symmetrix Arrays)
<emc-storage-request>
<operation-name>delete-storage-group</operation-name>
<arguments>
<argument>
<storage-system-name>SYMMETRIX+000294901120</storage-system-name>
<storage-group-name>SG_Test</storage-group-name>
<device-group-name>false</device-group-name>
<initiator-group-name>false</initiator-group-name>
<port-group-name>false</port-group-name>
</argument>
</arguments>
</emc-storage-request>
Adapter Response Elements for 'delete-storage-group' Operation
|
|
|
storage-system-name
|
Name of the storage system.
|
storage-group-name
|
Name of the deleted storage group.
|
wwn
|
WWN that belongs to the storage group.
|
delete-storage-group-status
|
Status of the operation.
|
Sample Adapter Response for 'delete-storage-group' Operation
Sample 1: Deleting a Storage Group (Clariion Arrays)
<emc-storage-response>
<metadata>
<status>success</status>
<response-count>1</response-count>
</metadata>
<responses>
<response>
<metadata>
<status>success</status>
<execution-milliseconds>40406</execution-milliseconds>
<line-count>7</line-count>
<target>pythagoras-p27p</target>
<config-name>pythagoras-p27p</config-name>
</metadata>
<output>
<storage-groups>
<storage-group>
<storage-system-name>CLARiiON+CKM00083900053</storage-system-name>
<storage-group-name>PC02 Group 4</storage-group-name>
<wwns>
<wwn>10000000C96EB8DB</wwn>
<wwn>2100001B3297C902</wwn>
<wwn>10000000C96EB8DA</wwn>
</wwns>
<delete-storage-group-status>0 (Success)</delete-storage-group-status>
</storage-group>
</storage-groups>
</output>
</response>
</responses>
</emc-storage-response>
Sample 2: Deleting a Storage Group (Symmetrix Arrays)
<emc-storage-response>
<metadata>
<status>success</status>
<response-count>1</response-count>
</metadata>
<responses>
<response>
<metadata>
<status>success</status>
<execution-milliseconds>17316</execution-milliseconds>
<line-count>13</line-count>
<target>pc-emc</target>
<config-name>default</config-name>
</metadata>
<output>
<storage-groups>
<storage-group>
<storage-system-name>SYMMETRIX+000294901120</storage-system-name>
<storage-group-name>SG_Test</storage-group-name>
<lun-name>0030A</lun-name>
<wwns>
<wwn>21000024FF04B66C</wwn>
<wwn>2000001B321E5A95</wwn>
<wwn>2000001B321E1B98</wwn>
</wwns>
<device-group-name>DG_Test</device-group-name>
<initiator-group-name>IG_Test</initiator-group-name>
<port-group-name>PG_Test</port-group-name>
<job-id>4134665121</job-id>
<delete-storage-group-status>Completed</delete-storage-group-status>
<job-status-description>Completed - Delete Masking View</job-status-description>
</storage-group>
</storage-groups>
</output>
</response>
</responses>
| 
