# Managed Object - HostAssignableHardwareManager(vim.host.AssignableHardwareManager)

Property of
  HostConfigManager
See also
  HostAssignableHardwareBinding, HostAssignableHardwareConfig, VirtualMachineDynamicPassthroughInfo, VirtualMachineVendorDeviceGroupInfo
Since
  vSphere API 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 present P 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
  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 P | HostAssignableHardwareConfig | Since vSphere API 7.0

P Required privilege: config

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>