Google, içerikleri tercih ettiğiniz dile çevirmek için yapay zeka teknolojisini kullanır. Yapay zeka çevirilerinde hata olabilir.

Politika hatası referansı

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. info

AccessControl politikası

Bu bölümde, bu politika bir hatayı tetiklediğinde döndürülen hata kodları ve hata mesajlarının yanı sıra Edge tarafından ayarlanan hata değişkenleri açıklanmaktadır. Hata kuralları geliştirirken bu bilgilerin farkında olmanız önemlidir. hoşuma gitmesi için bir fırsattır. Daha fazla bilgi için Bilmeniz gerekenler Politika hataları ve Kullanım sorun.

Çalışma zamanı hataları

Bu hatalar, politika yürütüldüğünde ortaya çıkabilir.

Hata kodu	HTTP durumu	Neden	Düzelt
`accesscontrol.IPDeniedAccess`	403	İstemci IP adresi veya iletilen IP adresi API isteğinde, `<SourceAddress>` Erişim Denetimi Politikası'nın `<MatchRule>` öğesi ve`action` `<MatchRule>` öğesi, `DENY` olarak ayarlandı.

Hata değişkenleri

Bu değişkenler, çalışma zamanı hatası oluştuğunda ayarlanır. Daha fazla bilgi için Politika hatalarına özel değişkenler bölümüne bakın.

Değişkenler	Konum	Örnek
`fault.name="fault_name"`	`fault_name`, yukarıdaki Çalışma zamanı hataları tablosunda listelendiği gibi hatanın adıdır. Hata adı, hata kodunun son kısmıdır.	`fault.name Matches "IPDeniedAccess"`
`acl.policy_name.failed`	`policy_name`, hataya neden olan politikanın kullanıcı tarafından belirtilen adıdır.	`acl.AC-AllowAccess.failed = true`

Örnek hata yanıtı

Not: Hata giderme için en iyi uygulama, Hata yanıtının errorcode bölümü. Yalnızca faultstring, değişebileceği için.

{
   "fault":{
     "faultstring":"Access Denied for client ip : 52.211.243.3"
      "detail":{
         "errorcode":"accesscontrol.IPDeniedAccess"
      }
   }
}

Örnek hata kuralı

<FaultRule name="IPDeniedAccess">
    <Step>
        <Name>AM-IPDeniedAccess</Name>
        <Condition>(fault.name Matches "IPDeniedAccess") </Condition>
    </Step>
    <Condition>(acl.failed = true) </Condition>
</FaultRule>

AccessEntity politikası

İlgili bilgiler için Politika hataları hakkında bilmeniz gerekenler ve Hataları işleme bölümlerine bakın.

Çalışma zamanı hataları

Yok.

Dağıtım hataları

Hata adı	Hata dizesi	HTTP durumu	Gerçekleşme zamanı:
`InvalidEntityType`	`Invalid type [entity_type] in ACCESSENTITYStepDefinition [policy_name]`	Yok	Kullanılan varlık türü, desteklenen türlerden biri olmalıdır.

AssignMessage politikası

Çalışma zamanı hataları

Bu hatalar, politika yürütüldüğünde ortaya çıkabilir.

Hata kodu HTTP durumu Neden Düzelt

steps.assignmessage.SetVariableFailed 500 Politika, değişken ayarlayamadı. çözümlenmemiş değişkendir.

Hata kodu	HTTP durumu	Neden
`steps.assignmessage.SetVariableFailed`	500	Politika, değişken ayarlayamadı. çözümlenmemiş değişkendir.
`steps.assignmessage.VariableOfNonMsgType`	500	Bu hata, `<Copy>` öğesindeki `source` özelliği bir değişkene ayarlanırsa ortaya çıkar Bu mesaj, mesaj türünde değildir. Mesaj türü değişkenleri, HTTP isteklerinin ve yanıtlarının tamamını temsil eder. Yerleşik Edge `request`, `response` ve `message` akış değişkenleri mesaj türünde. Daha fazla bilgi edinmek için hakkında daha fazla bilgi için Değişkenler referansı bölümüne bakın.
`steps.assignmessage.UnresolvedVariable`	500	Bu hata, İleti Ata politikasında belirtilen değişken aşağıdakilerden biri olduğunda ortaya çıkar: kapsam dışında (politikanın yürütüldüğü belirli akışta kullanılamaz) veya çözülemiyor (tanımlanmamış)

steps.assignmessage.VariableOfNonMsgType

500

Bu hata, <Copy> öğesindeki source özelliği bir değişkene ayarlanırsa ortaya çıkar Bu mesaj, mesaj türünde değildir.

Mesaj türü değişkenleri, HTTP isteklerinin ve yanıtlarının tamamını temsil eder. Yerleşik Edge request, response ve message akış değişkenleri mesaj türünde. Daha fazla bilgi edinmek için hakkında daha fazla bilgi için Değişkenler referansı bölümüne bakın.

steps.assignmessage.UnresolvedVariable

500

Bu hata, İleti Ata politikasında belirtilen değişken aşağıdakilerden biri olduğunda ortaya çıkar:

kapsam dışında (politikanın yürütüldüğü belirli akışta kullanılamaz)
çözülemiyor (tanımlanmamış)

Dağıtım hataları

Bu politikayı içeren bir proxy dağıttığınızda bu hatalar oluşabilir.

Hata adı	Neden	Düzelt
`InvalidIndex`	İleti Ata aracının `<Copy>` ve/veya `<Remove>` öğelerinde belirtilen dizin politika 0 veya negatif bir sayı olursa API Proxy'sinin dağıtımı başarısız olur.
`InvalidVariableName`	`<Name>` alt öğesi boşsa veya `<AssignVariable>` öğesinde belirtilmemişse geçerli bir değişken adı olmadığından API proxy’sinin dağıtımı için bir değer atanır. Geçerli bir değişken adı gerekiyor.
`InvalidPayload`	Politikada belirtilen bir yük geçersiz.

Hata değişkenleri

Bu değişkenler, politika çalışma zamanında bir hatayı tetiklediğinde ayarlanır. Daha fazla bilgi için Ne, ne ve ne zaman bilmeniz gerekir.

Değişkenler	Konum	Örnek
`fault.name="fault_name"`	`fault_name`, yukarıdaki Çalışma zamanı hataları tablosunda listelendiği gibi hatanın adıdır. Hata adı, hata kodunun son kısmıdır.	`fault.name Matches "UnresolvedVariable"`
`assignmessage.policy_name.failed`	`policy_name`, hataya neden olan politikanın kullanıcı tarafından belirtilen adıdır.	`assignmessage.AM-SetResponse.failed = true`

Örnek hata yanıtı

Not: Hata işleme için en iyi uygulama, Hata yanıtının errorcode bölümü. Yalnızca faultstring, çünkü değişebilir.

{  
   "fault":{  
      "detail":{  
         "errorcode":"steps.assignmessage.VariableOfNonMsgType"
      },
      "faultstring":"AssignMessage[AM-SetResponse]: value of variable is not of type Message"
   }
}

Örnek hata kuralı

    <FaultRule name="Assign Message Faults">    <Step>
        <Name>AM-CustomNonMessageTypeErrorResponse</Name>
        <Condition>(fault.name Matches "VariableOfNonMsgType") </Condition>
    </Step>
    <Step>
        <Name>AM-CustomSetVariableErrorResponse</Name>
        <Condition>(fault.name = "SetVariableFailed")</Condition>
    </Step>
    <Condition>(assignmessage.failed = true) </Condition>
</FaultRule>

BasicAuthentication politikası

This section describes the fault codes and error messages that are returned and fault variables that are set by Edge when this policy triggers an error. This information is important to know if you are developing fault rules to handle errors. To learn more, see What you need to know about policy errors and Handling faults.

Runtime errors

These errors can occur when the policy executes.

Fault code	HTTP status	Cause	Fix
`steps.basicauthentication.InvalidBasicAuthenticationSource`	500	On a decode when the incoming Base64 encoded string does not contain a valid value or the header is malformed (e.g., does not start with "Basic").
`steps.basicauthentication.UnresolvedVariable`	500	The required source variables for the decode or encode are not present. This error can only occur if `IgnoreUnresolvedVariables` is false.

Deployment errors

These errors can occur when you deploy a proxy containing this policy.

Error name	Occurs when	Fix
`UserNameRequired`	The `<User>` element must be present for the named operation.
`PasswordRequired`	The `<Password>` element must be present for the named operation.
`AssignToRequired`	The `<AssignTo>` element must be present for the named operation.
`SourceRequired`	The `<Source>` element must be present for the named operation.

Fault variables

These variables are set when a runtime error occurs. For more information, see What you need to know about policy errors.

Variables	Where	Example
`fault.name="fault_name"`	`fault_name` is the name of the fault, as listed in the Runtime errors table above. The fault name is the last part of the fault code.	`fault.name Matches "UnresolvedVariable"`
`BasicAuthentication.policy_name.failed`	`policy_name` is the user-specified name of the policy that threw the fault.	`BasicAuthentication.BA-Authenticate.failed = true`

Example error response

Note: For error handling, the best practice is to trap the errorcode part of the error response. Do not rely on the text in the faultstring, because it could change.

{  
   "fault":{  
      "detail":{  
         "errorcode":"steps.basicauthentication.UnresolvedVariable"
      },
      "faultstring":"Unresolved variable : request.queryparam.password"
   }
}

Example fault rule

<FaultRule name="Basic Authentication Faults">
    <Step>
        <Name>AM-UnresolvedVariable</Name>
        <Condition>(fault.name Matches "UnresolvedVariable") </Condition>
    </Step>
    <Step>
        <Name>AM-AuthFailedResponse</Name>
        <Condition>(fault.name = "InvalidBasicAuthenticationSource")</Condition>
    </Step>
    <Condition>(BasicAuthentication.BA-Authentication.failed = true) </Condition>
</FaultRule>

ConcurrentRateLimit politikası

Bu bölümde, bu politika bir hatayı tetiklediğinde döndürülen hata kodları ve hata mesajlarının yanı sıra Edge tarafından ayarlanan hata değişkenleri açıklanmaktadır. Hata kuralları geliştirirken bu bilgilerin farkında olmanız önemlidir. işleyeceğiz. Daha fazla bilgi için Bilmeniz gerekenler Politika hataları ve Kullanım sorun.

Çalışma zamanı hataları

Bu hatalar, politika yürütüldüğünde ortaya çıkabilir.

Hata kodu HTTP durumu Şu durumda gerçekleşir:

Hata kodu	HTTP durumu	Şu durumda gerçekleşir:
`policies.concurrentratelimit.ConcurrentRatelimtViolation`	503	ConcurrentRatelimit bağlantısı aşıldı. Bağlantı sınırı : {0} Not: Sol tarafta gösterilen Hata kodu doğru olsa da yazım hatası ("limt") içeriyor. Kodu tam olarak burada gösterildiği şekilde kullandığınızdan emin olun hata kuralları oluştururken kullanabilirsiniz.

policies.concurrentratelimit.ConcurrentRatelimtViolation

503

ConcurrentRatelimit bağlantısı aşıldı. Bağlantı sınırı : {0}

Not: Sol tarafta gösterilen Hata kodu doğru olsa da yazım hatası ("limt") içeriyor. Kodu tam olarak burada gösterildiği şekilde kullandığınızdan emin olun hata kuralları oluştururken kullanabilirsiniz.

Dağıtım hataları

Hata adı	Şu durumda gerçekleşir:
`InvalidCountValue`	ConcurrentRatelimit geçersiz sayı değeri belirtildi.
`ConcurrentRatelimitStepAttachment\ NotAllowedAtProxyEndpoint`	Proxy'de eşzamanlı Hız sınırı politikası {0} ekine izin verilmiyor istek/yanıt/hata yollarıyla ilişkilidir. Bu politika Hedef Uç Noktaya yerleştirilmelidir.
`ConcurrentRatelimitStepAttachment\ MissingAtTargetEndpoint`	Hedef istek/yanıt/hatada eşzamanlı Hız sınırı politikası {0} eki eksik yollar. Bu politika, Hedef İstek Ön Akışı, Hedef Yanıt Sonrası Akışına, ve DefaultFaultRule içerir.
`InvalidTTLForMessageTimeOut`	İleti zaman aşımı için ConcurrentRatelimit geçersiz ttl değeri belirtildi. Bu bir pozitif tam sayıdır.

Hata değişkenleri

Bu değişkenler, politika bir hatayı tetiklediğinde ayarlanır. Daha fazla bilgi için Bilmeniz gerekenler hakkında daha fazla bilgi edinin.

Değişkenler	Konum	Örnek
`fault.name="fault_name"`	`fault_name`, yukarıdaki Çalışma zamanı hataları tablosunda listelendiği gibi hatanın adıdır. Hata adı, hata kodunun son kısmıdır.	`fault.name Matches "ConcurrentRatelimtViolation"` Not: Örnekte gösterilen Hata kodu doğru olsa da yazım hatası ("limt") içeriyor. Kodu tam olarak burada gösterildiği şekilde kullandığınızdan emin olun hata kuralları oluştururken kullanabilirsiniz.
`concurrentratelimit.policy_name.failed`	`policy_name`, hataya neden olan politikanın kullanıcı tarafından belirtilen adıdır.	`concurrentratelimit.CRL-RateLimitPolicy.failed = true`

Örnek hata yanıtı

Oran sınırı aşılırsa politika istemciye yalnızca bir HTTP durumu 503 döndürür.

Örnek hata kuralı

<faultrule name="VariableOfNonMsgType"></faultrule><FaultRules>
    <FaultRule name="Quota Errors">
        <Step>
            <Name>JavaScript-1</Name>
            <Condition>(fault.name Matches "ConcurrentRatelimtViolation") </Condition>
        </Step>
        <Condition>concurrentratelimit.CRL-RateLimitPolicy.failed=true</Condition>
    </FaultRule>
</FaultRules>

DecodeJWS politikası

This section describes the fault codes and error messages that are returned and fault variables that are set by Edge when this policy triggers an error. This information is important to know if you are developing fault rules to handle faults. To learn more, see What you need to know about policy errors and Handling faults.

Runtime errors

These errors can occur when the policy executes.

Fault code	HTTP status	Occurs when
`steps.jws.FailedToDecode`	401	The policy was unable to decode the JWS. The JWS is possibly corrupted.
`steps.jws.FailedToResolveVariable`	401	Occurs when the flow variable specified in the `<Source>` element of the policy does not exist.
`steps.jws.InvalidClaim`	401	For a missing claim or claim mismatch, or a missing header or header mismatch.
`steps.jws.InvalidJsonFormat`	401	Invalid JSON found in the JWS header.
`steps.jws.InvalidJws`	401	This error occurs when the JWS signature verification fails.
`steps.jws.InvalidPayload`	401	The JWS payload is invalid.
`steps.jws.InvalidSignature`	401	`<DetachedContent>` is omitted and the JWS has a detached content payload.
`steps.jws.MissingPayload`	401	The JWS payload is missing.
`steps.jws.NoAlgorithmFoundInHeader`	401	Occurs when the JWS omits the algorithm header.
`steps.jws.UnknownException`	401	An unknown exception occurred.

Deployment errors

These errors can occur when you deploy a proxy containing this policy.

Error name Occurs when

InvalidAlgorithm The only valid values are: RS256, RS384, RS512, PS256, PS384, PS512, ES256, ES384, ES512, HS256, HS384, HS512.

Error name	Occurs when
`InvalidAlgorithm`	The only valid values are: RS256, RS384, RS512, PS256, PS384, PS512, ES256, ES384, ES512, HS256, HS384, HS512.
`EmptyElementForKeyConfiguration` `FailedToResolveVariable` `InvalidConfigurationForActionAndAlgorithmFamily` `InvalidConfigurationForVerify` `InvalidEmptyElement` `InvalidFamiliesForAlgorithm` `InvalidKeyConfiguration` `InvalidNameForAdditionalClaim` `InvalidNameForAdditionalHeader` `InvalidPublicKeyId` `InvalidPublicKeyValue` `InvalidSecretInConfig` `InvalidTypeForAdditionalClaim` `InvalidTypeForAdditionalHeader` `InvalidValueForElement` `InvalidValueOfArrayAttribute` `InvalidVariableNameForSecret` `MissingConfigurationElement` `MissingElementForKeyConfiguration` `MissingNameForAdditionalClaim` `MissingNameForAdditionalHeader`	Other possible deployment errors.

EmptyElementForKeyConfiguration

FailedToResolveVariable

InvalidConfigurationForActionAndAlgorithmFamily

InvalidConfigurationForVerify

InvalidEmptyElement

InvalidFamiliesForAlgorithm

InvalidKeyConfiguration

InvalidNameForAdditionalClaim

InvalidNameForAdditionalHeader

InvalidPublicKeyId

InvalidPublicKeyValue

InvalidSecretInConfig

InvalidTypeForAdditionalClaim

InvalidTypeForAdditionalHeader

InvalidValueForElement

InvalidValueOfArrayAttribute

InvalidVariableNameForSecret

MissingConfigurationElement

MissingElementForKeyConfiguration

MissingNameForAdditionalClaim

MissingNameForAdditionalHeader

Other possible deployment errors.

Hata değişkenleri

Bu değişkenler, çalışma zamanı hatası oluştuğunda ayarlanır. Daha fazla bilgi için Bilmeniz gerekenler hakkında daha fazla bilgi edinin.

Değişkenler	Konum	Örnek
`fault.name="fault_name"`	`fault_name`, yukarıdaki Çalışma zamanı hataları tablosunda listelendiği gibi hatanın adıdır. Hata adı, hata kodunun son kısmıdır.	`fault.name Matches "TokenExpired"`
`JWS.failed`	Tüm JWS politikaları, hata durumunda aynı değişkeni ayarlar.	`jws.JWS-Policy.failed = true`

