返回结果使用UTF-8字符集编码,主要有XML和JSON两种格式,默认为XML,您可以指定公共请求参数Format变更返回结果的格式。为了便于查看,API文档中的返回示例均有换行和缩进等处理,实际返回结果无换行和缩进处理。

正常返回示例

API接口调用成功后,会返回接口返回参数和请求ID,这样的返回结果为正常返回,HTTP状态码为2xx。

  • XML 示例
    <?xml version="1.0" encoding="UTF-8"?> <!--结果的根结点-->
    <ActionResponse> <!--返回请求标签-->
        <RequestId>4C467B38-3910-447D-87BC-AC049166F216</RequestId> <!--返回结果数据-->
    </ActionResponse>
  • JSON 示例
    {
        "RequestId": "4C467B38-3910-447D-87BC-AC049166F216" /* 返回结果数据 */
    }

异常返回示例

API接口调用出错后,会返回错误码、错误信息和请求ID,这样的返回结果为异常返回,HTTP状态码为4xx或者5xx。

您可以根据返回的错误码,参考公共错误码API错误中心来排查错误。当您无法排查错误时,可以 提交工单,并在工单中注明服务节点 HostIdRequestId

  • XML 示例
    <?xml version="1.0" encoding="UTF-8"?><!--结果的根结点-->
    <Error>
        <RequestId>540CFF28-407A-40B5-B6A5-74Bxxxxxxxxx</RequestId> <!--请求 ID-->
        <HostId>eci.aliyuncs.com</HostId> <!--服务节点-->
        <Code>MissingParameter.CommandId</Code> <!--错误码-->
        <Message>The input parameter “CommandId” that is mandatory for processing this request is not supplied.</Message> <!--错误信息-->
    </Error>
  • JSON 示例
    {
        "RequestId": "540CFF28-407A-40B5-B6A5-74Bxxxxxxxxx", /* 请求 ID */
        "HostId": "eci.aliyuncs.com", /* 服务节点 */
        "Code": "MissingParameter.CommandId", /* 错误码 */
        "Message": "The input parameter “CommandId” that is mandatory for processing this request is not supplied." /* 错误信息 */
    }