更新时间:2026-01-16 GMT+08:00

查询API版本列表信息

功能介绍

查询当前ELB服务所有可用的API版本。通常情况下高版本API(当前v3为最高版本)比低版本API支持更多更全的特性。

不同版本接口使用时需要注意如下事项:

  • 创建负载均衡器(POST /v3/{project_id}/elb/loadbalancers)接口无法创建共享型ELB实例。需要通过v2/v2.0接口创建,或者通过批量创建负载均衡器(/v3/{project_id}/elb/loadbalancers/batch-create)、复制已有负载均衡器(/v3/{project_id}/elb/loadbalancers/{loadbalancer_id}/clone)这两个接口创建。

  • 其他v3接口都可以同时处理独享型和共享型实例及其子资源。例如:可以使用创建监听器接口(POST /v3/{project_id}/elb/listeners)创建共享型ELB下的监听器。但在这种情况下部分独享型实例特有的特性将不会支持,具体见各API说明。

调用方法

请参见如何调用API。

URI

GET /versions

请求参数

无

响应参数

状态码:200

表1 响应Body参数

参数

参数类型

描述

versions

Array of ApiVersionInfo objects

参数解释:可用API版本列表。

表2 ApiVersionInfo

参数

参数类型

描述

id

String

参数解释:API版本号。

取值范围:由高到低版本分别为v3,v2,v2.0。

status

String

参数解释:API版本的状态。

取值范围:

  • CURRENT:当前版本,当前所支持的API版本中最高的版本。

  • STABLE:稳定版本,其他可用版本。

  • DEPRECATED:废弃版本。

请求示例

查询负载均衡服务的API版本列表信息

GET https://{ELB_Endpoint}/versions

响应示例

无

状态码

状态码

描述

200

操作正常返回。

错误码

请参见错误码。