返回结果主要有XML和JSON两种格式,默认为XML,您可以指定公共请求参数Format变更返回结果的格式。

成功结果

返回的HTTP状态码为2xx,代表调用成功。 返回的HTTP状态码为4xx或5xx,代表调用失败。

说明 为了便于查看,API文档返回示例均有换行和缩进等处理,实际返回结果无换行和缩进处理。
JSON示例
{
    "RequestId":"16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}

错误结果

调用接口出错后,不会返回结果数据。调用方可根据每个接口对应的错误码以及下述公共错误码来定位错误原因。 当调用出错时,HTTP请求返回一个4xx或5xx的HTTP状态码。返回的消息体中是具体的错误代码及错误信息,另外还包含一个全局唯一的请求ID(RequestId)和一个本次请求访问的站点ID(HostId)。

在调用方找不到错误原因时,可以联系阿里云客服,提供该HostId和RequestId,以便我们尽快帮您解决问题。

JSON示例
{
    "Code":"InternalError",
    "HostId":"live.aliyuncs.com",
    "Message":"The request processing has failed due to some unknown error.",
    "RequestId":"6EBD1AC4-C34D-4AE1-963E-B688A228BE31"
}
                

公共错误码

参见:公共错误码表