资源配额操作
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 的 UpdateQuota,upsert 语义:存在则覆盖,不存在则创建)。
当执行命令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/remove:AliyunFCFullAccessget/list:AliyunFCReadOnlyAccess