API 文档
CMP 的认证、调用约定与完整接口参考。
本节面向第三方开发者。先阅读认证和调用约定,再按业务模块查阅接口。需要完整业务顺序时转到开发文档。
- 身份认证:Cookie、CSRF、Origin 和当前不支持的认证方式。
- 调用约定:响应、分页、幂等、异步和下载。
- 错误处理:HTTP 错误与任务失败。
- 209 个接口操作:参数、必填项、约束与完整请求/响应结构。
- OpenAPI JSON:可导入接口工具的版本化契约。
下载契约的 info.version 为 0.1.0,接口兼容性应以产品发行版本及本手册提供的快照为准。
镜像自动初始化
cloud_init_enabled 用于创建镜像和修改镜像。启用后,Linux 使用 Cloud-Init,Windows 使用 Cloudbase-Init 读取 NoCloud 配置盘。qemu_guest_agent_enabled 单独配置来宾代理。Windows 所需的镜像组件和 Agent 版本见Windows 自动初始化。
资源限速
使用 PUT /api/v1/rate-limits/{kind}/{id} 替换限速配置。路径参数 kind 支持 instances、public_ips 和 volumes。前两类需要 network.manage 权限及 OVN,云硬盘需要 volume.manage 权限。字段单位和任务处理见配置限速。
