基本信息

Action

DescribeZones

Path

/iaas

Method

GET

请求参数

此接口除公共参数外，还包含以下参数。关于公共参数的更多信息，请参见前文内容。

参数名 类型 描述 是否必须

zones.n

String

区域 ID

否

status.n

String

区域状态，有效值为 active、faulty、defunct。

否

返回数据

此接口除了返回公共响应参数外，还返回以下参数。关于公共响应参数的更多信息，请参见前文内容。

参数名 类型 描述

zone_set

Array

JSON 格式的区域数据列表，每项数据可见下文。

total_count

Integer

根据过滤条件得到的区域总数

zone_set 参数说明如下。

参数名 类型 描述

zone_id

String

区域 ID

status

String

区域状态，有效值说明如下。

  • active 表示正常开放

  • faulty 表示不可用

  • defunct 表示已报废

请求示例

https://api.<your_domain>/iaas/?action=DescribeZones
&COMMON_PARAMS

返回示例

{
  "action":"DescribeZonesResponse",
  "total_count":1,
  "zone_set":[
    {
      "status":"active",
      "zone_id":pek3a
    },
    {
      "status":"active",
      "zone_id":gd2
    },
    {
      "status":"active",
      "zone_id":ap2a
    }
  ],
  "ret_code":0
}