文档首页/ 云解析服务 DNS/ API参考 (联盟区域) / API/ 解析器管理/ 查询终端节点VPC列表
更新时间：2026-09-15 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询终端节点VPC列表

功能介绍

查询终端节点VPC列表。

URI

GET /v2.1/vpcs

表1 Query参数

参数

是否必选

参数类型

描述

limit

否

Integer

每页返回的资源个数。

取值范围：0~500

取值一般为10，20，50。默认值为500。

offset

否

Integer

分页查询起始偏移量，表示从偏移量的下一个资源开始查询。

取值范围：0~2147483647

默认值为0。

当前设置marker不为空时，以marker为分页起始标识。

vpc_id

否

String

待查询的VPC的ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。

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

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

vpcs

Array of VpcsData objects

终端节点VPC列表。

metadata

metadata object

返回满足过滤条件的资源总数。
表4 VpcsData

参数

参数类型

描述

id

String

VPC的ID，UUID形式的一个资源标识。

inbound_endpoint_count

Integer

VPC下入站终端节点的数量。

outbound_endpoint_count

Integer

VPC下出站终端节点的数量。
表5 metadata

参数

参数类型

描述

total_count

Integer

满足查询条件的资源总数，不受分页（即limit、offset参数）影响。

请求示例

无

响应示例

状态码：200

查询终端节点VPC列表响应。

{
  "vpcs" : [ {
    "id" : "02443811-acf1-4c22-8f44-e3adf19f6097",
    "inbound_endpoint_count" : 32
  } ],
  "metadata" : {
    "total_count" : 1
  }
}

状态码

状态码

描述

200

查询终端节点VPC列表响应。

错误码

请参见错误码。

父主题： 解析器管理