ZStack Cloud API 与 SDK 调用异常排查

问题描述

适用于排查通过 curl、Postman、Java SDK、Python SDK 或第三方系统调用 ZStack Cloud API 时出现的访问失败、鉴权失败、返回码异常、轮询超时、权限不足和参数错误等问题。此类问题多与调用地址、端口、HTTP 方法、密码加密、异步 API 轮询、代理映射和账号权限有关。

现象

• Java SDK 调用报错 405，提示请求方式错误。
• 调用异步 API 后返回轮询地址，但继续调用轮询地址返回 Request timed out。
• 子账户调用配额、IPsec 或企业管理相关 API 报权限或 session 异常。
• API 返回 202、503、404 等状态码，调用方误判为接口失败。
• 通过代理地址访问 API 时，轮询地址仍返回管理节点内网地址。
• Python SDK 调用快照创建云盘 API，任务查询超时。

适用环境

• 产品：ZCF
• 组件：Cloud