# novaclient.exceptions module

Exception definitions.

exception novaclient.exceptions.BadRequest(code, message=None, details=None, request_id=None, url=None, method=None)

  Bases: `ClientException`

  HTTP 400 - Bad request: you sent some malformed data.

  http_status = 400
  message = 'Bad request'

exception novaclient.exceptions.ClientException(code, message=None, details=None, request_id=None, url=None, method=None)

  Bases: `Exception`

  The base exception class for all exceptions this library raises.

  message = 'Unknown Error'

exception novaclient.exceptions.CommandError

  Bases: `Exception`

exception novaclient.exceptions.Conflict(code, message=None, details=None, request_id=None, url=None, method=None)

  Bases: `ClientException`

  HTTP 409 - Conflict

  http_status = 409
  message = 'Conflict'

exception novaclient.exceptions.Forbidden(code, message=None, details=None, request_id=None, url=None, method=None)

  Bases: `ClientException`

  HTTP 403 - Forbidden: your credentials don’t give you access to this resource.

  http_status = 403
  message = 'Forbidden'

exception novaclient.exceptions.HTTPNotImplemented(code, message=None, details=None, request_id=None, url=None, method=None)

  Bases: `ClientException`

  HTTP 501 - Not Implemented: the server does not support this operation.

  http_status = 501
  message = 'Not Implemented'

exception novaclient.exceptions.InstanceInDeletedState

  Bases: `Exception`

  Instance is in the deleted state.

exception novaclient.exceptions.InvalidUsage

  Bases: `RuntimeError`

  This function call is invalid in the way you are using this client.

  Due to the transition to using keystoneauth some function calls are no longer available. You should make a similar call to the session object instead.

exception novaclient.exceptions.MethodNotAllowed(code, message=None, details=None, request_id=None, url=None, method=None)

  Bases: `ClientException`

  HTTP 405 - Method Not Allowed

  http_status = 405
  message = 'Method Not Allowed'

exception novaclient.exceptions.NoUniqueMatch

  Bases: `Exception`

exception novaclient.exceptions.NotAcceptable(code, message=None, details=None, request_id=None, url=None, method=None)

  Bases: `ClientException`

  HTTP 406 - Not Acceptable

  http_status = 406
  message = 'Not Acceptable'

exception novaclient.exceptions.NotFound(code, message=None, details=None, request_id=None, url=None, method=None)

  Bases: `ClientException`

  HTTP 404 - Not found

  http_status = 404
  message = 'Not found'

exception novaclient.exceptions.OverLimit(*args, **kwargs)

  Bases: `RetryAfterException`

  HTTP 413 - Over limit: you’re over the API limits for this time period.

  http_status = 413
  message = 'Over limit'

exception novaclient.exceptions.RateLimit(*args, **kwargs)

  Bases: `RetryAfterException`

  HTTP 429 - Rate limit: you’ve sent too many requests for this time period.

  http_status = 429
  message = 'Rate limit'

exception novaclient.exceptions.ResourceInErrorState(obj)

  Bases: `Exception`

  Resource is in the error state.

exception novaclient.exceptions.ResourceNotFound

  Bases: `Exception`

  Error in getting the resource.

exception novaclient.exceptions.RetryAfterException(*args, **kwargs)

  Bases: `ClientException`

  The base exception class for ClientExceptions that use Retry-After header.

exception novaclient.exceptions.Unauthorized(code, message=None, details=None, request_id=None, url=None, method=None)

  Bases: `ClientException`

  HTTP 401 - Unauthorized: bad credentials.

  http_status = 401
  message = 'Unauthorized'

exception novaclient.exceptions.UnsupportedAttribute(argument_name, start_version, end_version=None)

  Bases: `AttributeError`

  Indicates that the user is trying to transmit the argument to a method, which is not supported by selected version.

exception novaclient.exceptions.UnsupportedConsoleType(console_type)

  Bases: `Exception`

  Indicates that the user is trying to use an unsupported console type when retrieving console urls of servers.

exception novaclient.exceptions.UnsupportedVersion

  Bases: `Exception`

  Indicates that the user is trying to use an unsupported version of the API.

exception novaclient.exceptions.VersionNotFoundForAPIMethod(version, method)

  Bases: `Exception`

  msg_fmt = "API version '%(vers)s' is not supported on '%(method)s' method."

novaclient.exceptions.from_response(response, body, url, method=None)

  Return an instance of an ClientException or subclass based on a requests response.

  Usage:

      resp, body = requests.request(...)
      if resp.status_code != 200:
          raise exception_from_response(resp, rest.text)

this page last updated: 2026-04-01 09:32:37

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.

found an error? report a bug