Host Storage System Resolve Multiple Unresolved Vmfs Volumes

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.3.0 APIs.


Request Body
Required

Show optional properties

{
    "resolutionSpec": [
        {
            "extentDevicePath": [
                {}
            ],
            "uuidResolution": "string"
        }
    ]
}
{
    "resolutionSpec": [
        {
            "_typeName": "string",
            "extentDevicePath": [
                "string"
            ],
            "uuidResolution": "string"
        }
    ]
}
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.
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"
        }
    ]
}

Virtual Infrastructure Operations
POST
Host Storage System Add Internet Scsi Send Targets
POST
Host Storage System Add Internet Scsi Static Targets
POST
Host Storage System Attach Scsi Lun
POST
Host Storage System Attach Scsi Lun Ex Task
POST
Host Storage System Attach Vmfs Extent
POST
Host Storage System Change NFS User Password
POST
Host Storage System Clear NFS User
POST
Host Storage System Compute Disk Partition Info
POST
Host Storage System Compute Disk Partition Info For Resize
POST
Host Storage System Connect Nvme Controller
POST
Host Storage System Connect Nvme Controller Ex Task
POST
Host Storage System Create Nvme Over Rdma Adapter
POST
Host Storage System Create Software Adapter
POST
Host Storage System Delete Scsi Lun State
POST
Host Storage System Delete Vffs Volume State
POST
Host Storage System Delete Vmfs Volume State
POST
Host Storage System Destroy Vffs
POST
Host Storage System Detach Scsi Lun
POST
Host Storage System Detach Scsi Lun Ex Task
POST
Host Storage System Disable Multipath Path
POST
Host Storage System Disconnect Nvme Controller
POST
Host Storage System Disconnect Nvme Controller Ex Task
POST
Host Storage System Discover Fcoe Hbas
POST
Host Storage System Discover Nvme Controllers
POST
Host Storage System Enable Multipath Path
POST
Host Storage System Expand Vmfs Extent
POST
Host Storage System Extend Vffs
POST
Host Storage System Format Vffs
POST
Host Storage System Format Vmfs
GET
Host Storage System Get Available Field
GET
Host Storage System Get File System Volume Info
GET
Host Storage System Get Multipath State Info
GET
Host Storage System Get Storage Device Info
GET
Host Storage System Get System File
GET
Host Storage System Get Value
POST
Host Storage System Host Storage System Mark For Removal
POST
Host Storage System Mark As Local Task
POST
Host Storage System Mark As Non Local Task
POST
Host Storage System Mark As Non Ssd Task
POST
Host Storage System Mark As Ssd Task
POST
Host Storage System Mark Perennially Reserved
POST
Host Storage System Mark Perennially Reserved Ex Task
POST
Host Storage System Mount Vffs Volume
POST
Host Storage System Mount Vmfs Volume
POST
Host Storage System Mount Vmfs Volume Ex Task
POST
Host Storage System Query Available Ssds
POST
Host Storage System Query NFS User
POST
Host Storage System Query Path Selection Policy Options
POST
Host Storage System Query Storage Array Type Policy Options
POST
Host Storage System Query Unresolved Vmfs Volume
POST
Host Storage System Query Vmfs Config Option
POST
Host Storage System Refresh Storage System
POST
Host Storage System Remove Internet Scsi Send Targets
POST
Host Storage System Remove Internet Scsi Static Targets
POST
Host Storage System Remove Nvme Over Rdma Adapter
POST
Host Storage System Remove Software Adapter
POST
Host Storage System Rescan All Hba
POST
Host Storage System Rescan Hba
POST
Host Storage System Rescan Vffs
POST
Host Storage System Rescan Vmfs
POST
Host Storage System Resolve Multiple Unresolved Vmfs Volumes
POST
Host Storage System Resolve Multiple Unresolved Vmfs Volumes Ex Task
POST
Host Storage System Retrieve Disk Partition Info
POST
Host Storage System Set Custom Value
POST
Host Storage System Set Multipath Lun Policy
POST
Host Storage System Set NFS User
POST
Host Storage System Turn Disk Locator Led Off Task
POST
Host Storage System Turn Disk Locator Led On Task
POST
Host Storage System Unmap Vmfs Volume Ex Task
POST
Host Storage System Unmount Force Mounted Vmfs Volume
POST
Host Storage System Unmount Vffs Volume
POST
Host Storage System Unmount Vmfs Volume
POST
Host Storage System Unmount Vmfs Volume Ex Task
POST
Host Storage System Update Disk Partitions
POST
Host Storage System Update Hpp Multipath Lun Policy
POST
Host Storage System Update Internet Scsi Advanced Options
POST
Host Storage System Update Internet Scsi Alias
POST
Host Storage System Update Internet Scsi Authentication Properties
POST
Host Storage System Update Internet Scsi Digest Properties
POST
Host Storage System Update Internet Scsi Discovery Properties
POST
Host Storage System Update Internet Scsi IP Properties
POST
Host Storage System Update Internet Scsi Name
POST
Host Storage System Update Scsi Lun Display Name
POST
Host Storage System Update Software Internet Scsi Enabled
POST
Host Storage System Update Vmfs Unmap Bandwidth
POST
Host Storage System Update Vmfs Unmap Priority
POST
Host Storage System Upgrade Vmfs
POST
Host Storage System Upgrade Vm Layout