更新时间:2024-12-27 GMT+08:00

查询配额

功能介绍

查询租户各类资源的使用情况,如企业路由器的使用量,VPC连接的使用量等。

调用方法

请参见如何调用API

URI

GET /v3/{project_id}/enterprise-router/quotas

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID

表2 Query参数

参数

是否必选

参数类型

描述

limit

Integer

每页返回的个数。

取值范围:0~2000。

最小值:0

最大值:2000

marker

String

查询的页码id,为空时为查询第一页。

使用说明:必须与limit一起使用。

最小长度:1

最大长度:128

type

Array of strings

支持过滤的配额类型:

  • er_instance: 企业路由器实例的配额和使用量

  • dc_attachment: 云专线网关连接的配额和使用量

  • vpc_attachment: VPC连接的配额和使用量

  • vpn_attachment: VPN网关连接的配额和使用量

  • route_table: 路由表的配额和使用量

  • static_route: 静态路由的配额和使用量

  • vpc_er: 每个vpc可以接入的企业路由器数量和当前使用量

  • flow_log: 每个连接可以创建的流日志数量

erId

Object

企业路由器ID

routeTableId

Object

路由表ID

vpcId

Object

VPC ID

请求参数

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

quotas

Array of Quota objects

配额使用详情

page_info

PageInfo object

分页查询的信息

表4 Quota

参数

参数类型

描述

quota_key

String

配额类型

quota_limit

Long

可用的配额数,-1 代表不受限制

used

Long

已使用的配额数量

unit

String

用量单位

表5 PageInfo

参数

参数类型

描述

next_marker

String

下一个marker标识,为空时表示最后一页

current_count

Integer

当前列表中资源数量

请求示例

查询配额信息

GET https://{erouter_endpoint}/v3/08d5a9564a704afda6039ae2babbef3c/enterprise-router/quotas

响应示例

状态码: 200

OK

{
  "quotas" : [ {
    "quota_key" : "er_instance",
    "quota_limit" : 1,
    "used" : 0,
    "unit" : "count"
  }, {
    "quota_key" : "dc_attachment",
    "quota_limit" : 2,
    "used" : 0,
    "unit" : "count"
  }, {
    "quota_key" : "route_table",
    "quota_limit" : 20,
    "used" : 5,
    "unit" : "count"
  }, {
    "quota_key" : "static_route",
    "quota_limit" : 500,
    "used" : 2,
    "unit" : "count"
  }, {
    "quota_key" : "can_attachment",
    "quota_limit" : 10,
    "used" : 0,
    "unit" : "count"
  }, {
    "quota_key" : "connect_attachment",
    "quota_limit" : 20,
    "used" : 0,
    "unit" : "count"
  }, {
    "quota_key" : "peering_attachment",
    "quota_limit" : 10,
    "used" : 0,
    "unit" : "count"
  }, {
    "quota_key" : "vpn_attachment",
    "quota_limit" : 10,
    "used" : 0,
    "unit" : "count"
  }, {
    "quota_key" : "flow_log",
    "quota_limit" : 20,
    "used" : 4,
    "unit" : "count"
  } ],
  "page_info" : {
    "next_marker" : "1",
    "current_count" : 9
  }
}

状态码

状态码

描述

200

OK

错误码

请参见错误码