# keystoneauth1.exceptions.http module

HTTP Exceptions used by keystoneauth1.

exception keystoneauth1.exceptions.http.BadGateway(message: str | None = None, details: str | None = None, response: Response | None = None, request_id: str | None = None, url: str | None = None, method: str | None = None, http_status: int | None = None, retry_after: int = 0)

  Bases: `HttpServerError`

  HTTP 502 - Bad Gateway.

  The server was acting as a gateway or proxy and received an invalid response from the upstream server.

  __annotate_func__ = None
  __annotations_cache__ = {}
  __doc__ = 'HTTP 502 - Bad Gateway.\n\nThe server was acting as a gateway or proxy and received an invalid\nresponse from the upstream server.\n'
  __firstlineno__ = 360
  __module__ = 'keystoneauth1.exceptions.http'
  __static_attributes__ = ()
  http_status = 502
  message = 'Bad Gateway'

exception keystoneauth1.exceptions.http.BadRequest(message: str | None = None, details: str | None = None, response: Response | None = None, request_id: str | None = None, url: str | None = None, method: str | None = None, http_status: int | None = None, retry_after: int = 0)

  Bases: `HTTPClientError`

  HTTP 400 - Bad Request.

  The request cannot be fulfilled due to bad syntax.

  __annotate_func__ = None
  __annotations_cache__ = {}
  __doc__ = 'HTTP 400 - Bad Request.\n\nThe request cannot be fulfilled due to bad syntax.\n'
  __firstlineno__ = 110
  __module__ = 'keystoneauth1.exceptions.http'
  __static_attributes__ = ()
  http_status = 400
  message = 'Bad Request'

exception keystoneauth1.exceptions.http.Conflict(message: str | None = None, details: str | None = None, response: Response | None = None, request_id: str | None = None, url: str | None = None, method: str | None = None, http_status: int | None = None, retry_after: int = 0)

  Bases: `HTTPClientError`

  HTTP 409 - Conflict.

  Indicates that the request could not be processed because of conflict in the request, such as an edit conflict.

  __annotate_func__ = None
  __annotations_cache__ = {}
  __doc__ = 'HTTP 409 - Conflict.\n\nIndicates that the request could not be processed because of conflict\nin the request, such as an edit conflict.\n'
  __firstlineno__ = 205
  __module__ = 'keystoneauth1.exceptions.http'
  __static_attributes__ = ()
  http_status = 409
  message = 'Conflict'

exception keystoneauth1.exceptions.http.ExpectationFailed(message: str | None = None, details: str | None = None, response: Response | None = None, request_id: str | None = None, url: str | None = None, method: str | None = None, http_status: int | None = None, retry_after: int = 0)

  Bases: `HTTPClientError`

  HTTP 417 - Expectation Failed.

  The server cannot meet the requirements of the Expect request-header field.

  __annotate_func__ = None
  __annotations_cache__ = {}
  __doc__ = 'HTTP 417 - Expectation Failed.\n\nThe server cannot meet the requirements of the Expect request-header field.\n'
  __firstlineno__ = 317
  __module__ = 'keystoneauth1.exceptions.http'
  __static_attributes__ = ()
  http_status = 417
  message = 'Expectation Failed'

exception keystoneauth1.exceptions.http.Forbidden(message: str | None = None, details: str | None = None, response: Response | None = None, request_id: str | None = None, url: str | None = None, method: str | None = None, http_status: int | None = None, retry_after: int = 0)

  Bases: `HTTPClientError`

  HTTP 403 - Forbidden.

  The request was a valid request, but the server is refusing to respond to it.

  __annotate_func__ = None
  __annotations_cache__ = {}
  __doc__ = 'HTTP 403 - Forbidden.\n\nThe request was a valid request, but the server is refusing to respond\nto it.\n'
  __firstlineno__ = 141
  __module__ = 'keystoneauth1.exceptions.http'
  __static_attributes__ = ()
  http_status = 403
  message = 'Forbidden'

exception keystoneauth1.exceptions.http.GatewayTimeout(message: str | None = None, details: str | None = None, response: Response | None = None, request_id: str | None = None, url: str | None = None, method: str | None = None, http_status: int | None = None, retry_after: int = 0)

  Bases: `HttpServerError`

  HTTP 504 - Gateway Timeout.

  The server was acting as a gateway or proxy and did not receive a timely response from the upstream server.

  __annotate_func__ = None
  __annotations_cache__ = {}
  __doc__ = 'HTTP 504 - Gateway Timeout.\n\nThe server was acting as a gateway or proxy and did not receive a timely\nresponse from the upstream server.\n'
  __firstlineno__ = 381
  __module__ = 'keystoneauth1.exceptions.http'
  __static_attributes__ = ()
  http_status = 504
  message = 'Gateway Timeout'

