阿里云CLI命令结构

myusa2

于 2025-05-11 08:00:00 发布

阅读量1.4k

点赞数 25

文章标签：阿里云云计算

本文链接：https://blog.csdn.net/myusa2/article/details/147810722

版权

介绍阿里云CLI的通用命令结构，以及在调用RPC风格或ROA风格OpenAPI时所需的特定命令结构。

阿里云CLI的通用命令结构如下：

aliyun <Command> [SubCommand] [Options and Parameters]

结构示例中Command、SubCommand、Options and Parameters的详细信息如下所示：

Command：指定一个顶级命令。
- 可指定阿里云CLI支持的云产品CodeProductCode，例如ecs、rds等。
- 可指定阿里云CLI本身的功能命令，例如configure等。

SubCommand：指定要执行操作的子命令，即具体的某一项操作。
- 当顶级命令command为configure时，支持的子命令请参见配置凭证相关命令。
- 当顶级命令command为云产品Code，且OpenAPI风格为RPC风格时，子命令通常为可调用的OpenAPI名称。

Options and Parameters：指定用于控制阿里云CLI行为的选项或者OpenAPI参数选项，选项值可以是数字、字符串和JSON结构字符串等。更多参数格式信息，请参见参数格式。

阿里云云产品OpenAPI分为RPC和ROA两种风格类型，大部分产品使用的是RPC风格。不同风格接口的调用方式不同，当您使用阿里云CLI调用接口时需要判断接口类型。您可以通过以下方式判断OpenAPI风格：

前往目标云产品文档，单击开发参考 > API概览，在文档中查看云产品支持的OpenAPI风格。
在阿里云CLI中，通过在云产品CodeProductCode后使用--help选项可以获取产品可用OpenAPI列表，不同风格接口显示的帮助信息存在差异。
- RPC风格OpenAPI将在帮助信息中显示接口简述。
- ROA风格OpenAPI将在帮助信息中显示访问路径PathPattern。
更多信息，请参见获取产品可用API列表。
在阿里云CLI中，通过在接口名称APIName后使用--help选项可以获取OpenAPI参数详情。ROA风格OpenAPI会在帮助信息中额外显示接口的请求方式Method和访问路径PathPattern。更多信息，请参见获取API参数详情。

一般情况下，每个产品内所有接口的调用风格是统一的，且每个接口仅支持特定的一种风格。更多关于RPC风格和ROA风格的信息，请参见OpenAPI 风格。

在阿里云CLI中，调用RPC风格的OpenAPI时，其命令结构如下。

aliyun <ProductCode> <APIName> [Parameters]

示例中ProductCode、APIName、Parameters的详细信息如下所示：

以下示例为您展示如何调用云服务器 ECSDescribeRegions接口，查询可用地域信息列表。更多信息，请参见DescribeRegions - 查询地域列表。
```
aliyun ecs DescribeRegions
```
以下示例为您展示如何调用云服务器 ECSDescribeInstanceAttribute接口，查询指定ECS实例的属性信息。更多信息，请参见DescribeInstanceAttribute - 查询实例属性信息。
```
aliyun rds DescribeInstanceAttribute --InstanceId 'i-uf6f5trc95ug8t33****'
```

在阿里云CLI中，调用ROA风格OpenAPI时，基本命令结构如下。

 aliyun <ProductCode> <Method> <PathPattern> [RequestBody] [Parameters]

示例中ProductCode、Method、PathPattern、RequestBody、Parameters的详细信息如下所示：

ProductCode：云产品Code。例如容器服务 Kubernetes 版 ACK（Container Service for Kubernetes）的云产品Code为cs。
Method：请求方式。您可以根据帮助信息或官网文档选择正确的请求方式。常用请求方式有GET、PUT、POST、DELETE。
PathPattern：请求路径。您可以根据帮助信息或官网文档选择正确的请求路径。
RequestBody：请求主体。您可以参考帮助信息或官网文档，使用以下选项指定请求主体。
- 使用--body选项指定字符串或变量作为请求主体。
- 使用--body-file选项指定文件路径，将目标文件作为请求主体。
具体操作请参见API命令可用选项。
Parameters：请求参数。您可以在帮助信息或官网文档中查看可用请求参数，以选项形式指定参数。
可使用--help选项获取关于以上参数的帮助信息。详情请参见获取帮助信息。

GET请求

以下示例为您展示如何调用容器服务 Kubernetes 版DescribeClustersForRegion接口，查询杭州地域下的ACK专有集群。更多信息，请参见DescribeClustersForRegion - 查询指定地域的集群列表。

aliyun cs GET /regions/cn-hangzhou/clusters --cluster_type Kubernetes