Skip to content

资源配额操作

quota 命令是对云沙箱资源配额操作的命令:主要包括配额的查看、列举、设置、删除等功能。

命令解析

当执行命令quota -h/quota --help时,可以获取帮助文档。

⚠️ 配额是账号 / tag 级别的资源,不属于某个 Team,因此不进 s.yaml,也不参与 deploy / plan / info / remove / sync 的声明式生命周期,只能通过 quota 命令管理。

quota get 命令

quota get 命令,是获取指定 tag 配额详情的命令(对应 OpenAPI 的 DescribeQuota)。

当执行命令quota get -h/quota get --help时,可以获取帮助文档。

参数解析

参数全称 参数缩写 Yaml 模式下必填 Cli 模式下必填 参数含义
region - 选填 必填 地域名称,取值参见支持的地域
tag-value - 选填 选填 配额的 tag 值,不指定时查询默认配额

当前命令还支持部分全局参数(例如-a/--access, --debug等),详情可参考 Serverless Devs 全局参数文档

操作案例

s cli fc-sandbox quota get --tag-value default --region cn-hangzhou -a default

上述命令的执行结果示例:

tagValue: default
cpuCores: 16
memoryGB: 32

配额不存在时报错 Quota for tag "default" not found in region cn-hangzhou

quota list 命令

quota list 命令,是列举全部配额的命令。

当执行命令quota list -h/quota list --help时,可以获取帮助文档。

参数解析

参数全称 参数缩写 Yaml 模式下必填 Cli 模式下必填 参数含义
region - 选填 必填 地域名称,取值参见支持的地域
table - 选填 选填 是否以表格形式输出,--table 表示以表格形式输出

当前命令还支持部分全局参数(例如-a/--access, --debug等),详情可参考 Serverless Devs 全局参数文档

操作案例

s cli fc-sandbox quota list --table --region cn-hangzhou -a default

上述命令的执行结果示例:

-
  tagValue: default
  cpuCores: 16
  memoryGB: 32
-
  tagValue: ci
  cpuCores: 4
  memoryGB: 8

如果指定了--table参数,输出示例:

tagValue cpuCores memoryGB
default 16 32
ci 4 8

list 内部已做全量翻页(Quota 用的是 maxResults + nextToken 风格)。

quota put 命令

quota put 命令,是创建或覆盖指定 tag 配额的命令(对应 OpenAPI 的 UpdateQuotaupsert 语义:存在则覆盖,不存在则创建)。

当执行命令quota put -h/quota put --help时,可以获取帮助文档。

参数解析

参数全称 参数缩写 Yaml 模式下必填 Cli 模式下必填 参数含义
region - 选填 必填 地域名称,取值参见支持的地域
tag-value - 必填 必填 配额的 tag 值
cpu-cores - 选填 选填 CPU 核数配额
memory-gb - 选填 选填 内存配额,单位 GB

当前命令还支持部分全局参数(例如-a/--access, --debug等),详情可参考 Serverless Devs 全局参数文档

操作案例

s cli fc-sandbox quota put --tag-value default --cpu-cores 8 --memory-gb 16 \
    --region cn-hangzhou -a default

上述命令的执行结果示例:

tagValue: default
cpuCores: 8
memoryGB: 16

注意事项

  • --cpu-cores--memory-gb 至少要指定一个,否则报错:

    Nothing to update, please specify --cpu-cores and/or --memory-gb
    
  • 两个参数都必须是非负数,否则报错:

    Invalid --cpu-cores: "abc" is not a non-negative number
    
  • put 是覆盖语义,不是增量修改。

quota remove 命令

quota remove 命令,是删除指定 tag 配额的命令。

当执行命令quota remove -h/quota remove --help时,可以获取帮助文档。

参数解析

参数全称 参数缩写 Yaml 模式下必填 Cli 模式下必填 参数含义
region - 选填 必填 地域名称,取值参见支持的地域
tag-value - 必填 必填 配额的 tag 值
assume-yes y 选填 选填 在交互时,默认选择y

当前命令还支持部分全局参数(例如-a/--access, --debug等),详情可参考 Serverless Devs 全局参数文档

操作案例

s cli fc-sandbox quota remove --tag-value default --region cn-hangzhou -a default -y

上述命令的执行结果示例:

? Are you sure you want to delete the quota of tag "default"? yes
Quota of tag "default" removed

权限与策略说明

  • put / removeAliyunFCFullAccess
  • get / listAliyunFCReadOnlyAccess