exception keystoneauth1.exceptions.http.Gone(message: str | None = None, details: str | None = None, response: Response | None = None, request_id: str | None = None, url: str | None = None, method: str | None = None, http_status: int | None = None, retry_after: int = 0)

  Bases: `HTTPClientError`

  HTTP 410 - Gone.

  Indicates that the resource requested is no longer available and will not be available again.

  __annotate_func__ = None
  __annotations_cache__ = {}
  __doc__ = 'HTTP 410 - Gone.\n\nIndicates that the resource requested is no longer available and will\nnot be available again.\n'
  __firstlineno__ = 216
  __module__ = 'keystoneauth1.exceptions.http'
  __static_attributes__ = ()
  http_status = 410
  message = 'Gone'

exception keystoneauth1.exceptions.http.HTTPClientError(message: str | None = None, details: str | None = None, response: Response | None = None, request_id: str | None = None, url: str | None = None, method: str | None = None, http_status: int | None = None, retry_after: int = 0)

  Bases: `HttpError`

  Client-side HTTP error.

  Exception for cases in which the client seems to have erred.

  __annotate_func__ = None
  __annotations_cache__ = {}
  __doc__ = 'Client-side HTTP error.\n\nException for cases in which the client seems to have erred.\n'
  __firstlineno__ = 91
  __module__ = 'keystoneauth1.exceptions.http'
  __static_attributes__ = ()
  message = 'HTTP Client Error'

exception keystoneauth1.exceptions.http.HttpError(message: str | None = None, details: str | None = None, response: Response | None = None, request_id: str | None = None, url: str | None = None, method: str | None = None, http_status: int | None = None, retry_after: int = 0)

  Bases: `ClientException`

  The base exception class for all HTTP exceptions.

  __annotate_func__ = None
  __annotations_cache__ = {}
  __doc__ = 'The base exception class for all HTTP exceptions.'
  __firstlineno__ = 60
  __init__(message: str | None = None, details: str | None = None, response: Response | None = None, request_id: str | None = None, url: str | None = None, method: str | None = None, http_status: int | None = None, retry_after: int = 0)
  __module__ = 'keystoneauth1.exceptions.http'
  __static_attributes__ = ('details', 'http_status', 'message', 'method', 'request_id', 'response', 'retry_after', 'url')
  http_status = 0
  message = 'HTTP Error'

exception keystoneauth1.exceptions.http.HttpNotImplemented(message: str | None = None, details: str | None = None, response: Response | None = None, request_id: str | None = None, url: str | None = None, method: str | None = None, http_status: int | None = None, retry_after: int = 0)

  Bases: `HttpServerError`

  HTTP 501 - Not Implemented.

  The server either does not recognize the request method, or it lacks the ability to fulfill the request.

  __annotate_func__ = None
  __annotations_cache__ = {}
  __doc__ = 'HTTP 501 - Not Implemented.\n\nThe server either does not recognize the request method, or it lacks\nthe ability to fulfill the request.\n'
  __firstlineno__ = 349
  __module__ = 'keystoneauth1.exceptions.http'
  __static_attributes__ = ()
  http_status = 501
  message = 'Not Implemented'

exception keystoneauth1.exceptions.http.HttpServerError(message: str | None = None, details: str | None = None, response: Response | None = None, request_id: str | None = None, url: str | None = None, method: str | None = None, http_status: int | None = None, retry_after: int = 0)

  Bases: `HttpError`

  Server-side HTTP error.

  Exception for cases in which the server is aware that it has erred or is incapable of performing the request.

  __annotate_func__ = None
  __annotations_cache__ = {}
  __doc__ = 'Server-side HTTP error.\n\nException for cases in which the server is aware that it has\nerred or is incapable of performing the request.\n'
  __firstlineno__ = 100
  __module__ = 'keystoneauth1.exceptions.http'
  __static_attributes__ = ()
  message = 'HTTP Server Error'

