API 完备度的意义

改五十台服务器的安全组规则，在控制台逐台点要花一个多小时，用 API 写个循环脚本几分钟跑完。API 完备度对规模稍大的用户来说，不是加分项，是必需品。 一、为什么重要 控制台是给人手点用的，API 是给程序用的。机器数量上了两位数，或者业务需要频繁开关机、调整带宽、打快照，靠人点界面迟早出错。API 还有一个隐性价值：把例行操作交给脚本，不依赖某个人记得某件事，自动化流程的稳定性反而比人肉操作高。节假日扩容、深夜故障切换这类场景，脚本比叫人起来靠谱。不妨把一周内重复做过三次以上的控制台操作列出来，逐条去找对应的接口，这张清单就是你的自动化起点。 二、完备度看哪些接口 判断 API 够不够用，看核心资源是不是都覆盖：实例的创建、开关机、重装、改配；磁盘的创建、扩容、挂载；快照的创建与回滚；安全组与防火墙规则的增删改查；监控数据的读取。核心操作只能在控制台做、API 只开放查询接口的，属于残血版本，自动化空间很有限。 三、上手成本看三点 一看文档有没有给出请求地址、参数表和返回示例；二看有没有可直接复制的 curl 示例，比如带鉴权头调用实例列表接口；三看是否提供常见语言的 SDK 或至少有调用示例代码。鉴权方式也要看清：密钥怎么申请、有效期多久、权限能不能按资源拆分。密钥权限能细分，才敢放心交给自动化系统，不至于一把钥匙能删所有机器。 四、建议 采购前向售前要一份 API 文档链接，花半小时通读核心接口。已有内部运维平台的团队，重点确认监控数据接口和告警回调机制，能不能把告警推到自己的系统里。API 这东西平时感知不强，规模一上来就是分水岭，宁可下单前多问一句，别上线后才发现只能手点。文档里如果标注了接口调用频率限制，也一并记下来，批量脚本撞上限流会很难受。