Red Hat Bugzilla – Bug 1467969
[RFE] Add a hierarchy of exceptions
Last modified: 2017-11-16 08:21:21 EST
Currently when the SDK detects any kind of problem it raises ovirtsdk4.Error. The raise exception contains details about the error, like the HTTP error code, and the details of the error message generated by the engine. But when the error isn't HTTP related it is difficult to interpret it automatically, as the only information available is the error message. To improve this the SDK should instead provide a hierarchy of exception classes, and raise the ones that are relevant to the situation. This hierarchy should be rooted at the current ovirtsdk4.Error, and should contain at least the following exceptions:
ovirtsdk4.NotFoundError - When the server returns a 400 HTTP error code.
ovirtsdk4.TimeoutError - When a request fails after a timeout.
ovirtsdk4.NoSuchHostError - When the host name can't be resolved.
ovirtsdk4.UnauthorizedError - When the user isn't authorized.
The authentication error should be raised when the SSO service responds with an error or when the API responds with 401.
Following errors was implemented:
AuthError - Raised when authentication or authorization fail.
ConnectionError - Raised when the name of the server can’t be resolved, and when the server is down or unreachable.
NotFoundError - Raised when the requested object doesn’t exist.
TimeoutError - Raised when an operation times out.
Verified new error classes in SDK ovirt-engine-sdk-python-4.2.1a3. Engine version 4.2.0-0.0.master.20171108151837.gita7de53e.el7.centos.