exception keystoneauth1.exceptions.http.HttpVersionNotSupported(message: str | None = None, details: str | None = None, response: Response | None = None, request_id: str | None = None, url: str | None = None, method: str | None = None, http_status: int | None = None, retry_after: int = 0)

  Bases: `HttpServerError`

  HTTP 505 - HttpVersion Not Supported.

  The server does not support the HTTP protocol version used in the request.

  __annotate_func__ = None
  __annotations_cache__ = {}
  __doc__ = 'HTTP 505 - HttpVersion Not Supported.\n\nThe server does not support the HTTP protocol version used in the request.\n'
  __firstlineno__ = 392
  __module__ = 'keystoneauth1.exceptions.http'
  __static_attributes__ = ()
  http_status = 505
  message = 'HTTP Version Not Supported'

exception keystoneauth1.exceptions.http.InternalServerError(message: str | None = None, details: str | None = None, response: Response | None = None, request_id: str | None = None, url: str | None = None, method: str | None = None, http_status: int | None = None, retry_after: int = 0)

  Bases: `HttpServerError`

  HTTP 500 - Internal Server Error.

  A generic error message, given when no more specific message is suitable.

  __annotate_func__ = None
  __annotations_cache__ = {}
  __doc__ = 'HTTP 500 - Internal Server Error.\n\nA generic error message, given when no more specific message is suitable.\n'
  __firstlineno__ = 338
  __module__ = 'keystoneauth1.exceptions.http'
  __static_attributes__ = ()
  http_status = 500
  message = 'Internal Server Error'

exception keystoneauth1.exceptions.http.LengthRequired(message: str | None = None, details: str | None = None, response: Response | None = None, request_id: str | None = None, url: str | None = None, method: str | None = None, http_status: int | None = None, retry_after: int = 0)

  Bases: `HTTPClientError`

  HTTP 411 - Length Required.

  The request did not specify the length of its content, which is required by the requested resource.

  __annotate_func__ = None
  __annotations_cache__ = {}
  __doc__ = 'HTTP 411 - Length Required.\n\nThe request did not specify the length of its content, which is\nrequired by the requested resource.\n'
  __firstlineno__ = 227
  __module__ = 'keystoneauth1.exceptions.http'
  __static_attributes__ = ()
  http_status = 411
  message = 'Length Required'

exception keystoneauth1.exceptions.http.MethodNotAllowed(message: str | None = None, details: str | None = None, response: Response | None = None, request_id: str | None = None, url: str | None = None, method: str | None = None, http_status: int | None = None, retry_after: int = 0)

  Bases: `HTTPClientError`

  HTTP 405 - Method Not Allowed.

  A request was made of a resource using a request method not supported by that resource.

  __annotate_func__ = None
  __annotations_cache__ = {}
  __doc__ = 'HTTP 405 - Method Not Allowed.\n\nA request was made of a resource using a request method not supported\nby that resource.\n'
  __firstlineno__ = 163
  __module__ = 'keystoneauth1.exceptions.http'
  __static_attributes__ = ()
  http_status = 405
  message = 'Method Not Allowed'

exception keystoneauth1.exceptions.http.NotAcceptable(message: str | None = None, details: str | None = None, response: Response | None = None, request_id: str | None = None, url: str | None = None, method: str | None = None, http_status: int | None = None, retry_after: int = 0)

  Bases: `HTTPClientError`

  HTTP 406 - Not Acceptable.

  The requested resource is only capable of generating content not acceptable according to the Accept headers sent in the request.

  __annotate_func__ = None
  __annotations_cache__ = {}
  __doc__ = 'HTTP 406 - Not Acceptable.\n\nThe requested resource is only capable of generating content not\nacceptable according to the Accept headers sent in the request.\n'
  __firstlineno__ = 174
  __module__ = 'keystoneauth1.exceptions.http'
  __static_attributes__ = ()
  http_status = 406
  message = 'Not Acceptable'

exception keystoneauth1.exceptions.http.NotFound(message: str | None = None, details: str | None = None, response: Response | None = None, request_id: str | None = None, url: str | None = None, method: str | None = None, http_status: int | None = None, retry_after: int = 0)

  Bases: `HTTPClientError`

  HTTP 404 - Not Found.

  The requested resource could not be found but may be available again in the future.

  __annotate_func__ = None
  __annotations_cache__ = {}
  __doc__ = 'HTTP 404 - Not Found.\n\nThe requested resource could not be found but may be available again\nin the future.\n'
  __firstlineno__ = 152
  __module__ = 'keystoneauth1.exceptions.http'
  __static_attributes__ = ()
  http_status = 404
  message = 'Not Found'

