Package org.ovirt.engine.sdk4.services
Interface HostService
-
- All Superinterfaces:
MeasurableService
,Service
- All Known Implementing Classes:
HostServiceImpl
public interface HostService extends MeasurableService
A service to manage a host.
-
-
Nested Class Summary
Nested Classes Modifier and Type Interface Description static interface
HostService.ActivateRequest
Activates the host for use, for example to run virtual machines.static interface
HostService.ActivateResponse
Activates the host for use, for example to run virtual machines.static interface
HostService.ApproveRequest
Approve a pre-installed Hypervisor host for usage in the virtualization environment.static interface
HostService.ApproveResponse
Approve a pre-installed Hypervisor host for usage in the virtualization environment.static interface
HostService.ApproveUsingRootPasswordRequest
static interface
HostService.ApproveUsingRootPasswordResponse
static interface
HostService.ApproveUsingSshRequest
Approve the specified host to be added to the engine by using ssh authentication.static interface
HostService.ApproveUsingSshResponse
Approve the specified host to be added to the engine by using ssh authentication.static interface
HostService.CommitNetConfigRequest
Marks the network configuration as good and persists it inside the host.static interface
HostService.CommitNetConfigResponse
Marks the network configuration as good and persists it inside the host.static interface
HostService.CopyHostNetworksRequest
Copy the network configuration of the specified host to current host.static interface
HostService.CopyHostNetworksResponse
Copy the network configuration of the specified host to current host.static interface
HostService.DeactivateRequest
Deactivates the host to perform maintenance tasks.static interface
HostService.DeactivateResponse
Deactivates the host to perform maintenance tasks.static interface
HostService.DiscoverIscsiRequest
Discovers iSCSI targets on the host, using the initiator details.static interface
HostService.DiscoverIscsiResponse
Discovers iSCSI targets on the host, using the initiator details.static interface
HostService.EnrollCertificateRequest
Enrolls the certificate of the host.static interface
HostService.EnrollCertificateResponse
Enrolls the certificate of the host.static interface
HostService.FenceRequest
Controls the host's power management device.static interface
HostService.FenceResponse
Controls the host's power management device.static interface
HostService.ForceSelectSpmRequest
To manually set a host as the storage pool manager (SPM).static interface
HostService.ForceSelectSpmResponse
To manually set a host as the storage pool manager (SPM).static interface
HostService.GetRequest
Gets the host details.static interface
HostService.GetResponse
Gets the host details.static interface
HostService.InstallRequest
Installs the latest version of VDSM and related software on the host.static interface
HostService.InstallResponse
Installs the latest version of VDSM and related software on the host.static interface
HostService.InstallUsingRootPasswordRequest
Install VDSM and other packages required to get the host ready to be used in the engine providing the root password.static interface
HostService.InstallUsingRootPasswordResponse
Install VDSM and other packages required to get the host ready to be used in the engine providing the root password.static interface
HostService.InstallUsingSshRequest
Install VDSM and other packages required to get the host ready to be used in the engine providing the SSH password.static interface
HostService.InstallUsingSshResponse
Install VDSM and other packages required to get the host ready to be used in the engine providing the SSH password.static interface
HostService.IscsiDiscoverRequest
This method has been deprecated since Engine version 4.4.6.static interface
HostService.IscsiDiscoverResponse
This method has been deprecated since Engine version 4.4.6.static interface
HostService.IscsiLoginRequest
Login to iSCSI targets on the host, using the target details.static interface
HostService.IscsiLoginResponse
Login to iSCSI targets on the host, using the target details.static interface
HostService.RefreshRequest
Refresh the host devices and capabilities.static interface
HostService.RefreshResponse
Refresh the host devices and capabilities.static interface
HostService.RemoveRequest
Remove the host from the system.static interface
HostService.RemoveResponse
Remove the host from the system.static interface
HostService.SetupNetworksRequest
This method is used to change the configuration of the network interfaces of a host.static interface
HostService.SetupNetworksResponse
This method is used to change the configuration of the network interfaces of a host.static interface
HostService.SyncAllNetworksRequest
To synchronize all networks on the host, send a request like this: [source] ---- POST /ovirt-engine/api/hosts/123/syncallnetworks ---- With a request body like this: [source,xml] -------- static interface
HostService.SyncAllNetworksResponse
To synchronize all networks on the host, send a request like this: [source] ---- POST /ovirt-engine/api/hosts/123/syncallnetworks ---- With a request body like this: [source,xml] -------- static interface
HostService.UnregisteredStorageDomainsDiscoverRequest
Discovers the block Storage Domains which are candidates to be imported to the setup.static interface
HostService.UnregisteredStorageDomainsDiscoverResponse
Discovers the block Storage Domains which are candidates to be imported to the setup.static interface
HostService.UpdateRequest
Update the host properties.static interface
HostService.UpdateResponse
Update the host properties.static interface
HostService.UpdateUsingRootPasswordRequest
Update the specified host in the system.static interface
HostService.UpdateUsingRootPasswordResponse
Update the specified host in the system.static interface
HostService.UpdateUsingSshRequest
Updates the specified host in the system.static interface
HostService.UpdateUsingSshResponse
Updates the specified host in the system.static interface
HostService.UpgradeCheckRequest
Check if there are upgrades available for the host.static interface
HostService.UpgradeCheckResponse
Check if there are upgrades available for the host.static interface
HostService.UpgradeRequest
Upgrades VDSM and selected software on the host.static interface
HostService.UpgradeResponse
Upgrades VDSM and selected software on the host.
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description HostService.ActivateRequest
activate()
Activates the host for use, for example to run virtual machines.AssignedAffinityLabelsService
affinityLabelsService()
List of scheduling labels assigned to this host.HostService.ApproveRequest
approve()
Approve a pre-installed Hypervisor host for usage in the virtualization environment.HostService.ApproveUsingRootPasswordRequest
approveUsingRootPassword()
HostService.ApproveUsingSshRequest
approveUsingSsh()
Approve the specified host to be added to the engine by using ssh authentication.HostService.CommitNetConfigRequest
commitNetConfig()
Marks the network configuration as good and persists it inside the host.HostService.CopyHostNetworksRequest
copyHostNetworks()
Copy the network configuration of the specified host to current host.HostService.DeactivateRequest
deactivate()
Deactivates the host to perform maintenance tasks.HostDevicesService
devicesService()
A reference to the host devices service.HostService.DiscoverIscsiRequest
discoverIscsi()
Discovers iSCSI targets on the host, using the initiator details.HostService.EnrollCertificateRequest
enrollCertificate()
Enrolls the certificate of the host.ExternalNetworkProviderConfigurationsService
externalNetworkProviderConfigurationsService()
External network providers provisioned by the system on the host.HostService.FenceRequest
fence()
Controls the host's power management device.FenceAgentsService
fenceAgentsService()
A reference to the fence agents service.HostService.ForceSelectSpmRequest
forceSelectSpm()
To manually set a host as the storage pool manager (SPM).HostService.GetRequest
get()
Gets the host details.HostHooksService
hooksService()
A reference to the host hooks service.HostService.InstallRequest
install()
Installs the latest version of VDSM and related software on the host.HostService.InstallUsingRootPasswordRequest
installUsingRootPassword()
Install VDSM and other packages required to get the host ready to be used in the engine providing the root password.HostService.InstallUsingSshRequest
installUsingSsh()
Install VDSM and other packages required to get the host ready to be used in the engine providing the SSH password.HostService.IscsiDiscoverRequest
iscsiDiscover()
This method has been deprecated since Engine version 4.4.6.HostService.IscsiLoginRequest
iscsiLogin()
Login to iSCSI targets on the host, using the target details.KatelloErrataService
katelloErrataService()
A reference to the service that can show the applicable errata available on the host.NetworkAttachmentsService
networkAttachmentsService()
A reference to the network attachments service.HostNicsService
nicsService()
A reference to the service that manages the network interface devices on the host.HostNumaNodesService
numaNodesService()
A reference to the service that manage NUMA nodes for the host.AssignedPermissionsService
permissionsService()
A reference to the host permission service.HostService.RefreshRequest
refresh()
Refresh the host devices and capabilities.HostService.RemoveRequest
remove()
Remove the host from the system.Service
service(String path)
Service locator method, returns individual service on which the URI is dispatched.HostService.SetupNetworksRequest
setupNetworks()
This method is used to change the configuration of the network interfaces of a host.StorageServerConnectionExtensionsService
storageConnectionExtensionsService()
A reference to storage connection extensions.HostStorageService
storageService()
A reference to the service that manages the host's storage.HostService.SyncAllNetworksRequest
syncAllNetworks()
To synchronize all networks on the host, send a request like this: [source] ---- POST /ovirt-engine/api/hosts/123/syncallnetworks ---- With a request body like this: [source,xml] -------- AssignedTagsService
tagsService()
A reference to the host tags service.UnmanagedNetworksService
unmanagedNetworksService()
A reference to unmanaged networks.HostService.UnregisteredStorageDomainsDiscoverRequest
unregisteredStorageDomainsDiscover()
Discovers the block Storage Domains which are candidates to be imported to the setup.HostService.UpdateRequest
update()
Update the host properties.HostService.UpdateUsingRootPasswordRequest
updateUsingRootPassword()
Update the specified host in the system.HostService.UpdateUsingSshRequest
updateUsingSsh()
Updates the specified host in the system.HostService.UpgradeRequest
upgrade()
Upgrades VDSM and selected software on the host.HostService.UpgradeCheckRequest
upgradeCheck()
Check if there are upgrades available for the host.-
Methods inherited from interface org.ovirt.engine.sdk4.services.MeasurableService
statisticsService
-
-
-
-
Method Detail
-
activate
HostService.ActivateRequest activate()
Activates the host for use, for example to run virtual machines.
-
approve
HostService.ApproveRequest approve()
Approve a pre-installed Hypervisor host for usage in the virtualization environment. This action also accepts an optional cluster element to define the target cluster for this host.
-
commitNetConfig
HostService.CommitNetConfigRequest commitNetConfig()
Marks the network configuration as good and persists it inside the host. An API user commits the network configuration to persist a host network interface attachment or detachment, or persist the creation and deletion of a bonded interface. IMPORTANT: Networking configuration is only committed after the engine has established that host connectivity is not lost as a result of the configuration changes. If host connectivity is lost, the host requires a reboot and automatically reverts to the previous networking configuration. For example, to commit the network configuration of host with id `123` send a request like this: [source] ---- POST /ovirt-engine/api/hosts/123/commitnetconfig ---- With a request body like this: [source,xml] -------- IMPORTANT: Since {engine-name} 4.3, it is possible to also specify `commit_on_success` in the < > request, in which case the new configuration is automatically saved in the {hypervisor-name} upon completing the setup and re-establishing connectivity between the {hypervisor-name} and {engine-name}, and without waiting for a separate < > request.
-
copyHostNetworks
HostService.CopyHostNetworksRequest copyHostNetworks()
Copy the network configuration of the specified host to current host. IMPORTANT: Any network attachments that are not present on the source host will be erased from the target host by the copy operation. To copy networks from another host, send a request like this: [source] ---- POST /ovirt-engine/api/hosts/123/copyhostnetworks ---- With a request body like this: [source,xml] ----
-
deactivate
HostService.DeactivateRequest deactivate()
Deactivates the host to perform maintenance tasks.
-
discoverIscsi
HostService.DiscoverIscsiRequest discoverIscsi()
Discovers iSCSI targets on the host, using the initiator details. Returns a list of IscsiDetails objects containing the discovered data. For example, to discover iSCSI targets available in `myiscsi.example.com`, from host `123`, send a request like this: [source] ---- POST /ovirt-engine/api/hosts/123/discoveriscsi ---- With a request body like this: [source,xml] ----myiscsi.example.com 10.35.1.72 3260 10.35.1.72:3260,1 iqn.2015-08.com.tgt:444
-
enrollCertificate
HostService.EnrollCertificateRequest enrollCertificate()
Enrolls the certificate of the host. Useful in case you get a warning that it is about to expire or has already expired.
-
fence
HostService.FenceRequest fence()
Controls the host's power management device. For example, to start the host. This can be done via: [source] ---- #!/bin/sh -ex url="https://engine.example.com/ovirt-engine/api" user="admin@internal" password="..." curl \ --verbose \ --cacert /etc/pki/ovirt-engine/ca.pem \ --user "${user}:${password}" \ --request POST \ --header "Version: 4" \ --header "Content-Type: application/xml" \ --header "Accept: application/xml" \ --data 'start
-
forceSelectSpm
HostService.ForceSelectSpmRequest forceSelectSpm()
To manually set a host as the storage pool manager (SPM). [source] ---- POST /ovirt-engine/api/hosts/123/forceselectspm ---- With a request body like this: [source,xml] --------
-
get
HostService.GetRequest get()
Gets the host details. [source] ---- GET /ovirt-engine/api/hosts/123 ----
-
install
HostService.InstallRequest install()
Installs the latest version of VDSM and related software on the host. The action also performs every configuration steps on the host which is done during adding host to the engine: kdump configuration, hosted-engine deploy, kernel options changes, etc. The host type defines additional parameters for the action. Example of installing a host, using `curl` and JSON, plain: [source,bash] ---- curl \ --verbose \ --cacert /etc/pki/ovirt-engine/ca.pem \ --request PUT \ --header "Content-Type: application/json" \ --header "Accept: application/json" \ --header "Version: 4" \ --user "admin@internal:..." \ --data ' { "root_password": "myrootpassword" } ' \ "https://engine.example.com/ovirt-engine/api/hosts/123" ---- Example of installing a host using `curl` and JSON with hosted engine components: [source,bash] ---- curl \ curl \ --verbose \ --cacert /etc/pki/ovirt-engine/ca.pem \ --request PUT \ --header "Content-Type: application/json" \ --header "Accept: application/json" \ --header "Version: 4" \ --user "admin@internal:..." \ --data ' { "root_password": "myrootpassword" "deploy_hosted_engine" : "true" } ' \ "https://engine.example.com/ovirt-engine/api/hosts/123" ---- IMPORTANT: Since version 4.1.2 of the engine, when a host is reinstalled we override the host firewall definitions by default.
-
iscsiDiscover
HostService.IscsiDiscoverRequest iscsiDiscover()
This method has been deprecated since Engine version 4.4.6. DiscoverIscsi should be used instead. Discovers iSCSI targets on the host, using the initiator details. Returns an array of strings containing the discovered data. For example, to discover iSCSI targets available in `myiscsi.example.com`, from host `123`, send a request like this: [source] ---- POST /ovirt-engine/api/hosts/123/iscsidiscover ---- With a request body like this: [source,xml] ----myiscsi.example.com
-
iscsiLogin
HostService.IscsiLoginRequest iscsiLogin()
Login to iSCSI targets on the host, using the target details. IMPORTANT: When using this method to log in, you must use the iscsi details from the discovered targets results in the discoveriscsi method.
-
refresh
HostService.RefreshRequest refresh()
Refresh the host devices and capabilities.
-
remove
HostService.RemoveRequest remove()
Remove the host from the system. [source] ---- #!/bin/sh -ex url="https://engine.example.com/ovirt-engine/api" user="admin@internal" password="..." curl \ --verbose \ --cacert /etc/pki/ovirt-engine/ca.pem \ --user "${user}:${password}" \ --request DELETE \ --header "Version: 4" \ "${url}/hosts/1ff7a191-2f3b-4eff-812b-9f91a30c3acc" ----
-
setupNetworks
HostService.SetupNetworksRequest setupNetworks()
This method is used to change the configuration of the network interfaces of a host. For example, if you have a host with three network interfaces `eth0`, `eth1` and `eth2` and you want to configure a new bond using `eth0` and `eth1`, and put a VLAN on top of it. Using a simple shell script and the `curl` command line HTTP client that can be done as follows: [source] ---- #!/bin/sh -ex url="https://engine.example.com/ovirt-engine/api" user="admin@internal" password="..." curl \ --verbose \ --cacert /etc/pki/ovirt-engine/ca.pem \ --user "${user}:${password}" \ --request POST \ --header "Version: 4" \ --header "Content-Type: application/xml" \ --header "Accept: application/xml" \ --data 'bond0 eth1 eth2 myvlan bond0 static 192.168.122.10 255.255.255.0 1.1.1.1 2.2.2.2 ---- The same thing can be done using the Python SDK with the following code: [source,python] ---- # Find the service that manages the collection of hosts: hosts_service = connection.system_service().hosts_service() # Find the host: host = hosts_service.list(search='name=myhost')[0] # Find the service that manages the host: host_service = hosts_service.host_service(host.id) # Configure the network adding a bond with two slaves and attaching it to a # network with an static IP address: host_service.setup_networks( modified_bonds=[ types.HostNic( name='bond0', bonding=types.Bonding( options=[ types.Option( name='mode', value='4', ), types.Option( name='miimon', value='100', ), ], slaves=[ types.HostNic( name='eth1', ), types.HostNic( name='eth2', ), ], ), ), ], modified_network_attachments=[ types.NetworkAttachment( network=types.Network( name='myvlan', ), host_nic=types.HostNic( name='bond0', ), ip_address_assignments=[ types.IpAddressAssignment( assignment_method=types.BootProtocol.STATIC, ip=types.Ip( address='192.168.122.10', netmask='255.255.255.0', ), ), ], dns_resolver_configuration=types.DnsResolverConfiguration( name_servers=[ '1.1.1.1', '2.2.2.2', ], ), ), ], ) # After modifying the network configuration it is very important to make it # persistent: host_service.commit_net_config() ---- IMPORTANT: To make sure that the network configuration has been saved in the host, and that it will be applied when the host is rebooted, remember to call < >. IMPORTANT: Since {engine-name} 4.3, it is possible to also specify `commit_on_success` in the < > request, in which case the new configuration is automatically saved in the {hypervisor-name} upon completing the setup and re-establishing connectivity between the {hypervisor-name} and {engine-name}, and without waiting for a separate < > request.
-
syncAllNetworks
HostService.SyncAllNetworksRequest syncAllNetworks()
To synchronize all networks on the host, send a request like this: [source] ---- POST /ovirt-engine/api/hosts/123/syncallnetworks ---- With a request body like this: [source,xml] --------
-
unregisteredStorageDomainsDiscover
HostService.UnregisteredStorageDomainsDiscoverRequest unregisteredStorageDomainsDiscover()
Discovers the block Storage Domains which are candidates to be imported to the setup. For FCP no arguments are required.
-
update
HostService.UpdateRequest update()
Update the host properties. For example, to update a the kernel command line of a host send a request like this: [source] ---- PUT /ovirt-engine/api/hosts/123 ---- With request body like this: [source, xml] ----vfio_iommu_type1.allow_unsafe_interrupts=1
-
upgrade
HostService.UpgradeRequest upgrade()
Upgrades VDSM and selected software on the host.
-
upgradeCheck
HostService.UpgradeCheckRequest upgradeCheck()
Check if there are upgrades available for the host. If there are upgrades available an icon will be displayed next to host status icon in the Administration Portal. Audit log messages are also added to indicate the availability of upgrades. The upgrade can be started from the webadmin or by using the <> host action.
-
approveUsingRootPassword
HostService.ApproveUsingRootPasswordRequest approveUsingRootPassword()
-
installUsingRootPassword
HostService.InstallUsingRootPasswordRequest installUsingRootPassword()
Install VDSM and other packages required to get the host ready to be used in the engine providing the root password. This has been deprecated.
-
updateUsingRootPassword
HostService.UpdateUsingRootPasswordRequest updateUsingRootPassword()
Update the specified host in the system. This is deprecated and is provided only for backwards compatibility.
-
approveUsingSsh
HostService.ApproveUsingSshRequest approveUsingSsh()
Approve the specified host to be added to the engine by using ssh authentication. This occurs when the host registers itself with the engine.
-
installUsingSsh
HostService.InstallUsingSshRequest installUsingSsh()
Install VDSM and other packages required to get the host ready to be used in the engine providing the SSH password.
-
updateUsingSsh
HostService.UpdateUsingSshRequest updateUsingSsh()
Updates the specified host in the system.
-
affinityLabelsService
AssignedAffinityLabelsService affinityLabelsService()
List of scheduling labels assigned to this host.
-
devicesService
HostDevicesService devicesService()
A reference to the host devices service. Use this service to view the devices of the host object.
-
externalNetworkProviderConfigurationsService
ExternalNetworkProviderConfigurationsService externalNetworkProviderConfigurationsService()
External network providers provisioned by the system on the host.
-
fenceAgentsService
FenceAgentsService fenceAgentsService()
A reference to the fence agents service. Use this service to manage fence and power management agents on the host object.
-
hooksService
HostHooksService hooksService()
A reference to the host hooks service. Use this service to view the hooks available in the host object.
-
katelloErrataService
KatelloErrataService katelloErrataService()
A reference to the service that can show the applicable errata available on the host. This information is taken from Katello.
-
networkAttachmentsService
NetworkAttachmentsService networkAttachmentsService()
A reference to the network attachments service. You can use this service to attach Logical networks to host interfaces.
-
nicsService
HostNicsService nicsService()
A reference to the service that manages the network interface devices on the host.
-
numaNodesService
HostNumaNodesService numaNodesService()
A reference to the service that manage NUMA nodes for the host.
-
permissionsService
AssignedPermissionsService permissionsService()
A reference to the host permission service. Use this service to manage permissions on the host object.
-
storageService
HostStorageService storageService()
A reference to the service that manages the host's storage.
-
storageConnectionExtensionsService
StorageServerConnectionExtensionsService storageConnectionExtensionsService()
A reference to storage connection extensions.
-
tagsService
AssignedTagsService tagsService()
A reference to the host tags service. Use this service to manage tags on the host object.
-
unmanagedNetworksService
UnmanagedNetworksService unmanagedNetworksService()
A reference to unmanaged networks.
-
service
Service service(String path)
Service locator method, returns individual service on which the URI is dispatched.- Specified by:
service
in interfaceMeasurableService
-
-