OpenStack API Documentation

Octavia API

This is a reference for the OpenStack Load Balancing API which is provided by the Octavia project.

Current API version

Supported API version

Deprecated API version

None

The API status reflects the state of the endpoint on the service.

  • Current indicates a stable version that is up-to-date, recent, and might receive future versions. This endpoint should be prioritized over all others.
  • Supported is a stable version that is available on the server. However, it is not likely the most recent available and might not be updated or might be deprecated at some time in the future.
  • Deprecated is a stable version that is still available but is being deprecated and might be removed in the future.
  • Experimental is not a stable version. This version is under development or contains features that are otherwise subject to change. For more information about API status values and version information, see Version Discovery.

API Discovery

GET
/

List All Major Versions

This fetches all the information about all known major API versions in the deployment.

Response codes

Success
Code Reason
200 - OK Request was successful.
Error
Code Reason
500 - Internal Server Error Something went wrong with the service which prevents it from fulfilling the request.

Response

Name In Type Description
id body string A common name for the version.
status body string

The status of this API version. This can be one of:

  • CURRENT: This is the preferred version of the API to use.
  • SUPPORTED: This is an older, but still supported version of the API.
  • DEPRECATED: A deprecated version of the API that is slated for removal.
updated_at body string The UTC date and timestamp when the resource was last updated.

Response Example

{
    "versions": [
        {
            "id": "v2.0",
            "status": "CURRENT",
            "updated": "2017-02-17T00:00:00Z"
        },
        {
            "id": "v1",
            "status": "DEPRECATED",
            "updated": "2014-12-11T00:00:00Z"
        }
    ]
}

Note

This is just an example output and does not represent the current API versions available.

Creative Commons Attribution 3.0 License

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