exception keystoneauth1.exceptions.http.PaymentRequired(message: str | None = None, details: str | None = None, response: Response | None = None, request_id: str | None = None, url: str | None = None, method: str | None = None, http_status: int | None = None, retry_after: int = 0)

  Bases: `HTTPClientError`

  HTTP 402 - Payment Required.

  Reserved for future use.

  __annotate_func__ = None
  __annotations_cache__ = {}
  __doc__ = 'HTTP 402 - Payment Required.\n\nReserved for future use.\n'
  __firstlineno__ = 131
  __module__ = 'keystoneauth1.exceptions.http'
  __static_attributes__ = ()
  http_status = 402
  message = 'Payment Required'

exception keystoneauth1.exceptions.http.PreconditionFailed(message: str | None = None, details: str | None = None, response: Response | None = None, request_id: str | None = None, url: str | None = None, method: str | None = None, http_status: int | None = None, retry_after: int = 0)

  Bases: `HTTPClientError`

  HTTP 412 - Precondition Failed.

  The server does not meet one of the preconditions that the requester put on the request.

  __annotate_func__ = None
  __annotations_cache__ = {}
  __doc__ = 'HTTP 412 - Precondition Failed.\n\nThe server does not meet one of the preconditions that the requester\nput on the request.\n'
  __firstlineno__ = 238
  __module__ = 'keystoneauth1.exceptions.http'
  __static_attributes__ = ()
  http_status = 412
  message = 'Precondition Failed'

exception keystoneauth1.exceptions.http.ProxyAuthenticationRequired(message: str | None = None, details: str | None = None, response: Response | None = None, request_id: str | None = None, url: str | None = None, method: str | None = None, http_status: int | None = None, retry_after: int = 0)

  Bases: `HTTPClientError`

  HTTP 407 - Proxy Authentication Required.

  The client must first authenticate itself with the proxy.

  __annotate_func__ = None
  __annotations_cache__ = {}
  __doc__ = 'HTTP 407 - Proxy Authentication Required.\n\nThe client must first authenticate itself with the proxy.\n'
  __firstlineno__ = 185
  __module__ = 'keystoneauth1.exceptions.http'
  __static_attributes__ = ()
  http_status = 407
  message = 'Proxy Authentication Required'

exception keystoneauth1.exceptions.http.RequestEntityTooLarge(message: str | None = None, details: str | None = None, response: Response | None = None, request_id: str | None = None, url: str | None = None, method: str | None = None, http_status: int | None = None, retry_after: int = 0)

  Bases: `HTTPClientError`

  HTTP 413 - Request Entity Too Large.

  The request is larger than the server is willing or able to process.

  __annotate_func__ = None
  __annotations_cache__ = {}
  __doc__ = 'HTTP 413 - Request Entity Too Large.\n\nThe request is larger than the server is willing or able to process.\n'
  __firstlineno__ = 249
  __init__(message: str | None = None, details: str | None = None, response: Response | None = None, request_id: str | None = None, url: str | None = None, method: str | None = None, http_status: int | None = None, retry_after: int = 0)
  __module__ = 'keystoneauth1.exceptions.http'
  __static_attributes__ = ('retry_after',)
  http_status = 413
  message = 'Request Entity Too Large'

exception keystoneauth1.exceptions.http.RequestTimeout(message: str | None = None, details: str | None = None, response: Response | None = None, request_id: str | None = None, url: str | None = None, method: str | None = None, http_status: int | None = None, retry_after: int = 0)

  Bases: `HTTPClientError`

  HTTP 408 - Request Timeout.

  The server timed out waiting for the request.

  __annotate_func__ = None
  __annotations_cache__ = {}
  __doc__ = 'HTTP 408 - Request Timeout.\n\nThe server timed out waiting for the request.\n'
  __firstlineno__ = 195
  __module__ = 'keystoneauth1.exceptions.http'
  __static_attributes__ = ()
  http_status = 408
  message = 'Request Timeout'

exception keystoneauth1.exceptions.http.RequestUriTooLong(message: str | None = None, details: str | None = None, response: Response | None = None, request_id: str | None = None, url: str | None = None, method: str | None = None, http_status: int | None = None, retry_after: int = 0)

  Bases: `HTTPClientError`

  HTTP 414 - Request-URI Too Long.

  The URI provided was too long for the server to process.

  __annotate_func__ = None
  __annotations_cache__ = {}
  __doc__ = 'HTTP 414 - Request-URI Too Long.\n\nThe URI provided was too long for the server to process.\n'
  __firstlineno__ = 285
  __module__ = 'keystoneauth1.exceptions.http'
  __static_attributes__ = ()
  http_status = 414
  message = 'Request-URI Too Long'

