参数格式
更新时间:2026-06-10
BCE CLI 支持多种参数传入方式,以适应不同类型的 API 参数。
基本格式
Bash
1bce <service> <operation> --paramName value
2# 或使用等号形式
3bce <service> <operation> --paramName=value
布尔参数
直接写 Flag 名,不跟值,等同于 true:
Bash
1bce vpc QueryVpcList --isDefault
结构化参数(List / Object)
对于类型为 List 或 Object 的参数,支持两种传入方式:
JSON 格式(推荐)
Bash
1bce blb CreateLoadBalancer \
2 --region bj \
3 --name my-lb \
4 --tags '[{"tagKey":"env","tagValue":"prod"}]'
KV 点记法(需加 --unfold)
Bash
1bce blb CreateLoadBalancer \
2 --region bj \
3 --name my-lb \
4 --unfold \
5 --tags tagKey=env tagValue=prod
对于 List 类型参数,--unfold 模式下可以多次传入同一参数名,每次代表一个元素:
Bash
1--tags tagKey=env tagValue=prod \
2--tags tagKey=owner tagValue=alice
从文件读取参数
适合参数较多或需要复用的场景,使用 --cli-input-json 从 JSON 文件读取参数:
Bash
1# 生成参数骨架
2bce vpc CreateVpc --generate-cli-skeleton > create-vpc.json
3
4# 编辑文件后执行
5bce vpc CreateVpc --cli-input-json file://create-vpc.json
命令行 Flag 优先级高于文件中的值,可在文件基础上用 Flag 覆盖部分参数。
生成参数骨架
--generate-cli-skeleton 输出当前 API 所有参数的 JSON 模板:
Bash
1bce vpc CreateVpc --generate-cli-skeleton
输出:
JSON
1{
2 "version": "1",
3 "clientToken": "",
4 "name": "",
5 "description": "",
6 "cidr": "",
7 "enableIpv6": false,
8 "tags": [
9 {
10 "tagKey": "",
11 "tagValue": ""
12 }
13 ]
14}
评价此篇文章
