全部产品
Search
文档中心

负载均衡:DescribeZones - 查询可用区

更新时间:May 17, 2024

查询NLB一个地域下的可用区列表。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
ServiceCodestring

云产品的 ServiceCode,仅取值:nlb

nlb
RegionIdstring

可用区所在的地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。

cn-hangzhou
AcceptLanguagestring

支持的语言。取值:

  • zh-CN:中文
  • en-US(默认):英文
  • ja:日文
zh-CN
ClientTokenstring

客户端 Token,用于保证请求的幂等性。

从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符。

说明 若您未指定,则系统自动使用 API 请求的 RequestId 作为 ClientToken 标识。每次 API 请求的 RequestId 可能不一样。
123e4567-e89b-12d3-a456-426655440000

返回参数

名称类型描述示例值
object

返回数据的结构。

RequestIdstring

请求 ID。

CEF72CEB-54B6-4AE8-B225-F876FF7BA984
Zonesobject []

可用区列表。

LocalNamestring

可用区名称。

杭州 可用区G
ZoneIdstring

可用区 ID。

cn-hangzhou-g

示例

正常返回示例

JSON格式

{
  "RequestId": "CEF72CEB-54B6-4AE8-B225-F876FF7BA984",
  "Zones": [
    {
      "LocalName": "杭州 可用区G",
      "ZoneId": "cn-hangzhou-g"
    }
  ]
}

错误码

HTTP status code错误码错误信息描述
400IllegalParam.AcceptLanguageThe param of AcceptLanguage[%s] is illegal from bundle %sAcceptLanguage 参数[%s] 非法。
400SystemBusySystem is busy, please try again later.系统繁忙,请稍后重试
400IllegalParamThe param of %s is illegal.输入的参数有值非法,请检查输入。

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2023-10-09OpenAPI 错误码发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    错误码 400 变更
2023-09-26OpenAPI 错误码发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    错误码 400 变更
2023-09-05OpenAPI 错误码发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    错误码 400 变更
2023-08-22OpenAPI 错误码发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    新增错误码:400