exception keystoneauth1.exceptions.http.RequestedRangeNotSatisfiable(message: str | None = None, details: str | None = None, response: Response | None = None, request_id: str | None = None, url: str | None = None, method: str | None = None, http_status: int | None = None, retry_after: int = 0)

  Bases: `HTTPClientError`

  HTTP 416 - Requested Range Not Satisfiable.

  The client has asked for a portion of the file, but the server cannot supply that portion.

  __annotate_func__ = None
  __annotations_cache__ = {}
  __doc__ = 'HTTP 416 - Requested Range Not Satisfiable.\n\nThe client has asked for a portion of the file, but the server cannot\nsupply that portion.\n'
  __firstlineno__ = 306
  __module__ = 'keystoneauth1.exceptions.http'
  __static_attributes__ = ()
  http_status = 416
  message = 'Requested Range Not Satisfiable'

exception keystoneauth1.exceptions.http.ServiceUnavailable(message: str | None = None, details: str | None = None, response: Response | None = None, request_id: str | None = None, url: str | None = None, method: str | None = None, http_status: int | None = None, retry_after: int = 0)

  Bases: `HttpServerError`

  HTTP 503 - Service Unavailable.

  The server is currently unavailable.

  __annotate_func__ = None
  __annotations_cache__ = {}
  __doc__ = 'HTTP 503 - Service Unavailable.\n\nThe server is currently unavailable.\n'
  __firstlineno__ = 371
  __module__ = 'keystoneauth1.exceptions.http'
  __static_attributes__ = ()
  http_status = 503
  message = 'Service Unavailable'

exception keystoneauth1.exceptions.http.Unauthorized(message: str | None = None, details: str | None = None, response: Response | None = None, request_id: str | None = None, url: str | None = None, method: str | None = None, http_status: int | None = None, retry_after: int = 0)

  Bases: `HTTPClientError`

  HTTP 401 - Unauthorized.

  Similar to 403 Forbidden, but specifically for use when authentication is required and has failed or has not yet been provided.

  __annotate_func__ = None
  __annotations_cache__ = {}
  __doc__ = 'HTTP 401 - Unauthorized.\n\nSimilar to 403 Forbidden, but specifically for use when authentication\nis required and has failed or has not yet been provided.\n'
  __firstlineno__ = 120
  __module__ = 'keystoneauth1.exceptions.http'
  __static_attributes__ = ()
  http_status = 401
  message = 'Unauthorized'

exception keystoneauth1.exceptions.http.UnprocessableEntity(message: str | None = None, details: str | None = None, response: Response | None = None, request_id: str | None = None, url: str | None = None, method: str | None = None, http_status: int | None = None, retry_after: int = 0)

  Bases: `HTTPClientError`

  HTTP 422 - Unprocessable Entity.

  The request was well-formed but was unable to be followed due to semantic errors.

  __annotate_func__ = None
  __annotations_cache__ = {}
  __doc__ = 'HTTP 422 - Unprocessable Entity.\n\nThe request was well-formed but was unable to be followed due to semantic\nerrors.\n'
  __firstlineno__ = 327
  __module__ = 'keystoneauth1.exceptions.http'
  __static_attributes__ = ()
  http_status = 422
  message = 'Unprocessable Entity'

exception keystoneauth1.exceptions.http.UnsupportedMediaType(message: str | None = None, details: str | None = None, response: Response | None = None, request_id: str | None = None, url: str | None = None, method: str | None = None, http_status: int | None = None, retry_after: int = 0)

  Bases: `HTTPClientError`

  HTTP 415 - Unsupported Media Type.

  The request entity has a media type which the server or resource does not support.

  __annotate_func__ = None
  __annotations_cache__ = {}
  __doc__ = 'HTTP 415 - Unsupported Media Type.\n\nThe request entity has a media type which the server or resource does\nnot support.\n'
  __firstlineno__ = 295
  __module__ = 'keystoneauth1.exceptions.http'
  __static_attributes__ = ()
  http_status = 415
  message = 'Unsupported Media Type'

keystoneauth1.exceptions.http.from_response(response: Response, method: str, url: str) → HttpError | MissingAuthMethods

  Return an instance of `HttpError` or subclass based on response.

  Parameters:

    - response – instance of requests.Response class

    - method – HTTP method used for request

    - url – URL used for request

this page last updated: 2026-03-25 21:01:07

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