Mar
29
2021
调用RPC API和RESTful API
阿里云云产品的API分为RPC和RESTful两种类型,大部分产品使用的是RPC风格。当您使用阿里云CLI调用接口时,不同风格的API,调用方式不同。
在阿里云CLI中,使用的命令行结构如下:
aliyun <command> <subcommand> [options and parameters]
- aliyun:阿里云工具名。
-
command:指定一个顶级命令。
- 通常表示命令行工具中支持的阿里云产品基础服务,例如ecs、rds等。
- 也表示命令行工具本身的功能命令,例如help、configure等。
- subcommand:指定要执行操作的附加子命令,即具体的某一项操作。
- options and parameters:指定用于控制阿里云CLI行为的选项或者API参数选项,其选项值可以是数字、字符串和json结构字符串等。
调用产品接口时,首先需要判断API类型,选择标准的命令结构发起调用。您可以通过以下特点判断API类型:
- API参数中包含Action字段的是RPC API,需要PathPattern参数的是RESTful API。
- 一般情况下,每个产品内所有API的调用风格是统一的。
-
每个API仅支持特定的一种风格,传入错误的标识,可能会调用到其他API,或收到
ApiNotFound
的错误信息。
调用RPC API
在阿里云CLI中,调用RPC API时,基本命令结构如下:
aliyun <product> <ApiName> [--parameter1 value1 --parameter2 value2 ...]
代码示例:
aliyun rds DescribeDBInstanceAttribute --DBInstanceId xxxxxx
调用RESTful API
部分阿里云产品如容器服务是RESTful API。在阿里云CLI中,调用RESTful API时,基本命令结构如下:
aliyun 云产品code [GET|PUT|POST|DELETE] <PathPattern> --body "$(cat input.json)"
-
GET请求
请求结构:
aliyun 云产品code GET /资源
示例命令:
-
POST请求
请求结构:
aliyun 云产品code POST /资源 --body "$(cat input.json)"
示例命令:
aliyun cs POST /clusters/<cluster_id>/attach --header "Content-Type=application/json" --body "$(cat attach.json)"
-
DELETE请求
请求结构:
aliyun 云产品code DELETE /资源
示例命令:
-
本公司销售:阿里云、腾讯云、百度云、天翼云、金山大米云、金山企业云盘!可签订合同,开具发票。
我有话说: