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

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: 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>