- 最新动态
- 功能总览
- 产品介绍
- 计费说明
- 快速入门
- 用户指南
-
最佳实践
- 企业路由器最佳实践汇总
- 通过企业路由器和云连接中心网络实现跨区域VPC互通
- 通过企业路由器实现同区域VPC隔离
- 通过企业路由器和第三方防火墙实现多VPC互访流量清洗
- 通过企业路由器和中转VPC构建组网
- 通过企业路由器和云专线构建混合云组网（全域接入网关DGW）
- 通过企业路由器构建DC双链路负载混合云组网（全域接入网关DGW）
- 通过企业路由器构建DC双链路主备混合云组网（全域接入网关DGW）
- 通过企业路由器构建DC/VPN双链路主备混合云组网（全域接入网关DGW）
- 通过企业路由器和云专线实现线下IDC和云上VPC互通（虚拟网关VGW）
- 通过企业路由器构建DC双链路负载混合云组网（虚拟网关VGW）
- 通过企业路由器构建DC/VPN双链路主备混合云组网（虚拟网关VGW）
- 通过企业路由器和NAT网关实现多个VPC共享SNAT访问公网
- 将VPC对等连接组网迁移至企业路由器
- 将DC直连VPC组网迁移至企业路由器（全域接入网关DGW）
- 将云连接实例直连VPC组网迁移至中心网络和企业路由器
- API参考
- 常见问题
- 更多文档
- 通用参考
链接复制成功！
查询企业路由器列表
功能介绍
查询企业路由器列表
接口约束
-
分页查询使用的参数为marker、limit。marker和limit一起使用时才会生效，单独使用无效。
-
支持单字段排序，排序字段有[id,name,description,created_at,updated_at]，不支持多字段排序。
调用方法
请参见如何调用API。
URI
GET /v3/{project_id}/enterprise-router/instances
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
项目ID |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
limit |
否 |
Integer |
每页返回的个数。 取值范围：0~2000。 最小值：0 最大值：2000 |
|
marker |
否 |
String |
查询的页码id，为空时为查询第一页。 使用说明：必须与limit一起使用。 最小长度：1 最大长度：128 |
|
enterprise_project_id |
否 |
Array of strings |
企业项目ID |
|
state |
否 |
Array of strings |
资源状态:pending|available|modifying|deleting|deleted|failed|freezed |
|
id |
否 |
Array of strings |
根据资源ID查询，可同时查询多个。 |
|
resource_id |
否 |
Array of strings |
连接对应的资源ID列表 |
|
owned_by_self |
否 |
Boolean |
过滤资源是否属于当前租户；取值为true时，只查属于当前租户的资源，不包括共享资源；为false时，查询当前租户及共享给该租户的资源； |
|
sort_key |
否 |
Array of strings |
按关键字排序，默认按照id排序，可选值:id|name|state |
|
sort_dir |
否 |
Array of strings |
返回结果按照升序或降序排列，默认为asc,降序为desc |
请求参数
无
响应参数
状态码： 200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
instances |
Array of EnterpriseRouter objects |
企业路由器列表 |
|
page_info |
PageInfo object |
分页查询的信息 |
|
request_id |
String |
请求ID |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
String |
企业路由器实例的ID |
|
name |
String |
企业路由器实例名称 |
|
description |
String |
企业路由器实例描述信息 |
|
state |
String |
运行状态:pending|available|modifying|deleting|deleted|failed |
|
tags |
Array of Tag objects |
标签信息 |
|
charge_mode |
String |
计费模式 按需 缺省值：postPaid |
|
created_at |
String |
创建时间,格式:YYYY-MM-DDTHH:mm:ss.sssZ |
|
updated_at |
String |
更新时间,格式:YYYY-MM-DDTHH:mm:ss.sssZ |
|
enterprise_project_id |
String |
企业项目ID |
|
project_id |
String |
项目ID |
|
asn |
Long |
企业路由器实例的BGP AS号 |
|
enable_default_propagation |
Boolean |
是否开启默认路由表传播，默认false不开启 |
|
enable_default_association |
Boolean |
是否开启默认路由表关联，默认false不开启 |
|
default_propagation_route_table_id |
String |
默认传播路由表id |
|
default_association_route_table_id |
String |
默认关联路由表id |
|
availability_zone_ids |
Array of strings |
企业路由器所在可用区信息 |
|
auto_accept_shared_attachments |
Boolean |
是否自动接受共享连接创建，默认false不开启 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
key |
String |
标签键，规则：
最小长度：1 最大长度：128 |
|
value |
String |
标签值，规则：
最小长度：0 最大长度：255 |
请求示例
-
分页查询2两条记录
GET https://{erouter_endpoint}/v3/08d5a9564a704afda6039ae2babbef3c/enterprise-router/instances?limit=2&marker=1 -
全量查询
GET https://{erouter_endpoint}/v3/08d5a9564a704afda6039ae2babbef3c/enterprise-router/instances
响应示例
状态码： 200
OK
{
"instances" : [ {
"id" : "94c2b814-99dc-939a-e811-ae84c61ea3ff",
"name" : "my_er",
"description" : "this is my first enterprise router",
"asn" : 64512,
"project_id" : "08d5a9564a704afda6039ae2babbef3c",
"enable_default_association" : true,
"enable_default_propagation" : true,
"default_association_route_table_id" : "7f7f738f-453c-40b1-be26-28e7b9e390c1",
"default_propagation_route_table_id" : "7f7f738f-453c-40b1-be26-28e7b9e390c1",
"auto_accept_shared_attachments" : false,
"created_at" : "2019-09-06 02:11:13Z",
"updated_at" : "2019-09-06 02:11:13Z",
"tags" : [ {
"key" : "key",
"value" : "value"
} ],
"enterprise_project_id" : 0,
"availability_zone_ids" : [ "az1", "az2" ],
"domain_id" : "8c22c15f64ee4126b6849bb6a8152ac1"
} ],
"request_id" : "915a14a6-867b-4af7-83d1-70efceb146f9",
"page_info" : {
"next_marker" : "2",
"current_count" : 1
}
}状态码
|
状态码 |
描述 |
|---|---|
|
200 |
OK |
错误码
请参见错误码。
