异常排查

本文为您介绍调用 OpenAPI 出现异常返回时,如何定位问题。

使用问题诊断

OpenAPI 门户提供接口调用异常的问题诊断功能。当您在调用 OpenAPI 出现报错时,可将错误码粘贴到输入框中,点击诊断按钮,查看诊断结果和修复建议。

使用示例:

  1. 在调用DescribeSecurityGroupAttribute时,输入错误的regionId,得到错误码信息

    {
      "RequestId": "01C8238B-B79B-50C5-9011-D9AC41509C23",
      "HostId": "ecs-unit-share.cn-hangzhou.aliyuncs.com",
      "Code": "InvalidSecurityGroupId.NotFound",
      "Message": "The specified SecurityGroupId does not exist.",
      "Recommend": "https://api.aliyun.com/troubleshoot?q=InvalidSecurityGroupId.NotFound&product=Ecs"
    }
  2. 访问问题诊断地址:https://next.api.aliyun.com/troubleshoot

  3. 输入 RequestId 并点击诊断按钮。

  4. 得到返回信息。示例如下:

    image.png

    image.png

查看云产品错误码

可在阿里云产品文档中全局搜索错误码或在云产品 API 文档中查看错误码对应的原因说明。