Managed Object - HostImageConfigManager(vim.host.ImageConfigManager)

Property of
HostConfigManager
See also
HostImageProfileSummary, SoftwarePackage
Since
vSphere API 5.0


Managed Object Description

This managed object is the interface for configuration of the ESX software image, including properties such as acceptance level. It is currently designed to be host agent specific.

Properties

Name Type Description
None

Methods

Methods defined in this Managed Object
fetchSoftwarePackages, HostImageConfigGetAcceptance, HostImageConfigGetProfile, installDate, UpdateHostImageAcceptanceLevel

fetchSoftwarePackages

Reports the set of software packages installed. The CLI command is: esxcli software vib get
Required Privileges
Host.Config.Image
Since
vSphere API 6.5

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostImageConfigManager used to make the method call.

Return Value

Type Description
SoftwarePackage[]

Faults

Type Description
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

Show WSDL type definition



HostImageConfigGetAcceptance(queryHostAcceptanceLevel)

Queries the current host acceptance level setting.
See HostImageAcceptanceLevel
Required Privileges
System.Read

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostImageConfigManager used to make the method call.

Return Value

Type Description
xsd:string

Faults

Type Description
HostConfigFaultThrown if the host acceptance setting is invalid.
See HostImageAcceptanceLevel
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

Show WSDL type definition



HostImageConfigGetProfile(queryHostImageProfile)

Queries the current host image profile information.
See HostImageProfileSummary
Required Privileges
System.Read

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostImageConfigManager used to make the method call.

Return Value

Type Description
HostImageProfileSummary

Faults

Type Description
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

Show WSDL type definition



installDate

Reports the UTC time stamp when this system was first installed. The CLI command is: esxcli system stats installtime get
Required Privileges
Host.Config.Image
Since
vSphere API 6.5

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostImageConfigManager used to make the method call.

Return Value

Type Description
xsd:dateTime

Faults

Type Description
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

Show WSDL type definition



UpdateHostImageAcceptanceLevel(updateAcceptanceLevel)

Sets the acceptance level of the host image profile.
See HostImageAcceptanceLevel
Required Privileges
Host.Config.Image

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostImageConfigManager used to make the method call.
newAcceptanceLevel Pxsd:string

the new AcceptanceLevel to set.
See HostImageAcceptanceLevel

Since vSphere API 5.0
P Required privilege: newAcceptanceLevel

Return Value

Type Description
None

Faults

Type Description
HostConfigFaultThrown if the acceptance level is raised and there are VIB packages that are not permitted by the higher acceptance level.
See HostImageAcceptanceLevel
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

Show WSDL type definition