Host Vsan Internal System Reconfiguration Satisfiable

Host Vsan Internal System Reconfiguration Satisfiable

Determine if the given objects can be reconfigured with the given policies.

The what-if determination only takes into account the total number of hosts and total number of disks per host. The API is intended to answer the question: is this reconfiguration possible using the current cluster topology (#hosts and #disks) and does NOT take into account free space on the disk, size of disks, etc. If policy is not satisfiable, the API returns the reason for not being able to satisfy the policy. If the policy is satisfiable, the API returns the cost of provisioning objects with the new policy. This cost can be combined with current available free disk space to compute if a particular operation is expected to succeed or fail. Please note: This API ignores forceProvisioning.

Required privileges: System.Read

Request
URI
POST
https://{vcenter-host}/sdk/vim25/{release}/HostVsanInternalSystem/{moId}/ReconfigurationSatisfiable
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 HostVsanInternalSystem/{moId}.

string
release
Required

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


Request Body
ReconfigurationSatisfiableRequestType of type(s) application/json
Required
{
    "pcbs": [
        {
            "_typeName": "string",
            "uuid": [
                "string"
            ],
            "policy": "string"
        }
    ],
    "ignoreSatisfiability": false
}
pcbs
Required

List of PolicyChangeBatch structure with uuids and policies.

boolean
ignoreSatisfiability
Optional

Optionally populate PolicyCost even though object cannot be reconfigured in the current cluster topology.

Authentication
This operation uses the following authentication methods.
Responses
200

List of PolicySatisfiability objects, one for each specified UUID.

Returns Array of VsanPolicySatisfiability of type(s) application/json
[
    {
        "_typeName": "string",
        "uuid": "string",
        "isSatisfiable": false,
        "reason": {
            "_typeName": "string",
            "key": "string",
            "arg": [
                {
                    "_typeName": "string",
                    "key": "string",
                    "value": {
                        "_typeName": "string"
                    }
                }
            ],
            "message": "string"
        },
        "cost": {
            "_typeName": "string",
            "changeDataSize": 0,
            "currentDataSize": 0,
            "tempDataSize": 0,
            "copyDataSize": 0,
            "changeFlashReadCacheSize": 0,
            "currentFlashReadCacheSize": 0,
            "currentDiskSpaceToAddressSpaceRatio": "number",
            "diskSpaceToAddressSpaceRatio": "number"
        }
    }
]

500

Failure

Returns VimFault of type(s) application/json
This response body class contains all of the following: MethodFault
{
    "_typeName": "string",
    "faultCause": "MethodFault Object",
    "faultMessage": [
        {
            "_typeName": "string",
            "key": "string",
            "arg": [
                {
                    "_typeName": "string",
                    "key": "string",
                    "value": {
                        "_typeName": "string"
                    }
                }
            ],
            "message": "string"
        }
    ]
}