Örnek hata yanıtı

Hata giderme için en iyi uygulama, hatanın errorcode kısmını yakalamaktır tıklayın. Değişebileceği için faultstring içindeki metne güvenmeyin.

Örnek hata kuralı

<FaultRules>
    <FaultRule name="JWS Policy Errors">
        <Step>
            <Name>JavaScript-1</Name>
            <Condition>(fault.name Matches "TokenExpired")</Condition>
        </Step>
        <Condition>JWS.failed=true</Condition>
    </FaultRule>
</FaultRules>

DecodeJWT politikası

Bu bölümde, bu politika bir hatayı tetiklediğinde Edge tarafından ayarlanan hata kodları ile hata mesajları ve döndürülen hata mesajları ile Edge tarafından ayarlanan hata değişkenleri açıklanmaktadır. Bu bilgiyi, hataları ele almak için hata kuralları geliştirip geliştirmediğinizi bilmeniz önemlidir. Daha fazla bilgi için Politika hataları hakkında bilmeniz gerekenler ve Hataları işleme bölümlerine bakın.

Çalışma zamanı hataları

Politika yürütüldüğünde bu hatalar ortaya çıkabilir.

Hata kodu	HTTP durumu	Neden
`steps.jwt.FailedToDecode`	401	Politika, JWT'nin kodunu çözemediğinde ortaya çıkar. JWT bozuk, geçersiz veya başka bir şekilde kodu çözülemeyebilir.
`steps.jwt.FailedToResolveVariable`	401	Politikanın `<Source>` öğesinde belirtilen akış değişkeni mevcut olmadığında ortaya çıkar.
`steps.jwt.InvalidToken`	401	Politikanın `<Source>` öğesinde belirtilen akış değişkeni kapsam dışında olduğunda veya çözümlenemediğinde ortaya çıkar.

Dağıtım hataları

Bu hatalar, bu politikayı içeren bir proxy dağıttığınızda ortaya çıkabilir.

Hata adı	Neden	Düzelt
`InvalidEmptyElement`	Kodu çözülecek JWT'yi içeren akış değişkeni politikanın `<Source>` öğesinde belirtilmediğinde ortaya çıkar.

Hata değişkenleri

Bu değişkenler, çalışma zamanı hatası oluştuğunda ayarlanır. Daha fazla bilgi için Bilmeniz gerekenler hakkında daha fazla bilgi edinin.

Değişkenler	Konum	Örnek
`fault.name="fault_name"`	`fault_name`, yukarıdaki Çalışma zamanı hataları tablosunda listelendiği gibi hatanın adıdır. Hata adı, hata kodunun son kısmıdır.	`fault.name Matches "TokenExpired"`
`JWT.failed`	Tüm JWT politikaları, hata durumunda aynı değişkeni ayarlar.	`JWT.failed = true`

Örnek hata yanıtı

JWT Politikası Hata Kodları

Hata giderme için en iyi uygulama, hatanın errorcode kısmını yakalamaktır tıklayın. Değişebileceği için faultstring içindeki metne güvenmeyin.

Örnek hata kuralı

    <FaultRules>
        <FaultRule name="JWT Policy Errors">
            <Step>
                <Name>JavaScript-1</Name>
                <Condition>(fault.name Matches "TokenExpired")</Condition>
            </Step>
            <Condition>JWT.failed=true</Condition>
        </FaultRule>
    </FaultRules>

ExtractVariables politikası

Çalışma zamanı hataları

Bu hatalar, politika yürütüldüğünde ortaya çıkabilir.

Hata kodu	HTTP durumu	Neden
`steps.extractvariables.ExecutionFailed`	500	Bu hata aşağıdaki durumlarda oluşur: Giriş yükü (JSON, XML) boş. Politikaya iletilen giriş (JSON, XML vb.) geçersiz veya hatalı biçimlendirilmiş.
`steps.extractvariables.ImmutableVariable`	500	Politikada kullanılan değişkenler sabittir. Politika bunu ayarlayamadı değişkenine eklenmelidir.
`steps.extractvariables.InvalidJSONPath`	500	Bu hata,`JSONPath` politikası. Örneğin, bir JSON yükü `Name` nesnesine sahip değilse ancak politikada yol olarak `Name` değerini belirtirseniz bu hata oluşur.
`steps.extractvariables.JsonPathParsingFailure`	500	Bu hata, politika bir JSON yolunu ayrıştıramadığında ve `Source` öğesinde belirtilen akış değişkeninden verileri ayıklayın. Genellikle bu `Source` öğesinde belirtilen akış değişkeninin geçerli öğede mevcut olmaması, akışı sağlar.
`steps.extractvariables.SetVariableFailed`	500	Bu hata, politika değeri bir değişkene ayarlayamadığında oluşur. Hata genellikle adları ile başlayan birden çok değişkene değer atamaya çalışırsanız aynı kelimeleri iç içe yerleştirilmiş ve noktayla ayrılmış biçimde yazın.
`steps.extractvariables.SourceMessageNotAvailable`	500	Bu hata, ileti politikanın `Source` öğesinde belirtilen değişken şunlardan biridir: Kapsam dışında (politikanın yürütüldüğü belirli akışta kullanılamaz) veya Çözümlenemiyor (tanımlanmamış)
`steps.extractvariables.UnableToCast`	500	Bu hata, politika ayıklanan dosyayı bir değişkene dönüştürün. Bu genellikle bir veri türünü başka bir veri türünün değişkenine dönüştürebilirsiniz.

Dağıtım hataları

Bu politikayı içeren bir proxy dağıttığınızda bu hatalar oluşabilir.

Hata adı	Neden	Düzelt
`NothingToExtract`	Politikada `URIPath`, `QueryParam`, `Header`, `FormParam`, `XMLPayload` veya `JSONPayload`, çıkarılacak bir şey olmadığından API Proxy dağıtımı başarısız olur.
`NONEmptyPrefixMappedToEmptyURI`	Bu hata, politikanın `XMLPayload` öğesinin altında `Namespace` öğesi var ancak URI yok tanımlanmıştır.
`DuplicatePrefix`	Bu hata, politikada şundan daha fazla tanımlanmış aynı ön eke sahipse ortaya çıkar: `XMLPayload` öğesinin altındaki `Namespace` öğesinde bir kez.
`NoXPathsToEvaluate`	Politikanın`XPath` `XMLPayload` öğesi olursa API proxy'sinin dağıtımı bu hatayla başarısız olur. Bir XML yükünden değişkenler çıkarmak isterseniz `XPath` alt öğesi belirtilmelidir.
`EmptyXPathExpression`	Politikanın `XMLPayload` içinde boş bir `XPath` ifadesi varsa öğesini görürseniz API proxy'sinin dağıtımı başarısız olur.
`NoJSONPathsToEvaluate`	Politikanın`JSONPath` `JSONPayload` öğesi olursa API proxy'sinin dağıtımı bu hatayla başarısız olur.
`EmptyJSONPathExpression`	Politikanın`XPath` `XMLPayload` öğesi olursa API proxy'sinin dağıtımı başarısız olur.
`MissingName`	Politikanın hiçbirinde `name` özelliği yoksa `QueryParam`, `Header`, `FormParam` veya `Variable` değerini alırsa API proxy'sinin dağıtımı başarısız olur.
`PatternWithoutVariable`	Politikanın `Pattern` öğesi içinde belirtilmiş bir değişkeni yoksa API proxy'sinin dağıtımı başarısız olur. `Pattern` öğesi için şu ad gerekir: ayıklanan verilerin depolanacağı değişken.
`CannotBeConvertedToNodeset`	Politika, `Variable` türünün olduğu bir `XPath` ifadesi içeriyorsa nodeset olarak tanımlanır ancak ifade düğüm kümesine dönüştürülemezse API proxy'sinin dağıtımı başarısız olur.
`JSONPathCompilationFailed`	Politika, belirtilen bir JSON Yolu'nu derleyemedi.
`InstantiationFailed`	Politika örneklenemedi.
`XPathCompilationFailed`	`XPath` öğesinde kullanılan önek veya değer daha sonra API proxy'sinin dağıtımına izin verildikten sonra başarısız olur.
`InvalidPattern`	`URIPath` gibi öğelerin herhangi birinde `Pattern` öğe tanımı geçersizse `QueryParam`, `Header`, `FormParam`, `XMLPayload` veya politika içinde `JSONPayload`, API proxy'si başarısız oldu. `Pattern` öğesi şu durumda geçersiz olarak kabul edilir: bir değişken içermiyor. Desen eşleştirme hakkında daha fazla bilgi için Eşleme ve değişken oluşturma hakkında.

Hata değişkenleri

Bu değişkenler, politika çalışma zamanında bir hatayı tetiklediğinde ayarlanır. Daha fazla bilgi için Ne, ne ve ne zaman bilmeniz gerekir.

Değişkenler	Konum	Örnek
`fault.name="fault_name"`	`fault_name`, yukarıdaki Çalışma zamanı hataları tablosunda listelendiği gibi hatanın adıdır. Hata adı, hata kodunun son kısmıdır.	`fault.name = "SourceMessageNotAvailable"`
`extractvariables.policy_name.failed`	`policy_name`, hataya neden olan politikanın kullanıcı tarafından belirtilen adıdır.	`extractvariables.EV-ParseJsonResponse.failed = true`

Örnek hata yanıtı

Not: Hata işleme için en iyi uygulama, Hata yanıtının errorcode bölümü. Yalnızca faultstring, çünkü değişebilir.

{
   "fault":{
      "detail":{
         "errorcode":"steps.extractvariables.SourceMessageNotAvailable"
      },
      "faultstring":"request message is not available for ExtractVariable: EV-ParseJsonResponse"
   }
}

Örnek hata kuralı

<FaultRule name="Extract Variable Faults">
    <Step>
        <Name>AM-CustomErrorMessage</Name>
        <Condition>(fault.name = "SourceMessageNotAvailable") </Condition>
    </Step>
    <Condition>(extractvariables.EM-ParseJsonResponse.failed = true) </Condition>
</FaultRule>

GenerateJWS politikası

Bu bölümde, bu politika bir hatayı tetiklediğinde Edge tarafından ayarlanan hata kodları ile hata mesajları ve döndürülen hata mesajları ile Edge tarafından ayarlanan hata değişkenleri açıklanmaktadır. Hataları ele almak için hata kuralları geliştirip geliştirmediğinizi bilmeniz önemlidir. Daha fazla bilgi için Politika hataları hakkında bilmeniz gerekenler ve Hataları işleme bölümlerine bakın.

Çalışma zamanı hataları

Politika yürütüldüğünde bu hatalar ortaya çıkabilir.

Hata kodu	HTTP durumu	Gerçekleşme zamanı:
`steps.jws.GenerationFailed`	401	Politika, JWS'yi oluşturamadı.
`steps.jws.InsufficientKeyLength`	401	HS256 algoritmasına göre 32 bayttan küçük bir anahtar için
`steps.jws.InvalidClaim`	401	Eksik hak talebi veya hak talebi uyuşmazlığı ya da eksik başlık veya başlık uyuşmazlığı için.
`steps.jws.InvalidCurve`	401	Anahtar tarafından belirtilen eğri, Elips Biçimli Eğri algoritması için geçerli değildir.
`steps.jws.InvalidJsonFormat`	401	JWS üstbilgisinde geçersiz JSON bulundu.
`steps.jws.InvalidPayload`	401	JWS yükü geçersiz.
`steps.jws.InvalidSignature`	401	`<DetachedContent>` atlanır ve JWS'de ayrı bir içerik yükü bulunur.
`steps.jws.KeyIdMissing`	401	Doğrulama politikası, ortak anahtarlar için kaynak olarak bir JWKS kullanır ancak imzalanmış JWS, başlıkta bir `kid` özelliği içermez.
`steps.jws.KeyParsingFailed`	401	Ortak anahtar, verilen anahtar bilgisinden ayrıştırılamadı.
`steps.jws.MissingPayload`	401	JWS yükü eksik.
`steps.jws.NoAlgorithmFoundInHeader`	401	JWS, algoritma başlığını çıkardığında ortaya çıkar.
`steps.jws.SigningFailed`	401	GenerateJWS'de HS384 veya HS512 algoritmaları için minimum boyuttan daha küçük bir anahtar için
`steps.jws.UnknownException`	401	Bilinmeyen bir istisna oluştu.
`steps.jws.WrongKeyType`	401	Anahtar türü yanlış belirtilmiş. Örneğin, Elips Biçimli Eğri algoritması için RSA anahtarı veya RSA algoritması için eğri anahtarı belirtirseniz.

Dağıtım hataları

Bu hatalar, bu politikayı içeren bir proxy dağıttığınızda ortaya çıkabilir.

Hata adı Gerçekleşme zamanı:

InvalidAlgorithm Geçerli değerler şunlardır: RS256, RS384, RS512, PS256, PS384, PS512, ES256, ES384, ES512, HS256, HS384, HS512.

Hata adı	Gerçekleşme zamanı:
`InvalidAlgorithm`	Geçerli değerler şunlardır: RS256, RS384, RS512, PS256, PS384, PS512, ES256, ES384, ES512, HS256, HS384, HS512.
`EmptyElementForKeyConfiguration` `FailedToResolveVariable` `InvalidConfigurationForActionAndAlgorithmFamily` `InvalidConfigurationForVerify` `InvalidEmptyElement` `InvalidFamiliesForAlgorithm` `InvalidKeyConfiguration` `InvalidNameForAdditionalClaim` `InvalidNameForAdditionalHeader` `InvalidPublicKeyId` `InvalidPublicKeyValue` `InvalidSecretInConfig` `InvalidTypeForAdditionalClaim` `InvalidTypeForAdditionalHeader` `InvalidValueForElement` `InvalidValueOfArrayAttribute` `InvalidVariableNameForSecret` `MissingConfigurationElement` `MissingElementForKeyConfiguration` `MissingNameForAdditionalClaim` `MissingNameForAdditionalHeader`	Diğer olası dağıtım hataları.

EmptyElementForKeyConfiguration

FailedToResolveVariable

InvalidConfigurationForActionAndAlgorithmFamily

InvalidConfigurationForVerify

InvalidEmptyElement

InvalidFamiliesForAlgorithm

InvalidKeyConfiguration

InvalidNameForAdditionalClaim

InvalidNameForAdditionalHeader

InvalidPublicKeyId

InvalidPublicKeyValue

InvalidSecretInConfig

InvalidTypeForAdditionalClaim

InvalidTypeForAdditionalHeader

InvalidValueForElement

InvalidValueOfArrayAttribute

InvalidVariableNameForSecret

MissingConfigurationElement

MissingElementForKeyConfiguration

MissingNameForAdditionalClaim

MissingNameForAdditionalHeader

Diğer olası dağıtım hataları.

Hata değişkenleri

Bu değişkenler, çalışma zamanı hatası oluştuğunda ayarlanır. Daha fazla bilgi için Bilmeniz gerekenler hakkında daha fazla bilgi edinin.

Değişkenler	Konum	Örnek
`fault.name="fault_name"`	`fault_name`, yukarıdaki Çalışma zamanı hataları tablosunda listelendiği gibi hatanın adıdır. Hata adı, hata kodunun son kısmıdır.	`fault.name Matches "TokenExpired"`
`JWS.failed`	Tüm JWS politikaları, hata durumunda aynı değişkeni ayarlar.	`jws.JWS-Policy.failed = true`

Örnek hata yanıtı

Hata giderme için en iyi uygulama, hatanın errorcode kısmını yakalamaktır tıklayın. Değişebileceği için faultstring içindeki metne güvenmeyin.

Örnek hata kuralı

<FaultRules>
    <FaultRule name="JWS Policy Errors">
        <Step>
            <Name>JavaScript-1</Name>
            <Condition>(fault.name Matches "TokenExpired")</Condition>
        </Step>
        <Condition>JWS.failed=true</Condition>
    </FaultRule>
</FaultRules>

GenerateJWT politikası

This section describes the fault codes and error messages that are returned and fault variables that are set by Edge when this policy triggers an error. This information is important to know if you are developing fault rules to handle faults. To learn more, see What you need to know about policy errors and Handling faults.

Runtime errors

These errors can occur when the policy executes.

Fault code	HTTP status	Occurs when
`steps.jwt.AlgorithmInTokenNotPresentInConfiguration`	401	Occurs when the verification policy has multiple algorithms.
`steps.jwt.AlgorithmMismatch`	401	The algorithm specified in the Generate policy did not match the one expected in the Verify policy. The algorithms specified must match.
`steps.jwt.FailedToDecode`	401	The policy was unable to decode the JWT. The JWT is possibly corrupted.
`steps.jwt.GenerationFailed`	401	The policy was unable to generate the JWT.
`steps.jwt.InsufficientKeyLength`	401	For a key less than 32 bytes for the HS256 algorithm, less than 48 bytes for the HS386 algortithm, and less than 64 bytes for the HS512 algorithm.
`steps.jwt.InvalidClaim`	401	For a missing claim or claim mismatch, or a missing header or header mismatch.
`steps.jwt.InvalidCurve`	401	The curve specified by the key is not valid for the Elliptic Curve algorithm.
`steps.jwt.InvalidJsonFormat`	401	Invalid JSON found in the header or payload.
`steps.jwt.InvalidToken`	401	This error occurs when the JWT signature verification fails.
`steps.jwt.JwtAudienceMismatch`	401	The audience claim failed on token verification.
`steps.jwt.JwtIssuerMismatch`	401	The issuer claim failed on token verification.
`steps.jwt.JwtSubjectMismatch`	401	The subject claim failed on token verification.
`steps.jwt.KeyIdMissing`	401	The Verify policy uses a JWKS as a source for public keys, but the signed JWT does not include a `kid` property in the header.
`steps.jwt.KeyParsingFailed`	401	The public key could not be parsed from the given key information.
`steps.jwt.NoAlgorithmFoundInHeader`	401	Occurs when the JWT contains no algorithm header.
`steps.jwt.NoMatchingPublicKey`	401	The Verify policy uses a JWKS as a source for public keys, but the `kid` in the signed JWT is not listed in the JWKS.
`steps.jwt.SigningFailed`	401	In GenerateJWT, for a key less than the minimum size for the HS384 or HS512 algorithms
`steps.jwt.TokenExpired`	401	The policy attempts to verify an expired token.
`steps.jwt.TokenNotYetValid`	401	The token is not yet valid.
`steps.jwt.UnhandledCriticalHeader`	401	A header found by the Verify JWT policy in the `crit` header is not listed in `KnownHeaders`.
`steps.jwt.UnknownException`	401	An unknown exception occurred.
`steps.jwt.WrongKeyType`	401	Wrong type of key specified. For example, if you specify an RSA key for an Elliptic Curve algorithm, or a curve key for an RSA algorithm.

