| Local Methods | ||
Managed Object Types | Data Object Types | All Properties | All Methods |
Properties
Name | Type | Description |
---|---|---|
None |
Methods
Methods defined in this Managed Object |
---|
InstallIoFilter_Task, QueryDisksUsingFilter, QueryIoFilterInfo, QueryIoFilterIssues, ResolveInstallationErrorsOnCluster_Task, ResolveInstallationErrorsOnHost_Task, UninstallIoFilter_Task, UpgradeIoFilter_Task |
Parameters
Name | Type | Description |
---|---|---|
_this | ManagedObjectReference | A reference to the IoFilterManager used to make the method call. |
vibUrl | xsd:string |
The URL that points to the IO Filter VIB package.
|
compRes | ManagedObjectReference
to a ComputeResource |
The compute resource to install the IO Filter on.
"compRes" must be a cluster.
|
Return Value
Type | Description |
---|---|
ManagedObjectReference
to a Task | This method returns a Task object with which to monitor the operation. The task is set to success if the filter is installed on all the hosts in the compute resource successfully. If the task fails, first check error to see the error. If the error indicates that installation has failed on the hosts, use QueryIoFilterIssues to get the detailed errors occured during installation on each host. The dynamic privilege check ensures that the user must have Host.Config.Patch privilege for all the hosts in the compute resource. |
Faults
Type | Description |
---|---|
AlreadyExists | Thrown if another VIB with the same name and vendor has been installed. |
InvalidArgument | Thrown if "compRes" is a standalone host. |
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 |
Parameters
Name | Type | Description |
---|---|---|
_this | ManagedObjectReference | A reference to the IoFilterManager used to make the method call. |
filterId | xsd:string |
ID of the filter.
|
compRes | ManagedObjectReference
to a ComputeResource |
The compute resource that the filter has been installed on.
"compRes" must be a cluster.
|
Return Value
Type | Description |
---|---|
VirtualDiskId[] | An array of VirtualDiskId objects that use the given IO Filter installed on the compute resource. |
Faults
Type | Description |
---|---|
NotFound | Thrown if the filter specified by "filterId" is not installed on the cluster. |
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 |
Parameters
Name | Type | Description |
---|---|---|
_this | ManagedObjectReference | A reference to the IoFilterManager used to make the method call. |
compRes | ManagedObjectReference
to a ComputeResource |
The compute resource.
"compRes" must be a cluster.
|
Return Value
Type | Description |
---|---|
ClusterIoFilterInfo[] | An array of ClusterIoFilterInfo objects that contain the information for the IO Filters that are installed on the compute resource. |
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 |
Parameters
Name | Type | Description |
---|---|---|
_this | ManagedObjectReference | A reference to the IoFilterManager used to make the method call. |
filterId | xsd:string |
The filter.
|
compRes | ManagedObjectReference
to a ComputeResource |
The compute resource.
"compRes" must be a cluster.
|
Return Value
Type | Description |
---|---|
IoFilterQueryIssueResult | A IoFilterQueryIssueResult object. |
Faults
Type | Description |
---|---|
NotFound | Thrown if the filter specified by "filterId" is not installed on the cluster. |
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 |
Depending on the nature of the installation failure, vCenter will take the appropriate actions to resolve it. For example, retry or resume installation.
Parameters
Name | Type | Description |
---|---|---|
_this | ManagedObjectReference | A reference to the IoFilterManager used to make the method call. |
filterId | xsd:string |
ID of the filter.
|
cluster | ManagedObjectReference
to a ClusterComputeResource |
The cluster.
|
Return Value
Type | Description |
---|---|
ManagedObjectReference
to a Task | This method returns a Task object with which to monitor the operation. The task is set to success if all the errors related to the filter are resolved on the cluster. If the task fails, first check error to see the error. If the error indicates that issues persist on the cluster, use QueryIoFilterIssues to get the detailed errors on the hosts in the cluster. The dynamic privilege check will ensure that the appropriate privileges must be acquired for all the hosts in the cluster based on the remediation actions. For example, Host.Config.Maintenance privilege and Host.Config.Patch privileges must be required for upgrading a VIB. |
Faults
Type | Description |
---|---|
NotFound | Thrown if the filter specified by "filterId" is not installed on the cluster. |
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 |
Depending on the nature of the installation failure, vCenter will take the appropriate actions to resolve it. For example, retry or resume installation.
Parameters
Name | Type | Description |
---|---|---|
_this | ManagedObjectReference | A reference to the IoFilterManager used to make the method call. |
filterId | xsd:string |
ID of the filter.
|
host | ManagedObjectReference
to a HostSystem |
The host.
|
Return Value
Type | Description |
---|---|
ManagedObjectReference
to a Task | This method returns a Task object with which to monitor the operation. The task is set to success if all the errors related to the filter are resolved on the host. If the task fails, first check error to see the error. If the error indicates that issues persist on the host, use QueryIoFilterIssues to get the detailed errors on the host. The dynamic privilege check will ensure that the appropriate privileges are acquired based on the remediation actions. For example, Host.Config.Maintenance and Host.Config.Patch privilege must required for upgrading a VIB. |
Faults
Type | Description |
---|---|
NotFound | Thrown if the filter specified by "filterId" is not installed on the cluster. |
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 |
Parameters
Name | Type | Description |
---|---|---|
_this | ManagedObjectReference | A reference to the IoFilterManager used to make the method call. |
filterId | xsd:string |
ID of the filter.
|
compRes | ManagedObjectReference
to a ComputeResource |
The compute resource to uninstall the IO Filter from.
"compRes" must be a cluster.
|
Return Value
Type | Description |
---|---|
ManagedObjectReference
to a Task | This method returns a Task object with which to monitor the operation. The task is set to success if the filter is uninstalled from all the hosts in the compute resource successfully. If the task fails, first check error to see the error. If the error indicates that uninstallation has failed on the hosts, use QueryIoFilterIssues to get the detailed errors occured during uninstallation on each host. The dynamic privilege check ensures that the user must have Host.Config.Maintenance and Host.Config.Patch privilege for all the hosts in the compute resource. |
Faults
Type | Description |
---|---|
FilterInUse | Thrown if the filter to be uninstalled is being used by a virtual disk. |
InvalidArgument | Thrown if "compRes" is a standalone host. |
InvalidState | Thrown if "compRes" is a cluster and DRS is disabled on the cluster. |
NotFound | Thrown if the filter is not installed on the cluster. |
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 |
Parameters
Name | Type | Description |
---|---|---|
_this | ManagedObjectReference | A reference to the IoFilterManager used to make the method call. |
filterId | xsd:string |
The filter to be upgraded.
|
compRes | ManagedObjectReference
to a ComputeResource |
The compute resource that the filter is installed on.
"compRes" must be a cluster.
|
vibUrl | xsd:string |
The URL that points to the new IO Filter VIB package.
|
Return Value
Type | Description |
---|---|
ManagedObjectReference
to a Task | This method returns a Task object with which to monitor the operation. The task is set to success if all the hosts in the compute resource are upgraded successfully. If the task fails, first check error to see the error. If the error indicates that upgrade has failed on the hosts, use QueryIoFilterIssues to get the detailed errors occured during upgrade on each host. The dynamic privilege check ensures that the user must have Host.Config.Maintenance and Host.Config.Patch privileges for all the hosts in the compute resource. |
Faults
Type | Description |
---|---|
InvalidArgument | Thrown if "compRes" is a standalone host; or if the VIB package pointed by "vibUrl" is not an upgrade of the IO Filter specified by "filterId". |
InvalidState | Thrown if "compRes" is a cluster and DRS is disabled on the cluster. |
NotFound | Thrown if the filter specified by "filterId" is not installed on the cluster. |
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 |
Top of page | Local Methods | ||
Managed Object Types | Data Object Types | All Properties | All Methods |