The congressclient.exceptions Module

Exception definitions.

exception congressclient.exceptions.AmbiguousEndpoints(endpoints=None)

Bases: congressclient.exceptions.EndpointException

Found more than one matching endpoint in Service Catalog.

exception congressclient.exceptions.AuthPluginOptionsMissing(opt_names)

Bases: congressclient.exceptions.AuthorizationFailure

Auth plugin misses some options.

exception congressclient.exceptions.AuthSystemNotFound(auth_system)

Bases: congressclient.exceptions.AuthorizationFailure

User has specified an AuthSystem that is not installed.

exception congressclient.exceptions.AuthorizationFailure

Bases: congressclient.exceptions.ClientException

Cannot authorize API client.

exception congressclient.exceptions.BadGateway(message=None, details=None, response=None, request_id=None, url=None, method=None, http_status=None)

Bases: congressclient.exceptions.HttpServerError

HTTP 502 - Bad Gateway.

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

http_status = 502
message = u’Bad Gateway’
exception congressclient.exceptions.BadRequest(message=None, details=None, response=None, request_id=None, url=None, method=None, http_status=None)

Bases: congressclient.exceptions.HTTPClientError

HTTP 400 - Bad Request.

The request cannot be fulfilled due to bad syntax.

http_status = 400
message = u’Bad Request’
exception congressclient.exceptions.ClientException

Bases: exceptions.Exception

The base exception class for all exceptions this library raises.

exception congressclient.exceptions.CommandError

Bases: congressclient.exceptions.ClientException

Error in CLI tool.

exception congressclient.exceptions.Conflict(message=None, details=None, response=None, request_id=None, url=None, method=None, http_status=None)

Bases: congressclient.exceptions.HTTPClientError

HTTP 409 - Conflict.

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

http_status = 409
message = u’Conflict’
exception congressclient.exceptions.ConnectionRefused

Bases: congressclient.exceptions.ClientException

Cannot connect to API service.

exception congressclient.exceptions.EndpointException

Bases: congressclient.exceptions.ClientException

Something is rotten in Service Catalog.

exception congressclient.exceptions.EndpointNotFound

Bases: congressclient.exceptions.EndpointException

Could not find requested endpoint in Service Catalog.

exception congressclient.exceptions.ExpectationFailed(message=None, details=None, response=None, request_id=None, url=None, method=None, http_status=None)

Bases: congressclient.exceptions.HTTPClientError

HTTP 417 - Expectation Failed.

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

http_status = 417
message = u’Expectation Failed’
exception congressclient.exceptions.Forbidden(message=None, details=None, response=None, request_id=None, url=None, method=None, http_status=None)

Bases: congressclient.exceptions.HTTPClientError

HTTP 403 - Forbidden.

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

http_status = 403
message = u’Forbidden’
exception congressclient.exceptions.GatewayTimeout(message=None, details=None, response=None, request_id=None, url=None, method=None, http_status=None)

Bases: congressclient.exceptions.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.

http_status = 504
message = u’Gateway Timeout’
exception congressclient.exceptions.Gone(message=None, details=None, response=None, request_id=None, url=None, method=None, http_status=None)

Bases: congressclient.exceptions.HTTPClientError

HTTP 410 - Gone.

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

http_status = 410
message = u’Gone’
exception congressclient.exceptions.HTTPClientError(message=None, details=None, response=None, request_id=None, url=None, method=None, http_status=None)

Bases: congressclient.exceptions.HttpError

Client-side HTTP error.

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

message = u’HTTP Client Error’
exception congressclient.exceptions.HTTPRedirection(message=None, details=None, response=None, request_id=None, url=None, method=None, http_status=None)

Bases: congressclient.exceptions.HttpError

HTTP Redirection.

message = u’HTTP Redirection’
exception congressclient.exceptions.HttpError(message=None, details=None, response=None, request_id=None, url=None, method=None, http_status=None)

Bases: congressclient.exceptions.ClientException

The base exception class for all HTTP exceptions.

http_status = 0
message = u’HTTP Error’
exception congressclient.exceptions.HttpNotImplemented(message=None, details=None, response=None, request_id=None, url=None, method=None, http_status=None)

Bases: congressclient.exceptions.HttpServerError

HTTP 501 - Not Implemented.

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

http_status = 501
message = u’Not Implemented’
exception congressclient.exceptions.HttpServerError(message=None, details=None, response=None, request_id=None, url=None, method=None, http_status=None)

Bases: congressclient.exceptions.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.

message = u’HTTP Server Error’
exception congressclient.exceptions.HttpVersionNotSupported(message=None, details=None, response=None, request_id=None, url=None, method=None, http_status=None)

Bases: congressclient.exceptions.HttpServerError

HTTP 505 - HttpVersion Not Supported.

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

http_status = 505
message = u’HTTP Version Not Supported’
exception congressclient.exceptions.InternalServerError(message=None, details=None, response=None, request_id=None, url=None, method=None, http_status=None)

Bases: congressclient.exceptions.HttpServerError

HTTP 500 - Internal Server Error.

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

http_status = 500
message = u’Internal Server Error’
exception congressclient.exceptions.LengthRequired(message=None, details=None, response=None, request_id=None, url=None, method=None, http_status=None)

