|
The delete-lun operation sends a query to the EMC SMI-S Provider to remove an existing LUN from a storage system. All the data in the specified volume are destroyed.
The delete-lun operation is typically used when decommissioning a server that was using storage space in a disk array.
 Use this operation cautiously as it cannot be undone.
The table below describes the input properties for this request. If not specified, the value for an element should be assumed to be any string.
Adapter Request Elements for 'delete-lun' Operation
|
|
|
|
operation-name
|
Specifies the name of the operation you want to perform.
| • | Valid value: delete-lun. |
|
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. |
|
Yes
|
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.
|
lun-name
|
Specifies the name of the LUN that must be deleted.
| • | Valid value: Please refer to the get-lun operation to list the valid values of this field. |
|
Yes
|
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
|
Wait until the job completes.
|
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
|
Sample Adapter Request for Multiple 'delete-lun' Operation
<emc-storage-request>
<operation-name>delete-lun</operation-name>
<arguments>
<argument>
<storage-system-name>CLARiiON+CKM00083900053</storage-system-name>
<lun-name>00018</lun-name>
<lun-name>00018</lun-name>
<lun-name>00020</lun-name>
<synchronous>yes</synchronous>
</argument>
</arguments>
</emc-storage-request>
Adapter Response Elements for 'delete-lun' Operation
|
|
|
storage-system-name
|
Name of the storage system.
|
lun-name
|
Name of the deleted LUN.
|
job-id
|
Number identifying the job.
|
job-status
|
Status of the job.
|
job-status-description
|
Detailed information about the status of the job.
|
Sample Adapter Response for Multiple 'delete-lun' Operation
<emc-storage-response>
<metadata>
<status>success</status>
<response-count>1</response-count>
</metadata>
<responses>
<response>
<metadata>
<status>success</status>
<execution-milliseconds>18187</execution-milliseconds>
<line-count>5</line-count>
<target>pythagoras-p27p</target>
<config-name>pythagoras-p27p</config-name>
</metadata>
<output>
<luns>
<lun>
<storage-system-name>CLARiiON+CKM00083900053</storage-system-name>
<lun-name>00018</lun-name>
<job-id>260920594</job-id>
<job-status-description>Completed - Volume Delete</job-status-description>
<job-status>Completed</job-status>
</lun>
</luns>
</output>
</response>
</responses>
</emc-storage-response>
| 