Deployment errors

These errors can occur when you deploy a proxy containing this policy.

Error name	Cause	Fix
`InvalidNameForAdditionalClaim`	The deployment will fail if the claim used in the child element `<Claim>` of the `<AdditionalClaims>` element is one of the following registered names: `kid`, `iss`, `sub`, `aud`, `iat`, `exp`, `nbf`, or `jti`.
`InvalidTypeForAdditionalClaim`	If the claim used in the child element `<Claim>` of the `<AdditionalClaims>` element is not of type `string`, `number`, `boolean`, or `map`, the deployment will fail.
`MissingNameForAdditionalClaim`	If the name of the claim is not specified in the child element `<Claim>` of the `<AdditionalClaims>` element, the deployment will fail.
`InvalidNameForAdditionalHeader`	This error ccurs when the name of the claim used in the child element `<Claim>` of the `<AdditionalClaims>` element is either `alg` or `typ`.
`InvalidTypeForAdditionalHeader`	If the type of claim used in the child element `<Claim>` of the `<AdditionalClaims>` element is not of type `string`, `number`, `boolean`, or `map`, the deployment will fail.
`InvalidValueOfArrayAttribute`	This error occurs when the value of the array attribute in the child element `<Claim>` of the `<AdditionalClaims>` element is not set to `true` or `false`.
`InvalidConfigurationForActionAndAlgorithm`	If the `<PrivateKey>` element is used with HS Family algorithms or the `<SecretKey>` element is used with RSA Family algorithms, the deployment will fail.
`InvalidValueForElement`	If the value specified in the `<Algorithm>` element is not a supported value, the deployment will fail.
`MissingConfigurationElement`	This error will occur if the `<PrivateKey>` element is not used with RSA family algorithms or the `<SecretKey>` element is not used with HS Family algorithms.
`InvalidKeyConfiguration`	If the child element `<Value>` is not defined in the `<PrivateKey>` or `<SecretKey>` elements, the deployment will fail.
`EmptyElementForKeyConfiguration`	If the ref attribute of the child element `<Value>` of the `<PrivateKey>` or `<SecretKey>` elements is empty or unspecified, the deployment will fail.
`InvalidVariableNameForSecret`	This error occurs if the flow variable name specified in the ref attribute of the child element `<Value>` of the `<PrivateKey>` or `<SecretKey>` elements does not contain the private prefix `(private.)`.
`InvalidSecretInConfig`	This error occurs if the child element `<Value>` of the `<PrivateKey>` or `<SecretKey>` elements does not contain the private prefix `(private.)`.
`InvalidTimeFormat`	If the value specified in the`<NotBefore>` element does not use a supported format, the deployment will fail.

Hata değişkenleri

Bu değişkenler, çalışma zamanı hatası oluştuğunda ayarlanır. Daha fazla bilgi için Bilmeniz gerekenler hakkında daha fazla bilgi edinin.

Değişkenler	Konum	Örnek
`fault.name="fault_name"`	`fault_name`, yukarıdaki Çalışma zamanı hataları tablosunda listelendiği gibi hatanın adıdır. Hata adı, hata kodunun son kısmıdır.	`fault.name Matches "TokenExpired"`
`JWT.failed`	Tüm JWT politikaları, hata durumunda aynı değişkeni ayarlar.	`JWT.failed = true`

Örnek hata yanıtı

JWT Politikası Hata Kodları

Hata giderme için en iyi uygulama, hatanın errorcode kısmını yakalamaktır tıklayın. Değişebileceği için faultstring içindeki metne güvenmeyin.

Örnek hata kuralı

    <FaultRules>
        <FaultRule name="JWT Policy Errors">
            <Step>
                <Name>JavaScript-1</Name>
                <Condition>(fault.name Matches "TokenExpired")</Condition>
            </Step>
            <Condition>JWT.failed=true</Condition>
        </FaultRule>
    </FaultRules>

JavaCallout politikası

Çalışma zamanı hataları

Bu hatalar, politika yürütüldüğünde ortaya çıkabilir.

Hata kodu	HTTP durumu	Neden	Düzelt
`steps.javacallout.ExecutionError`	500	Java kodu bir istisna oluşturduğunda veya JavaScript çağrısı politikası yürütülürken null döndürdüğünde ortaya çıkar.

Dağıtım hataları

Politikayı içeren proxy dağıtıldığında bu hatalar oluşabilir.

Hata adı	Hata dizesi	HTTP durumu	Şu durumda gerçekleşir:
`ResourceDoesNotExist`	`Resource with name [name] and type [type] does not exist`	Yok	`<ResourceURL>` öğesinde belirtilen dosya mevcut değil.
`JavaCalloutInstantiationFailed`	`Failed to instantiate the JavaCallout Class [classname]`	Yok	`<ClassName>` öğesinde belirtilen sınıf dosyası jar.
`IncompatibleJavaVersion`	`Failed to load java class [classname] definition due to - [reason]`	Yok	Hata dizesini inceleyin. Ayrıca bkz. Desteklenenler yazılım ve desteklenen sürümler hakkında daha fazla bilgi edinin.
`JavaClassNotFoundInJavaResource`	`Failed to find the ClassName in java resource [jar_name] - [class_name]`	Yok	Hata dizesini inceleyin.
`JavaClassDefinitionNotFound`	`Failed to load java class [class_name] definition due to - [reason]`	Yok	Hata dizesini inceleyin.
`NoAppropriateConstructor`	`No appropriate constructor found in JavaCallout class [class_name]`	Yok	Hata dizesini inceleyin.
`NoResourceForURL`	`Could not locate a resource with URL [string]`	Yok	Hata dizesini inceleyin.

Hata değişkenleri

Bu değişkenler, politika bir hatayı tetiklediğinde ayarlanır. Daha fazla bilgi için Bilmeniz gerekenler hakkında daha fazla bilgi edinin.

Değişkenler	Konum	Örnek
`fault.name="fault_name"`	`fault_name`, yukarıdaki Çalışma zamanı hataları tablosunda listelendiği gibi hatanın adıdır. Hata adı, hata kodunun son kısmıdır.	`fault.name Matches "ExecutionError"`
`javacallout.policy_name.failed`	`policy_name`, hataya neden olan politikanın kullanıcı tarafından belirtilen adıdır.	`javacallout.JC-GetUserData.failed = true`

Örnek hata yanıtı

{  
   "fault":{  
      "faultstring":"Failed to execute JavaCallout. [policy_name]",
      "detail":{  
         "errorcode":"javacallout.ExecutionError"
      }
   }
}

Örnek hata kuralı

<FaultRule name="JavaCalloutFailed">
    <Step>
        <Name>AM-JavaCalloutError</Name>
    </Step>
    <Condition>(fault.name Matches "ExecutionError") </Condition>
</FaultRule>

JavaScript politikası

This section describes the fault codes and error messages that are returned and fault variables that are set by Edge when this policy triggers an error. This information is important to know if you are developing fault rules to handle faults. To learn more, see What you need to know about policy errors and Handling faults.

Runtime errors

These errors can occur when the policy executes.

Fault code	HTTP status	Cause	Fix
`steps.javascript.ScriptExecutionFailed`	500	The JavaScript policy can throw many different types of ScriptExecutionFailed errors. Commonly seen types of errors include RangeError, ReferenceError, SyntaxError, TypeError, and URIError.
`steps.javascript.ScriptExecutionFailedLineNumber`	500	An error occurred in the JavaScript code. See the fault string for details.	N/A
`steps.javascript.ScriptSecurityError`	500	A security error occurred when the JavaScript executed. See the fault string for details.	N/A

Deployment errors

These errors can occur when you deploy a proxy containing this policy.

Error name	Cause	Fix
`InvalidResourceUrlFormat`	If the format of the resource URL specified within the `<ResourceURL>` or the `<IncludeURL>` element of the JavaScript policy is invalid, then the deployment of the API proxy fails.
`InvalidResourceUrlReference`	If the `<ResourceURL>` or the `<IncludeURL>` elements refer to a JavaScript file that does not exist, then the deployment of the API proxy fails. The referenced source file must exist either the API proxy, environment, or organization level.
`WrongResourceType`	This error occurs during deployment if the `<ResourceURL>` or the `<IncludeURL>` elements of the JavaScript policy refer to any resource type other than jsc (JavaScript file).
`NoResourceURLOrSource`	The deployment of the JavaScript policy can fail with this error if the `<ResourceURL>` element is not declared or if the resource URL is not defined within this element. `<ResourceURL>` element is a mandatory element. Or, The `<IncludeURL>` element is declared but the resource URL is not defined within this element. The `<IncludeURL>` element is optional but if declared, the resource URL must be specified within the `<IncludeURL>` element.

Fault variables

These variables are set when this policy triggers an error at runtime. For more information, see What you need to know about policy errors.

Variables	Where	Example
`fault.name="fault_name"`	`fault_name` is the name of the fault, as listed in the Runtime errors table above. The fault name is the last part of the fault code.	`fault.name Matches "ScriptExecutionFailed"`
`javascript.policy_name.failed`	`policy_name` is the user-specified name of the policy that threw the fault.	`javascript.JavaScript-1.failed = true`

Example error response

Note: For error handling, the best practice is to trap the errorcode part of the error response. Do not rely on the text in the faultstring, because it could change.

{
  "fault": {
    "faultstring": "Execution of SetResponse failed with error: Javascript runtime error: "ReferenceError: "status" is not defined. (setresponse.js:6)\"",
    "detail": {
      "errorcode": "steps.javascript.ScriptExecutionFailed"
    }
  }
}

Example fault rule

<FaultRule name="JavaScript Policy Faults">
    <Step>
        <Name>AM-CustomErrorResponse</Name>
        <Condition>(fault.name Matches "ScriptExecutionFailed") </Condition>
    </Step>
    <Condition>(javascript.JavaScript-1.failed = true) </Condition>
</FaultRule>

JSONThreatProtection politikası

Çalışma zamanı hataları

Bu hatalar, politika yürütüldüğünde ortaya çıkabilir.

Hata kodu	HTTP durumu	Neden
`steps.jsonthreatprotection.ExecutionFailed`	500	JSONThreatProtection politikası birçok farklı türde ExecutionFailed hatası verebilir. Bu hataların çoğu, politikada belirlenen belirli bir eşik aşıldığında ortaya çıkar. Bu Hata türleri şunlardır: nesne giriş adı uzunluğu, nesne giriş sayısı ise dizi öğesi sayısı container derinliği, dize dizesi değeri uzunluğu. Bu hata, yük geçersiz JSON nesnesi içerdiğinde de ortaya çıkar.
`steps.jsonthreatprotection.SourceUnavailable`	500	Bu hata, ileti `<Source>` öğesinde belirtilen değişken aşağıdakilerden biri olabilir: Kapsam dışında (politikanın yürütüldüğü belirli akışta kullanılamaz) Şu geçerli değerlerden biri değil: `request`, `response` veya `message`
`steps.jsonthreatprotection.NonMessageVariable`	500	Bu hata, `<Source>` öğesi farklı bir değişkene ayarlanırsa şu türde değil: mesaj yazın.

Dağıtım hataları

Yok.

Hata değişkenleri

Bu değişkenler, politika bir hatayı tetiklediğinde ayarlanır. Daha fazla bilgi için Bilmeniz gerekenler hakkında daha fazla bilgi edinin.

Değişkenler	Konum	Örnek
`fault.name="fault_name"`	`fault_name`, yukarıdaki Çalışma zamanı hataları tablosunda listelendiği gibi hatanın adıdır. Hata adı, hata kodunun son kısmıdır.	`fault.name Matches "SourceUnavailable"`
`jsonattack.policy_name.failed`	`policy_name`, hataya neden olan politikanın kullanıcı tarafından belirtilen adıdır.	`jsonattack.JTP-SecureRequest.failed = true`

Örnek hata yanıtı

{
  "fault": {
    "faultstring": "JSONThreatProtection[JPT-SecureRequest]: Execution failed. reason: JSONThreatProtection[JTP-SecureRequest]: Exceeded object entry name length at line 2",
    "detail": {
      "errorcode": "steps.jsonthreatprotection.ExecutionFailed"
    }
  }
}

Örnek hata kuralı

<FaultRule name="JSONThreatProtection Policy Faults">
    <Step>
        <Name>AM-CustomErrorResponse</Name>
        <Condition>(fault.name Matches "ExecutionFailed") </Condition>
    </Step>
    <Condition>(jsonattack.JPT-SecureRequest.failed = true) </Condition>
</FaultRule>

JSONThreatProtection politika türleri aşağıdaki hata kodlarını tanımlar:

JSONtoXML politikası

Çalışma zamanı hataları

Bu hatalar, politika yürütüldüğünde ortaya çıkabilir.

Hata kodu	HTTP durumu	Neden
`steps.jsontoxml.ExecutionFailed`	500	Giriş yükü (JSON) boş veya JSON'a XML politikasına iletilen giriş (JSON) veya hatalı biçimlendirilmiş olmalıdır.
`steps.jsontoxml.InCompatibleTypes`	500	Bu hata, `<Source>` öğesinde tanımlanan değişkenin türü ve `<OutputVariable>` öğesi aynı değildir. Veri türünün `<Source>` öğesi ve `<OutputVariable>` öğesinde bulunan değişkenler şununla eşleşir: Geçerli türler: `message` ve `string`.
`steps.jsontoxml.InvalidSourceType`	500	Bu hata, `<Source>` öğesini tanımlamak için kullanılan değişkenin türü olduğunda ortaya çıkar geçersiz. Geçerli değişken türleri `message` ve `string`'dir.
`steps.jsontoxml.OutputVariableIsNotAvailable`	500	Bu hata, JSON'un `<Source>` öğesinde belirtilen değişken XML Politikası dize türünde ve `<OutputVariable>` öğesi tanımlı değil. `<Source>` içinde tanımlanan değişken için `<OutputVariable>` öğesi zorunludur öğesi dize türünde.
`steps.jsontoxml.SourceUnavailable`	500	Bu hata, ileti JSON'dan XML'e politikasının `<Source>` öğesinde belirtilen değişken aşağıdakilerden biri olabilir: Kapsam dışında (politikanın yürütüldüğü belirli akışta kullanılamaz) veya çözülemiyor (tanımlanmamış)

Dağıtım hataları

Yok.

Hata değişkenleri

Bu değişkenler, çalışma zamanı hatası oluştuğunda ayarlanır. Daha fazla bilgi için Bilmeniz gerekenler hakkında daha fazla bilgi edinin.

Değişkenler	Konum	Örnek
`fault.name="fault_name"`	`fault_name`, yukarıdaki Çalışma zamanı hataları tablosunda listelendiği gibi hatanın adıdır. Hata adı, hata kodunun son kısmıdır.	`fault.name Matches "SourceUnavailable"`
`jsontoxml.policy_name.failed`	`policy_name`, hataya neden olan politikanın kullanıcı tarafından belirtilen adıdır.	`jsontoxml.JSON-to-XML-1.failed = true`

Örnek hata yanıtı

Not: Hata işleme için en iyi uygulama, Hata yanıtının errorcode bölümü. Yalnızca faultstring, çünkü değişebilir.

{
  "fault": {
    "faultstring": "JSONToXML[JSON-to-XML-1]: Source xyz is not available",
    "detail": {
      "errorcode": "steps.json2xml.SourceUnavailable"
    }
  }
}

Örnek hata kuralı

<FaultRule name="JSON To XML Faults">
    <Step>
        <Name>AM-SourceUnavailableMessage</Name>
        <Condition>(fault.name Matches "SourceUnavailable") </Condition>
    </Step>
    <Step>
        <Name>AM-BadJSON</Name>
        <Condition>(fault.name = "ExecutionFailed")</Condition>
    </Step>
    <Condition>(jsontoxml.JSON-to-XML-1.failed = true) </Condition>
</FaultRule>

KeyValueMapOperations politikası

Çalışma zamanı hataları

Politika yürütüldüğünde bu hatalar ortaya çıkabilir.

Hata kodu	HTTP durumu	Neden	Düzelt
`steps.keyvaluemapoperations.SetVariableFailed`	500	Bu hata, şifrelenmiş bir anahtar/değer eşlemesinden bir değer almaya çalışır ve değeri, adında `private` öneki olmayan bir değişken olarak ayarlarsanız ortaya çıkar. Hata ayıklama sırasında temel güvenlik amacıyla gerekli olan ön ek, şifrelenmiş değerleri API Proxy Trace ve hata ayıklama oturumlarından gizler.
`steps.keyvaluemapoperations.UnsupportedOperationException`	500	Bu hata, `mapIdentifier` özelliği Anahtar/Değer Eşleme İşlemleri politikasında boş dize olarak ayarlanırsa ortaya çıkar.

Dağıtım hataları

Bu hatalar, bu politikayı içeren bir proxy dağıttığınızda ortaya çıkabilir.

