更新时间:2024-08-06 GMT+08:00

查看可用区信息

功能介绍

查看可用区信息

调用方法

请参见如何调用API

URI

GET /v2/{project_id}/apigw/available-zones

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID,获取方式请参见获取项目ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

available_zones

Array of AvailableZone objects

可用区列表

表4 AvailableZone

参数

参数类型

描述

name

String

可用区名称。

id

String

实例创建失败错误信息

code

String

可用区编码。

port

String

可用区端口号。

local_name

LocalName object

可用区中英文名称。

specs

Map<String,Boolean>

可用区支持的实例规格。

表5 LocalName

参数

参数类型

描述

en_us

String

可用区英文名称。

zh_cn

String

可用区中文名称。

状态码: 401

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

状态码: 403

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

状态码: 500

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

请求示例

响应示例

状态码: 200

OK

{
  "available_zones" : [ {
    "code" : "xx-xxx-4a",
    "id" : "effdcbc7d4d64a02aa1fa26b42f56533",
    "local_name" : {
      "en_us" : "AZ1",
      "zh_cn" : "<Name_of_AZ1>"
    },
    "name" : "<Name_of_AZ1>",
    "port" : "8403",
    "specs" : {
      "BASIC" : true,
      "ENTERPRISE" : true,
      "PLATINUM" : true,
      "PROFESSIONAL" : true,
      "TRIAL" : true,
    }
  }, {
    "code" : "xx-xxx-4b",
    "id" : "a0865121f83b41cbafce65930a22a6e8",
    "local_name" : {
      "en_us" : "AZ2",
      "zh_cn" : "<Name_of_AZ2>"
    },
    "name" : "<Name_of_AZ2>",
    "port" : "8404",
    "specs" : {
      "BASIC" : true,
      "ENTERPRISE" : true,
      "PLATINUM" : true,
      "PROFESSIONAL" : true,
      "TRIAL" : true,
    }
  } ]
}

状态码: 401

Unauthorized

{
  "error_code" : "APIC.7102",
  "error_msg" : "Incorrect token or token resolution failed"
}

状态码: 403

Forbidden

{
  "error_code" : "APIC.7106",
  "error_msg" : "No permissions to request for the method"
}

状态码: 500

Internal Server Error

{
  "error_code" : "APIC.9000",
  "error_msg" : "Failed to request internal service"
}

状态码

状态码

描述

200

OK

401

Unauthorized

403

Forbidden

500

Internal Server Error

错误码

请参见错误码