Managed Object - HostImageConfigManager

Property of: HostConfigManager
See also: HostImageProfileSummary
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
HostImageConfigGetAcceptance, HostImageConfigGetProfile, UpdateHostImageAcceptanceLevel

HostImageConfigGetAcceptance

Queries the current host acceptance level setting.
See HostImageAcceptanceLevel

Required Privileges: System.Read

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the HostImageConfigManager used to make the method call.

Return Value

Type	Description
xsd:string

Faults

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

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="HostImageConfigGetAcceptance" type="vim25:HostImageConfigGetAcceptanceRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="HostImageConfigGetAcceptanceResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="xsd:string"/>
               </sequence>
            </complexType>
         </element>

HostImageConfigGetProfile

Queries the current host image profile information.
See HostImageProfileSummary

Required Privileges: System.Read

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the HostImageConfigManager used to make the method call.

Return Value

Type	Description
HostImageProfileSummary

Faults

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

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="HostImageConfigGetProfile" type="vim25:HostImageConfigGetProfileRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="HostImageConfigGetProfileResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vim25:HostImageProfileSummary"/>
               </sequence>
            </complexType>
         </element>

UpdateHostImageAcceptanceLevel

Sets the acceptance level of the host image profile.
See HostImageAcceptanceLevel

Required Privileges: Host.Config.Image

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the HostImageConfigManager used to make the method call.
newAcceptanceLevel	xsd:string	the new AcceptanceLevel to set. See HostImageAcceptanceLevel

Return Value

Type	Description
None

Faults

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

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="UpdateHostImageAcceptanceLevel" type="vim25:UpdateHostImageAcceptanceLevelRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="UpdateHostImageAcceptanceLevelResponse">
            <complexType/>
         </element>