vSphere Web Services API

		Local Properties	Local Methods
Managed Object Types	Data Object Types	All Properties	All Methods

Managed Object - HostAssignableHardwareManager(vim.host.AssignableHardwareManager)

Property of

HostConfigManager

See also

HostAssignableHardwareBinding, HostAssignableHardwareConfig, VirtualMachineDynamicPassthroughInfo, VirtualMachineVendorDeviceGroupInfo

Since

vSphere API Release 7.0

Managed Object Description

This managed object manages the assignable hardware state of the host.

Properties

Name	Type	Description
binding* P	HostAssignableHardwareBinding[]	Assignable Hardware bindings
config P	HostAssignableHardwareConfig	Assignable Hardware configuration

*May not be presentP Required privilege: System.Read

Methods

Methods defined in this Managed Object
DownloadDescriptionTree, RetrieveDynamicPassthroughInfo, RetrieveVendorDeviceGroupInfo, UpdateAssignableHardwareConfig

DownloadDescriptionTree(downloadDescriptionTree)

Download Assignable Hardware description tree. The size of the downloaded description tree is dependent on the type and number of assignable devices found on the host. As a rough estimate, each device might require approximate 256 bytes to represent. The number of assignable devices on a host may vary from none to 60 or more. A host with 3 SRIOV type devices consisting of a PF and 16 VFs would have a total of 51 devices and the description tree would be approximately 51 * 256 bytes = 13,056 bytes.

Required Privileges

System.Read

Parameters

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

Return Value

Type	Description
xsd:base64Binary

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.

Events

Type
None

Show WSDL type definition

<element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="DownloadDescriptionTree" type="vim25:DownloadDescriptionTreeRequestType"/> <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="DownloadDescriptionTreeResponse"> <complexType> <sequence> <element name="returnval" type="xsd:base64Binary"/> </sequence> </complexType> </element>

RetrieveDynamicPassthroughInfo(retrieveDynamicPassthroughInfo)

Retrieve PCI Dynamic Passthrough info. Returns the list of PCI devices that may be used as a Dynamic DirectPath IO device.

Required Privileges

System.Read

Parameters

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

Return Value

Type	Description
VirtualMachineDynamicPassthroughInfo[]

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.

Events

Type
None

Show WSDL type definition

<element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="RetrieveDynamicPassthroughInfo" type="vim25:RetrieveDynamicPassthroughInfoRequestType"/> <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="RetrieveDynamicPassthroughInfoResponse"> <complexType> <sequence> <element name="returnval" type="vim25:VirtualMachineDynamicPassthroughInfo" minOccurs="0" maxOccurs="unbounded"/> </sequence> </complexType> </element>

RetrieveVendorDeviceGroupInfo(retrieveVendorDeviceGroupInfo)

Retrieve VendorDeviceGroup info. Returns the list of Vendor Device Group deviceTypes present.

Required Privileges

System.Read

Since

vSphere API Release 8.0.0.1

Parameters

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

Return Value

Type	Description
VirtualMachineVendorDeviceGroupInfo[]

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.

Events

Type
None

Show WSDL type definition

<element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="RetrieveVendorDeviceGroupInfo" type="vim25:RetrieveVendorDeviceGroupInfoRequestType"/> <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="RetrieveVendorDeviceGroupInfoResponse"> <complexType> <sequence> <element name="returnval" type="vim25:VirtualMachineVendorDeviceGroupInfo" minOccurs="0" maxOccurs="unbounded"/> </sequence> </complexType> </element>

UpdateAssignableHardwareConfig(updateConfig)

Update Assignable Hardware configuration. Entries are updated as described in HostAssignableHardwareConfig.

Required Privileges

Host.Config.Settings

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the HostAssignableHardwareManager used to make the method call.
config	HostAssignableHardwareConfig	Since vSphere API Release 7.0

Return Value

Type	Description
None

Faults

Type	Description
HostConfigFault
RuntimeFault	Thrown 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

<element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="UpdateAssignableHardwareConfig" type="vim25:UpdateAssignableHardwareConfigRequestType"/> <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="UpdateAssignableHardwareConfigResponse"> <complexType/> </element>

Top of page		Local Properties	Local Methods
Managed Object Types	Data Object Types	All Properties	All Methods