全栈应用服务器 > API 文档 > 查询区域列表

查询区域列表

最近更新时间: 2025-10-31 14:06:11

查询区域列表

接口描述

查询全栈应用服务器支持的区域列表，可以根据资源类型进行筛选，支持多语言显示。

请求方法

GET /v1/regions/list?resource=<resource>&language=<language>

请求参数

参数名称	参数类型	是否必填	描述	可选值
resource	string	否	资源类型，如果为空，则返回所有区域	cpu, gpu
language	string	否	区域名称的语言类型，如果是 zh-CN 代表返回中文的名称，如果是 en-US 代表返回英文的名称。如果为空，则返回中文的名称	zh-CN, en-US

请求示例

GET /v1/regions/list?resource=cpu&language=zh-CN HTTP/1.1
Host: las-api.qiniu.com
Authorization: Qiniu <AccessToken>
X-Qiniu-Date: 20250924T040050Z

响应示例

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
X-Reqid: vF0AALFqqjECHGgY

{
   "regions": [
      {
         "id": "ap-northeast-1",
         "is_china_mainland": false,
         "name": "日本（东京1）",
         "resource": {
            "cpu": {
               "state": "available",
               "support": true
            }
         }
      },
      {
         "id": "ap-southeast-1",
         "is_china_mainland": false,
         "name": "新加坡",
         "resource": {
            "cpu": {
               "state": "available",
               "support": true
            },
            "gpu": {
               "state": "available",
               "support": true
            }
         }
      },
      {
         "id": "cn-changshan-1",
         "is_china_mainland": true,
         "name": "中国（常山1）",
         "resource": {
            "cpu": {
               "state": "available",
               "support": true
            }
         }
      },
   ],
   ... // 其他区域
}

响应字段

字段名	类型	说明
id	string	区域的唯一标识符
name	string	区域的对应语言的名称
is_china_mainland	boolean	是否是中国大陆区域
resource	object	区域支持的资源类型
resource.cpu	object	CPU 资源信息。如果存在，表示支持 CPU 资源；如果为 null，表示不支持纯 CPU 的虚拟机
resource.gpu	object	GPU 资源信息。如果存在，表示支持 GPU 资源；如果为 null，表示不支持 GPU 的虚拟机
resource.*.support	boolean	是否支持该类型资源
resource.*.state	string	资源状态，可能的取值：`available`（可用）、`exhausted`（资源不足）

以上内容是否对您有帮助？