Hata adı	Neden	Düzelt
`InvalidIndex`	Anahtar Değer Eşleme İşlemleri politikasının `<Get>` öğesinde belirtilen `index` özelliği sıfır veya negatif bir sayıysa API proxy'sinin dağıtımı başarısız olur. Dizin, `1` değerinden başlar. Bu nedenle sıfır veya negatif tam sayı içeren bir dizin geçersiz olarak kabul edilir.
`KeyIsMissing`	Bu hata, Anahtar/Değer Eşleme İşlemleri politikasının `<InitialEntries>` öğesinin `<Entry>` altındaki `<Key>` öğesi içinde `<Key>` öğesi tamamen eksik olduğunda veya `<Parameter>` öğesi eksik olduğunda ortaya çıkar.
`ValueIsMissing`	Bu hata, Anahtar/Değer Eşleme İşlemleri politikasının `<InitialEntries>` öğesinin `<Entry>` öğesi altında `<Value>` öğesi eksikse ortaya çıkar.

LDAP politikası

Bu politika aşağıdaki hata kodlarını kullanır:

Hata Kodu	Message
`InvalidAttributeName`	`Invalid attribute name {0}.`
`InvalidSearchBase`	`Search base can not be empty.`
`InvalidValueForPassword`	`Invalid value for password field. It can not be empty.`
`InvalidSearchScope`	`Invalid scope {0}. Allowed scopes are {1}.`
`InvalidUserCredentials`	`Invalid user credentials.`
`InvalidExternalLdapReference`	`Invalid external ldap reference {0}.`
`LdapResourceNotFound`	`Ldap resource {0} not found.`
`BaseDNRequired`	`Base DN required.`
`OnlyReferenceOrValueIsAllowed`	`Only value or reference is allowed for {0}.`
`AttributesRequired`	`At least one attribute required for search action.`
`UserNameIsNull`	`User name is null.`
`SearchQueryAndUserNameCannotBePresent`	`Both search query and username can not be present in the authentication action. Please specify either one of them.`

MessageLogging politikası

Çalışma zamanı hataları

Bu hatalar, politika yürütüldüğünde ortaya çıkabilir.

Hata kodu	HTTP durumu	Neden
`steps.messagelogging.StepDefinitionExecutionFailed`	500	Hata dizesini inceleyin.

Dağıtım hataları

Bu politikayı içeren bir proxy dağıttığınızda bu hatalar oluşabilir.

Hata adı	Neden	Düzelt
`InvalidProtocol`	Protokol `<Protocol>` öğesi içinde belirtilen geçerli değil. Geçerli protokoller TCP ve UDP'dir. TLS/SSL üzerinden sistem günlüğü mesajları göndermek için yalnızca TCP desteklenir.
`InvalidPort`	Bağlantı noktası numarası `<Port>` öğesi içinde belirtilmemişse veya geçerli değilse. Bağlantı noktası numarası şu olmalıdır: sıfırdan büyük bir tam sayı.

Hata değişkenleri

Bu değişkenler, çalışma zamanı hatası oluştuğunda ayarlanır. Daha fazla bilgi için Bilmeniz gerekenler hakkında daha fazla bilgi edinin.

Değişkenler	Konum	Örnek
`fault.name="fault_name"`	`fault_name`, yukarıdaki Çalışma zamanı hataları tablosunda listelendiği gibi hatanın adıdır. Hata adı, hata kodunun son kısmıdır.	`fault.name Matches "StepDefinitionExecutionFailed"`
`messagelogging.policy_name.failed`	`policy_name`, hataya neden olan politikanın kullanıcı tarafından belirtilen adıdır.	`messagelogging.ML-LogMessages.failed = true`

Örnek hata yanıtı

Not: Hata işleme için en iyi uygulama, Hata yanıtının errorcode bölümü. Yalnızca faultstring, çünkü değişebilir.

{  
   "fault":{  
      "detail":{  
         "errorcode":"steps.messagelogging.StepDefinitionExecutionFailed"
      },
      "faultstring":"Execution failed"
   }
}

Örnek hata kuralı

<FaultRule name="MessageLogging">
    <Step>
        <Name>ML-LogMessages</Name>
        <Condition>(fault.name Matches "StepDefinitionExecutionFailed") </Condition>
    </Step>
    <Condition>(messagelogging.ML-LogMessages.failed = true) </Condition>
</FaultRule>

OASValidation politikası

Çalışma zamanı hataları

Politika yürütüldüğünde bu hatalar ortaya çıkabilir.

Hata kodu	HTTP durumu	Neden
`steps.oasvalidation.Failed`	500	İstek mesajı gövdesi, sağlanan OpenAPI Specification ile doğrulanamıyor.
`steps.oasvalidation.SourceMessageNotAvailable`	500	Politikanın `<Source>` öğesinde belirtilen değişken kapsam dışında veya çözümlenemiyor.
`steps.oasvalidation.NotMessageVariable`	500	`<Source>` öğesi, message türünde olmayan bir değişkene ayarlanmış.

Dağıtım hataları

Bu hatalar, bu politikayı içeren bir proxy dağıttığınızda ortaya çıkabilir.

Hata adı	Neden
`ResourceDoesNotExist`	`<OASResource>` öğesinde referans verilen OpenAPI Spesifikasyonu mevcut değil.
`ResourceCompileFailed`	Dağıtıma dahil edilen OpenAPI Spesifikasyonu, derlenmesini engelleyen hatalar içeriyor. Bu genellikle spesifikasyonun, doğru biçimlendirilmiş bir OpenAPI Specification 3.0 olmadığını belirtir.
`BadResourceURL`	`<OASResource>` öğesinde referans verilen OpenAPI Spesifikasyonu işlenemiyor. Bu durum, dosya bir JSON veya YAML dosyası değilse ya da dosya URL'si doğru şekilde belirtilmediyse ortaya çıkabilir.

Hata değişkenleri

Bu değişkenler, bu politika çalışma zamanında bir hata tetiklediğinde ayarlanır. Daha fazla bilgi için Politika hataları hakkında bilmeniz gerekenler bölümüne bakın.

Değişkenler	Konum	Örnek
`fault.name="fault_name"`	`fault_name`, yukarıdaki Çalışma zamanı hataları tablosunda listelenen hatanın adıdır. Hata adı, hata kodunun son kısmıdır.	`fault.name Matches "ResourceDoesNotExist"`
`oasvalidation.policy_name.failed`	`policy_name`, hataya neden olan politikanın kullanıcı tarafından belirtilen adıdır.	`oasvalidation.myoaspolicy.failed = true`

PopulateCache politikası

Çalışma zamanı hataları

Bu hatalar, politika yürütüldüğünde ortaya çıkabilir.

Hata kodu	HTTP Durumu	Şu durumda gerçekleşir:
`policies.populatecache.EntryCannotBeCached`	500	Giriş önbelleğe alınamaz. Önbelleğe alınan ileti nesnesi bir sınıf oluşturun.

Dağıtım hataları

Bu politikayı içeren bir proxy dağıttığınızda bu hatalar oluşabilir.

Hata adı	Neden	Düzelt
`InvalidCacheResourceReference`	Bu hata, PopulateCache politikasındaki `<CacheResource>` öğesi API proxy'sinin dağıtıldığı ortamda bulunmayan bir ad.
`CacheNotFound`	`<CacheResource>` öğesinde belirtilen önbellek bulunur.

Hata değişkenleri

Bu değişkenler, politika bir hatayı tetiklediğinde ayarlanır. Daha fazla bilgi için Bilmeniz gerekenler hakkında daha fazla bilgi edinin.

Değişkenler	Konum	Örnek
`fault.name="fault_name"`	`fault_name`, yukarıdaki Çalışma zamanı hataları tablosunda listelendiği gibi hatanın adıdır. Hata adı, hata kodunun son kısmıdır.	`fault.name = "EntryCannotBeCached"`
`populatecache.policy_name.failed`	`policy_name`, hataya neden olan politikanın kullanıcı tarafından belirtilen adıdır.	`populatecache.POP-CACHE-1.failed = true`

Örnek hata yanıtı

{
  "fault": {
    "faultstring": "[entry] can not be cached. Only serializable entries are cached.",
    "detail": {
      "errorcode": "steps.populatecache.EntryCannotBeCached"
    }
  }
}

Örnek hata kuralı

<FaultRule name="Populate Cache Fault">
    <Step>
        <Name>AM-EntryCannotBeCached</Name>
        <Condition>(fault.name Matches "EntryCannotBeCached") </Condition>
    </Step>
    <Condition>(populatecache.POP-CACHE-1.failed = true) </Condition>
</FaultRule>

LookupCache politikası

Bu bölümde, bu politika bir hatayı tetiklediğinde ayarlanan hata mesajları ve akış değişkenleri açıklanmaktadır. Bu bilgiler, bir proxy için hata kuralları geliştirip geliştirmediğinizi bilmeniz önemlidir. Daha fazla bilgi için Politika hataları hakkında bilmeniz gerekenler ve Hataları işleme bölümlerine bakın.

Hata kodu öneki

Yok

Çalışma zamanı hataları

Bu politika, çalışma zamanı hatası bildirmez.

Dağıtım hataları

Bu hatalar, bu politikayı içeren bir proxy dağıttığınızda ortaya çıkabilir.

Hata adı	Neden	Düzelt
`InvalidCacheResourceReference`	Bu hata, `<CacheResource>` öğesi API proxy'sinin dağıtıldığı ortamda bulunmayan bir ada ayarlanırsa ortaya çıkar.
`InvalidTimeout`	`<CacheLookupTimeoutInSeconds>` öğesi negatif bir sayıya ayarlanırsa API proxy'sinin dağıtımı başarısız olur.
`CacheNotFound`	Bu hata, hata mesajında bahsedilen belirli önbellek belirli bir Mesaj İşleyici bileşeninde oluşturulmamışsa ortaya çıkar.

Hata değişkenleri

Yok

Örnek hata yanıtı

Yok

InvalidateCache politikası

Hata kodu öneki

Yok

Çalışma zamanı hataları

Bu politika, çalışma zamanı hatası bildirmez.

Dağıtım hataları

Bu hatalar, bu politikayı içeren bir proxy dağıttığınızda ortaya çıkabilir.

Hata adı	Neden	Düzelt
`InvalidCacheResourceReference`	Bu hata, InValidateCache politikasındaki `<CacheResource>` öğesi, API proxy'sinin dağıtıldığı ortamda var olmayan bir ada ayarlanırsa bu hata oluşur.
`CacheNotFound`	Bu hata, hata mesajında bahsedilen belirli önbellek belirli bir Mesaj İşleyici bileşeninde oluşturulmamışsa ortaya çıkar.

Hata değişkenleri

Yok

Örnek hata yanıtı

Yok

ResponseCache politikası

Hata kodu öneki

Yok

Çalışma zamanı hataları

Bu politika, çalışma zamanı hatası bildirmez.

Dağıtım hataları

Bu hatalar, bu politikayı içeren bir proxy dağıttığınızda ortaya çıkabilir.

Hata adı	Neden	Düzelt
`InvalidTimeout`	ResponseCache politikasının `<CacheLookupTimeoutInSeconds>` öğesi negatif bir sayıya ayarlanırsa API proxy'sinin dağıtımı başarısız olur.
`InvalidCacheResourceReference`	Bu hata, ResponseCache politikasındaki `<CacheResource>` öğesi, API proxy'sinin dağıtıldığı ortamda var olmayan bir ada ayarlanırsa ortaya çıkar.
`ResponseCacheStepAttachmentNotAllowedReq`	Bu hata, bir API proxy'sinin herhangi bir akışındaki birden fazla istek yoluna aynı ResponseCache politikası eklenirse ortaya çıkar.
`ResponseCacheStepAttachmentNotAllowedResp`	Bu hata, API proxy'sinin herhangi bir akışındaki birden fazla yanıt yoluna aynı ResponseCache politikası eklenirse ortaya çıkar.
`InvalidMessagePatternForErrorCode`	Bu hata, ResponseCache politikasındaki `<SkipCacheLookup>` veya `<SkipCachePopulation>` öğesi geçersiz bir koşul içeriyorsa ortaya çıkar.
`CacheNotFound`	Bu hata, hata mesajında bahsedilen belirli önbellek belirli bir Mesaj İşleyici bileşeninde oluşturulmamışsa ortaya çıkar.

Hata değişkenleri

Yok

Örnek hata yanıtı

Yok

OAuthV2 politikası

Bu bölümde, döndürülen hata kodları ve hata mesajları ile bu politika bir hata tetiklediğinde Edge tarafından ayarlanan hata değişkenleri açıklanmaktadır. Hataları ele almak için hata kuralları geliştiriyorsanız bu bilgileri bilmeniz önemlidir. Daha fazla bilgi edinmek için Politika hataları hakkında bilmeniz gerekenler ve Hataları ele alma başlıklı makaleleri inceleyin.

Çalışma zamanı hataları

Bu hatalar, politika yürütüldüğünde ortaya çıkabilir.

Hata kodu	HTTP durumu	Neden	İşlemler tarafından atılır.
`steps.oauth.v2.access_token_expired`	401	Erişim jetonunun süresi doldu.	VerifyAccessToken InvalidateToken
`steps.oauth.v2.access_token_not_approved`	401	Erişim jetonu iptal edildi.	VerifyAccessToken
`steps.oauth.v2.apiresource_doesnot_exist`	401	İstenen kaynak, erişim jetonuyla ilişkili API ürünlerinden hiçbirinde mevcut değildir.	VerifyAccessToken
`steps.oauth.v2.FailedToResolveAccessToken`	500	Politika, `<AccessToken>` öğesinde belirtilen bir değişkende erişim jetonu bulmasını bekledi ancak değişken çözülemedi.	GenerateAccessToken
`steps.oauth.v2.FailedToResolveAuthorizationCode`	500	Politika, `<Code>` öğesinde belirtilen bir değişkende yetkilendirme kodu bulmasını bekledi ancak değişken çözülemedi.	GenerateAuthorizationCode
`steps.oauth.v2.FailedToResolveClientId`	500	Politika, istemci kimliğini `<ClientId>` öğesinde belirtilen bir değişkende bulmasını bekledi ancak değişken çözülemedi.	GenerateAccessToken GenerateAuthorizationCode GenerateAccessTokenImplicitGrant RefreshAccessToken
`steps.oauth.v2.FailedToResolveRefreshToken`	500	Politika, `<RefreshToken>` öğesinde belirtilen bir değişkende yenileme jetonu bulmasını bekledi ancak değişken çözülemedi.	RefreshAccessToken
`steps.oauth.v2.FailedToResolveToken`	500	Politika, `<Tokens>` öğesinde belirtilen bir değişkende jeton bulmasını bekledi ancak değişken çözülemedi.	ValidateToken InvalidateToken
`steps.oauth.v2.InsufficientScope`	403	İstekte sunulan erişim jetonunun kapsamı, erişim jetonunu doğrulama politikasında belirtilen kapsamla eşleşmiyor. Kapsam hakkında bilgi edinmek için OAuth2 kapsamlarıyla çalışma başlıklı makaleyi inceleyin.	VerifyAccessToken
`steps.oauth.v2.invalid_access_token`	401	İstemciden gönderilen erişim jetonu geçersiz.	VerifyAccessToken
`steps.oauth.v2.invalid_client`	401	Bu hata adı, politikanın `<GenerateResponse>` mülkü true olarak ayarlandığında ve istekle gönderilen istemci kimliği geçersiz olduğunda döndürülür. Proxy'nizle ilişkili Geliştirici Uygulaması için doğru istemci anahtarını ve gizli değerleri kullandığınızdan emin olun. Bu değerler genellikle Base64 kodlu Temel Yetkilendirme üst bilgisi olarak gönderilir. Not: Mevcut hata kuralı koşullarını, hem `invalid_client` hem de `InvalidClientIdentifier` adlarını yakalayacak şekilde değiştirmeniz önerilir. Daha fazla bilgi ve örnek için 16.09.21 Sürüm Notları'na bakın.	GenerateAccessToken RefreshAccessToken
`steps.oauth.v2.InvalidRequest`	400	Bu hata adı, genellikle istekte eksik veya yanlış parametreler gönderildiğinde olmak üzere birden fazla farklı hata türü için kullanılır. `<GenerateResponse>` `false` olarak ayarlanmışsa hata adı ve nedeni gibi hata ayrıntılarını almak için hata değişkenlerini (aşağıda açıklanmıştır) kullanın.	GenerateAccessToken GenerateAuthorizationCode GenerateAccessTokenImplicitGrant RefreshAccessToken
`steps.oauth.v2.InvalidAccessToken`	401	Yetkilendirme başlığında gerekli olan "Bearer" kelimesi yok. Örneğin: `Authorization: Bearer your_access_token`	VerifyAccessToken
`steps.oauth.v2.InvalidAPICallAsNoApiProductMatchFound`	401	API proxy'si, erişim jetonuyla ilişkili üründe değil. İpuçları: Erişim jetonuyla ilişkili ürünün doğru şekilde yapılandırıldığından emin olun. Örneğin, kaynak yollarında joker karakter kullanıyorsanız joker karakterlerin doğru şekilde kullanıldığından emin olun. Ayrıntılar için API ürünleri oluşturma başlıklı makaleyi inceleyin. Bu hatanın nedenleri hakkında daha fazla bilgi için bu Apigee Topluluk gönderisine de göz atın.	VerifyAccessToken
`steps.oauth.v2.InvalidClientIdentifier`	500	Bu hata adı, politikanın `<GenerateResponse>` mülkü false olarak ayarlandığında ve istekle gönderilen istemci kimliği geçersiz olduğunda döndürülür. Proxy'nizle ilişkili geliştirici uygulaması için doğru istemci anahtarını ve gizli değerlerinizi kullandığınızdan emin olun. Bu değerler genellikle Base64 kodlu Temel Yetkilendirme üst bilgisi olarak gönderilir. Not: Bu durumda, bu hata eskiden `invalid_client` olarak adlandırılıyordu. Mevcut hata kuralı koşullarını, hem `invalid_client` hem de `InvalidClientIdentifier` adlarını yakalayacak şekilde değiştirmeniz önerilir. Daha fazla bilgi ve örnek için 16.09.21 Sürüm Notları'na bakın.	GenerateAccessToken RefreshAccessToken
`steps.oauth.v2.InvalidParameter`	500	Politikada bir erişim jetonu veya yetkilendirme kodu belirtilmelidir. İkisi birden belirtilmemelidir.	GenerateAuthorizationCode GenerateAccessTokenImplicitGrant
`steps.oauth.v2.InvalidTokenType`	500	`<Tokens>/<Token>` öğesi, jeton türünü (örneğin, `refreshtoken`) belirtmenizi gerektirir. İstemci yanlış türü iletirse bu hata meydana gelir.	ValidateToken InvalidateToken
`steps.oauth.v2.MissingParameter`	500	Yanıt türü `token` ancak herhangi bir bağış türü belirtilmemiş.	GenerateAuthorizationCode GenerateAccessTokenImplicitGrant
`steps.oauth.v2.UnSupportedGrantType`	500	İstemci, politika tarafından desteklenmeyen bir izin türü belirtmiş (<SupportedGrantTypes> öğesinde listelenmemiş) Not: Şu anda desteklenmeyen izin türü hatalarının doğru şekilde atılmamasına yol açan bir hata var. Desteklenmeyen bir izin türü hatası oluşursa proxy, beklendiği gibi Hata Akışına girmez.	GenerateAccessToken GenerateAuthorizationCode GenerateAccessTokenImplicitGrant RefreshAccessToken

