DataWorks Data Agent 默认无 Token 用量限制，免费额度用完后触发按量计费。当您需要通过管控Token额度从而控制成本时，管理员可以在管理中心设置租户级和用户级的 Token 用量上限，按统计周期独立管控，防止成本失控。
功能概述
Token 限额支持两个独立管控维度，可分别启用或组合使用：
限额维度 | 统计周期 | 限制对象 |
租户限额 | 按月、按周 | 整个租户（所有 RAM 用户和角色） |
用户限额 | 每周、每 5 小时 | 单个 RAM 用户或角色 |
两个维度独立管控，任意一个达到上限即触发限制。两个维度均未开启时，Token 消耗不受限制，免费额度用完后触发按量计费。
因 Token 统计存在时延，实际用量可能少量超出限额。
权限说明
操作 | 所需权限 |
配置限额（租户限额、用户限额） | 租户管理员或已授予 |
查看限额状态 | 不限，所有用户均可查看，且每个用户只能看到租户限额以及当前登录账号的用户限额。 |
配置租户限额
登录 DataWorks 管理中心，在左侧导航栏选择。
在租户限额卡片中，开启租户限额开关。
在操作列单击调整上限。
分别启用或关闭每月和每周周期，为已启用的周期设置用量上限。
单击确认。
配置完成后，表格中展示每个周期的消耗与上限、使用率进度条、周期起止时间和下次重置时间。
配置用户限额
逐个调整
在用户限额卡片中，开启用户限额开关。
在用户列表中找到目标用户，在操作列单击调整上限。
在弹窗中启用每周周期，设置每周用量上限。
单击确认。
每 5 小时的限额按每周限额除以 34 自动计算。
批量调整
在用户列表中勾选多个用户。
单击批量调整上限。
统一设置每周用量上限。
单击确认，所有选中用户应用相同配置。
查看限额状态（成员视角）
普通成员可以在 Token 限额页面查看以下信息：
租户用量：当前租户的 Token 消耗与上限。若租户限额未开启，显示无限制。
个人状态：当前账号的限额状态（正常、限制或无限制）。
个人用量明细：自己的每 5 小时和每周消耗与上限。
成员视角不提供任何配置入口，所有调整操作仅限管理员（租户管理员或已授予 AliyunDataWorksFullAccess 权限策略的 RAM 账号）执行。
统计周期
维度 | 支持的周期 | 说明 |
租户限额 | 每月、每周 | 管理员可分别启用或关闭每月与每周周期，独立配置用量上限。 |
用户限额 | 每周、每 5 小时 | 每周额度由管理员手动设置。每 5 小时额度按每周限额除以 34 自动计算，无法单独设置。 |
周期重置规则：
每月：跟随阿里云订单计费周期，以订单开始时间为锚定日，每月对应日 00:00:00 自动重置。
每周：跟随阿里云订单计费周期，以订单开始时间为锚定日，每周对应日 00:00:00 自动重置。
每 5 小时：从周期起点开始计时，5 小时后自动重置。
手动重置：管理员可手动重置用户的每周周期，重置后当前统计周期立即结束，进入下一个统计周期。
周期结束时间 = 下一周期开始时间 = 下次重置时间，三者为同一时刻，不存在服务空窗。
月周期计算规则
当月 N 日购买的服务，第二个月的 N+1 日凌晨到期并自动重置。后续每个统计周期为：每月的 N+1 日零点至次月的 N+1 日零点。如果次月不存在 N+1 日，则顺延至下一个月的 1 日零点。
示例：7 月 30 日购买的服务，8 月 31 日凌晨到期。统计周期如下：
周期 1：2026-07-30 14:47:13 → 2026-08-31 00:00:00（覆盖 8 月 30 日全天）
周期 2：2026-08-31 00:00:00 → 2026-10-01 00:00:00（9 月无 31 日，顺延至 10 月 1 日）
周期 3：2026-10-01 00:00:00 → 2026-11-01 00:00:00
限额触发机制
当用量达到上限时，系统通过门禁机制拦截 Data Agent 调用。
租户级限额触发：所有用户使用 Data Agent 时均被拦截。
用户级限额触发：仅该用户的 Data Agent 调用被拦截。
限额触发后，管理员可通过以下方式恢复：
调整上限：提高用量上限，新上限立即生效。
等待重置：当前统计周期结束后，用量自动归零，限额状态恢复。
配额与限制
约束项 | 说明 |
租户统计周期 | 支持按月、按周，可分别启用或关闭。 |
用户统计周期 | 每周（手动设置）+ 每 5 小时（自动计算，每周限额 / 34）。 |
用户每 5 小时限额 | 不可单独设置，由每周限额自动计算。 |
叠加生效 | 租户限额和用户限额独立管控，任意一个达到上限即生效。 |
成员管理 | 不支持添加或删除用户，用户列表自动同步 RAM 用户和角色。 |
常见问题
Q: 租户限额和用户限额同时开启，如何生效？
A: 两个维度独立管控，任意一个维度达到上限，即刻触发限制。例如，租户限额尚未触发，但某用户的个人用量达到上限，则仅该用户被限制；反之，若租户限额触发，则所有用户均被限制。
Q: 每 5 小时的限额如何计算？
A: 每 5 小时的限额 = 每周限额 / 34，无法单独设置。修改每周限额后，每 5 小时限额自动更新。
Q: 达到上限后，已运行的任务会怎样？
A: 达到上限后，Data Agent 将无法继续使用。因 Token 统计存在时延，实际用量可能少量超出限额。