Bases: congressclient.exceptions.HTTPClientError

HTTP 411 - Length Required.

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

http_status = 411
message = u’Length Required’
exception congressclient.exceptions.MethodNotAllowed(message=None, details=None, response=None, request_id=None, url=None, method=None, http_status=None)

Bases: congressclient.exceptions.HTTPClientError

HTTP 405 - Method Not Allowed.

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

http_status = 405
message = u’Method Not Allowed’
exception congressclient.exceptions.MissingArgs(missing)

Bases: congressclient.exceptions.ClientException

Supplied arguments are not sufficient for calling a function.

exception congressclient.exceptions.MultipleChoices(message=None, details=None, response=None, request_id=None, url=None, method=None, http_status=None)

Bases: congressclient.exceptions.HTTPRedirection

HTTP 300 - Multiple Choices.

Indicates multiple options for the resource that the client may follow.

http_status = 300
message = u’Multiple Choices’
exception congressclient.exceptions.NoUniqueMatch

Bases: congressclient.exceptions.ClientException

Multiple entities found instead of one.

exception congressclient.exceptions.NotAcceptable(message=None, details=None, response=None, request_id=None, url=None, method=None, http_status=None)

Bases: congressclient.exceptions.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.

http_status = 406
message = u’Not Acceptable’
exception congressclient.exceptions.NotFound(message=None, details=None, response=None, request_id=None, url=None, method=None, http_status=None)

Bases: congressclient.exceptions.HTTPClientError

HTTP 404 - Not Found.

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

http_status = 404
message = u’Not Found’
exception congressclient.exceptions.PaymentRequired(message=None, details=None, response=None, request_id=None, url=None, method=None, http_status=None)

Bases: congressclient.exceptions.HTTPClientError

HTTP 402 - Payment Required.

Reserved for future use.

http_status = 402
message = u’Payment Required’
exception congressclient.exceptions.PreconditionFailed(message=None, details=None, response=None, request_id=None, url=None, method=None, http_status=None)

Bases: congressclient.exceptions.HTTPClientError

HTTP 412 - Precondition Failed.

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

http_status = 412
message = u’Precondition Failed’
exception congressclient.exceptions.ProxyAuthenticationRequired(message=None, details=None, response=None, request_id=None, url=None, method=None, http_status=None)

Bases: congressclient.exceptions.HTTPClientError

HTTP 407 - Proxy Authentication Required.

The client must first authenticate itself with the proxy.

http_status = 407
message = u’Proxy Authentication Required’
exception congressclient.exceptions.RequestEntityTooLarge(*args, **kwargs)

Bases: congressclient.exceptions.HTTPClientError

HTTP 413 - Request Entity Too Large.

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

http_status = 413
message = u’Request Entity Too Large’
exception congressclient.exceptions.RequestTimeout(message=None, details=None, response=None, request_id=None, url=None, method=None, http_status=None)

Bases: congressclient.exceptions.HTTPClientError

HTTP 408 - Request Timeout.

The server timed out waiting for the request.

http_status = 408
message = u’Request Timeout’
exception congressclient.exceptions.RequestUriTooLong(message=None, details=None, response=None, request_id=None, url=None, method=None, http_status=None)

Bases: congressclient.exceptions.HTTPClientError

HTTP 414 - Request-URI Too Long.

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

http_status = 414
message = u’Request-URI Too Long’
exception congressclient.exceptions.RequestedRangeNotSatisfiable(message=None, details=None, response=None, request_id=None, url=None, method=None, http_status=None)

Bases: congressclient.exceptions.HTTPClientError

HTTP 416 - Requested Range Not Satisfiable.

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

http_status = 416
message = u’Requested Range Not Satisfiable’
exception congressclient.exceptions.ServiceUnavailable(message=None, details=None, response=None, request_id=None, url=None, method=None, http_status=None)

Bases: congressclient.exceptions.HttpServerError

HTTP 503 - Service Unavailable.

The server is currently unavailable.

http_status = 503
message = u’Service Unavailable’
exception congressclient.exceptions.Unauthorized(message=None, details=None, response=None, request_id=None, url=None, method=None, http_status=None)

Bases: congressclient.exceptions.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.

http_status = 401
message = u’Unauthorized’
exception congressclient.exceptions.UnprocessableEntity(message=None, details=None, response=None, request_id=None, url=None, method=None, http_status=None)

Bases: congressclient.exceptions.HTTPClientError

HTTP 422 - Unprocessable Entity.

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

http_status = 422
message = u’Unprocessable Entity’
exception congressclient.exceptions.UnsupportedMediaType(message=None, details=None, response=None, request_id=None, url=None, method=None, http_status=None)

Bases: congressclient.exceptions.HTTPClientError

HTTP 415 - Unsupported Media Type.

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

http_status = 415
message = u’Unsupported Media Type’
exception congressclient.exceptions.UnsupportedVersion

Bases: congressclient.exceptions.ClientException

User is trying to use an unsupported version of the API.

exception congressclient.exceptions.ValidationError

Bases: congressclient.exceptions.ClientException

Error in validation on API client side.

congressclient.exceptions.from_response(response, method, url)

Returns 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