Vsan System Ex Vsan Unmount Disk Mapping Ex

Vsan System Ex Vsan Unmount Disk Mapping Ex

Unmount vSAN diskgroup, which stops using specified vSAN diskgroup for any vSAN I/O without destroying it.

This API extended and deprecated UnmountDiskMapping_Task, added vSAN data migration support, to provide data protection during the process. Without data migration, for vSAN data which is not configured with redundancy (policy hostFailureToTolerate=0), or in incompliant state (data redundancy reduced when policy hostFailureToTolerate>0), its accessibility could be broken after diskgroup unmounted.

Required privileges: Host.Config.Storage

Request
URI
POST
https://{api_host}/sdk/vim25/{release}/vsan/VsanSystemEx/{moId}/VsanUnmountDiskMappingEx
COPY
Path Parameters
string
moId
Required

The unique identifier for the managed object to which the method attaches; the serialized managed object reference for a request has the form moType/moId, in this case VsanSystemEx/{moId}.

string
release
Required

The vSphere release schema. The current specification covers vSphere 9.0.0.0 APIs.


Request Body
VsanUnmountDiskMappingExRequestType of type(s) application/json
Required
"VsanUnmountDiskMappingExRequestType Object"
array of object
mappings
Required

List of diskgroups to be unmounted.

maintenanceSpec
Optional

Any additional actions to move data out of the diskgroup before unmounting it. See HostMaintenanceSpec. If unspecified, there is no action taken to move data from the diskgroup.

integer As int32 As int32
timeout
Optional

Time to wait for the task to complete in seconds. If the value is less than or equal to zero, there is no timeout. The operation fails with a Timedout exception if it timed out.

string
evacReason
Optional

The reason to evacuate diskgroup. Allowed values can be found in VsanDiskEvacReasonEnum

Since: 8.0.0.4

Authentication
This operation uses the following authentication methods.
Responses
200

Task to track the diskrgoup unmounting process.

Returns MoRefTask of type(s) application/json
"MoRefTask Object"

500

Failure

Returns VsanFault of type(s) application/json
"VsanFault Object"

Code Samples
COPY
                    curl -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '[{}]' https://{api_host}/sdk/vim25/{release}/vsan/VsanSystemEx/{moId}/VsanUnmountDiskMappingEx