The OvirtSDK4 module contains the following software development kit classes:
The Type classes implement the types supported by the API. For example, the Vm class is the implementation of the virtual machine type. The classes are data containers and do not contain any logic. You will be working with instances of types.
Instances of these classes are used as parameters and return values of service methods. The conversion to or from the underlying representation is handled transparently by the software development kit.
The Service classes implement the services supported by the API. For example, the VmsService class is the implementation of the service that manages the collection of virtual machines in the system.
Instances of these classes are automatically created by the SDK when a service is referenced. For example, a new instance of the
VmsServiceclass is created automatically by the SDK when you call the
vms_servicemethod of the
vms_service = connection.system_service.vms_service
Do not create instances of these classes manually. The constructor parameters and methods may change in the future.
The Error class is the base exception class that the software development kit raises when it reports an error.
Certain specific error classes extend the base error class:
AuthError - Authentication or authorization failure
ConnectionError - Server name cannot be resolved or server is unreachable
NotFoundError - Requested object does not exist
TimeoutError - Operation time-out
- Other Classes
Other classes (for example, HTTP client classes, readers, and writers) are used for HTTP communication and for XML parsing and rendering. Using these classes is not recommended, because they comprise internal implementation details that may change in the future. Their backwards-compatibility cannot be relied upon.