Host Auto Start Manager Reconfigure Autostart

Changes the power-on or power-off sequence and system defaults.

The specification is an incremental change to the current configuration.

If systemDefaults are included, only values that are specified in the specification are changed.

For the spec.powerInfo array, each element is interpreted as an incremental change and the changes are processed sequentially. It is not an error to remove a non-existing virtual machine. If both startAction and stopAction are set to none, then the virtual machine is removed from the configuration.

A virtual machine's position in the order can be changed either by assigning the virtual machine a different position in the order or removing the machine from the order. When a virtual machine's position changes, all other virtual machines' positions may be affected as they move to new positions relative to each other.

Required privileges: Host.Config.AutoStart

Request

URI

POST

https://{vcenter-host}/sdk/vim25/{release}/HostAutoStartManager/{moId}/ReconfigureAutostart

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

string

release

Required

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

Request Body

ReconfigureAutostartRequestType of type(s) application/json

Required

{
    "spec": {
        "_typeName": "string",
        "defaults": {
            "_typeName": "string",
            "enabled": false,
            "startDelay": 0,
            "stopDelay": 0,
            "waitForHeartbeat": false,
            "stopAction": "string"
        },
        "powerInfo": [
            {
                "_typeName": "string",
                "key": {
                    "_typeName": "string",
                    "type": "string",
                    "value": "string"
                },
                "startOrder": 0,
                "startDelay": 0,
                "waitForHeartbeat": "string",
                "startAction": "string",
                "stopDelay": 0,
                "stopAction": "string"
            }
        ]
    }
}

HostAutoStartManagerConfig

spec

Required

Contains the entire auto-start/auto-stop configuration.

Authentication

This operation uses the following authentication methods.

Session

Responses

204

No Content

Operation doesn't return any data structure

On This Page