云 API 是什么
云平台把资源操作暴露成 HTTP 接口：一次调用由接入点地址、公共参数、业务参数和签名四部分组成。公共参数（Action、Version、RegionId、Format、Timestamp、AccessKeyId、Signature）由平台统一定义，各接口的业务参数不同。看懂公共参数，是在控制台之外排查权限与签名类报错的起点。
基本信息
| 适用平台 | 阿里云 OpenAPI、腾讯云 API 3.0、华为云 API，均提供各语言官方 SDK |
|---|---|
| 请求方式 | HTTPS，GET 或 POST，返回 JSON 或 XML |
| 签名机制 | AccessKeySecret 参与的 HMAC 系列签名，时间戳与随机数一并参与计算 |
| 鉴权身份 | 主账号 AK/子账号 AK/临时凭证（STS），生产建议用子账号或临时凭证 |
| 调用限制 | 按接口与账号维度限流，超出返回限流错误码 |
典型使用场景
- 自动化运维：批量创建、启停、打标实例，替代控制台重复点击
- CI/CD 集成：流水线里按需申请资源与发布后回收资源
- 资产同步：定时拉取实例与云盘列表，写入 CMDB 或监控系统
- 成本采集：按账期拉取账单明细，生成内部成本报表
- 自愈脚本：监控告警触发后调用 API 重启实例或换挂盘
公共参数示例
公共参数示例
Action=DescribeInstances # 调用的接口名
Version=2014-05-26 # 接口版本，随服务不同
RegionId=cn-hangzhou # 目标地域，混合云场景尤其重要
Format=JSON # 返回格式
AccessKeyId=<AKID> # 调用身份标识
SignatureMethod=HMAC-SHA256 # 签名算法
Timestamp=2026-10-12T08:00:00Z # 与服务器时间偏差过大会被拒绝
Signature=<签名串> # 上述参数按规则拼接后计算得出常见错误码读法
| 错误码 | 常见原因 | 排查动作 |
|---|---|---|
| SignatureDoesNotMatch | 签名串构造不对或密钥错 | 先核对时间戳，再核对参数排序与编码 |
| Throttling | 触发接口限流 | 降低并发，改为指数退避重试 |
| Forbidden | 子账号策略未授权 | 确认该 RAM 用户是否被授予对应接口权限 |
| InvalidAccessKeyId | AK 已禁用或写错 | 确认 AK 状态与所属账号 |
手写签名易错且难维护，生产集成建议使用官方 SDK；重试必须带退避与并发上限，避免把限流错误放大成雪崩。
调用路径上还有一层配额：接口限流与资源配额是两回事，前者是调用次数上限，后者是资源数量上限。