Host Storage System Resolve Multiple Unresolved Vmfs Volumes

Resignature or 'Force Mount' list of unbound VMFS volumes.

To safely enable sharing of the volume across hosts, a VMFS volume is bound to its underlying block device storage. When a low level block copy is performed to copy or move the VMFS volume, the copied volume will be unbound. In order for the VMFS volume to be usable, a resolution operation is needed to determine whether the VMFS volume should be treated as a new volume or not and what extents compose that volume in the event there is more than one unbound volume.

Resignature results in a new VMFS volume on the host. Operations performed at the StorageSystem interface apply only to a specific host. Hence, callers of this method are responsible for issuing rescan operations to detect the new VMFS volume on other hosts. Alternatively, callers that want VirtualCenter to handle rescanning the necessary hosts should use the DatastoreSystem interface.

When user wants to keep the original Vmfs Uuid and mount it on the host, set the 'resolutionSpec.uuidResolution' to 'forceMounted' This is per-host operation. It will return an array of ResolutionResult describing success or failure associated with each specification.

Required privileges: Host.Config.Storage

Request

URI

POST

https://{vcenter-host}/sdk/vim25/{release}/HostStorageSystem/{moId}/ResolveMultipleUnresolvedVmfsVolumes

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 HostStorageSystem/{moId}.

string

release

Required

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

Request Body

ResolveMultipleUnresolvedVmfsVolumesRequestType of type(s) application/json

Required

{
    "resolutionSpec": [
        {
            "_typeName": "string",
            "extentDevicePath": [
                "string"
            ],
            "uuidResolution": "string"
        }
    ]
}

array of HostUnresolvedVmfsResolutionSpec

resolutionSpec

Required

List of data object that describes what the disk extents to be used for creating the new VMFS volume.

Authentication

This operation uses the following authentication methods.

Session

Responses

200

A data object that represents the VMFS file system and return status value.

Returns Array of HostUnresolvedVmfsResolutionResult of type(s) application/json

[
    {
        "_typeName": "string",
        "spec": {
            "_typeName": "string",
            "extentDevicePath": [
                "string"
            ],
            "uuidResolution": "string"
        },
        "vmfs": {
            "_typeName": "string",
            "type": "string",
            "name": "string",
            "capacity": 0,
            "blockSizeMb": 0,
            "blockSize": 0,
            "unmapGranularity": 0,
            "unmapPriority": "string",
            "unmapBandwidthSpec": {
                "_typeName": "string",
                "policy": "string",
                "fixedValue": 0,
                "dynamicMin": 0,
                "dynamicMax": 0
            },
            "maxBlocks": 0,
            "majorVersion": 0,
            "version": "string",
            "uuid": "string",
            "extent": [
                {
                    "_typeName": "string",
                    "diskName": "string",
                    "partition": 0
                }
            ],
            "vmfsUpgradable": false,
            "forceMountedInfo": {
                "_typeName": "string",
                "persist": false,
                "mounted": false
            },
            "ssd": false,
            "local": false,
            "scsiDiskType": "string"
        },
        "fault": {
            "_typeName": "string",
            "faultCause": "MethodFault Object",
            "faultMessage": [
                {
                    "_typeName": "string",
                    "key": "string",
                    "arg": [
                        {
                            "_typeName": "string",
                            "key": "string",
                            "value": {
                                "_typeName": "string"
                            }
                        }
                    ],
                    "message": "string"
                }
            ]
        }
    }
]

500

HostConfigFault: if batch operation fails on the host. Because the returned array of ResolutionResult contains the new VMFS volume or fault for each operation, as of vSphere API 5.x, we won't throw fault when batch operation fails.

Returns HostConfigFault of type(s) application/json

This response body class contains all of the following: VimFault

{
    "_typeName": "string",
    "faultCause": "MethodFault Object",
    "faultMessage": [
        {
            "_typeName": "string",
            "key": "string",
            "arg": [
                {
                    "_typeName": "string",
                    "key": "string",
                    "value": {
                        "_typeName": "string"
                    }
                }
            ],
            "message": "string"
        }
    ]
}

On This Page

Description

Request

Path Parameters

Request Body

Authentication

Response

200 Response Body

Errors

Host Storage System Operations