Octavia API

这是由 Octavia 项目提供的 OpenStack 负载均衡 API 的参考。

当前 API 版本

支持的 API 版本

Octavia API 的次要版本是 API 主要修订版的补充,并共享相同的 URL 路径。API 的次要修订版更改会在 API 参考中,在发生更改的部分中说明。后续的次要版本是相同主要修订版之前版本的超集。

API 状态反映了服务上端点的状态。

  • 当前 表示一个稳定、最新且可能接收未来版本的版本。应优先使用此端点。

  • 支持的 是服务器上可用的稳定版本。但是,它可能不是最新的可用版本,并且可能在将来被更新或弃用。

  • 已弃用 是仍然可用的稳定版本,但正在弃用,并且将来可能会被删除。

  • 实验性 不是一个稳定版本。此版本正在开发中,或包含以其他方式可能发生更改的功能。有关 API 状态值和版本信息的更多信息,请参阅 版本发现

API 发现

GET
/

列出所有版本

这将获取有关部署中所有已知 API 版本的所有信息。

响应代码

成功

代码

原因

200 - 正常

请求成功。

错误

代码

原因

500 - 内部服务器错误

服务出现问题,导致无法满足请求。

响应

名称

入参

类型

描述

id

body

字符串

版本的通用名称。

links

body

数组

相对链接列表。包括 API 的 self 链接。

status

body

字符串

此 API 版本的状态。它可以是以下之一:

  • CURRENT:这是要使用的 API 的首选版本。

  • SUPPORTED:这是 API 的较旧版本,但仍然受支持。

  • DEPRECATED:一个计划删除的已弃用 API 版本。

updated_at

body

字符串

上次更新资源的 UTC 日期和时间戳。

响应示例

{
  "versions": [{
    "status": "SUPPORTED",
    "updated": "2016-12-11T00:00:00Z",
    "id": "v2.0",
    "links": [{
      "href": "http://10.21.21.53/load-balancer/v2",
      "rel": "self"
    }]
  }, {
    "status": "CURRENT",
    "updated": "2018-04-20T00:00:00Z",
    "id": "v2.1",
    "links": [{
      "href": "http://10.21.21.53/load-balancer/v2",
      "rel": "self"
    }]
  }]
}

注意

这只是一个示例输出,并不代表当前可用的 API 版本。