调用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状态码为4xx或5xx，代表调用失败，系统将不会返回结果数据。此时，返回的消息体中包含：具体的错误代码、错误信息、全局唯一的请求IDRequestId以及本次请求访问的站点IDHostId。您可以通过错误码定位问题。更多信息，请参见查看RAM错误码。

  • 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."
}