Host Specification Manager Update Host Specification

Update the host specification with the provided copy.

If there is no host specification for the host, create the host specification for this host in the host specification "database"; otherwise, update the host specification with the provided. HostSpecification object. On success, it will fire a HostSpecificationChangedEvent.

Required privileges: Profile.Edit

Request

URI

POST

https://{vcenter-host}/sdk/vim25/{release}/HostSpecificationManager/{moId}/UpdateHostSpecification

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

string

release

Required

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

Request Body

UpdateHostSpecificationRequestType of type(s) application/json

Required

Show optional properties

{
    "host": {},
    "hostSpec": {
        "createdTime": "string",
        "host": {}
    }
}

{
    "host": {
        "_typeName": "string",
        "type": "string",
        "value": "string"
    },
    "hostSpec": {
        "_typeName": "string",
        "createdTime": "string",
        "lastModified": "string",
        "host": {
            "_typeName": "string",
            "type": "string",
            "value": "string"
        },
        "subSpecs": [
            {
                "_typeName": "string",
                "name": "string",
                "createdTime": "string",
                "data": [
                    0
                ],
                "binaryData": "string"
            }
        ],
        "changeID": "string"
    }
}

MoRefHostSystem

host

Required

Reference to an instance of the HostSystem managed object.

HostSpecification

hostSpec

Required

The host specification data are those needed at host boot time to create and configure virtual devices and host services.

The HostSpecification data object contains a collection of host sub specification data. For host sub specification data, see HostSubSpecification for details.

Authentication

This operation uses the following authentication methods.

Session

Responses

204

No Content

Operation doesn't return any data structure

500

HostSpecificationOperationFailed: If the method fails.

Returns HostSpecificationOperationFailed 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"
        }
    ],
    "host": {
        "_typeName": "string",
        "type": "string",
        "value": "string"
    }
}

MoRefHostSystem

host

Required

Reference to an instance of the HostSystem managed object.

On This Page

Description

Request

Path Parameters

Request Body

Authentication

Response

204 Response Body