调用RAM API后返回数据采用统一格式,返回结果格式主要有XML和JSON两种,默认为XML 格式。本文档中的返回示例为了便于用户查看,做了格式化处理,实际返回结果是没有进行换行、缩进等处理的。

成功结果

调用RAM API后,如果返回的HTTP状态码为:2xx,代表调用成功。

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

错误结果

调用STS API后,如果返回的HTTP状态码为:4xx5xx,代表调用失败,系统将不会返回结果数据。此时,返回的消息体中包含:具体的错误代码、错误信息、全局唯一的请求ID:RequestId以及本次请求访问的站点ID:HostId。您可以通过错误码定位问题,详情请参见查看本产品错误码

  • XML示例
    <?xml version="1.0" encoding="UTF-8"?>
    <Error>
       <RequestId>8906582E-6722-409A-A6C4-0E7863B733A5</RequestId>
       <HostId>ram.aliyuncs.com</HostId>
       <Code>InvalidParameter</Code>
       <Message>The specified parameter "Action or Version" is not valid.</Message>
    </Error>
  • JSON示例
    {
        "RequestId": "7463B73D-35CC-4D19-A010-6B8D65D242EF",
        "HostId": "ram.aliyuncs.com",
        "Code": "InvalidParameter",
        "Message": "The specified parameter \"Action or Version\" is not valid."
    }