文档首页/ 智能体开发平台 AgentArts/ API参考/ API/ 评估/ 配额管理/ 获取当前项目的配额 - ShowOpsQuota
更新时间:2026-04-15 GMT+08:00
分享

获取当前项目的配额 - ShowOpsQuota

功能介绍

该接口用于获取当前项目的配额信息,支持查询各类任务的数量上限和剩余配额,适用于资源管理和容量规划的场景。

适用场景:

  • 任务创建前查询当前项目的资源限制和剩余容量,避免因配额不足导致任务创建失败。

  • 查看各类任务的已用配额和总量,掌握项目的资源消耗状况。

  • 当配额接近上限时,通过查询结果进行容量规划和预警。

URI

GET /v1/ops/quotas

表1 Query参数

参数

是否必选

参数类型

描述

task_type

String

参数解释:

任务的类型分类标识。该参数用于在查询列表时进行过滤,以便区分并获取特定类别的任务(例如:评估任务、数据合成任务等)。

约束限制:

字符串长度为0到1,200。

取值范围:

0-1200字符。

默认取值:

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

String

参数解释:

消息体编码格式。用于告知服务端请求体(Body)所采用的主体数据类型,以便服务端正确解析。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

application/json

Authorization

String

参数解释:

签名认证信息,当使用AK/SK方式认证时,使用SDK对请求进行签名的过程中会自动填充该字段。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

X-Sdk-Date

String

参数解释:

请求发送的时间,当使用AK/SK方式认证时,使用SDK对请求进行签名的过程中会自动填充该字段。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

quotas

Array of QuotaItem objects

参数解释:

当前项目下的任务配额信息列表。

取值范围:

不涉及。

表4 QuotaItem

参数

参数类型

描述

task_type

String

参数解释:

任务的类型分类。

约束限制:

长度为0到10000个字符。

取值范围:

不涉及。

默认取值:

不涉及。

total_task_count

Long

参数解释:

当前已消耗的任务总数。

约束限制:

0到int64 最大值。

取值范围:

0到9223372036854775807。

默认取值:

0。

free_task_quota_limit

Long

参数解释:

免费任务的配额上限。

约束限制:

0到int64 最大值。

取值范围:

0到9223372036854775807。

默认取值:

0。

状态码:400

表5 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

系统定义的标准化错误代码。

取值范围:

业务异常编码字符串。

error_msg

String

参数解释:

对错误的详细描述,包含异常原因或解决建议。

取值范围:

任意文本内容。

请求示例

请求获取当前项目的配额信息

GET https://*.com/agentarts/v1/ops/quotas

响应示例

状态码:200

查询成功

{
  "quotas" : [ {
    "task_type" : "evaluation",
    "total_task_count" : 10,
    "free_task_quota_limit" : 10
  } ]
}

状态码:400

错误请求

{
  "error_code" : "AgentArts.03400001",
  "error_msg" : "请求错误"
}

状态码

状态码

描述

200

查询成功

400

错误请求

错误码

请参见错误码

相关文档