錯誤的參考碼

您正在查看 Apigee Edge 說明文件。
查看 Apigee X 說明文件
資訊

Apigee 針對各種功能提供一組錯誤代碼,可協助您診斷問題。舉例來說,一般的 4xx5xx HTTP 狀態碼可以使用一或多個錯誤代碼加以分類。

錯誤程式碼可以提供執行階段錯誤的相關實用資訊,包括錯誤來源和名稱,格式如下:[prefix].[error_name]

例如:steps.raisefault.RaiseFault

在這個例子中:

  • steps.raisefault 是前置字串,表示 riseFault 政策產生了錯誤。
  • RaiseFault 是錯誤名稱,可協助您判斷錯誤原因。在此情況下,錯誤字串會提供更多資訊。

下表歸納了各個錯誤代碼,並依類別和子類別分類。

注意設定快訊時,錯誤代碼會依照類別和子類別分類,並顯示使用者可理解的名稱。比較指標之間的關聯活動時,系統會顯示原始錯誤碼。

類別 子類別 名稱 錯誤代碼

API 通訊協定

HTTP

HTTP BadFormData protocol.http.BadFormData
HTTP BadRequestPath protocol.http.BadPath
HTTP DuplicateHeader protocol.http.DuplicateHeader
HTTP EmptyHeaderName protocol.http.EmptyHeaderName
HTTP HeaderNameWithNonASCIICharacter protocol.http.HeaderNameWithNonAsciiChar
HTTP HeaderWithInvalidCharacter protocol.http.HeaderWithInvalidChar
HTTP InvalidRequestPath protocol.http.InvalidPath
HTTP 長度必填 messaging.adaptors.http.flow.LengthRequired
HTTP ProxyTunnelCreationFailed protocol.http.ProxyTunnelCreationFailed
HTTP RequestHasABigBody protocol.http.TooBigBody
HTTP RequestAskABigLine protocol.http.TooBigLine
HTTP Response306IsReserved protocol.http.Response306Reserved
HTTP Response405WithoutAllowHeader protocol.http.Response405WithoutAllowHeader
ResponseWithBodyForIncorrectStatusCode protocol.http.ResponseWithBody
HTTP TargetURLHasEmptyPath protocol.http.EmptyPath
HTTP TooBigHeaders protocol.http.TooBigHeaders
HTTP 不支援編碼 protocol.http.UnsupportedEncoding

開發人員/應用程式

金鑰管理

KeyManagement AccessTokenNotApproval keymanagement.service.access_token_not_approved
KeyManagement APIProductNotFound keymanagement.service.InvalidAPICallAsNoApiProductMatchFound
Key Management 應用程式未獲核准 keymanagement.service.invalid_client-app_not_approved
Key Management 應用程式未獲核准 keymanagement.service.app_not_approved
KeyManagement AuthorizationCodeired keymanagement.service.access_denied-authorization_code_expired
KeyManagement AuthorizationCode 無效 keymanagement.service.invalid_request-authorization_code_invalid
KeyManagement ClientIDAuthorizationCodeMismatch keymanagement.service.invalid_client-client_id_authorzation_code_mismatch
KeyManagement ClientID 未核准 keymanagement.service.invalid_client-client_id_not_approved
KeyManagement CompanyStatus 未啟用 keymanagement.service.CompanyStatusNotActive
KeyManagement 用戶端金鑰已過期 keymanagement.service.consumer_key_expired
KeyManagement 開發人員未啟用 keymanagement.service.DeveloperStatusNotActive
KeyManagement InvalidAccessToken keymanagement.service.oauth10_access_token_doesnotexist
KeyManagement InvalidClientID 無效 keymanagement.service.InvalidClientIdForGivenResource
KeyManagement InvalidClientID 無效 keymanagement.service.invalid_client-client_id_authorzation_code_mismatch
KeyManagement InvalidClientID 無效 keymanagement.service.invalid_client-invalid_client_id
KeyManagement InvalidConsumerKey keymanagement.service.invalid_consumer_key
KeyManagement InvalidRefreshToken keymanagement.service.invalid_refresh_token
KeyManagement RefreshTokenExpired keymanagement.service.refresh_token_expired

擴充功能政策

JavaCallout

Java 呼叫 errorname 請參閱「Java 呼叫政策執行階段錯誤」一文。

JavaScript 呼叫

JavaScript 呼叫 errorname 請參閱 JavaScript 政策執行階段錯誤

MessageLogging

MessageLogging StepDefinitionExecutionFailed steps.messagelogging.StepDefinitionExecutionFailed

節點指令碼

NodeScript ExecutionError scripts.node.ScriptExecutionError

PythonScript

PythonScript errorname 請參閱 PythonScript 政策執行階段錯誤