Dağıtım hataları

Bu hatalar, bu politikayı içeren bir proxy dağıttığınızda ortaya çıkabilir.

Hata adı	Neden
`InvalidValueForExpiresIn`	`<ExpiresIn>` öğesi için geçerli değerler pozitif tam sayılar ve `-1`'dır.
`InvalidValueForRefreshTokenExpiresIn`	`<RefreshTokenExpiresIn>` öğesi için geçerli değerler pozitif tam sayılar ve `-1`'dir.
`InvalidGrantType`	`<SupportedGrantTypes>` öğesinde geçersiz bir bağış türü belirtilmiş. Geçerli türlerin listesi için politika referansına bakın.
`ExpiresInNotApplicableForOperation`	<Operations> öğesinde belirtilen işlemlerin geçerlilik süresini desteklediğinden emin olun. Örneğin, VerifyToken işlemi bunu yapmaz.
`RefreshTokenExpiresInNotApplicableForOperation`	<Operations> öğesinde belirtilen işlemlerin yenileme jetonu geçerlilik süresini desteklediğinden emin olun. Örneğin, VerifyToken işlemi bunu yapmaz.
`GrantTypesNotApplicableForOperation`	<SupportedGrantTypes> bölümünde belirtilen izin türlerinin, belirtilen işlem için desteklendiğinden emin olun.
`OperationRequired`	Bu politikada `<Operation>` öğesini kullanarak bir işlem belirtmeniz gerekir. Not: `<Operation>` öğesi eksikse kullanıcı arayüzünde şema doğrulama hatası oluşur.
`InvalidOperation`	Bu politikada `<Operation>` öğesini kullanarak geçerli bir işlem belirtmeniz gerekir. Not: `<Operation>` öğesi geçersizse kullanıcı arayüzü bir şema doğrulama hatası verir.
`TokenValueRequired`	`<Tokens>` öğesinde bir jeton `<Token>` değeri belirtmeniz gerekir.

Hata değişkenleri

Bu değişkenler, bu politika çalışma zamanında bir hata tetiklediğinde ayarlanır.

Not: Hata Kuralı koşulları oluşturmak için bu değişkenleri kullanabilirsiniz. <GenerateResponse>, false olarak ayarlanırsa hata oluştuğunda bu değişkenler doldurulur. <GenerateResponse> true ise politika, hata meydana gelirse istemciye hemen yanıt döndürür. Hata akışı atlanır ve bu değişkenler doldurulmaz. Daha fazla bilgi için Politika hataları hakkında bilmeniz gerekenler başlıklı makaleyi inceleyin.

Değişkenler	Konum	Örnek
`fault.name="fault_name"`	`fault_name`, yukarıdaki Yazılım hataları tablosunda listelenen hatanın adıdır. Hata adı, hata kodunun son kısmıdır.	`fault.name = "InvalidRequest"`
`oauthV2.policy_name.failed`	`policy_name`, hatayı atan politikanın kullanıcı tarafından belirtilen adıdır.	`oauthV2.GenerateAccesstoken.failed = true`
`oauthV2.policy_name.fault.name`	`policy_name`, hatayı atan politikanın kullanıcı tarafından belirtilen adıdır.	`oauthV2.GenerateAccesstoken.fault.name = InvalidRequest` Not: VerifyAccessToken işleminde hata adı şu son eki içerir: `keymanagement.service` Örneğin: `keymanagement.service.invalid_access_token`
`oauthV2.policy_name.fault.cause`	`policy_name`, hatayı atan politikanın kullanıcı tarafından belirtilen adıdır.	`oauthV2.GenerateAccesstoken.cause = Required param : grant_type`

Örnek hata yanıtı

<GenerateResponse> öğesi true ise bu yanıtlar istemciye geri gönderilir.

Not: Hata işleme için en iyi uygulama, hata yanıtının errorcode bölümünü yakalamaktır. faultstring içindeki metne güvenmeyin, çünkü bu metin değişebilir.

<GenerateResponse> true ise politika, jeton ve kod oluşturan işlemler için bu biçimde hata döndürür. Tam liste için OAuth HTTP hata yanıtı referansı başlıklı makaleyi inceleyin.

{"ErrorCode" : "invalid_client", "Error" :"ClientId is Invalid"}

<GenerateResponse> doğru ise politika, doğrulama ve doğrulama işlemleri için hataları bu biçimde döndürür. Tam liste için OAuth HTTP hata yanıtı referansı başlıklı makaleyi inceleyin.

