返回結(jié)果
調(diào)用API服務(wù)后，系統(tǒng)會返回HTTP狀態(tài)碼。如果返回的狀態(tài)碼為2xx，表示調(diào)用成功。如果返回的狀態(tài)碼為4xx或5xx，表示調(diào)用失敗。
對于返回結(jié)果的說明如下：
調(diào)用成功返回的數(shù)據(jù)格式暫時只支持JSON。
如果您使用外部系統(tǒng)發(fā)送請求，可在參數(shù)中定制返回的數(shù)據(jù)格式。
本文檔中的返回示例為了便于用戶查看，做了斷行處理。
正常返回示例
JSON示例
{
"Name": "CreateTest",
"OssBucketName": "yuanchuang",
"OssKeyPrefix": "",
"RoleName": "aliyunactiontraildefaultrole"
} 異常返回示例
調(diào)用接口出錯后，不會返回結(jié)果數(shù)據(jù)。調(diào)用方可根據(jù)每個接口對應(yīng)的錯誤碼以及公共錯誤碼來定位錯誤原因。
調(diào)用API報錯后，將在response中返回HTTP狀態(tài)碼、錯誤碼和錯誤信息，還會包括該次請求在全局的唯一標(biāo)識RequestId。若您根據(jù)錯誤碼和錯誤信息無法明確問題，可將RequestId提供給技術(shù)支持人員，幫忙快速定位到該條請求日志。
JSON示例
{
"RequestId": "0BC51021-1740-4C13-8072-4C1CD1D6B1F2",
"Name": "CreateTest",
"OssBucketName": "yuanchuang",
"OssKeyPrefix": "",
"RoleName": "aliyunactiontraildefaultrole"
} 公共錯誤碼
名稱 | 描述 | 狀態(tài)碼 |
InvalidAction | 非法的Action。 | 400 |
InvalidParameterValue | 不支持的參數(shù)值。 | 400 |
MissingAction | 缺少Action參數(shù)。 | 400 |
MissingParameter | 缺少必選參數(shù)。 | 400 |
InvalidAccessKeyId.Inactive | AccessKeyId被禁用。 | 403 |
NeedRamAuthorize | RAM授權(quán)用戶不存在。 | 403 |
InternalFailure | 內(nèi)部服務(wù)未知錯誤。 | 500 |
InternalServerError | 內(nèi)部服務(wù)錯誤。 | 500 |
ActionNotImplemented | 指定的Action未實現(xiàn)。 | 501 |
ServiceUnavailable | 服務(wù)不可用。 | 503 |