title | description | position | category |
---|---|---|---|
按量资源 onDemand |
按量资源 onDemand |
4 |
发布&配置 |
ondemand
命令是对函数计算按量资源操作的命令。
当执行命令ondemand -h
/ondemand --help
时,可以获取帮助文档:
OnDemand
Resource on-demand operation
Usage
s ondemand <sub-command> <options>
Document
https://github.com/devsapp/fc/blob/main/docs/zh/command/ondemand.md
SubCommand List
get Get resource on-demand; help command [s ondemand get -h]
list View the list of resource on-demand; help command [s ondemand list -h]
put Put resource on-demand; help command [s ondemand put -h]
在该命令中,包括了三个子命令:
ondemand get
命令,是获取服务指定按量资源详情的命令。
当执行命令ondemand get -h
/ondemand get --help
时,可以获取帮助文档:
Ondemand get
Get on-demand configuration
Usage
s ondemand get <options>
Document
https://github.com/devsapp/fc/blob/main/docs/zh/command/ondemand.md
Options
--region [string] [C-Required] Specify the fc region, value: cn-hangzhou/cn-beijing/cn-beijing/cn-hangzhou/cn-shanghai/cn-qingdao/cn-zhangjiakou/cn-huhehaote/cn-shenzhen/cn-chengdu/cn-hongkong/ap-southeast-1/ap-southeast-2/ap-southeast-3/ap-southeast-5/ap-northeast-1/eu-central-1/eu-west-1/us-west-1/us-east-1/ap-south-1
--service-name [string] [C-Required] Specify the fc service name
--function-name [string] [C-Required] Specify the fc function name
--qualifier [string] [Optional] Specify the qualifier parameter. Only supports LATEST and alias
Global Options
-h, --help [Optional] Help for command
-a, --access [string] [Optional] Specify key alias
--debug [Optional] Output debug informations
Options Help
Required: Required parameters in YAML mode and CLI mode
C-Required: Required parameters in CLI mode
Y-Required: Required parameters in Yaml mode
Optional: Non mandatory parameter
✋ The difference between Yaml mode and CLI mode: https://github.com/Serverless-Devs/Serverless-Devs/blob/master/docs/zh/yaml_and_cli.md
Examples with Yaml
$ s ondemand get --qualifier qualifier
Examples with CLI
$ s cli fc ondemand get --region cn-hangzhou --service-name serviceName --function-name functionName --qualifier qualifier
参数全称 | 参数缩写 | Yaml模式下必填 | Cli模式下必填 | 参数含义 |
---|---|---|---|---|
region | - | 选填 | 必填 | 地区,取值范围:cn-hangzhou, cn-beijing, cn-beijing, cn-hangzhou, cn-shanghai, cn-qingdao, cn-zhangjiakou, cn-huhehaote, cn-shenzhen, cn-chengdu, cn-hongkong, ap-southeast-1, ap-southeast-2, ap-southeast-3, ap-southeast-5, ap-northeast-1, eu-central-1, eu-west-1, us-west-1, us-east-1, ap-south-1 |
service-name | - | 选填 | 必填 | 服务名 |
function-name | - | 选填 | 必填 | 函数名 |
qualifier | - | 必填 | 必填 | 版本,支持LATEST和别名 |
access | a | 选填 | 选填 | 本次请求使用的密钥,可以使用通过config命令 配置的密钥信息,以及配置到环境变量的密钥信息 |
debug | - | 选填 | 选填 | 打开debug 模式,将会输出更多日志信息 |
help | h | 选填 | 选填 | 查看帮助信息 |
- 有资源描述文件(Yaml)时,可以直接执行
s ondemand get --qualifier qualifier
进行指定的版本按量资源详情获取; - 纯命令行形式(在没有资源描述 Yaml 文件时),需要指定服务所在地区以及服务名称,例如
s cli fc ondemand get --region cn-hangzhou --service-name fc-deploy-service --qualifier qualifier
;
上述命令的执行结果示例:
fc-deploy-test:
serviceName: fc-deploy-service
functionName: http-trigger-py36
qualifier: LATEST
resource: services/fc-deploy-service.http-trigger-py36/functions/LATEST
maximumInstanceCount: 1
ondemand list
命令,是列举按量资源列表的命令。
当执行命令ondemand list -h
/ondemand list --help
时,可以获取帮助文档:
OnDemand list
View the list of on-demand
Usage
s ondemand list <options>
Document
https://github.com/devsapp/fc/blob/main/docs/zh/command/ondemand.md
Options
--region [string] [C-Required] Specify the fc region, value: cn-hangzhou/cn-beijing/cn-beijing/cn-hangzhou/cn-shanghai/cn-qingdao/cn-zhangjiakou/cn-huhehaote/cn-shenzhen/cn-chengdu/cn-hongkong/ap-southeast-1/ap-southeast-2/ap-southeast-3/ap-southeast-5/ap-northeast-1/eu-central-1/eu-west-1/us-west-1/us-east-1/ap-south-1
--service-name [string] [C-Required] Specify the fc service name
--table [Optional] Table format output
Global Options
-h, --help [Optional] Help for command
-a, --access [string] [Optional] Specify key alias
--debug [Optional] Output debug informations
Options Help
Required: Required parameters in YAML mode and CLI mode
C-Required: Required parameters in CLI mode
Y-Required: Required parameters in Yaml mode
Optional: Non mandatory parameter
✋ The difference between Yaml mode and CLI mode: https://github.com/Serverless-Devs/Serverless-Devs/blob/master/docs/zh/yaml_and_cli.md
Examples with Yaml
$ s ondemand list
Examples with CLI
$ s cli fc ondemand list --region cn-hangzhou --service-name serviceName
参数全称 | 参数缩写 | Yaml模式下必填 | Cli模式下必填 | 参数含义 |
---|---|---|---|---|
region | - | 选填 | 必填 | 地区,取值范围:cn-hangzhou, cn-beijing, cn-beijing, cn-hangzhou, cn-shanghai, cn-qingdao, cn-zhangjiakou, cn-huhehaote, cn-shenzhen, cn-chengdu, cn-hongkong, ap-southeast-1, ap-southeast-2, ap-southeast-3, ap-southeast-5, ap-northeast-1, eu-central-1, eu-west-1, us-west-1, us-east-1, ap-south-1 |
service-name | - | 选填 | 必填 | 服务名 |
table | - | 选填 | 选填 | 是否以表格形式输出 |
access | a | 选填 | 选填 | 本次请求使用的密钥,可以使用通过config命令 配置的密钥信息,以及配置到环境变量的密钥信息 |
debug | - | 选填 | 选填 | 打开debug 模式,将会输出更多日志信息 |
help | h | 选填 | 选填 | 查看帮助信息 |
- 有资源描述文件(Yaml)时,可以直接执行
s ondemand list
获取按量资源列表; - 纯命令行形式(在没有资源描述 Yaml 文件时),需要指定服务所在地区以及服务名称,例如
s cli fc ondemand list --region cn-hangzhou --service-name fc-deploy-service
上述命令的执行结果示例:
fc-deploy-test:
-
serviceName: fc-deploy-service
qualifier: http-trigger-py36
functionName: LATEST
resource: services/fc-deploy-service.http-trigger-py36/functions/LATEST
maximumInstanceCount: 1
如果指定了--table
参数,输出示例:
┌───────────────────┬───────────────────┬──────────────┬──────────────────────┐
│ serviceName │ qualifier │ functionName │ maximumInstanceCount │
├───────────────────┼───────────────────┼──────────────┼──────────────────────┤
│ fc-deploy-service │ http-trigger-py36 │ LATEST │ 1 │
└───────────────────┴───────────────────┴──────────────┴──────────────────────┘
ondemand put
命令,是对别名进行发布和更新的命令。
当执行命令ondemand put -h
/ondemand put --help
时,可以获取帮助文档:
Ondemand put
Set reserved configuration
Usage
s ondemand put <options>
Document
https://github.com/devsapp/fc/blob/main/docs/zh/command/ondemand.md
Options
--region [string] [C-Required] Specify the fc region, value: cn-hangzhou/cn-beijing/cn-beijing/cn-hangzhou/cn-shanghai/cn-qingdao/cn-zhangjiakou/cn-huhehaote/cn-shenzhen/cn-chengdu/cn-hongkong/ap-southeast-1/ap-southeast-2/ap-southeast-3/ap-southeast-5/ap-northeast-1/eu-central-1/eu-west-1/us-west-1/us-east-1/ap-south-1
--service-name [string] [C-Required] Specify the fc service name
--function-name [string] [C-Required] Specify the fc function name
--qualifier [string] [Required] Specify the qualifier parameter. Only supports LATEST and alias
--max [string] [Required] Specify the maximumInstanceCount parameter
Global Options
-h, --help [Optional] Help for command
-a, --access [string] [Optional] Specify key alias
--debug [Optional] Output debug informations
Options Help
Required: Required parameters in YAML mode and CLI mode
C-Required: Required parameters in CLI mode
Y-Required: Required parameters in Yaml mode
Optional: Non mandatory parameter
✋ The difference between Yaml mode and CLI mode: https://github.com/Serverless-Devs/Serverless-Devs/blob/master/docs/zh/yaml_and_cli.md
Examples with Yaml
$ s ondemand put --qualifier pre --max 1
Examples with CLI
$ s cli fc ondemand put --region cn-hangzhou --service-name serviceName --function-name functionName --qualifier alias --max 1
参数全称 | 参数缩写 | Yaml模式下必填 | Cli模式下必填 | 参数含义 |
---|---|---|---|---|
region | - | 选填 | 必填 | 地区,取值范围:cn-hangzhou, cn-beijing, cn-beijing, cn-hangzhou, cn-shanghai, cn-qingdao, cn-zhangjiakou, cn-huhehaote, cn-shenzhen, cn-chengdu, cn-hongkong, ap-southeast-1, ap-southeast-2, ap-southeast-3, ap-southeast-5, ap-northeast-1, eu-central-1, eu-west-1, us-west-1, us-east-1, ap-south-1 |
service-name | - | 选填 | 必填 | 服务名 |
function-name | - | 选填 | 选填 | 函数名 |
qualifier | - | 必填 | 必填 | 版本,支持LATEST和别名 |
max | - | 必填 | 必填 | 最大实例数量 |
access | a | 选填 | 选填 | 本次请求使用的密钥,可以使用通过config命令 配置的密钥信息,以及配置到环境变量的密钥信息 |
debug | - | 选填 | 选填 | 打开debug 模式,将会输出更多日志信息 |
help | h | 选填 | 选填 | 查看帮助信息 |
- 有资源描述文件(Yaml)时,可以直接执行
s ondemand put --qualifier qualifier
进行按量资源配置; - 纯命令行形式(在没有资源描述 Yaml 文件时),需要指定服务所在地区以及服务名称、函数名,例如
s cli fc ondemand put --qualifier LATEST --max 1
;
上述命令的执行结果示例:
fc-deploy-test:
resource: services/fc-deploy-service.http-trigger-py36/functions/LATEST
maximumInstanceCount: 1
-
ondemand list
与ondemand get
命令所需要的权限策略:AliyunFCReadOnlyAccess
-
ondemand put
命令所需要的权限策略:{ "Version": "1", "Statement": [ { "Action": "fc:PutFunctionOnDemandConfig", "Effect": "Allow", "Resource": "acs:fc:<region>:<account-id>:services/services/<serviceName>.<qualifier>/functions/<functionName>" } ] }