|
The operation delete-masking-group is a generic process that can be used to delete the following groups:
which compose the "Auto-provisioning Groups" on Symmetrix arrays. Auto-provisioning Groups simplify the deletion of the Storage Group (Masking View).
 This operation is applicable only on Symmetrix arrays running Enginuity 5874 or above.
Adapter Request Elements for 'delete-masking-group' Operation
|
|
|
|
operation-name
|
Specifies the name of the operation you want to perform.
| • | Valid value: delete-masking-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.
|
username
|
Specifies the login name used to connect to EMC SMI-S Provider. The 'username' specified in adapter request overrides the value specified in adapter configuration.
|
No
|
password
|
Specifies the password used to connect to EMC SMI-S Provider. The 'password' specified in adapter request overrides the value specified in adapter configuration.
|
No
|
protocol
|
Specifies the protocol used to connect to EMC SMI-S Provider. The 'protocol' specified in adapter request overrides the value specified in adapter configuration.
| • | Valid value: HTTPS or HTTP |
|
No
|
port
|
Specifies the port number used to connect to EMC SMI-S Provider. The 'port' specified in adapter request overrides the value specified in adapter configuration.
| ▪ | Valid value: A valid numeric value. |
|
No
|
timeout-secs
|
Specifies the time in seconds after which the attempt to connect to 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
|
storage-system-name
|
Specifies the storage system name from which the information has to be collected.
| • | Valid value: Any valid string. |
|
Yes
|
device-group-name
or
initiator-group-name
or
port-group-name
|
Specify any one of the three group names that has to be deleted or modified.
| • | Valid value: Any valid string. |
|
Yes
|
fast-policy-name
|
If the device-group-name is specified then provide the name of the FAST Policy that must be unassociated from the specified device-group-name.
| • | Valid value: Any valid string. |
|
No
|
lun-name
|
If the device-group-name is specified then provide the name of the lun(s) that must be unassociated from the host(s)(wwn).
| • | Valid value: Any valid string. |
|
No
|
initiator-group-to-cascade
|
If the initiator-group-name is specified then provide the name of the existing initiator group(s) that has to be removed from the specified initiator-group-name.
| • | Valid value: Any valid string. |
|
No
|
wwn
|
If the initiator-group-name is specified then provide the name of the host(s) from which the lun(s) must be unassociated.
| • | Valid value: Any valid string. |
|
No
|
iqn
|
If the initiator-group-name is specified then provide the name of the iSCSI host(s) from which the LUN(s) must be unassociated.
| • | Valid value: Any valid string. |
|
No
|
port-name
|
If the port-group-name is specified then provide the name of the FC/Ethernet port(s) that has to be unassociated.
| • | Valid value: Any valid string. |
|
No
|
Sample Adapter Request for 'delete-masking-group' Operation
Sample 1 - Deleting a Device Group
<emc-storage-request>
<operation-name>create-masking-group</operation-name>
<arguments>
<argument>
<storage-system-name>SYMMETRIX+000294901120</storage-system-name>
<device-group-name>DG_Pc10</device-group-name>
</argument>
</arguments>
</emc-storage-request>
Sample 2 - Deleting an Initiator Group
<emc-storage-request>
<operation-name>delete-masking-group</operation-name>
<arguments>
<argument>
<storage-system-name>SYMMETRIX+000294901120</storage-system-name>
<initiator-group-name>IG_Pc10</initiator-group-name>
</argument>
</arguments>
</emc-storage-request>
Sample -3 Deleting a Port Group
<emc-storage-request>
<operation-name>delete-masking-group</operation-name>
<arguments>
<argument>
<storage-system-name>SYMMETRIX+000294901120</storage-system-name>
<port-group-name>PG_Pc10</port-group-name>
</argument>
</arguments>
</emc-storage-request>
Adapter Response Elements for 'delete-masking-group' Operation
|
|
|
storage-system-name
|
Name of the storage system.
|
device-group-name
|
Name of the device group.
|
lun-name
|
Name of the LUN unassociated from device group.
|
fast-policy-name
|
Name of the FAST policy unassociated from the device group.
|
initiator-group-name
|
Name of the Initiator group.
|
wwn
|
Name of the unassociated host.
|
initiator-group-to-cascade
|
Name of the unassociated initiator group(s).
|
port-group-name
|
Name of the port group.
|
port-name
|
Name of the unassociated port.
|
create-modify-status
|
Status of the operation
|
Sample Adapter Response for 'delete-masking-group' Operation
Sample 1 - Device Group Deleted
<emc-storage-response>
<metadata>
<status>success</status>
<response-count>1</response-count>
</metadata>
<responses>
<response>
<metadata>
<status>success</status>
<execution-milliseconds>3229</execution-milliseconds>
<line-count>3</line-count>
<target>pc-emc</target>
<config-name>default</config-name>
</metadata>
<output>
<masking-groups>
<masking-group>
<storage-system-name>SYMMETRIX+000294901120</storage-system-name>
<device-group-name>DG_Pc10</device-group-name>
<delete-modify-status>0 (Success)</delete-modify-status>
</masking-group>
</masking-groups>
</output>
</response>
</responses>
</emc-storage-response>
Sample 2 - Initiator Group Deleted
<emc-storage-response>
<metadata>
<status>success</status>
<response-count>1</response-count>
</metadata>
<responses>
<response>
<metadata>
<status>success</status>
<execution-milliseconds>27643</execution-milliseconds>
<line-count>3</line-count>
<target>pc-emc</target>
<config-name>default</config-name>
</metadata>
<output>
<masking-groups>
<masking-group>
<storage-system-name>SYMMETRIX+000294901120</storage-system-name>
<initiator-group-name>IG_Pc10</initiator-group-name>
<delete-modify-status>0 (Success)</delete-modify-status>
</masking-group>
</masking-groups>
</output>
</response>
</responses>
</emc-storage-response>
Sample 3 - Port Group Deleted
<emc-storage-response>
<metadata>
<status>success</status>
<response-count>1</response-count>
</metadata>
<responses>
<response>
<metadata>
<status>success</status>
<execution-milliseconds>3260</execution-milliseconds>
<line-count>3</line-count>
<target>pc-emc</target>
<config-name>default</config-name>
</metadata>
<output>
<masking-groups>
<masking-group>
<storage-system-name>SYMMETRIX+000294901120</storage-system-name>
<port-group-name>PG_Pc10</port-group-name>
<delete-modify-status>0 (Success)</delete-modify-status>
</masking-group>
</masking-groups>
</output>
</response>
</responses>
</emc-storage-response>
| 
