Skip to content

提高限制

套餐的哪些限制可以应单个账户的要求提高,以及如何用 API 申请。

更新于

同一套餐下,每个账户的限制都相同。在免费版上,换到付费版就能一次提高其中的大部分 (glac billing plan paid),被拒绝的调用也会这样提示。有些限制,在某个账户需要的超过套餐所给时,我们也可以单独为它提高:能这样解除的拒绝,错误信息中会写明“ask us to raise it for this account”,其 docs_url 指向对应的错误说明。账户调用一次 API 即可申请,见下文。

我们提高什么

内容 拒绝时返回 我们怎么做
账户同时能拥有多少、创建东西的速度:运行中的沙箱和实例及其 vCPU 和内存、保持休眠的沙箱、应用在一个区域中的实例、每分钟创建的沙箱和每个项目每小时创建的沙箱、每小时创建的方块和版本 403 plan_cap_reached,它的 param 指明是哪项限制 为账户单独设定其中任何一项的数字
付费版上一个项目可保有的云盘和存储卷数量 403 drive_limit_reached, volume_limit_reached 为账户单独设定一个数字:在付费版上它是软限制
单个云盘或存储卷的大小,超过所有套餐的上限 同上 让企业账户拥有最大 16 TiB 的云盘
每月最多能从账户的银行卡扣多少:它的信任等级 403 trust_limit_exceeded 在等级自动提升之前提前提升

为账户设定的数字,无论账户换到哪个套餐都有效,直到被收回。GET /v1/account (glac account) 显示账户能同时拥有的每项限制、已用了多少、这个数字来自谁(caps:source 为 plan 或 operator),以及密钥所属项目的云盘和存储卷保有量(keeps:数量、单个大小上限、合计大小上限,每项都附带项目已有的量,以及不指定大小时创建的大小);数字属于账户自己时,拒绝信息会写“this account may”。

如何申请

在控制台中,账户的 Limits 页面列出每项这样的限制,以及它现在的数字、已用了多少、数字来自谁;在某项限制所在行点 Ask for more 即可申请,填写想要的数字和用途,申请及其答复会列在下方。

或者用有 admin 权限范围的密钥通过 API 申请:

curl -X POST https://api.glac.ai/v1/limits/requests \
  -H "Authorization: Bearer $GLAC_API_KEY" -H 'Content-Type: application/json' \
  -d '{"limit": "vcpus", "wanted": 64, "why": "a build farm of eight sandboxes of 8 vCPUs"}'
  • limit:限制的名称,即拒绝时 param 给出的名称,也是 GET /v1/account 中 caps 下的名称:instances、vcpus、memory_bytes、sleeping、app_instances、creates_per_minute、creates_per_hour_per_project 或 app_creates_per_hour。或者项目保有的东西:volumes(云盘和存储卷的数量)或 volume_bytes(单个的大小上限,最大 16 TiB)。
  • wanted:账户需要的数字,必须大于现在的数字;memory_bytes 和 volume_bytes 以字节为单位。
  • why:需要它做什么,1 到 2,000 个字符。

响应就是这份申请(limit_request,它的 id 为 lrq-…),状态为 pending,附带账户申请时的数字 (from)。申请本身不会改变任何东西。同一项限制同一时间只能有一份未决申请:同一项限制的另一份申请会以 409 limit_request_pending 被拒绝,并指明正在等待的那一份。GET /v1/limits/requests 列出账户的申请,最新的在前,GET /v1/limits/requests/{id} 读取一份;账户所有项目的密钥看到的都一样。

答复。我们批准时,申请会显示 granted,附带账户此后拥有的数字(granted;云盘或存储卷的大小以整 GiB 计);我们拒绝时,它会显示 refused 及原因 (answer)。无论哪种,账户的每个项目都会收到一个事件(limit_request.granted、limit_request.refused:见 GET /v1/events,以及接收这些事件的 Webhook),也会有邮件发到账户的地址。批准的数字属于账户自己,如上表所述。

调用不涵盖的事项,比如在信任等级自动提升之前提前提升,请发邮件到 support@glac.ai,附上账户 ID(glac account,或 GET /v1/account 返回的 id)、被拒绝调用的 code 和 request_id,以及你的需求。

导航

输入以搜索……

↑↓ 切换↵ 选择Esc 关闭