阿里云調(diào)用 API 服務(wù)后返回什么結(jié)果

　　調(diào)用 API 服務(wù)后返回數(shù)據(jù)采用統(tǒng)一格式，返回的 HTTP 狀態(tài)碼為 2xx，代表調(diào)用成功;返回 4xx 或 5xx 的 HTTP 狀態(tài)碼代表調(diào)用失敗。調(diào)用成功返回的數(shù)據(jù)格式主要有 XML 和 JSON 兩種，外部系統(tǒng)可以在請求時傳入?yún)?shù)來制定返回的數(shù)據(jù)格式，默認(rèn)為 XML 格式。本文檔中的返回示例為了便于用戶查看，做了格式化處理，實際返回結(jié)果是沒有進(jìn)行換行、縮進(jìn)等處理的。

　　成功結(jié)果

　　錯誤結(jié)果

　　調(diào)用接口出錯后，將不會返回結(jié)果數(shù)據(jù)。調(diào)用方可根據(jù)每個接口對應(yīng)的錯誤碼以及下述 2.3.3 的公共錯誤碼來定位錯誤原因。當(dāng)調(diào)用出錯時，HTTP 請求返回一個 4xx 或 5xx 的 HTTP 狀態(tài)碼。返回的消息體中是具體的錯誤代碼及錯誤信息。另外還包含一個全局唯一的請求 ID：RequestId 和一個您該次請求訪問的站點 ID：HostId。在調(diào)用方找不到錯誤原因時，可以聯(lián)系阿里云客服，并提供該 HostId 和 RequestId，以便我們盡快幫您解決問題。

　　公共錯誤碼

錯誤代碼 描述 Http 狀態(tài)碼 語義
MissingParameter   The input parameter “Action” that is mandatory for processing this request is not supplied   400   缺少 Action 字段  
MissingParameter   The input parameter “AccessKeyId” that is mandatory for processing this request is not supplied   400   缺少 AccessKeyId 字段  
MissingParameter   An input parameter “Signature” that is mandatory for processing the request is not supplied.   400   缺少 Signature 字段  
MissingParameter   The input parameter “TimeStamp” that is mandatory for processing this request is not supplied   400   缺少 Timestamp 字段  
MissingParameter   The input parameter “Version” that is mandatory for processing this request is not supplied   400   缺少 Version 字段  
InvalidParameter   The specified parameter “Action or Version” is not valid.   400   無效的 Action 值（該 API 不存在）  
InvalidAccessKeyId.NotFound   The Access Key ID provided does not exist in our records.   400   無效的 AccessKeyId 值（該 key 不存在）  
Forbidden.AccessKeyDisabled   The Access Key is disabled.   403   該 AccessKey 處于禁用狀態(tài)  
IncompleteSignature   The request signature does not conform to Aliyun standards.   400   無效的 Signature 取值（簽名結(jié)果錯誤）  
InvalidParamater   The specified parameter “SignatureMethod” is not valid.   400   無效的 SignatureMethod 取值  
InvalidParamater   The specified parameter “SignatureVersion” is not valid.   400   無效的 SignatureVersion 取值  
IllegalTimestamp   The input parameter “Timestamp” that is mandatory for processing this request is not supplied.   400   無效的 Timestamp 取值（Timestamp 與服務(wù)器時間相差超過了 1 個小時）  
SignatureNonceUsed   The request signature nonce has been used.   400   無效的 SignatureNonce（該 SignatureNonce 值已被使用過）  
InvalidParameter   The specified parameter “Action or Version” is not valid.   400   無效的 Version 取值  
InvalidOwnerId   The specified OwnerId is not valid.   400   無效的 OwnerId 取值  
InvalidOwnerAccount   The specified OwnerAccount is not valid.   400   無效的 OwnerAccount 取值  
InvalidOwner   OwnerId and OwnerAccount can’t be used at one API access.   400   同時使用了 OwnerId 和 OwnerAccount  
Throttling   Request was denied due to request throttling.   400   因系統(tǒng)流控拒絕訪問  
Throttling   Request was denied due to request throttling.   400   該 key 的調(diào)用 quota 已用完  
InvalidAction   Specified action is not valid.   403   該 key 無權(quán)調(diào)用該 API  
UnsupportedHTTPMethod   This http method is not supported.   403   用戶使用了不支持的 Http Method（當(dāng)前 TOP 只支持 post 和 get）  
ServiceUnavailable   The request has failed due to a temporary failure of the server.   500   服務(wù)不可用  
UnsupportedParameter   The parameter ”” is not supported.   400   使用了無效的參數(shù)  
InternalError   The request processing has failed due to some unknown error, exception or failure.   500   其他情況  
MissingParameter   The input parameter OwnerId,OwnerAccount that is mandatory for processing this request is not supplied.   403   調(diào)用該接口沒有指定 OwnerId  
Forbidden.SubUser   The specified action is not available for you。   403   無權(quán)調(diào)用訂單類接口  
UnsupportedParameter   The parameter ”” is not supported.   400   該參數(shù)無權(quán)使用  
Forbidden.InstanceNotFound   The specified Instance is not found, so we cann’t get enough information to check permission in RAM.   404   使用了 RAM 授權(quán)子賬號進(jìn)行資源訪問，但是本次訪問涉及到的 Instance 不存在  
Forbidden.DiskNotFound   The specified Disk is not found, so we cann’t get enough information to check permission in RAM.   404   使用了 RAM 授權(quán)子賬號進(jìn)行資源訪問,但是本次訪問涉及到的 Disk 不存在  
Forbidden.SecurityGroupNotFound   The specified SecurityGroup is not found, so we cann’t get enough information to check permission in RAM.   404   使用了 RAM 授權(quán)子賬號進(jìn)行資源訪問,但是本次訪問涉及到的 SecurityGroup 不存在  
Forbidden.SnapshotNotFound   The specified Snapshot is not found, so we cann’t get enough information to check permission in RAM.   404   使用了 RAM 授權(quán)子賬號進(jìn)行資源訪問,但是本次訪問涉及到的 Snapshot 不存在  
Forbidden.ImageNotFound   The specified Image is not found, so we cann’t get enough information to check permission in RAM.   404   使用了 RAM 授權(quán)子賬號進(jìn)行資源訪問,但是本次訪問涉及到的 Image 不存在  
Forbidden.RAM   User not authorized to operate the specified resource, or this API doesn’t support RAM.   403   使用了 RAM 授權(quán)子賬號進(jìn)行資源訪問,但是本次操作沒有被正確的授權(quán)  
Forbidden.NotSupportRAM   This action does not support accessed by RAM mode.   403   該接口不允許使用 RAM 方式進(jìn)行訪問  
InsufficientBalance   Your account does not have enough balance.   400   余額不足  
IdempotentParameterMismatch   Request uses a client token in a previous request but is not identical to that request.   400   使用了一個已經(jīng)使用過的 ClientToken，但此次請求內(nèi)容卻又與上一次使用該 Token 的 request 不一樣.  
RealNameAuthenticationError   Your account has not passed the real-name authentication yet.   403   用戶未進(jìn)行實名認(rèn)證  
InvalidIdempotenceParameter.Mismatch   The specified parameters are different from before   403   冪等參數(shù)不匹配  
LastTokenProcessing   The last token request is processing   403   上一次請求還在處理中  
InvalidParameter   The specified parameter is not valid   400   參數(shù)校驗失敗