腳本

指令碼評估失敗 steps.script.ScriptEvaluationFailed

ServiceCallout

服務呼叫 errorname 請參閱「Service callout 政策執行階段錯誤」。

閘道

Proxy

Gateway APITimedOut flow.APITimedOut
閘道 ApplicationNotFound messaging.adaptors.http.flow.ApplicationNotFound
Gateway DecompressionFailureAtRequest messaging.adaptors.http.flow.DecompressionFailureAtRequest
Gateway DecompressionFailureAtResponse messaging.adaptors.http.flow.DecompressionFailureAtResponse
Gateway KeyAliasNotFound security.util.KeyAliasNotFound
Gateway RouteToTargetFailed messaging.runtime.RouteFailed
Gateway SharedFlowNotFound flow.SharedFlowNotFound
缺少閘道目標 messaging.runtime.TargetMissing

目標

Gateway InvalidHandshakeWithTargetEndpoint messaging.adaptors.http.flow.SslHandshakeFailed
Gateway TimeoutWithTargetOr 號 messaging.adaptors.http.flow.GatewayTimeout
Gateway TargetOr calloutEndpointNotAvailable messaging.adaptors.http.flow.ServiceUnavailable
Gateway TargetServerConfiguredInLoadBalancerIsDown messaging.adaptors.http.flow.NoActiveTargets
Gateway UnexpectedEOFAtTarget messaging.adaptors.http.flow.UnexpectedEOFAtTarget

其他

閘道 HTTPErrorResponseCode messaging.adaptors.http.flow.ErrorResponseCode

中介服務政策

AssignMessage

AssignMessage errorname 請參閱「AssignMessage 政策執行階段錯誤」一文

ExtractVariables

擷取變數 errorname 請參閱「擷取變數政策執行階段錯誤」一文

JSONtoXML

JSONtoXML 錯誤名稱 請參閱 JSONtoXML 政策執行階段錯誤

KeyValueMap

KeyValueMap errorname 請參閱 KeyValueMapOperations 政策執行階段錯誤

MessageValidation

MessageValidation errorname 請參閱 SOAPMessageValidation 政策執行階段錯誤

RaiseFault

LiftFault IncreaseFaultException steps.raisefault.RaiseFault

XMLtoJSON

XMLtoJSON errorname 請參閱 XMLtoJSON 政策執行階段錯誤

XSLTransformation

XSLTransformation errorname 請參閱 XSLTransform 政策執行階段錯誤

營利

Mint 未定義的產品 mintstep.undefinedProduct

安全性政策

AccessControl

AccessControl errorname 請參閱 AccessControl 政策執行階段錯誤

BasicAuthentication

BasicAuthentication errorname 請參閱 BasicAuthentication 政策執行階段錯誤

JSONThreatProtection

JSONThreatProtection errorname 請參閱 JSONThreatProtection 政策執行階段錯誤

JWT

JWT errorname 請參閱 JWT 政策執行階段錯誤一文

OAuth

OAuth errorname 請參閱 OAuth V2 政策執行階段錯誤

規則運算式保護

RegexProtection errorname 請參閱 RegularExpressionProtection 政策執行階段錯誤

SAMLAssertion

SAMLAssertion InvalidKeyStore steps.saml.generate.InvalidKeyStore
SAMLAssertion InvalidMediaType steps.saml.generate.InvalidMediaTpe
SAMLAssertion InvalidTrustStore steps.saml.validate.InvalidTrustStore
SAMLAssertion SAMLAssertionForNotBeforeConditionViolated steps.saml.validate.NotBeforeConditionViolated
SAMLAssertion SignatureValidationFailed steps.saml.validate.SignatureValidationFailed
SAMLAssertion XPathResolutionFailed steps.saml.validate.XPathResolutionFailed

XMLThreatProtection

XMLThreatProtection errorname 請參閱 XMLThreatProtection 政策執行階段錯誤

Sense

Sense

Sense ImprFault messaging.runtime.SenseRaiseFault

流量管理政策

快取

快取 InvalidExpiryDatForCacheEntry messaging.config.beans.InvalidExpiryDateForCacheEntry

ConcurrentRateLimit

ConcurrentRateLimit ConcurrentRateLimitTerms policies.concurrentratelimit.ConcurrentRatelimitViolation

配額

配額 errorname 請參閱配額政策執行階段錯誤

配額或 SpikeArrest

QuotaOrSpikeArrest InvalidMessageWeight policies.ratelimit.InvalidMessageWeight

ResetQuota

重設配額 errorname 請參閱 ResetQuota 政策執行階段錯誤

SpikeArrest

SpikeArrest errorname 請參閱 SpikeArrest 政策執行階段錯誤