所有的返回都会带上RequestId、Action、Version、Service、Region等字段。
接口调用成功后会返回RequestId和接口返回参数,我们称这样的返回为正常返回。HTTP 状态码为2xx。
{ "ResponseMetadata": { "RequestId": "202305151154564F7C9BB252D644F11A54", "Action": "ModifyVolumeAttribute", "Version": "2020-04-01", "Service": "storage_ebs", "Region": "cn-beijing" }, "Result": {} }
请求被正常处理后,返回中会包含ResponseMetadata
和Result
两部分,Result
视请求的接口而定,不同的接口会有不同的Result返回。字段解释如下:
字段 | 解释 |
---|---|
RequestId | RequestId为每次API请求的唯一标识。 |
Action | 请求的接口名,属于请求的公共参数。 |
Version | 请求的版本号,属于请求的公共参数。 |
Service | 请求的服务,属于请求的公共参数。 |
Region | 服务所在的地域信息,属于请求的公共参数。 |
接口调用出错后,会返回RequestId和错误信息,我们称这样的返回为异常返回。HTTP状态码为4xx或5xx。
您可以根据接口错误代码Code和错误信息Message,参考公共错误码和接口错误码排查错误。
{ "ResponseMetadata": { "RequestId": "202010201722300102****", "Action": "ModifyVolumeAttribute", "Version": "2018-01-01", "Service": "storage_ebs", "Region": "cn-beijing", "Error": { "Code": "InvalidActionOrVersion", "Message": "Could not find operation GetUserById for version 2018-01-01" } } }
相较于成功结果,错误结果将不再有Result
部分,而ResponseMetadata
中将额外出现Error字段,包括Code和Message。字段解释如下:
字段 | 解释 |
---|---|
Error | Error出现表明本次请求失败。 |
Code | Code内容为具体的错误码,您可根据错误码查询文档自助解决问题。 |
Message | Message描述了错误发生的具体原因,供您排查问题参考。 |
RequestId | RequestId是每次API请求的唯一标识,当出现了无法自助解决的问题时,您可通过工单系统联系我们,提供请求的RequestId,我们将协助进行故障排查。 |