文档首页/ 数据接入服务 DIS/ API参考/ API说明/ 通道管理/ 获取租户账户下配额情况 - GetQuotas
更新时间:2026-02-12 GMT+08:00

获取租户账户下配额情况 - GetQuotas

功能介绍

本接口用于获取租户账户下配额情况。

调用方法

请参见如何调用API。

URI

GET /v1/{project_id}/quotas

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释:

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

约束限制:

不涉及

取值范围:

只能由英文字母和数字组成,且长度为[1-64]个字符。

默认取值:

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释:

用户Token,通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。请参见认证鉴权-Token认证。

约束限制:

不涉及

取值范围:

长度为[1-32768]个字符。

默认取值:

不涉及

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

quota

Array of ResourcesResult objects

参数解释:

配额。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

表4 ResourcesResult

参数

参数类型

描述

resources

Array

参数解释:

资源详情。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

items

ResourcesdescriptionResult object

参数解释:

资源详情列表。包含资源的类型、配额、使用情况。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

表5 ResourcesdescriptionResult

参数

参数类型

描述

type

String

参数解释:

资源类型。

约束限制:

不涉及

取值范围:

  • common_partition:普通分区。

  • advanced_partition:高级分区。

  • app: app。

默认取值:

不涉及

quota

Integer

参数解释:

当前资源类型总配额。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

根据资源类型配额默认值不同,普通分区默认总配额50,高级分区默认总10,app分区默认总配额100。

used

Integer

参数解释:

当前资源类型已使用配额。

约束限制:

不涉及

取值范围:

不大于对应资源类型总配额,普通分区不大于50,如高级分区不大于10,app不大于100。

默认取值:

不涉及

请求示例

获取租户账户下配额情况。

GET https://{Endpoint}/v1/{tenantId}/quotas

响应示例

状态码:200

正常返回

{
  "quotas" : {
    "resource" : {
      "type" : "common_partition",
      "quota" : 50,
      "used" : 10
    }
  }
}

状态码

状态码

描述

200

正常返回

错误码

请参见错误码。