調用API服務後,系統會返回HTTP狀態代碼。如果返回的狀態代碼為2xx,表示調用成功。如果返回的狀態代碼為4xx或5xx,表示調用失敗。本文檔中的返回樣本為了便於您查看,做了格式化處理,實際返回結果沒有進行換行、縮排等處理。
正常返回樣本
XML樣本
<?xml version="1.0" encoding="UTF-8"?>
<!--結果的根結點-->
<介面名稱+Response>
<!--返回請求標籤-->
<RequestId>4C467B38-3910-447D-87BC-AC049166F216</RequestId>
<!--返回結果資料-->
</介面名稱+Response>JSON樣本
{
"RequestId": "4C467B38-3910-447D-87BC-AC049166F216"
}異常返回樣本
調用介面出錯後,將不會返回結果資料。調用方可根據每個介面對應的錯誤碼以及公用錯誤碼來定位錯誤原因。
當調用API報錯後,將在response中返回HTTP狀態代碼、錯誤碼和錯誤資訊,還會包括該次請求在全域的唯一標識RequestId。若您根據錯誤碼和錯誤資訊無法明確問題,可將RequestId提供給技術支援人員,幫忙快速定位到該條請求日誌。
XML樣本(請求到期)
<KMS>
<HttpStatus>400</HttpStatus>
<Code>IllegalTimestamp</Code>
<Message>The input parameter "Timestamp" that is mandatory for processing this request is not supplied.</Message>
<RequestId>3b237773-bc2c-4bea-95fc-319a1a5baa68</RequestId>
</KMS>JSON樣本(請求到期)
{
"HttpStatus": 400,
"Code": "IllegalTimestamp",
"Message": "The input parameter \"Timestamp\" that is mandatory for processing this request is not supplied.",
"RequestId": "e85db688-a2d3-44ca-9790-4259f59e90d8"
}公用錯誤碼
錯誤碼 | 描述 | HTTP狀態代碼 |
InternalFailure | Internal Failure. | 500 |
ServiceUnavailableTemporary | Service Unavailable Temporary. | 503 |
InvalidAccessKeyId.NotFound | The AccessKey ID provided does not exist in our records. 說明 STS Token到期時也可能會提示該報錯。 | 404 |
Forbidden.KeyNotFound | The specified Key is not found. | 404 |
Forbidden.KeyVersionNotFound | The specified Key version is not found. | 404 |
Forbidden.AliasNotFound | The specified Alias is not found. | 404 |
Forbidden.NoPermission | This operation is forbidden by permission system. 說明 STS Token到期時也可能會提示該報錯。 | 403 |
Forbidden.AccessKey | This AccessKey is not enabled. 說明 STS Token到期時也可能會提示該報錯。 | 403 |
UnsupportedHTTPMethod | This http method is not supported. | 403 |
Forbidden.UbsmsInvalidUserid | Userid Invalid For Ubsms. | 403 |
Forbidden.UbsmsInvalidBid | Your account partner does not have KMS Service. | 403 |
Forbidden.KmsServiceNotEnabled | Kms service is not Enabled for current user. Please get access permission first. | 403 |
Forbidden.ProhibitedByRiskControl | Current user is Prohibited By Risk Control. | 403 |
Forbidden.InDebtOverdue | Current user is indebted Overdue. | 403 |
Forbidden.InDebt | Current user is indebted. | 403 |
ParseRequestParameterException | Server parse parameters exception. Please check your input params. | 400 |
MissingParameter | The parameter "< parameter name >" is needed but not provided. | 400 |
InvalidParameter | The specified parameter "< parameter name >" is not valid. | 400 |
IncompleteSignature | The request signature does not conform to Alibaba Cloud standards. | 400 |
IllegalTimestamp | The input parameter "Timestamp" that is required for processing this request is not supplied. | 400 |
Rejected.LimitExceeded | The request was rejected because user create resource limit was exceeded. | 400 |
AliasAlreadyExists | AliasName Already Exists. | 400 |
InvalidKeyMaterial | key material is invalid. | 400 |
InvalidImportToken | import token is invalid. | 400 |
ExpiredImportToken | import token is expired. | 400 |
Unsupported.Origin | This key origin is not valid for this api. | 400 |
Unsupported.Alias | Alias is not valid for this api. | 400 |
Unsupported.ProtectionLevel | This protection level is not valid for this region | 400 |
Rejected.StateModifiedFailed | Keystate modified failed. | 409 |
Rejected.Disabled | The request was rejected because the key state is Disabled. | 409 |
Rejected.PendingDeletion | The request was rejected because the key state is PendingDeletion. | 409 |
Rejected.PendingImport | The request was rejected because the key state is PendingImport. | 409 |