Vim Cluster Vsan Vc Disk Management System Rebuild Disk Mapping

Vim Cluster Vsan Vc Disk Management System Rebuild Disk Mapping

This API is used to rebuild an existing vSAN disk mapping on the specified host.

Please note that the API does not support rebuilding unmounted DGs. Rebuild disk mapping is done in two steps: 1. remove the existing disk mapping with user specified data evacuation mode; 2. perform a trim operation on every disk in DG. 3. re-create a new disk mapping with the same set of disks. Removal of a disk mapping may cause data movement so a disk data evacuation resource check VsanPerformResourceCheck will be done before removing the disk mapping. Before re-creating new disk mapping, the disks will be trimmed for refreshing possible bad blocks in the meta-data section of the disks.

Request
URI
POST
https://{api_host}/sdk/vim25/{release}/vsan/VimClusterVsanVcDiskManagementSystem/{moId}/RebuildDiskMapping
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 VimClusterVsanVcDiskManagementSystem/{moId}.

string
release
Required

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


Request Body
RebuildDiskMappingRequestType of type(s) application/json
Required
"RebuildDiskMappingRequestType Object"
host
Required

Target host to rebuild.

Required privileges: Host.Config.Storage

mapping
Required

The disk mapping to be rebuilt from VSAN usage.

maintenanceSpec
Required

Specifies the data evacuation mode.

Authentication
This operation uses the following authentication methods.
Responses
200

OK

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

500

VsanFault: If below issues exist:

  1. Specified host doesn't exist;
  2. User doesn't have Host.Config.Storage privilege on specified host;
  3. Specified host is not connected to vCenter server;
  4. Resource check completes with "red" status;
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/VimClusterVsanVcDiskManagementSystem/{moId}/RebuildDiskMapping