更新时间:2025-08-20 GMT+08:00
        
          
          
        
      
      
      
      
      
      
      
      
      
      
      
      
      
      
      
      
  
      
      
      
        
查询所有的可用分区信息
功能介绍
查询所有的可用分区信息。
调用方法
请参见如何调用API。
URI
GET /v2/{project_id}/os-availability-zone
| 参数 | 是否必选 | 参数类型 | 描述 | 
|---|---|---|---|
| project_id | 是 | String | 项目ID。 获取方法请参见"获取项目ID"。 | 
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 | 
|---|---|---|---|
| X-Auth-Token | 是 | String | 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 | 
响应参数
状态码:200
| 参数 | 参数类型 | 描述 | 
|---|---|---|
| availabilityZoneInfo | Array of AzInfo objects | 查询请求返回的可用分区列表。 | 
状态码:400
| 参数 | 参数类型 | 描述 | 
|---|---|---|
| error | Error object | 参数解释 出现错误时,返回的错误信息。 取值范围 不涉及。 | 
| 参数 | 参数类型 | 描述 | 
|---|---|---|
| code | String | 参数解释 出现错误时,返回的错误码。 取值范围 错误码和其对应的含义请参考错误码说明。 | 
| message | String | 参数解释 出现错误时,返回的错误消息。 取值范围 不涉及。 | 
请求示例
GET https://{endpoint}/v2/{project_id}/os-availability-zone
  响应示例
状态码:200
OK
{
  "availabilityZoneInfo" : [ {
    "zoneState" : {
      "available" : true
    },
    "zoneName" : "az-dc-1"
  } ]
}
   状态码:400
Bad Request
{
  "error" : {
    "message" : "XXXX",
    "code" : "EVS.XXX"
  }
}
  状态码
| 状态码 | 描述 | 
|---|---|
| 200 | OK | 
| 400 | Bad Request | 
错误码
请参见错误码。
 
    