Host Specification Manager Retrieve Host Specification
Retrieve the host specification.
When the parameter fromHost
is true
, the host specification is retrieved from the host; otherwise, it is from the host specification "database" for this manager. When retrieved from host, the copy in host specification "database" will be updated. On success, it will fire a HostSpecificationChangedEvent
.
Required privileges: System.View
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}
.
The vSphere release schema. The current specification covers vSphere 8.0.2.0 APIs.
{
"host": {
"_typeName": "string",
"type": "string",
"value": "string"
},
"fromHost": false
}
Whether retrieve from the host.
The host specification of the specified host.
{
"_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"
}
Time at which the host specification was created.
Time at which the host specification was last modified.
If it isn't set, it is the same as createdTime
.
The collection of the host sub specifications.
It is optional.
The change ID for querying the host specification data updated in a time period.
It has a format of timestamp:change_number, where timestamp is the decimal string of a start time, and change_number is the decimal string of an auto incremented variable counting from the start time.
HostSpecificationOperationFailed: If the method fails when retrieve from host.
{
"_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"
}
}