更新时间:2025-08-08 GMT+08:00
分享

查询配额

功能介绍

该API用于获取用户配额信息列表。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

GET /v3/{project_id}/quotas

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目编号,用于资源隔离。获取方式请参考获取项目ID

请求参数

响应参数

状态码: 200

表2 响应Body参数

参数

参数类型

描述

is_success

Boolean

是否查询成功。

quotas

object

配额信息列表。请参考表3

表3 quotas

参数

参数类型

描述

resources

Array of objects

配额资源详细信息。请参考表4

表4 resources

参数

参数类型

描述

type

String

配额类型。

  • CU:计算单元
  • QUEUE:资源队列
  • DATABASE:数据库
  • TABLE:表
  • TEMPLATE:模板
  • SL_PKG_RESOURCE:Spark资源包
  • SL_SESSION:Spark会话
  • JOB_CU:作业计算单元
  • IAM_USER:IAM用户数
  • ELASTIC_RESOURCE_POOL:弹性资源池

min

Integer

配额的最小值。

max

Integer

配额的最大值。

quota

Integer

目前的配额。

used

Integer

已用的配额。

状态码: 400

表5 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述信息。

状态码: 500

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述信息。

请求示例

响应示例

{
 "quotas": {
  "resources": [
   {
    "type": "CU",
    "min": 0,
    "max": 100000,
    "quota": 2500,
    "used": 992
   },
   {
    "type": "QUEUE",
    "min": 0,
    "max": 1000,
    "quota": 50000,
    "used": 53
   },
   {
    "type": "DATABASE",
    "min": 0,
    "max": 500,
    "quota": 1000,
    "used": 593
   },
   {
    "type": "TABLE",
    "min": 0,
    "max": 10000,
    "quota": 50000,
    "used": 8548
   },
   {
    "type": "TEMPLATE",
    "min": 0,
    "max": 10000,
    "quota": 1000,
    "used": 130
   },
   {
    "type": "SL_PKG_RESOURCE",
    "min": 0,
    "max": 2000,
    "quota": 50000,
    "used": 525
   },
   {
    "type": "SL_SESSION",
    "min": 0,
    "max": 1000,
    "quota": 300,
    "used": 2
   },
   {
    "type": "JOB_CU",
    "min": 0,
    "max": 400,
    "quota": 400,
    "used": 0
   },
   {
    "type": "ELASTIC_RESOURCE_POOL",
    "min": 0,
    "max": 1024,
    "quota": 5000,
    "used": 3
   }
  ]
 },
 "is_success": true
}

状态码

状态码

描述

200

返回结果。

400

错误类型及描述。

500

内部服务器错误。

错误码

请参见错误码

相关文档