文档首页> 分布式缓存服务 DCS> API参考（巴黎区域）> API V2（推荐）> 其他接口> 查询租户配额
更新时间：2023-12-13 GMT+08:00
查看PDF

查询租户配额

功能介绍

查询租户默认可以创建的实例数和总内存的配额限制，以及可以申请配额的最大值和最小值。不同的租户在不同的区域配额可能不同。

URI

GET /v2/{project_id}/quota

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID。获取方法请参见获取项目ID。

请求参数

无

响应参数

状态码： 200

表2 响应Body参数

参数

参数类型

描述

quotas

quotas object

配额信息。
表3 quotas

参数

参数类型

描述

resources

Array of Resources objects

配额列表。
表4 Resources

参数

参数类型

描述

unit

String

资源的计数单位。

  • 当type为instance时，无单位。

  • 当type为ram时，单位为GB。

min

Integer

  • 当type为instance时，表示可申请实例配额的最小值。

  • 当type为ram时，表示可申请内存配额的最小值。

max

Integer

  • 当type为instance时，表示可申请实例配额的最大值。

  • 当type为ram时，表示可申请内存配额的最大值。

quota

Integer

可以创建的实例最大数和总内存的配额限制。

used

Integer

已创建的实例个数和已使用的内存配额。

type

String

支持instance、ram两种。

  • instance表示实例配额。

  • ram表示内存配额。

状态码： 400

表5 响应Body参数

参数

参数类型

描述

error_msg

String

错误信息。

最大长度：1024

error_code

String

错误码。

最大长度：9

error_ext_msg

String

扩展错误信息（暂未使用，赋值为null）。

最大长度：1024

状态码： 500

表6 响应Body参数

参数

参数类型

描述

error_msg

String

错误信息。

最大长度：1024

error_code

String

错误码。

最大长度：9

error_ext_msg

String

扩展错误信息（暂未使用，赋值为null）。

最大长度：1024

请求示例

GET https://{dcs_endpoint}/v2/{project_id}/quota

响应示例

状态码： 200

查询租户配额成功。

{
  "quotas" : {
    "resources" : [ {
      "unit" : { },
      "min" : 1,
      "max" : 10,
      "quota" : 10,
      "used" : 3,
      "type" : "instance"
    }, {
      "unit" : "GB",
      "min" : 1,
      "max" : 800,
      "quota" : 800,
      "used" : 22,
      "type" : "ram"
    } ]
  }
}

状态码

状态码

描述

200

查询租户配额成功。

400

非法请求。

500

内部服务错误。

错误码

请参见错误码。

父主题： 其他接口