Resource Pool Update Child Resource Configuration

Changes resource configuration of a set of children of this resource pool.

The method allows bulk modifications of the set of the direct children (virtual machines and resource pools).

Bulk modifications are not transactional. Each modification is made individually. If a failure is encountered while applying the changes, then the processing stops, meaning at least one and as many as all of the changes are not applied.

A set can include a subset of the resources. Children that are not mentioned in the list are not changed.

For each ResourceConfigSpec, the following privilege checks apply:

If the ResourceConfigSpec refers to a child resource pool or a child vApp, the privileges required are the same as would be required for calling UpdateConfig on that entity.
If the ResourceConfigSpec refers to a virtual machine, VirtualMachine.Config.Resource must be held on the virtual machine.

Request

URI

POST

https://{vcenter-host}/sdk/vim25/{release}/ResourcePool/{moId}/UpdateChildResourceConfiguration

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

string

release

Required

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

Request Body

UpdateChildResourceConfigurationRequestType of type(s) application/json

Required

{
    "spec": [
        {
            "_typeName": "string",
            "entity": {
                "_typeName": "string",
                "type": "string",
                "value": "string"
            },
            "changeVersion": "string",
            "lastModified": "string",
            "cpuAllocation": {
                "_typeName": "string",
                "reservation": 0,
                "expandableReservation": false,
                "limit": 0,
                "shares": {
                    "_typeName": "string",
                    "shares": 0,
                    "level": "string"
                },
                "overheadLimit": 0
            },
            "memoryAllocation": {
                "_typeName": "string",
                "reservation": 0,
                "expandableReservation": false,
                "limit": 0,
                "shares": {
                    "_typeName": "string",
                    "shares": 0,
                    "level": "string"
                },
                "overheadLimit": 0
            },
            "scaleDescendantsShares": "string"
        }
    ]
}

array of ResourceConfigSpec

spec

Required

spec

Authentication

This operation uses the following authentication methods.

Session

Responses

204

No Content

Operation doesn't return any data structure

500

InvalidArgument: if a managed entity that is not a child of this group is included.

InsufficientResourcesFault: if the operation would violate a resource usage policy. Typically, a more specific subclass, such as InsufficientMemoryResourcesFault will be thrown.

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"
        }
    ]
}

On This Page

Description

Request

Path Parameters

Request Body

Authentication

Response

204 Response Body

Errors

Resource Pool Operations

POST

Resource Pool Create Child VM Task

POST

Resource Pool Create Resource Pool

POST

Resource Pool Create V App