Vim Cluster Vsan Vc Disk Management System Initialize Disk Mappings

Vim Cluster Vsan Vc Disk Management System Initialize Disk Mappings

This API is used to create new vSAN disk groups or attach more disks into existing vSAN disk group on specified host.

It deprecates APIs AddDisks_Task and InitializeDisks_Task, to support creating both hybrid and all flash disk group. Scsi disks eligible for vSAN service, could be retrieved through API QueryDisksForVsan. If the "creationType" of the given spec is set to "vsandirect", then it will create vSAN direct datastores on each specified SSD and HDD.

Request
URI
POST
https://{api_host}/sdk/vim25/{release}/vsan/VimClusterVsanVcDiskManagementSystem/{moId}/InitializeDiskMappings
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
InitializeDiskMappingsRequestType of type(s) application/json
Required
"InitializeDiskMappingsRequestType Object"
spec
Required

The specification to create vSAN disk group. Please reference to VimVsanHostDiskMappingCreationSpec;

Required privileges: Host.Config.Storage

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. If requests to create all flash disk group but host's ESX software doesn't support this feature;
  5. If requests to create all flash disk group but host is not licensed to support this feature;
  6. If requests to append disks to existing disk group, but specified more than one disks for cache tier;
  7. If none of specified disks for capacity tier is eligible for vSAN;
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}/InitializeDiskMappings