阿里云CLI参数输入格式说明

Mar 12 2021

阿里云代理

分类：图文教程

已被围观 803 次

概述

本文主要介绍阿里云CLI参数输入格式的说明。

详细信息

如果您对实例或数据有修改、变更等风险操作，务必注意实例的容灾、容错能力，确保数据安全。

如果您对实例（包括但不限于ECS、RDS）等进行配置与数据修改，建议提前创建快照或开启RDS日志备份等功能。

如果您在阿里云平台授权或者提交过登录账号、密码等安全信息，建议您及时修改。

对于API中不同类型的字段，阿里云CLI遵循不同的输入格式要求，主要说明如下。

参数大小写：由于API参数严格区分大小写，阿里云CLI的参数输入也严格区分大小写。
String类型参数值的传入：API文档中标注为String类型的参数，如果参数值中没有包含特殊字符，可直接传入。否则需要用单引号或双引号包含后再传入，如下所示。
```
aliyun ecs DescribeImages --ImageName "自定义镜像_1-10.X.X.1"
aliyun ecs DescribeImages --ImageName '蓝屏windows-DB业务-10.X.X.26'
aliyun ecs DescribeImages --ImageName WindowsTest
```
Integer类型参数值的传入：API文档中标注为Integer类型的参数，可直接传入，如下所示。
```
aliyun ecs DescribeImages --ImageName WindowsTest --Pagesize 10
```
注：本示例中“--Pagesize 10”表示默认值，而不是最大值。
String类型字符串列表值的传入：API文档中标注为String类型的参数，如果支持多个值的列表，例如ImageId列表，可将相应的参数值串用半角逗号字符分隔后，再使用单引号或双引号包含后传入，如下所示。
```
aliyun ecs DescribeImages --ImageId "m-23e0oxmbv,m-23waejuy9"
aliyun ecs DescribeImages --ImageId 'm-23e0oxmbv,m-23waejuy9'
```
String类型JSON数组参数值的传入：API文档中标注为String类型的参数，如果要求参数值是一个带有格式的JSON数组，需要将所有值用单引号包括，中间用方括号包含、双引号引用、逗号分隔。也可将上述用法中的单引号和双引号互换，如下所示。
```
aliyun ecs DescribeDisks --DiskIds '["d-23rssg24f","d-23vsih26x","d-23sfqfbfa"]'
aliyun ecs DescribeDisks --DiskIds "['d-23rssg24f','d-23vsih26x','d-23sfqfbfa']"
```
String类型JSON数组列表参数值的传入：API文档中标注为String类型的参数，如果要求参数值是一个JSON数组列表，需要将所有值在最外层用双引号包括，中间用方括号包含，JSON数组值用大括号包含、逗号分隔，JSON数组内的key和value用冒号分隔。也可将上述用法中的单引号和双引号互换，如下所示。
```
aliyun slb AddBackendServers --LoadBalancerId 15157b19f18-cn-hangzhou-dg-a01 --BackendServers "[{'ServerId':'i-23g8aact0'},{'ServerId':'i-23bb03yh9'}]"
aliyun slb AddBackendServers --LoadBalancerId 15157b19f18-cn-hangzhou-dg-a01 --BackendServers '[{"ServerId":"i-23g8aact0"},{"ServerId":"i-23bb03yh9"}]'
```
String类型日期格式参数值的传入：API文档中标注为String类型的参数，如果要求参数值是一个按照“ISO8601”标准表示的UTC 时间，需要将时间按YYYY-MM-DDThh:mm:ssZ格式传入，如下所示。
```
aliyun ecs DescribeInstanceMonitorData --InstanceId i-94ola4btx --StartTime 2015-11-28T15:00:00Z --EndTime 2015-11-28T18:00:00Z
```