{  
   {  
      "fault":{  
         "faultstring":"Invalid Access Token",
         "detail":{  
            "errorcode":"keymanagement.service.invalid_access_token"
         }
      }
   }

Örnek hata kuralı

<FaultRule name=OAuthV2 Faults">
    <Step>
        <Name>AM-InvalidClientResponse</Name>
        <Condition>(fault.name = "invalid_client") OR (fault.name = "InvalidClientIdentifier")</Condition>
    </Step>
    <Step>
        <Name>AM-InvalidTokenResponse</Name>
        <Condition>(fault.name = "invalid_access_token")</Condition>
    </Step>
    <Condition>(oauthV2.failed = true) </Condition>
</FaultRule>

GetOAuthV2Info politikası

Çalışma zamanı hataları

Bu hatalar, politika yürütüldüğünde ortaya çıkabilir. Aşağıda gösterilen hata adları dizedir fault.name değişkenine atanır. Hatayı Göster değişkenler bölümüne bakın.

Hata kodu	HTTP durumu	Neden
`steps.oauth.v2.access_token_expired`	500	Politikaya gönderilen erişim jetonunun süresi doldu.
`steps.oauth.v2.authorization_code_expired`	500	Politikaya gönderilen yetkilendirme kodunun süresi dolmuş.
`steps.oauth.v2.invalid_access_token`	500	Politikaya gönderilen erişim jetonu geçersiz.
`steps.oauth.v2.invalid_client-invalid_client_id`	500	Politikaya gönderilen istemci kimliği geçersiz.
`steps.oauth.v2.invalid_refresh_token`	500	Politikaya gönderilen yenileme jetonu geçersiz.
`steps.oauth.v2.invalid_request-authorization_code_invalid`	500	Politikaya gönderilen yetkilendirme kodu geçersizdir.
`steps.oauth.v2.InvalidAPICallAsNoApiProductMatchFound`	401	Lütfen bkz. bu Apigee Topluluk gönderisine göz atın.
`steps.oauth.v2.refresh_token_expired`	500	Politikaya gönderilen yenileme jetonunun süresi dolmuş.

Dağıtım hataları

Dağıtım hataları hakkında bilgi için kullanıcı arayüzünde bildirilen mesaja bakın.

Hata değişkenleri

Bu değişkenler, politika çalışma zamanında bir hatayı tetiklediğinde ayarlanır.

Değişkenler	Konum	Örnek
`fault.name="fault_name"`	`fault_name`, yukarıdaki Çalışma zamanı hataları tablosunda listelendiği gibi hatanın adıdır. Hata adı, hata kodunun son kısmıdır.	`fault.name Matches "IPDeniedAccess"`
`oauthV2.policy_name.failed`	`policy_name`, hataya neden olan politikanın kullanıcı tarafından belirtilen adıdır.	`oauthV2.GetTokenInfo.failed = true`
`oauthV2.policy_name.fault.name`	`policy_name`, hataya neden olan politikanın kullanıcı tarafından belirtilen adıdır.	`oauthV2.GetToKenInfo.fault.name = invalid_client-invalid_client_id`
`oauthV2.policy_name.fault.cause`	`policy_name`, hataya neden olan politikanın kullanıcı tarafından belirtilen adıdır.	`oauthV2.GetTokenInfo.cause = ClientID is Invalid`

Örnek hata yanıtı

{  
   "fault":{  
      "faultstring":"ClientId is Invalid",
      "detail":{  
         "errorcode":"keymanagement.service.invalid_client-invalid_client_id"
      }
   }
}

Örnek hata kuralı

<FaultRule name="OAuthV2 Faults">
    <Step>
        <Name>AM-InvalidClientIdResponse</Name>
    </Step>
    <Condition>(fault.name = "invalid_client-invalid_client_id")</Condition>
</FaultRule>

SetOAuthV2Info politikası

Bu bölümde, bu politika bir hatayı tetiklediğinde Edge tarafından döndürülen hata kodları ve hata mesajları ile ayarlanan hata değişkenleri açıklanmaktadır. Bu bilgiler, hataları işlemek için hata kuralları geliştiriyorsanız önemlidir. Daha fazla bilgi edinmek için Politika hataları hakkında bilmeniz gerekenler ve Hataları ele alma başlıklı makaleleri inceleyin.

Çalışma zamanı hataları

Bu hatalar, politika yürütülürken oluşabilir.

Hata kodu	HTTP durumu	Neden
`steps.oauth.v2.access_token_expired`	500	Politikaya gönderilen erişim jetonunun süresi dolmuş.
`steps.oauth.v2.invalid_access_token`	500	Politikaya gönderilen erişim jetonu geçersiz.
`steps.oauth.v2.InvalidAPICallAsNoApiProductMatchFound`	401	Bu hatayı giderme hakkında bilgi edinmek için lütfen bu Apigee Topluluğu gönderisine bakın.

Dağıtım hataları

Dağıtım hataları hakkında bilgi edinmek için kullanıcı arayüzünde bildirilen mesaja bakın.

Hata değişkenleri

Bu değişkenler, bu politika çalışma zamanında bir hatayı tetiklediğinde ayarlanır.

Değişkenler	Konum	Örnek
`fault.name="fault_name"`	`fault_name`, yukarıdaki Çalışma zamanı hataları tablosunda listelenen hata adıdır. Hata adı, hata kodunun son kısmıdır.	`fault.name = "invalid_access_token"`
`oauthV2.policy_name.failed`	`policy_name`, hataya neden olan politikanın kullanıcı tarafından belirtilen adıdır.	`oauthV2.SetTokenInfo.failed = true`
`oauthV2.policy_name.fault.name`	`policy_name`, hataya neden olan politikanın kullanıcı tarafından belirtilen adıdır.	`oauthV2.SetTokenInfo.fault.name = invalid_access_token`
`oauthv2.policy_name.fault.cause`	`policy_name`, hataya neden olan politikanın kullanıcı tarafından belirtilen adıdır.	`oauthV2.SetTokenInfo.cause = Invalid Access Token`

Örnek hata yanıtı

{
  "fault": {
    "faultstring": "Invalid Access Token",
    "detail": {
      "errorcode": "keymanagement.service.invalid_access_token"
    }
  }
}

Örnek hata kuralı

<FaultRule name=SetOAuthV2Info Faults">
    <Step>
        <Name>AM-InvalidTokenResponse</Name>
        <Condition>(fault.name = "invalid_access_token")</Condition>
    </Step>
    <Condition>(oauthV2.failed = true) </Condition>
</FaultRule>

DeleteOAuthV2Info politikası

Çalışma zamanı hataları

Bu hatalar, politika yürütüldüğünde ortaya çıkabilir.

Hata kodu	HTTP durumu	Neden
`steps.oauth.v2.invalid_access_token`	401	Politikaya gönderilen erişim jetonu geçersiz.
`steps.oauth.v2.invalid_request-authorization_code_invalid`	401	Politikaya gönderilen yetkilendirme kodu geçersizdir.
`steps.oauth.v2.InvalidAPICallAsNoApiProductMatchFound`	401	Lütfen bkz. bu Apigee Topluluk gönderisine göz atın.

Dağıtım hataları

Dağıtım hataları hakkında bilgi için kullanıcı arayüzünde bildirilen mesaja bakın.

Hata değişkenleri

Bu değişkenler, politika çalışma zamanında bir hatayı tetiklediğinde ayarlanır.

Değişkenler	Konum	Örnek
`fault.name="fault_name"`	`fault_name`, yukarıdaki Çalışma zamanı hataları tablosunda listelendiği gibi hatanın adıdır. Hata adı, hata kodunun son kısmıdır.	`fault.name = "invalid_access_token"`
`oauthV2.policy_name.failed`	`policy_name`, hataya neden olan politikanın kullanıcı tarafından belirtilen adıdır.	`oauthV2.DeleteTokenInfo.failed = true`
`oauthV2.policy_name.fault.name`	`policy_name`, hataya neden olan politikanın kullanıcı tarafından belirtilen adıdır.	`oauthV2.DeleteTokenInfo.fault.name = invalid_access_token`
`oauthv2.policy_name.fault.cause`	`policy_name`, hataya neden olan politikanın kullanıcı tarafından belirtilen adıdır.	`oauthV2.DeleteTokenInfo.cause = Invalid Access Token`

Örnek hata yanıtı

{
  "fault": {
    "faultstring": "Invalid Access Token",
    "detail": {
      "errorcode": "keymanagement.service.invalid_access_token"
    }
  }
}

Örnek hata kuralı

<faultrule name="VariableOfNonMsgType"></faultrule><FaultRule name="DeleteOAuthV2Info_Faults">
    <Step>
        <Name>AM-InvalidTokenResponse</Name>
    </Step>
    <Condition>(fault.name = "invalid_access_token")</Condition>
</FaultRule>

OAuthv1.0a politikası

OAuthV1 Politika türü aşağıdaki hata kodlarını tanımlar.

OAuth ile ilgili HTTP hata kodları için OAuth HTTP hata yanıtı referansı başlıklı makaleye bakın.

Hata Kodu	Message

`AppKeyNotResolved`	`Could not resolve the app key with variable {0}`
`ConsumerKeyNotResolved`	`Could not resolve the consumer key with variable {0}`
`RequestTokenNotResolved`	`Could not resolve the request token with the variable {0}`
`AccessTokenNotResolved`	`Could not resolve the access token with the variable {0}`
`ResponseGenerationError`	`Error while generating response : {0}`
`UnableToDetermineOperation`	`Unable to determine an operation for stepDefinition {0}`
`UnableToResolveOAuthConfig`	`Unable to resolve the OAuth configuration for {0}`
`AtLeastOneParamRequired`	`At least one of AccessToken, RequestToken or ConsumerKey must be specified in stepDefinition {0}`
`SpecifyValueOrRefReqToken`	`Specify Request Token as value or ref in stepDefinition {0}`
`SpecifyValueOrRefAccToken`	`Specify Access Token as value or ref in stepDefinition {0}`
`SpecifyValueOrRefConKey`	`Specify Consumer Key as value or ref in stepDefinition {0}`
`SpecifyValueOrRefAppKey`	`Specify App Key as value or ref in stepDefinition {0}`
`ExpiresInNotApplicableForOperation`	`ExpiresIn element is not valid for operation {0}`
`InvalidValueForExpiresIn`	`Invalid value for ExpiresIn element for operation {0}`
`FailedToFetchApiProduct`	`Failed to fetch api product for key {0}`
`InvalidTokenType`	`Valid token types : {0}, Invalid toke type {1} in stepDefinition {2}`
`TokenValueRequired`	`Token value is required in stepDefinition {0}`
`FailedToResolveRealm`	`Failed to resolve realm {0}`

GetOAuthV1Info politikası

Get OAuth v1.0a Bilgi Politikası için hata kodu belirtilmemiş.

DeleteOAuthV1Info politikası

Başarılı olursa, politika 200 durumunu döndürür.

Hata durumunda, politika 404 hatasını döndürür ve aşağıdakine benzer bir çıkış verir (geçerlilik koşuluna bağlı olarak bir erişim jetonunu, istek jetonunu veya doğrulayıcıyı siliyorsanız):

HTTP/1.1 404 Not Found
Content-Type: application/json
Content-Length: 144
Connection: keep-alive

{"fault":{"faultstring":"Invalid Access Token","detail":{"errorcode":"keymanagement.service.invalid_request-access_token_invalid"}}}

PythonScript politikası

This section describes the fault codes and error messages that are returned and fault variables that are set by Edge when this policy triggers an error. This information is important to know if you are developing fault rules to handle faults. To learn more, see What you need to know about policy errors and Handling faults.

Runtime errors

These errors can occur when the policy executes.

Fault code	HTTP status	Cause	Fix
`steps.script.ScriptEvaluationFailed`	500	The PythonScript policy can throw several different types of ScriptExecutionFailed errors. Commonly seen types of errors include NameError and ZeroDivisionError.

Deployment errors

These errors can occur when you deploy a proxy containing this policy.

Error name	Cause	Fix
`InvalidResourceUrlFormat`	If the format of the resource URL specified within the `<ResourceURL>` or the `<IncludeURL>` element of the PythonScript policy is invalid, then the deployment of the API proxy fails.
`InvalidResourceUrlReference`	If the `<ResourceURL>` or the `<IncludeURL>` elements refer to a PythonScript file that does not exist, then the deployment of the API proxy fails. The referenced source file must exist either the API proxy, environment, or organization level.

Fault variables

These variables are set when this policy triggers an error at runtime. For more information, see What you need to know about policy errors.

Variables	Where	Example
`fault.name="fault_name"`	`fault_name` is the name of the fault, as listed in the Runtime errors table above. The fault name is the last part of the fault code.	`fault.name Matches "ScriptExecutionFailed"`
`pythonscript.policy_name.failed`	`policy_name` is the user-specified name of the policy that threw the fault.	`pythonscript.PythonScript-1.failed = true`

Example error response

Note: For error handling, the best practice is to trap the errorcode part of the error response. Do not rely on the text in the faultstring, because it could change.

{
  "fault": {
    "faultstring": "Execution of SetResponse failed with error: Pythonscript runtime error: "ReferenceError: "status" is not defined.\"",
    "detail": {
      "errorcode": "steps.script.ScriptExecutionFailed"
    }
  }
}

Example fault rule

<FaultRule name="PythonScript Policy Faults">
    <Step>
        <Name>AM-CustomErrorResponse</Name>
        <Condition>(fault.name Matches "ScriptExecutionFailed") </Condition>
    </Step>
    <Condition>(pythonscript.PythonScript-1.failed = true) </Condition>
</FaultRule>

Kota politikası

Çalışma zamanı hataları

Bu hatalar, politika yürütüldüğünde ortaya çıkabilir.

Hata kodu	HTTP durumu	Neden	Düzelt
`policies.ratelimit.FailedToResolveQuotaIntervalReference`	500	`<Interval>` öğesi Kota politikası içinde tanımlanmamışsa gerçekleşir. Bu öğe zorunludur ve kotaya uygulanabilir zaman aralığını belirtmek için kullanılır. Zaman aralığı `<TimeUnit>` öğesiyle tanımlanan şekilde dakika, saat, gün, hafta veya ay olabilir.
`policies.ratelimit.FailedToResolveQuotaIntervalTimeUnitReference`	500	`<TimeUnit>` öğesi Kota politikası içinde tanımlanmamışsa gerçekleşir. Bu öğe zorunludur ve kotaya uygulanacak zaman birimini belirtmek için kullanılır. Zaman aralığı dakika, saat, gün, hafta veya ay biçiminde olabilir.
`policies.ratelimit.InvalidMessageWeight`	500	`<MessageWeight>` öğesinin değeri bir akış değişkeni aracılığıyla belirtilirse gerçekleşir geçersiz (tam sayı olmayan bir değer).
`policies.ratelimit.QuotaViolation`	500	Kota sınırı aşıldı.	Yok

Dağıtım hataları

Hata adı	Neden	Düzelt
`InvalidQuotaInterval`	`<Interval>` öğesinde belirtilen kota aralığı farklıysa bir tam sayı görüntülerse API proxy'sinin dağıtımı başarısız olur. Örneğin, kota aralığı belirtilen `<Interval>` öğesinde 0.1 ise API proxy'si başarısız oldu.
`InvalidQuotaTimeUnit`	`<TimeUnit>` öğesinde belirtilen zaman birimi desteklenmiyorsa API proxy'sinin dağıtımı başarısız olur. Desteklenen zaman birimleri: `minute` `hour`, `day`, `week` ve `month`.
`InvalidQuotaType`	Kotanın türü, `<Quota>` içindeki `type` özelliği tarafından belirtiliyorsa öğesinin geçersiz olması durumunda API proxy'sinin dağıtımı başarısız olur. İlgili içeriği oluşturmak için kullanılan desteklenen kota türleri şunlardır: `default`, `calendar`, `flexi` ve `rollingwindow`.
`InvalidStartTime`	`<StartTime>` öğesinde belirtilen saatin biçimi geçersizse API proxy'sinin dağıtımı başarısız olur. Geçerli biçim şöyledir: `yyyy-MM-dd HH:mm:ss` ISO 8601 tarih ve saat biçimi. Örneğin, Örneğin, `<StartTime>` öğesinde belirtilen zaman `7-16-2017 12:00:00` sonrasında API proxy'sinin dağıtımı başarısız olur.
`StartTimeNotSupported`	Kota türü şu olmayan `<StartTime>` öğesi belirtilirse `calendar` türündeyse API proxy'sinin dağıtımı başarısız olur. `<StartTime>` öğesi yalnızca `calendar` kota türü için desteklenir. Örneğin, `type` özelliği `<Quota>` öğesinde `flexi` veya `rolling window` olarak değiştirilirse dağıtımı başarısız olur.
`InvalidTimeUnitForDistributedQuota`	`<Distributed>` öğesi `true` olarak, `<TimeUnit>` öğesi ise `second` nedeniyle API proxy'sinin dağıtımı başarısız olur. `second` zaman birimi şunun için geçersiz: dağıtılmış bir kota kullanır.
`InvalidSynchronizeIntervalForAsyncConfiguration`	`<SyncIntervalInSeconds>` öğesi için Kota politikasındaki `<AsynchronousConfiguration>` öğesi sıfırdan küçükse dağıtımı başarısız olur.
`InvalidAsynchronizeConfigurationForSynchronousQuota`	Kota politikasında `<AsynchronousConfiguration>` öğesinin değeri `true` olarak ayarlanırsa bu ayar aynı zamanda `<AsynchronousConfiguration>` öğesi kullanılarak tanımlanmış eşzamansız bir yapılandırma varsa ve API proxy'sinin dağıtımı başarısız olur.

Hata değişkenleri

Bu değişkenler, politika bir hatayı tetiklediğinde ayarlanır. Daha fazla bilgi için Bilmeniz gerekenler hakkında daha fazla bilgi edinin.

Değişkenler	Konum	Örnek
`fault.name="fault_name"`	`fault_name`, yukarıdaki Çalışma zamanı hataları tablosunda listelendiği gibi hatanın adıdır. Hata adı, hata kodunun son kısmıdır.	`fault.name Matches "QuotaViolation"`
`ratelimit.policy_name.failed`	`policy_name`, hataya neden olan politikanın kullanıcı tarafından belirtilen adıdır.	`ratelimit.QT-QuotaPolicy.failed = true`

Örnek hata yanıtı

Not: Hata işleme için en iyi uygulama, Hata yanıtının errorcode bölümü. Yalnızca faultstring, çünkü değişebilir.

{  
   "fault":{  
      "detail":{  
         "errorcode":"policies.ratelimit.QuotaViolation"
      },
      "faultstring":"Rate limit quota violation. Quota limit  exceeded. Identifier : _default"
   }
}

Örnek hata kuralı

<FaultRules>
    <FaultRule name="Quota Errors">
        <Step>
            <Name>JavaScript-1</Name>
            <Condition>(fault.name Matches "QuotaViolation") </Condition>
        </Step>
        <Condition>ratelimit.Quota-1.failed=true</Condition>
    </FaultRule>
</FaultRules>

ResetQuota politikası

Çalışma zamanı hataları

Politika yürütüldüğünde bu hatalar ortaya çıkabilir.

Hata kodu	HTTP durumu	Neden
`policies.resetquota.InvalidRLPolicy`	500	Kotayı Sıfırla politikasının `<Quota>` öğesinde belirtilen Kota politikası, API proxy'sinde tanımlanmadığından akış sırasında kullanılamaz. `<Quota>` öğesi zorunludur ve sayacının Kota Sıfırlama politikası aracılığıyla güncellenmesi gereken hedef Kota politikasını tanımlar.
`policies.resetquota.FailedToResolveAllowCountRef`	Yok	Politikanın `<Allow>` öğesinde izin verilen sayıyı içeren değişken referansı bir değere çözümlenemez. Bu öğe zorunludur ve kota sayacının azaltılacağı miktarı belirtir.
`policies.resetquota.FailedToResolveRLPolicy`	500	`<Quota>` öğesinde `ref` özelliği tarafından başvurulan değişken çözümlenemiyor.

Dağıtım hataları

Bu hatalar, bu politikayı içeren bir proxy dağıttığınızda ortaya çıkabilir.

Hata adı	Neden	Düzelt
`InvalidCount`	Kotayı Sıfırlama Politikası'nın `<Allow>` öğesinde belirtilen sayı değeri tam sayı değilse API proxy'sinin dağıtımı başarısız olur.

RaiseFault politikası

Bu bölümde, döndürülen hata kodları, hata mesajları ve hata değişkenleri açıklanmaktadır. bu politika bir hatayı tetiklediğinde Edge tarafından ayarlanır. Hata kuralları geliştirirken bu bilgilerin farkında olmanız önemlidir. hoşuma gitmesi için bir fırsattır. Daha fazla bilgi edinmek için bkz. Politika hataları ve politika hataları hakkında bilmeniz gerekenler Hataları işleme.

Çalışma zamanı hataları

Bu hatalar, politika yürütüldüğünde ortaya çıkabilir.

Hata kodu	HTTP durumu	Neden
`steps.raisefault.RaiseFault`	500	Hata dizesini inceleyin.

Dağıtım hataları

Yok.

Hata değişkenleri

Bu değişkenler, çalışma zamanı hatası oluştuğunda ayarlanır. Daha fazla bilgi için Bilmeniz gerekenler hakkında daha fazla bilgi edinin.

Değişkenler	Konum	Örnek
`fault.name="fault_name"`	`fault_name`, hatanın şurada belirtildiği gibi adıdır: Yukarıdaki Çalışma zamanı hataları tablosu. Hata adı en son hata kodunun bir bölümüdür.	`fault.name = "RaiseFault"`
`raisefault.policy_name.failed`	`policy_name`, politikanın kullanıcı tarafından belirtilen adıdır ortaya koydu.	`raisefault.RF-ThrowError.failed = true`

Örnek hata yanıtı

Not: Hata işleme için en iyi uygulama, Hata yanıtının errorcode bölümü. Yalnızca faultstring, çünkü değişebilir.

{
   "fault":{
      "detail":{
         "errorcode":"steps.raisefault.RaiseFault"
      },
      "faultstring":"Raising fault. Fault name: [name]"
   }
}

RegularExpressionProtection politikası

This section describes the error codes and messages returned and fault variables set by Edge when this policy triggers an error. This information is important to know if you are developing fault rules to handle faults. If you want to capture an error and raise your own custom error, set the continueOnError="true" attribute on the policy root element. To learn more, see What you need to know about policy errors and Handling faults.

Errors returned from Edge policies follow a consistent format as described in the Error code reference.

Runtime errors

These errors can occur when the policy executes.

Error Code	Message

ExecutionFailed	Failed to execute the RegularExpressionProtection StepDefinition {0}. Reason: {1}
InstantiationFailed	Failed to instantiate the RegularExpressionProtection StepDefinition {0}
NonMessageVariable	Variable {0} does not resolve to a Message
SourceMessageNotAvailable	{0} message is not available for RegularExpressionProtection StepDefinition {1}
ThreatDetected	Regular Expression Threat Detected in {0}: regex: {1} input: {2}
VariableResolutionFailed	Failed to resolve variable {0}

Deployment errors

Error Code	Message	Fix

CannotBeConvertedToNodeset	RegularExpressionProtection {0}: Result of xpath {1} cannot be converted to nodeset. Context {2}
DuplicatePrefix	RegularExpressionProtection {0}: Duplicate prefix {1}
EmptyJSONPathExpression	RegularExpressionProtection {0}: Empty JSONPath expression
EmptyXPathExpression	RegularExpressionProtection {0}: Empty XPath expression
InvalidRegularExpression	RegularExpressionProtection {0}: Invalid Regular Expression {1}, Context {2}
JSONPathCompilationFailed	RegularExpressionProtection {0}: Failed to compile jsonpath {1}. Context {2}
NONEmptyPrefixMappedToEmptyURI	RegularExpressionProtection {0}: Non-empty prefix {1} cannot be mapped to empty uri
NoPatternsToEnforce	RegularExpressionProtection {0}: No patterns to enforce in {1}
NothingToEnforce	RegularExpressionProtection {0}: at least one of URIPath, QueryParam, Header, FormParam, XMLPayload, JSONPayload is mandatory
XPathCompilationFailed	RegularExpressionProtection {0}: Failed to compile xpath {1}. Context {2}

Fault variables

These variables are set when this policy triggers an error. For more information, see What you need to know about policy errors.

Variables	Where	Example
`fault.name="fault_name"`	`fault_name` is the name of the fault, as listed in the table above.	`fault.name Matches "ThreatDetected"`
`regularexpressionprotection.policy_name.failed`	`policy_name` is the user-specified name of the policy that threw the fault.	`regularexpressionprotection.Regular-Expressions-Protection-1.failed = true`

SOAPMessageValidation politikası

This section describes the fault codes and error messages that are returned and fault variables that are set by Edge when this policy triggers an error. This information is important to know if you are developing fault rules to handle faults. To learn more, see What you need to know about policy errors and Handling faults.

Runtime errors

These errors can occur when the policy executes.

Fault code HTTP status Cause Fix

steps.messagevalidation.SourceMessageNotAvailable

500

This error occurs if a variable specified in the <Source> element of the policy is either:

out of scope (not available in the specific flow where the policy is being executed)
can't be resolved (is not defined)

steps.messagevalidation.NonMessageVariable

500

This error occurs if the <Source> element in the SOAPMessageValidation policy is set to a variable which is not of type message.

Message type variables represent entire HTTP requests and responses. The built-in Edge flow variables request, response, and message are of type message. To learn more about message variables, see the Variables reference.

steps.messagevalidation.Failed 500 This error occurs if the SOAPMessageValidation policy fails to validate the input message payload against the XSD schema or WSDL definition. It will also occur if there is malformed JSON or XML in the payload message.

Deployment errors

These errors can occur when you deploy a proxy containing this policy.

Error name	Cause	Fix
`InvalidResourceType`	The `<ResourceURL>` element in the SOAPMessageValidation policy is set to a resource type not supported by the policy.
`ResourceCompileFailed`	The resource script referenced in the `<ResourceURL>` element of the SOAPMessageValidation policy contains an error that prevents it from compiling.
`RootElementNameUnspecified`	The `<Element>` element in the SOAPMessageValidation policy does not contain the root element's name.
`InvalidRootElementName`	The `<Element>` element in the SOAPMessageValidation policy contains a root element name that does not adhere to XML rules for valid element naming.

SAMLAssertion politikası

Bu bölümde, döndürülen hata kodları ve hata mesajları açıklanmaktadır ve bu politika bir hatayı tetiklediğinde Edge tarafından ayarlanan hata değişkenleri. Hata kuralları geliştirirken bu bilgilerin farkında olmanız önemlidir. hoşuma gitmesi için bir fırsattır. Daha fazla bilgi için Bilmeniz gerekenler Politika hataları ve Kullanım sorun.

Dağıtım hataları

Bu politikayı içeren bir proxy dağıttığınızda bu hatalar oluşabilir.

Hata adı	Neden	Düzelt
`SourceNotConfigured`	Aşağıdaki "SAML Onay Doğrulaması" öğelerinden biri veya daha fazlası politika tanımlanmadı veya boş: `<Source>`, `<XPath>`, `<Namespaces>`, `<Namespace>`.
`TrustStoreNotConfigured`	`<TrustStore>` öğesi boşsa veya ValidateSAMLAssertion politikasını kontrol ederseniz API proxy'sinin dağıtımı başarısız olur. Geçerli bir Trust Store gerekli.
`NullKeyStoreAlias`	`<Alias>` alt öğesi boşsa veya `<Keystore>` içinde belirtilmemişse öğesi oluşturun, ardından API'nin dağıtımına proxy başarısız olur. Geçerli bir Anahtar Deposu takma adı gerekir.
`NullKeyStore`	`<Name>` alt öğesi boşsa veya `<Keystore>` içinde belirtilmemişse öğesi oluşturmak, ardından API dağıtımının proxy başarısız olur. Geçerli bir Anahtar Deposu adı gerekli.
`NullIssuer`	`<Issuer>` öğesi boşsa veya SAML Oluştur bölümünde belirtilmemişse Onay politikası yoksa API proxy'sinin dağıtımı başarısız olur. CEVAP geçerli `<Issuer>` değeri gereklidir.

Hata değişkenleri

Bu değişkenler, çalışma zamanı hatası oluştuğunda ayarlanır. Daha fazla bilgi için Bilmeniz gerekenler hakkında daha fazla bilgi edinin.

Değişkenler	Konum	Örnek
`fault.name="fault_name"`	`fault_name`, hatanın adıdır. Hata adı, hata kodunun son kısmıdır.	`fault.name = "InvalidMediaTpe"`
`GenerateSAMLAssertion.failed`	Doğrulama SAML onay politikası yapılandırması için hata öneki `ValidateSAMLAssertion`	`GenerateSAMLAssertion.failed = true`

Örnek hata yanıtı

Not: Hata işleme için en iyi uygulama, Hata yanıtının errorcode bölümü. Yalnızca faultstring, çünkü değişebilir.

{
  "fault": {
    "faultstring": "GenerateSAMLAssertion[GenSAMLAssert]: Invalid media type",
    "detail": {
      "errorcode": "steps.saml.generate.InvalidMediaTpe"
    }
  }
}

Örnek hata kuralı

<FaultRules>
    <FaultRule name="invalid_saml_rule">
        <Step>
            <Name>invalid-saml</Name>
        </Step>
        <Condition>(GenerateSAMLAssertion.failed = "true")</Condition>
    </FaultRule>
</FaultRules>

ServiceCallout politikası

Çalışma zamanı hataları

Bu hatalar, politika yürütüldüğünde ortaya çıkabilir.

Hata kodu HTTP durumu Neden Düzelt

steps.servicecallout.ExecutionFailed

500

Bu hata aşağıdaki durumlarda ortaya çıkabilir:

politikanın, hatalı veya başka bir şekilde geçersiz olan girişi işlemesi istenir.
arka uç hedef hizmeti bir hata durumu (varsayılan olarak 4xx veya 5xx) döndürür.

steps.servicecallout.RequestVariableNotMessageType 500 Politikada belirtilen İstek değişkeni Mesaj türünde değil. Örneğin, bir dize veya başka bir mesaj türünde değilse bu hatayı görürsünüz.

steps.servicecallout.RequestVariableNotRequestMessageType 500 Politikada belirtilen İstek değişkeni, İstek Mesajı türünde değil. Örneğin, Örneğin, Yanıt türü ise bu hatayı görürsünüz.

Dağıtım hataları

Bu politikayı içeren bir proxy dağıttığınızda bu hatalar oluşabilir.

Hata adı	Neden	Düzelt
`URLMissing`	`<HTTPTargetConnection>` içindeki `<URL>` öğesi eksik veya boş.
`ConnectionInfoMissing`	Bu hata, politikada `<HTTPTargetConnection>` veya `<LocalTargetConnection>` öğesine dokunun.
`InvalidTimeoutValue`	Bu hata, `<Timeout>` değeri negatif veya sıfır olduğunda ortaya çıkar.

Hata değişkenleri

Bu değişkenler, çalışma zamanı hatası oluştuğunda ayarlanır. Daha fazla bilgi için Bilmeniz gerekenler hakkında daha fazla bilgi edinin.

Değişkenler	Konum	Örnek
`fault.name="fault_name"`	`fault_name`, yukarıdaki Çalışma zamanı hataları tablosunda listelendiği gibi hatanın adıdır. Hata adı, hata kodunun son kısmıdır.	`fault.name = "RequestVariableNotMessageType"`
`servicecallout.policy_name.failed`	`policy_name`, hataya neden olan politikanın kullanıcı tarafından belirtilen adıdır.	`servicecallout.SC-GetUserData.failed = true`

Örnek hata yanıtı

Not: Hata işleme için en iyi uygulama, Hata yanıtının errorcode bölümü. Yalnızca faultstring, çünkü değişebilir.

{  
   "fault":{  
      "detail":{  
         "errorcode":"steps.servicecallout.RequestVariableNotMessageType"
      },
      "faultstring":"ServiceCallout[ServiceCalloutGetMockResponse]: 
            request variable data_str value is not of type Message"
   }
}

Örnek hata kuralı

<faultrule name="VariableOfNonMsgType"></faultrule><FaultRule name="RequestVariableNotMessageType">
    <Step>
        <Name>AM-RequestVariableNotMessageType</Name>
    </Step>
    <Condition>(fault.name = "RequestVariableNotMessageType")</Condition>
</FaultRule>

SpikeArrest politikası

Bu bölümde, döndürülen hata kodları, hata mesajları ve hata değişkenleri açıklanmaktadır. bu politika bir hatayı tetiklediğinde Edge tarafından ayarlanır. Hata kuralları geliştirirken bu bilgilerin farkında olmanız önemlidir. hoşuma gitmesi için bir fırsattır. Daha fazla bilgi edinmek için bkz. Bilmeniz gerekenler Politika hataları ve Kullanım sorun.

Çalışma zamanı hataları

Bu hatalar, politika yürütüldüğünde ortaya çıkabilir.

Hata kodu	HTTP durumu	Neden
`policies.ratelimit.FailedToResolveSpikeArrestRate`	`500`	Bu hata, ücret ayarını içeren değişkene yapılan referansın `<Rate>` öğesi içindeki artış, Spike Arrest içindeki bir değere çözümlenemez. politikası. Bu öğe zorunludur ve şu öğede artış durdurma oranını belirtmek için kullanılır: `intpm` veya `intps` biçiminde olmalıdır.
`policies.ratelimit.InvalidMessageWeight`	`500`	Bu hata, `<MessageWeight>` öğesi için belirtilen değer bir akış değişkeni geçersiz (tam sayı olmayan bir değer).
`policies.ratelimit.SpikeArrestViolation`	`429`	Oran sınırı aşıldı. Not: Private Cloud için döndürülen varsayılan HTTP durum kodu `500` şeklindedir. `429` parametresine döndürülen durum kodunu değiştirmek için bu özelliği API ile ayarlayın Örnek hata kuralı bölümünde açıklandığı çağrı

Dağıtım hataları

Bu politikayı içeren bir proxy dağıttığınızda bu hatalar oluşabilir.

Hata adı	Neden	Düzelt
`InvalidAllowedRate`	Ani artış durdurma oranı, Spike Arrest'in `<Rate>` öğesinde belirtiliyorsa Politika tam sayı değil veya ücretin son eki `ps` ya da `pm` yoksa API proxy'sinin dağıtımı başarısız olur.

Hata değişkenleri

Bu değişkenler, çalışma zamanı hatası oluştuğunda ayarlanır. Daha fazla bilgi için Bilmeniz gerekenler hakkında daha fazla bilgi edinin.

Değişkenler	Konum	Örnek
`fault.name="fault_name"`	`fault_name`, hatanın şurada belirtildiği gibi adıdır: Yukarıdaki Çalışma zamanı hataları tablosu. Hata adı son parça hata kodu vardır.	`fault.name Matches "SpikeArrestViolation"`
`ratelimit.policy_name.failed`	`policy_name`, hataya neden olan politikanın kullanıcı tarafından belirtilen adıdır.	`ratelimit.SA-SpikeArrestPolicy.failed = true`

Örnek hata yanıtı

Aşağıda örnek bir hata yanıtı gösterilmektedir:

Not: Hata işleme için en iyi uygulama, Hata yanıtının errorcode bölümü. Yalnızca faultstring, çünkü değişebilir.

{  
   "fault":{  
      "detail":{  
         "errorcode":"policies.ratelimit.SpikeArrestViolation"
      },
      "faultstring":"Spike arrest violation. Allowed rate : 10ps"
   }
}

Örnek hata kuralı

Aşağıda, bir SpikeArrestViolation hatasını işleyecek örnek bir hata kuralı gösterilmektedir:

<FaultRules>
    <FaultRule name="Spike Arrest Errors">
        <Step>
            <Name>JavaScript-1</Name>
            <Condition>(fault.name Matches "SpikeArrestViolation") </Condition>
        </Step>
        <Condition>ratelimit.Spike-Arrest-1.failed=true</Condition>
    </FaultRule>
</FaultRules>

StatisticsCollector politikası

This section describes the error messages and flow variables that are set when this policy triggers an error. This information is important to know if you are developing fault rules for a proxy. To learn more, see What you need to know about policy errors and Handling faults.

Runtime errors

None.

Deployment errors

Error name	Cause	Fix
`UnsupportedDatatype`	If the type of the variable specified by the ref attribute in the `<Statistic>` element of the Statistics Collector policy is unsupported, then the deployment of the API proxy fails. The supported data types are `string`, `integer`, `float`, `long`, `double`, and `boolean`.
`InvalidName`	If the name used to reference the data collected for the specified variable defined within the `<Statistic>` element of the Statistics Collector policy conflicts with a system-defined variable, then the deployment of the API proxy fails. Some of the known system-defined variables are `organization` and `environment`.
`DatatypeMissing`	If the type of the variable specified by the `ref` attribute in the `<Statistic>` element of the Statistics Collector policy is missing, then the deployment of the API proxy fails.

Fault variables

None.

VerifyAPIKey politikası

Çalışma zamanı hataları

Bu hatalar, politika yürütülürken oluşabilir.

Hata kodu	HTTP durumu	Neden
`keymanagement.service.CompanyStatusNotActive`	401	Kullandığınız API anahtarına sahip geliştirici uygulamasıyla ilişkili şirketin durumu etkin değil. Bir şirketin durumu etkin değil olarak ayarlandığında, bu şirketle ilişkili geliştiricilere veya uygulamalara erişemezsiniz. Bir kuruluş yöneticisi, yönetim API'sini kullanarak bir şirketin durumunu değiştirebilir. Şirketlerin durumunu ayarlama başlıklı makaleyi inceleyin.
`keymanagement.service.DeveloperStatusNotActive`	401	Kullandığınız API anahtarını içeren geliştirici uygulamasını oluşturan geliştiricinin durumu etkin değil. Bir uygulama geliştiricinin durumu etkin değil olarak ayarlandığında, bu geliştirici tarafından oluşturulan tüm geliştirici uygulamaları devre dışı bırakılır. Uygun izinlere sahip bir yönetici kullanıcısı (ör. kuruluş yöneticisi), geliştiricinin durumunu aşağıdaki şekillerde değiştirebilir: Management API: Set Developer Status Yönetim kullanıcı arayüzü: Uygulama geliştiricileri kaydetme bölümünde, geliştiricileri devre dışı bırakma (ve etkinleştirme) talimatlarını inceleyin.
`keymanagement.service.invalid_client-app_not_approved`	401	API anahtarıyla ilişkili geliştirici uygulaması iptal edildi. İptal edilen bir uygulama, herhangi bir API ürününe erişemez ve Apigee Edge tarafından yönetilen herhangi bir API'yi çağıramaz. Kuruluş yöneticisi, yönetim API'sini kullanarak geliştirici uygulamasının durumunu değiştirebilir. Geliştirici Uygulamasını Onaylama veya İptal Etme başlıklı makaleyi inceleyin.
`oauth.v2.FailedToResolveAPIKey`	401	Politika, API anahtarının politikanın <APIKey> öğesinde belirtilen bir değişkende bulunmasını bekler. Bu hata, beklenen değişken mevcut olmadığında (çözümlenemediğinde) ortaya çıkar.
`oauth.v2.InvalidApiKey`	401	Edge tarafından bir API anahtarı alındı ancak bu anahtar geçersiz. Edge, veritabanında anahtarı ararken istekle gönderilen anahtarla tam olarak eşleşmelidir. API daha önce çalıştıysa anahtarın yeniden oluşturulmadığından emin olun. Anahtar yeniden oluşturulduysa eski anahtarı kullanmaya çalıştığınızda bu hatayı görürsünüz. Ayrıntılı bilgi için Uygulamaları kaydetme ve API anahtarlarını yönetme başlıklı makaleyi inceleyin.
`oauth.v2.InvalidApiKeyForGivenResource`	401	Edge tarafından geçerli bir API anahtarı alındı ancak bu anahtar, bir ürün aracılığıyla API proxy'nizle ilişkili geliştirici uygulamasındaki onaylı bir anahtarla eşleşmiyor.

Not: Edge şu anda ApiKeyNotApproved hatasını doğru şekilde bildirmiyor. Bunun yerine, bir anahtar onaylanmazsa (durumu "iptal edildi" veya "beklemede" olarak ayarlanırsa) FailedToResolveAPIKey hatası alırsınız. Daha fazla bilgi ve olası bir geçici çözüm için Apigee Topluluğu'ndaki bu gönderiye göz atın.

Dağıtım hataları

Bu hatalar, bu politikayı içeren bir proxy dağıttığınızda oluşabilir.

Hata adı	Neden
`SpecifyValueOrRefApiKey`	`<APIKey>` öğesinde değer veya anahtar belirtilmemiş.

Hata değişkenleri

Bu değişkenler, çalışma zamanı hatası oluştuğunda ayarlanır. Daha fazla bilgi için Politika hataları hakkında bilmeniz gerekenler başlıklı makaleyi inceleyin.

Değişkenler	Konum	Örnek
`fault.name="fault_name"`	`fault_name`, yukarıdaki Çalışma zamanı hataları tablosunda listelenen hata adıdır. Hata adı, hata kodunun son kısmıdır.	`fault.name Matches "FailedToResolveAPIKey"`
`oauthV2.policy_name.failed`	`policy_name`, hataya neden olan politikanın kullanıcı tarafından belirtilen adıdır.	`oauthV2.VK-VerifyAPIKey.failed = true`

Örnek hata yanıtları

Not: Hata işleme için en iyi uygulama, hata yanıtının errorcode bölümünü yakalamaktır. faultstring içindeki metin değişebileceğinden bu metne güvenmeyin.

{
   "fault":{
      "faultstring":"Invalid ApiKey",
      "detail":{
         "errorcode":"oauth.v2.InvalidApiKey"
      }
   }
}

{
   "fault":{
      "detail":{
         "errorcode":"keymanagement.service.DeveloperStatusNotActive"
      },
      "faultstring":"Developer Status is not Active"
   }
}

Örnek hata kuralı

<FaultRule name="FailedToResolveAPIKey">
    <Step>
        <Name>AM-FailedToResolveAPIKey</Name>
    </Step>
    <Condition>(fault.name Matches "FailedToResolveAPIKey") </Condition>
</FaultRule>

VerifyJWS politikası

Çalışma zamanı hataları

Politika yürütüldüğünde bu hatalar ortaya çıkabilir.

Hata kodu	HTTP durumu	Gerçekleşme zamanı:
`steps.jws.AlgorithmInTokenNotPresentInConfiguration`	401	Doğrulama politikasında birden fazla algoritma olduğunda ortaya çıkar
`steps.jws.AlgorithmMismatch`	401	Oluşturma politikası tarafından başlıkta belirtilen algoritma, Doğrulama politikasında beklenen algoritmayla eşleşmedi. Belirtilen algoritmalar eşleşmelidir.
`steps.jws.ContentIsNotDetached`	401	`<DetachedContent>`, JWS, ayrılmış içerik yükü içermiyorsa belirtilir.
`steps.jws.FailedToDecode`	401	Politika, JWS'nin kodu çözülemedi. JWS büyük olasılıkla bozuktur.
`steps.jws.InsufficientKeyLength`	401	HS256 algoritmasına göre 32 bayttan küçük bir anahtar için
`steps.jws.InvalidClaim`	401	Eksik hak talebi veya hak talebi uyuşmazlığı ya da eksik başlık veya başlık uyuşmazlığı için.
`steps.jws.InvalidCurve`	401	Anahtar tarafından belirtilen eğri, Elips Biçimli Eğri algoritması için geçerli değildir.
`steps.jws.InvalidJsonFormat`	401	JWS üstbilgisinde geçersiz JSON bulundu.
`steps.jws.InvalidJws`	401	Bu hata, JWS imzası doğrulaması başarısız olduğunda oluşur.
`steps.jws.InvalidPayload`	401	JWS yükü geçersiz.
`steps.jws.InvalidSignature`	401	`<DetachedContent>` atlanır ve JWS'de ayrı bir içerik yükü bulunur.
`steps.jws.KeyIdMissing`	401	Doğrulama politikası, ortak anahtarlar için kaynak olarak bir JWKS kullanır ancak imzalanmış JWS, başlıkta bir `kid` özelliği içermez.
`steps.jws.KeyParsingFailed`	401	Ortak anahtar, verilen anahtar bilgisinden ayrıştırılamadı.
`steps.jws.MissingPayload`	401	JWS yükü eksik.
`steps.jws.NoAlgorithmFoundInHeader`	401	JWS, algoritma başlığını çıkardığında ortaya çıkar.
`steps.jws.NoMatchingPublicKey`	401	Doğrulama politikası, ortak anahtarlar için kaynak olarak JWKS kullanır ancak imzalanmış JWS'deki `kid`, JWKS'de listelenmiyor.
`steps.jws.UnhandledCriticalHeader`	401	`crit` başlığında JWS'yi Doğrula politikası tarafından bulunan üst bilgi `KnownHeaders` bölgesinde listelenmiyor.
`steps.jws.UnknownException`	401	Bilinmeyen bir istisna oluştu.
`steps.jws.WrongKeyType`	401	Anahtar türü yanlış belirtilmiş. Örneğin, Elips Biçimli Eğri algoritması için RSA anahtarı veya RSA algoritması için eğri anahtarı belirtirseniz.

Dağıtım hataları

Bu hatalar, bu politikayı içeren bir proxy dağıttığınızda ortaya çıkabilir.

Hata adı Gerçekleşme zamanı:

InvalidAlgorithm Geçerli değerler şunlardır: RS256, RS384, RS512, PS256, PS384, PS512, ES256, ES384, ES512, HS256, HS384, HS512.

EmptyElementForKeyConfiguration

FailedToResolveVariable

InvalidConfigurationForActionAndAlgorithmFamily

InvalidConfigurationForVerify

InvalidEmptyElement

InvalidFamiliesForAlgorithm

InvalidKeyConfiguration

InvalidNameForAdditionalClaim

InvalidNameForAdditionalHeader

InvalidPublicKeyId

InvalidPublicKeyValue

InvalidSecretInConfig

InvalidTypeForAdditionalClaim

InvalidTypeForAdditionalHeader

InvalidValueForElement

InvalidValueOfArrayAttribute

InvalidVariableNameForSecret

MissingConfigurationElement

MissingElementForKeyConfiguration

MissingNameForAdditionalClaim

MissingNameForAdditionalHeader

Diğer olası dağıtım hataları.

Hata değişkenleri

Bu değişkenler, çalışma zamanı hatası oluştuğunda ayarlanır. Daha fazla bilgi için Bilmeniz gerekenler hakkında daha fazla bilgi edinin.

Değişkenler	Konum	Örnek
`fault.name="fault_name"`	`fault_name`, yukarıdaki Çalışma zamanı hataları tablosunda listelendiği gibi hatanın adıdır. Hata adı, hata kodunun son kısmıdır.	`fault.name Matches "TokenExpired"`
`JWS.failed`	Tüm JWS politikaları, hata durumunda aynı değişkeni ayarlar.	`jws.JWS-Policy.failed = true`

Örnek hata yanıtı

Hata giderme için en iyi uygulama, hatanın errorcode kısmını yakalamaktır tıklayın. Değişebileceği için faultstring içindeki metne güvenmeyin.

Örnek hata kuralı

<FaultRules>
    <FaultRule name="JWS Policy Errors">
        <Step>
            <Name>JavaScript-1</Name>
            <Condition>(fault.name Matches "TokenExpired")</Condition>
        </Step>
        <Condition>JWS.failed=true</Condition>
    </FaultRule>
</FaultRules>

VerifyJWT politikası

Çalışma zamanı hataları

Politika yürütüldüğünde bu hatalar ortaya çıkabilir.

Hata kodu	HTTP durumu	Gerçekleşme zamanı:
`steps.jwt.AlgorithmInTokenNotPresentInConfiguration`	401	Doğrulama politikasında birden fazla algoritma olduğunda ortaya çıkar.
`steps.jwt.AlgorithmMismatch`	401	Oluşturma politikasında belirtilen algoritma, Doğrulama politikasında beklenen algoritmayla eşleşmedi. Belirtilen algoritmalar eşleşmelidir.
`steps.jwt.FailedToDecode`	401	Politika, JWT'nin kodu çözülemedi. JWT bozuk olabilir.
`steps.jwt.GenerationFailed`	401	Politika, JWT'yi oluşturamadı.
`steps.jwt.InsufficientKeyLength`	401	HS256 algoritmasında 32 bayttan, HS386 algoritmasında 48 bayttan ve HS512 algoritmasında 64 bayttan az olan bir anahtar.
`steps.jwt.InvalidClaim`	401	Eksik hak talebi veya hak talebi uyuşmazlığı ya da eksik başlık veya başlık uyuşmazlığı için.
`steps.jwt.InvalidCurve`	401	Anahtar tarafından belirtilen eğri, Elips Biçimli Eğri algoritması için geçerli değildir.
`steps.jwt.InvalidJsonFormat`	401	Başlıkta veya yükte geçersiz JSON bulundu.
`steps.jwt.InvalidToken`	401	Bu hata, JWT imzası doğrulaması başarısız olduğunda ortaya çıkar.
`steps.jwt.JwtAudienceMismatch`	401	Kitle hak talebi, jeton doğrulanamadı.
`steps.jwt.JwtIssuerMismatch`	401	Kartı veren kuruluş talebi, jeton doğrulamasında başarısız oldu.
`steps.jwt.JwtSubjectMismatch`	401	Konuyla ilgili hak talebi, jeton doğrulanamadı.
`steps.jwt.KeyIdMissing`	401	Doğrulama politikası, ortak anahtarlar için kaynak olarak bir JWKS kullanır ancak imzalı JWT, başlıkta `kid` özelliği içermiyor.
`steps.jwt.KeyParsingFailed`	401	Ortak anahtar, verilen anahtar bilgisinden ayrıştırılamadı.
`steps.jwt.NoAlgorithmFoundInHeader`	401	JWT, herhangi bir algoritma başlığı içermiyorsa ortaya çıkar.
`steps.jwt.NoMatchingPublicKey`	401	Doğrulama politikası, ortak anahtarlar için kaynak olarak JWKS kullanır ancak imzalı JWT'deki `kid`, JWKS'de listelenmiyor.
`steps.jwt.SigningFailed`	401	GenerateJWT'de, HS384 veya HS512 algoritmaları için minimum boyuttan daha küçük bir anahtar için
`steps.jwt.TokenExpired`	401	Politika, süresi dolmuş bir jetonu doğrulamaya çalışır.
`steps.jwt.TokenNotYetValid`	401	Jeton henüz geçerli değil.
`steps.jwt.UnhandledCriticalHeader`	401	`crit` başlığında JWT'yi Doğrula politikası tarafından bulunan üst bilgi, `KnownHeaders` bölgesinde listelenmiyor.
`steps.jwt.UnknownException`	401	Bilinmeyen bir istisna oluştu.
`steps.jwt.WrongKeyType`	401	Anahtar türü yanlış belirtilmiş. Örneğin, Elips Biçimli Eğri algoritması için RSA anahtarı veya RSA algoritması için eğri anahtarı belirtirseniz.

Dağıtım hataları

Bu hatalar, bu politikayı içeren bir proxy dağıttığınızda ortaya çıkabilir.

Hata adı	Neden	Düzelt
`InvalidNameForAdditionalClaim`	`<AdditionalClaims>` öğesinin `<Claim>` alt öğesinde kullanılan hak talebi şu kayıtlı adlardan biriyse dağıtım başarısız olur: `kid`, `iss`, `sub`, `aud`, `iat`, `exp`, `nbf` veya `jti`.
`InvalidTypeForAdditionalClaim`	`<AdditionalClaims>` öğesinin `<Claim>` alt öğesinde kullanılan hak talebi `string`, `number`, `boolean` veya `map` türünde değilse dağıtım başarısız olur.
`MissingNameForAdditionalClaim`	İddianın adı `<AdditionalClaims>` öğesinin `<Claim>` alt öğesinde belirtilmezse dağıtım başarısız olur.
`InvalidNameForAdditionalHeader`	Bu hata, `<AdditionalClaims>` öğesinin `<Claim>` alt öğesinde kullanılan iddianın adı `alg` veya `typ` olduğunda ortaya çıkar.
`InvalidTypeForAdditionalHeader`	`<AdditionalClaims>` öğesinin `<Claim>` alt öğesinde kullanılan hak talebi türü `string`, `number`, `boolean` veya `map` türünde değilse dağıtım başarısız olur.
`InvalidValueOfArrayAttribute`	Bu hata, `<AdditionalClaims>` öğesinin `<Claim>` alt öğesindeki dizi özelliğinin değeri `true` veya `false` olarak ayarlanmadığında ortaya çıkar.
`InvalidValueForElement`	`<Algorithm>` öğesinde belirtilen değer desteklenen bir değer değilse dağıtım başarısız olur.
`MissingConfigurationElement`	`<PrivateKey>` öğesi, RSA ailesi algoritmaları veya `<SecretKey>` öğesi HS Family algoritmaları ile kullanılmazsa bu hata oluşur.
`InvalidKeyConfiguration`	`<Value>` alt öğesi `<PrivateKey>` veya `<SecretKey>` öğelerinde tanımlanmazsa dağıtım başarısız olur.
`EmptyElementForKeyConfiguration`	`<PrivateKey>` veya `<SecretKey>` öğelerinin `<Value>` alt öğesinin ref özelliği boşsa ya da belirtilmemişse dağıtım başarısız olur.
`InvalidConfigurationForVerify`	Bu hata, `<Id>` öğesi `<SecretKey>` öğesi içinde tanımlanırsa ortaya çıkar.
`InvalidEmptyElement`	Bu hata, JWT'yi Doğrula politikasının `<Source>` öğesi boşsa ortaya çıkar. Varsa Edge akışı değişken adıyla tanımlanmalıdır.
`InvalidPublicKeyValue`	`<PublicKey>` öğesinin `<JWKS>` alt öğesinde kullanılan değer, RFC 7517'de belirtildiği gibi geçerli bir biçimi kullanmıyorsa dağıtım başarısız olur.
`InvalidConfigurationForActionAndAlgorithm`	`<PrivateKey>` öğesi HS Family algoritmalarıyla veya `<SecretKey>` öğesi RSA Family algoritmalarıyla kullanılıyorsa dağıtım başarısız olur.

Hata değişkenleri

Bu değişkenler, çalışma zamanı hatası oluştuğunda ayarlanır. Daha fazla bilgi için Bilmeniz gerekenler hakkında daha fazla bilgi edinin.

Değişkenler	Konum	Örnek
`fault.name="fault_name"`	`fault_name`, yukarıdaki Çalışma zamanı hataları tablosunda listelendiği gibi hatanın adıdır. Hata adı, hata kodunun son kısmıdır.	`fault.name Matches "TokenExpired"`
`JWT.failed`	Tüm JWT politikaları, hata durumunda aynı değişkeni ayarlar.	`JWT.failed = true`

Örnek hata yanıtı

JWT Politikası Hata Kodları

Hata giderme için en iyi uygulama, hatanın errorcode kısmını yakalamaktır tıklayın. Değişebileceği için faultstring içindeki metne güvenmeyin.

Örnek hata kuralı

    <FaultRules>
        <FaultRule name="JWT Policy Errors">
            <Step>
                <Name>JavaScript-1</Name>
                <Condition>(fault.name Matches "TokenExpired")</Condition>
            </Step>
            <Condition>JWT.failed=true</Condition>
        </FaultRule>
    </FaultRules>

XMLThreatProtection politikası

Çalışma zamanı hataları

Bu hatalar, politika yürütüldüğünde ortaya çıkabilir.

Hata kodu	HTTP durumu	Neden
`steps.xmlthreatprotection.ExecutionFailed`	500	XMLThreatProtection politikası birçok farklı türde ExecutionFailed hatası verebilir. Bu hataların çoğu, politikada belirlenen belirli bir eşik aşıldığında ortaya çıkar. Bu Hata türleri şunlardır: öğe adı uzunluğu alt öğe sayısı, düğüm derinliği, özellik sayısı, özellik adı uzunluğu, ve çok daha fazlası. Tam listeyi XMLThreatProtection politikası çalışma zamanı hatası sorunlarını giderme konusunda bulabilirsiniz.
`steps.xmlthreatprotection.InvalidXMLPayload`	500	Bu hata, XMLThreatProtection politikasının `<Source>` öğesi tarafından belirtilen giriş mesajı yükü geçerli bir XML dokümanı değilse ortaya çıkar.
`steps.xmlthreatprotection.SourceUnavailable`	500	Bu hata, ileti `<Source>` öğesinde belirtilen değişken aşağıdakilerden biri olabilir: Kapsam dışında (politikanın yürütüldüğü belirli akışta kullanılamaz) Şu geçerli değerlerden biri değil: `request`, `response` veya `message`
`steps.xmlthreatprotection.NonMessageVariable`	500	Bu hata, `<Source>` öğesi farklı bir değişkene ayarlanırsa şu türde değil: mesaj yazın.

Notlar:

Hata adı ExecutionFailed, varsayılan hata adıdır ve tespit edilen hatanın türü; ancak bu varsayılan değer kuruluş düzeyinde bir mülktür. Bu özellik ayarlandığında hata adı, orijinal hatası. Örneğin, "TextExceeded" veya "AttrValueExceeded" değerini alır. Aşağıdakiler için Kullanım Notları'na bakın: bolca fırsat sunuyor.
500 HTTP durumu varsayılandır; ancak HTTP Durumu, tüm URL'ler için akış hatalarını almak için bir istek oluşturun. Aşağıdakiler için Kullanım Notları'na bakın: bolca fırsat sunuyor.

Dağıtım hataları

Yok.

Hata değişkenleri

Bu değişkenler, çalışma zamanı hatası oluştuğunda ayarlanır. Daha fazla bilgi için Bilmeniz gerekenler hakkında daha fazla bilgi edinin.

Değişkenler	Konum	Örnek
`fault.name="fault_name"`	`fault_name`, yukarıdaki Çalışma zamanı hataları tablosunda listelendiği gibi hatanın adıdır. Hata adı, hata kodunun son kısmıdır.	`fault.name Matches "SourceUnavailable"`
`xmlattack.policy_name.failed`	`policy_name`, hataya neden olan politikanın kullanıcı tarafından belirtilen adıdır.	`xmlattack.XPT-SecureRequest.failed = true`

Örnek hata yanıtı

Not: Hata işleme için en iyi uygulama, Hata yanıtının errorcode bölümü. Yalnızca faultstring, çünkü değişebilir.

{
  "fault": {
    "faultstring": "XMLThreatProtection[XPT-SecureRequest]: Execution failed. reason: XMLThreatProtection[XTP-SecureRequest]: Exceeded object entry name length at line 2",
    "detail": {
      "errorcode": "steps.xmlthreatprotection.ExecutionFailed"
    }
  }
}

Örnek hata kuralı

<FaultRule name="XML Threat Protection Policy Faults">
    <Step>
        <Name>AM-CustomErrorResponse</Name>
        <Condition>(fault.name Matches "ExecutionFailed") </Condition>
    </Step>
    <Condition>(xmlattack.XPT-SecureRequest.failed = true) </Condition>
</FaultRule>

XMLtoJSON politikası

Çalışma zamanı hataları

Bu hatalar, politika yürütüldüğünde ortaya çıkabilir.

Hata kodu	HTTP durumu	Neden
`steps.xmltojson.ExecutionFailed`	500	Bu hata, giriş yükü (XML) boş olduğunda veya giriş XML'si geçersiz ya da bozuk olduğunda ortaya çıkar.
`steps.xmltojson.InCompatibleType`	500	Bu hata, `<Source>` öğesinde tanımlanan değişkenin türü ve `<OutputVariable>` öğesi aynı değil. Değişkenlerin türü, sistem tarafından `<Source>` öğesinin içinde bulunur ve `<OutputVariable>` öğesi eşleşir.
`steps.xmltojson.InvalidSourceType`	500	Bu hata, `<Source>` öğesini tanımlamak için kullanılan değişkenin türü geçersiz.Geçerli değişken türleri mesaj ve dizedir.
`steps.xmltojson.OutputVariableIsNotAvailable`	500	Bu hata, XML'in `<Source>` öğesinde belirtilen değişken JSON politikası dize türünde ve `<OutputVariable>` öğesi tanımlı değil. `<Source>` içinde tanımlanan değişken için `<OutputVariable>` öğesi zorunludur öğesi dize türünde.
`steps.xmltojson.SourceUnavailable`	500	Bu hata, ileti XML'den JSON'a politikasının `<Source>` öğesinde belirtilen değişken aşağıdakilerden biridir: Kapsam dışında (politikanın yürütüldüğü belirli akışta kullanılamaz) veya çözülemiyor (tanımlanmamış)

Dağıtım hataları

Bu politikayı içeren bir proxy dağıttığınızda bu hatalar oluşabilir.

Hata adı	Neden	Düzelt
`EitherOptionOrFormat`	`<Options>` veya `<Format>` öğelerinden biri değilse JSON Politikası'na bildirirseniz API proxy'sinin dağıtımı başarısız olur.
`UnknownFormat`	XML'den JSON'ye politikası içindeki `<Format>` öğesi bilinmiyorsa biçimi tanımlanırsa API proxy'sinin dağıtımı başarısız olur. Önceden tanımlanmış biçimler şunlardır: `xml.com`, `yahoo`, `google` ve `badgerFish`.

Hata değişkenleri

Bu değişkenler, çalışma zamanı hatası oluştuğunda ayarlanır. Daha fazla bilgi için Bilmeniz gerekenler hakkında daha fazla bilgi edinin.

Değişkenler	Konum	Örnek
`fault.name="fault_name"`	`fault_name`, yukarıdaki Çalışma zamanı hataları tablosunda listelendiği gibi hatanın adıdır. Hata adı, hata kodunun son kısmıdır.	`fault.name = "SourceUnavailable"`
`xmltojson.policy_name.failed`	`policy_name`, hataya neden olan politikanın kullanıcı tarafından belirtilen adıdır.	`xmltojson.XMLtoJSON-1.failed = true`

Örnek hata yanıtı

Not: Hata işleme için en iyi uygulama, Hata yanıtının errorcode bölümü. Yalnızca faultstring, çünkü değişebilir.

{
  "fault": {
    "faultstring": "XMLToJSON[XMLtoJSON-1]: Source xyz is not available",
    "detail": {
      "errorcode": "steps.xml2json.SourceUnavailable"
    }
  }
}

Örnek hata kuralı

<faultrule name="VariableOfNonMsgType"></faultrule><FaultRule name="XML to JSON Faults">
    <Step>
        <Name>AM-SourceUnavailableMessage</Name>
        <Condition>(fault.name Matches "SourceUnavailable") </Condition>
    </Step>
    <Step>
        <Name>AM-BadXML</Name>
        <Condition>(fault.name = "ExecutionFailed")</Condition>
    </Step>
    <Condition>(xmltojson.XMLtoJSON-1.failed = true) </Condition>
</FaultRule>

XSLTransform politikası

Çalışma zamanı hataları

Politika yürütüldüğünde bu hatalar ortaya çıkabilir.

Hata kodu	HTTP durumu	Neden	Düzelt
`steps.xsl.XSLSourceMessageNotAvailable`	500	Bu hata, XSL Dönüşümü politikasının `<Source>` öğesinde belirtilen mesaj veya dize değişkeni kapsam dışındaysa (politikanın yürütüldüğü belirli akışta kullanılamaz) ya da çözülemiyorsa (tanımlanmamışsa) ortaya çıkar.
`steps.xsl.XSLEvaluationFailed`	500	Bu hata, giriş XML yükü kullanılamıyorsa/bozuk biçimlendirilmişse veya XSLTransform politikası XSL dosyasında sağlanan dönüştürme kurallarına göre giriş XML dosyasını dönüştüremiyorsa ortaya çıkar. XSLTransform politikasının başarısız olmasının birçok farklı nedeni olabilir. Hata mesajındaki hatanın nedeni hakkında daha fazla bilgi sağlanır.

Dağıtım hataları

Bu hatalar, bu politikayı içeren bir proxy dağıttığınızda ortaya çıkabilir.

Hata adı	Neden	Düzelt
`XSLEmptyResourceUrl`	XSL Dönüşümü politikasındaki `<ResourceURL>` öğesi boşsa API proxy'sinin dağıtımı başarısız olur.
`XSLInvalidResourceType`	XSL Dönüşümü politikasının `<ResourceURL>` öğesinde belirtilen kaynak türü `xsl` türünde değilse API proxy'sinin dağıtımı başarısız olur.