تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

مرجع خطأ السياسة

يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. المعلومات

سياسة AccessControl

يصف هذا القسم رموز الأخطاء ورسائل الخطأ التي يتم عرضها ومتغيرات الأخطاء التي تضبطها Edge عندما تؤدي هذه السياسة إلى ظهور خطأ. هذه المعلومات مهمة لمعرفة ما إذا كنت تعمل على تطوير قواعد للأخطاء للتعامل معها. لمزيد من المعلومات، يمكنك الاطّلاع على المعلومات التي يجب معرفتها عن الأخطاء المتعلقة بالسياسات وأخطاء المعالجة.

أخطاء في وقت التشغيل

يمكن أن تحدث هذه الأخطاء عند تنفيذ السياسة.

رمز الخطأ	رموز حالة HTTP	السبب	إصلاح
`accesscontrol.IPDeniedAccess`	403	يتطابق عنوان IP للعميل أو عنوان IP الذي تم تمريره في طلب واجهة برمجة التطبيقات مع عنوان IP المحدّد في العنصر `<SourceAddress>` ضمن العنصر `<MatchRule>` ضمن سياسة التحكّم في الوصول، ويتم ضبط السمة `action` للعنصر `<MatchRule>` على `DENY`.

متغيرات الخطأ

ويتم ضبط هذه المتغيرات عند حدوث خطأ في وقت التشغيل. لمزيدٍ من المعلومات، اطّلِع على المتغيّرات الخاصة بأخطاء السياسة.

المتغيرات	المكان	مثال
`fault.name="fault_name"`	`fault_name` هو اسم الخطأ، كما هو موضَّح في جدول أخطاء وقت التشغيل أعلاه. اسم الخطأ هو الجزء الأخير من رمز الخطأ.	`fault.name Matches "IPDeniedAccess"`
`acl.policy_name.failed`	`policy_name` هو اسم السياسة التي حدّدها المستخدم التي أدت إلى حدوث الخطأ.	`acl.AC-AllowAccess.failed = true`

مثال على الاستجابة للخطأ

ملاحظة: لمعالجة الأخطاء، إنّ أفضل ممارسة هي تثبيت الجزء errorcode من الاستجابة للخطأ. لا تعتمد على النص في السمة faultstring لأنّه يمكن أن يتغيّر.

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

مثال لقاعدة خطأ

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

سياسة AccessEntity

للحصول على معلومات ذات صلة، يمكنك الاطّلاع على المعلومات التي يجب معرفتها عن الأخطاء المتعلقة بالسياسات وأخطاء المعالجة.

أخطاء في وقت التشغيل

بلا عُري

أخطاء النشر

اسم الخطأ	سلسلة الخطأ	رموز حالة HTTP	يحدث عند
`InvalidEntityType`	`Invalid type [entity_type] in ACCESSENTITYStepDefinition [policy_name]`	لا ينطبق	يجب أن يكون نوع الكيان المستخدَم من الأنواع المتوافقة.

سياسة AssignMessage

أخطاء في وقت التشغيل

يمكن أن تحدث هذه الأخطاء عند تنفيذ السياسة.

رمز الخطأ رموز حالة HTTP السبب إصلاح

steps.assignmessage.SetVariableFailed 500 تعذّر على السياسة ضبط متغيّر. راجِع سلسلة الخطأ لمعرفة اسم المتغيّر الذي لم يتم حله.

رمز الخطأ	رموز حالة HTTP	السبب
`steps.assignmessage.SetVariableFailed`	500	تعذّر على السياسة ضبط متغيّر. راجِع سلسلة الخطأ لمعرفة اسم المتغيّر الذي لم يتم حله.
`steps.assignmessage.VariableOfNonMsgType`	500	يحدث هذا الخطأ إذا تم ضبط السمة `source` في العنصر `<Copy>` على متغيّر ليس من نوع message. تمثل متغيرات نوع الرسالة طلبات واستجابات HTTP كاملة. وتكون متغيّرات تدفق Edge المدمَجة `request` و`response` و`message` من نوع الرسالة. لمزيد من المعلومات عن متغيّرات الرسائل، اطّلِع على مرجع المتغيّرات.
`steps.assignmessage.UnresolvedVariable`	500	يحدث هذا الخطأ إذا كان أحد المتغيّرات المحددة في سياسة "تعيين الرسالة": خارج النطاق (غير متاحة في المسار المحدّد الذي يتم فيه تنفيذ السياسة) أو لا يمكن حلها (غير محددة)

steps.assignmessage.VariableOfNonMsgType

500

يحدث هذا الخطأ إذا تم ضبط السمة source في العنصر <Copy> على متغيّر ليس من نوع message.

تمثل متغيرات نوع الرسالة طلبات واستجابات HTTP كاملة. وتكون متغيّرات تدفق Edge المدمَجة request وresponse وmessage من نوع الرسالة. لمزيد من المعلومات عن متغيّرات الرسائل، اطّلِع على مرجع المتغيّرات.

steps.assignmessage.UnresolvedVariable

500

يحدث هذا الخطأ إذا كان أحد المتغيّرات المحددة في سياسة "تعيين الرسالة":

خارج النطاق (غير متاحة في المسار المحدّد الذي يتم فيه تنفيذ السياسة)
لا يمكن حلها (غير محددة)

أخطاء النشر

يمكن أن تحدث هذه الأخطاء عند نشر خادم وكيل يحتوي على هذه السياسة.

اسم الخطأ	السبب	إصلاح
`InvalidIndex`	إذا كان الفهرس المحدَّد في العنصرَين `<Copy>` و/أو `<Remove>` في سياسة تخصيص الرسالة هو 0 أو رقمًا سالبَين، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات.
`InvalidVariableName`	إذا كان العنصر الفرعي `<Name>` فارغًا أو غير محدَّد في العنصر `<AssignVariable>`، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات بسبب عدم توفّر اسم متغيّر صالح يتم تخصيص قيمة له. يجب إدخال اسم متغيّر صالح.
`InvalidPayload`	الحمولة المحددة في السياسة غير صالحة.

متغيرات الخطأ

ويتم ضبط هذه المتغيّرات عندما تؤدي هذه السياسة إلى ظهور خطأ في وقت التشغيل. لمزيد من المعلومات، اطّلِع على المعلومات التي تحتاج إلى معرفتها عن الأخطاء المتعلقة بالسياسات.

المتغيرات	المكان	مثال
`fault.name="fault_name"`	`fault_name` هو اسم الخطأ، كما هو موضَّح في جدول أخطاء وقت التشغيل أعلاه. اسم الخطأ هو الجزء الأخير من رمز الخطأ.	`fault.name Matches "UnresolvedVariable"`
`assignmessage.policy_name.failed`	`policy_name` هو اسم السياسة التي حدّدها المستخدم التي أدت إلى حدوث الخطأ.	`assignmessage.AM-SetResponse.failed = true`

مثال على الردّ على الخطأ

ملاحظة: بالنسبة إلى معالجة الأخطاء، أفضل الممارسات هي إدراج الجزء errorcode من استجابة الخطأ. لا تعتمد على النص في السمة faultstring لأنّه قد يتغير.

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

مثال لقاعدة خطأ

<faultrule name="VariableOfNonMsgType"></faultrule><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>

سياسة المصادقة الأساسية

يصف هذا القسم رموز الأخطاء ورسائل الخطأ التي يتم عرضها ومتغيرات الأخطاء التي تضبطها Edge عندما تؤدي هذه السياسة إلى ظهور خطأ. هذه المعلومات مهمة لمعرفة ما إذا كنت تعمل على تطوير قواعد للأخطاء للتعامل مع الأخطاء. لمزيد من المعلومات، يمكنك الاطّلاع على المعلومات التي يجب معرفتها عن الأخطاء المتعلقة بالسياسات وأخطاء المعالجة.

أخطاء في وقت التشغيل

يمكن أن تحدث هذه الأخطاء عند تنفيذ السياسة.

رمز الخطأ	رموز حالة HTTP	السبب	إصلاح
`steps.basicauthentication.InvalidBasicAuthenticationSource`	500	في عملية فك الترميز عندما لا تحتوي سلسلة Base64 المشفرة الواردة على قيمة صالحة أو يكون العنوان مكتوبًا بصيغة غير صحيحة (على سبيل المثال، لا تبدأ كلمة Base64 بكلمة أساسية).
`steps.basicauthentication.UnresolvedVariable`	500	لا توجد متغيرات المصدر المطلوبة لفك الترميز أو التشفير. ولا يمكن أن يحدث هذا الخطأ إلّا إذا كانت قيمة `IgnoreUnresolvedVariables` خطأ.

أخطاء النشر

يمكن أن تحدث هذه الأخطاء عند نشر خادم وكيل يحتوي على هذه السياسة.

اسم الخطأ	يحدث عند	إصلاح
`UserNameRequired`	يجب أن يتوفّر العنصر `<User>` للعملية المُسمّاة.
`PasswordRequired`	يجب أن يتوفّر العنصر `<Password>` للعملية المُسمّاة.
`AssignToRequired`	يجب أن يتوفّر العنصر `<AssignTo>` للعملية المُسمّاة.
`SourceRequired`	يجب أن يتوفّر العنصر `<Source>` للعملية المُسمّاة.

متغيرات الخطأ

ويتم ضبط هذه المتغيرات عند حدوث خطأ في وقت التشغيل. لمزيد من المعلومات، يمكنك الاطّلاع على المعلومات التي يجب معرفتها عن الأخطاء المتعلقة بالسياسات.

المتغيرات	المكان	مثال
`fault.name="fault_name"`	`fault_name` هو اسم الخطأ، كما هو موضَّح في جدول أخطاء وقت التشغيل أعلاه. اسم الخطأ هو الجزء الأخير من رمز الخطأ.	`fault.name Matches "UnresolvedVariable"`
`BasicAuthentication.policy_name.failed`	`policy_name` هو اسم السياسة التي حدّدها المستخدم التي أدت إلى حدوث الخطأ.	`BasicAuthentication.BA-Authenticate.failed = true`

مثال على الردّ على الخطأ

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

مثال لقاعدة خطأ

<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

يصف هذا القسم رموز الأخطاء ورسائل الخطأ التي يتم عرضها ومتغيرات الأخطاء التي تضبطها Edge عندما تؤدي هذه السياسة إلى ظهور خطأ. هذه المعلومات مهمة لمعرفة ما إذا كنت تعمل على تطوير قواعد للأخطاء للتعامل مع الأخطاء. لمزيد من المعلومات، يمكنك الاطّلاع على المعلومات التي يجب معرفتها عن الأخطاء المتعلقة بالسياسات وأخطاء المعالجة.

أخطاء في وقت التشغيل

يمكن أن تحدث هذه الأخطاء عند تنفيذ السياسة.

رمز الخطأ رموز حالة HTTP يحدث عند

رمز الخطأ	رموز حالة HTTP	يحدث عند
`policies.concurrentratelimit.ConcurrentRatelimtViolation`	503	تم تجاوز الاتصال ConcurrentRatelimit. حد الاتصال : {0} ملاحظة: إنّ رمز الخطأ الظاهر على اليمين هو رمز صحيح، إلا أنّه يحتوي على خطأ إملائي ("limt"). احرص على استخدام الرمز كما هو موضّح هنا تمامًا عند إنشاء قواعد خطأ لرصد هذا الخطأ.

policies.concurrentratelimit.ConcurrentRatelimtViolation

503

تم تجاوز الاتصال ConcurrentRatelimit. حد الاتصال : {0}

ملاحظة: إنّ رمز الخطأ الظاهر على اليمين هو رمز صحيح، إلا أنّه يحتوي على خطأ إملائي ("limt"). احرص على استخدام الرمز كما هو موضّح هنا تمامًا عند إنشاء قواعد خطأ لرصد هذا الخطأ.

أخطاء النشر

اسم الخطأ	يحدث عند
`InvalidCountValue`	تم تحديد قيمة عدد غير صالحة لـ ConcurrentRatelimit.
`ConcurrentRatelimitStepAttachment\ NotAllowedAtProxyEndpoint`	مرفق سياسة الحد الأقصى لمعدّل الزحف المتزامن {0} غير مسموح به في مسارات الطلبات/الاستجابة/الأخطاء في الخادم الوكيل. يجب وضع هذه السياسة على نقطة النهاية المستهدفة.
`ConcurrentRatelimitStepAttachment\ MissingAtTargetEndpoint`	مرفق سياسة الحدّ الأقصى المتزامن {0} غير متوفّر في مسارات الطلب/الاستجابة/الأخطاء المستهدفة. يجب وضع هذه السياسة في التدفق المسبق للطلب المستهدف وتدفق النشر للاستجابة المستهدفة وDefaultFaultRule.
`InvalidTTLForMessageTimeOut`	تم تحديد قيمة ttl غير صالحة لـ ConcurrentRatelimit لمهلة الرسالة. ويجب أن يكون عددًا صحيحًا موجبًا.

متغيرات الخطأ

ويتم ضبط هذه المتغيّرات عندما تؤدي هذه السياسة إلى ظهور خطأ. لمزيد من المعلومات، يمكنك الاطّلاع على المعلومات التي يجب معرفتها عن الأخطاء المتعلقة بالسياسات.

المتغيرات	المكان	مثال
`fault.name="fault_name"`	`fault_name` هو اسم الخطأ، كما هو موضَّح في جدول أخطاء وقت التشغيل أعلاه. اسم الخطأ هو الجزء الأخير من رمز الخطأ.	`fault.name Matches "ConcurrentRatelimtViolation"` ملاحظة: إنّ رمز الخطأ الموضّح في المثال صحيح، على الرغم من أنّه يحتوي على خطأ إملائي ("limt"). يُرجى التأكّد من استخدام الرمز كما هو موضّح هنا تمامًا عند إنشاء قواعد خطأ لرصد هذا الخطأ.
`concurrentratelimit.policy_name.failed`	`policy_name` هو اسم السياسة التي حدّدها المستخدم التي أدت إلى حدوث الخطأ.	`concurrentratelimit.CRL-RateLimitPolicy.failed = true`

مثال على الردّ على الخطأ

وفي حال تجاوز الحدّ الأقصى لمعدّل الزحف، ستعرض السياسة حالة HTTP 503 فقط للعميل.

مثال لقاعدة خطأ

<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

أخطاء في وقت التشغيل

يمكن أن تحدث هذه الأخطاء عند تنفيذ السياسة.

رمز الخطأ	رموز حالة HTTP	يحدث عند
`steps.jws.FailedToDecode`	401	تعذَّر على السياسة فك ترميز JWS. من المحتمل أن يكون JWS تالفًا.
`steps.jws.FailedToResolveVariable`	401	يحدث ذلك عندما لا يكون متغيّر التدفق المحدّد في العنصر `<Source>` ضِمن السياسة متوفّرًا.
`steps.jws.InvalidClaim`	401	بسبب عدم تطابق مطالبة أو مطالبة، أو عدم تطابق العنوان أو العنوان.
`steps.jws.InvalidJsonFormat`	401	تم العثور على تنسيق JSON غير صالح في عنوان JWS.
`steps.jws.InvalidJws`	401	يحدث هذا الخطأ عند تعذُّر إثبات صحة توقيع JWS.
`steps.jws.InvalidPayload`	401	حمولة JWS غير صالحة.
`steps.jws.InvalidSignature`	401	تم حذف `<DetachedContent>` ولديها حمولة بيانات منفصلة في JWS.
`steps.jws.MissingPayload`	401	حمولة JWS مفقودة.
`steps.jws.NoAlgorithmFoundInHeader`	401	يحدث عندما تغفل JWS عنوان الخوارزمية.
`steps.jws.UnknownException`	401	حدث استثناء غير معروف.

أخطاء النشر

يمكن أن تحدث هذه الأخطاء عند نشر خادم وكيل يحتوي على هذه السياسة.

اسم الخطأ يحدث عند

InvalidAlgorithm القيم الصالحة الوحيدة هي: RS256 وRS384 وRS512 وPS256 وPS384 وPS512 وES256 وES384 وES512 وHS256 وHS384 وHS512.

اسم الخطأ	يحدث عند
`InvalidAlgorithm`	القيم الصالحة الوحيدة هي: 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`	أخطاء النشر المحتملة الأخرى

EmptyElementForKeyConfiguration

FailedToResolveVariable

InvalidConfigurationForActionAndAlgorithmFamily

InvalidConfigurationForVerify

InvalidEmptyElement

InvalidFamiliesForAlgorithm

InvalidKeyConfiguration

InvalidNameForAdditionalClaim

InvalidNameForAdditionalHeader

InvalidPublicKeyId

InvalidPublicKeyValue

InvalidSecretInConfig

InvalidTypeForAdditionalClaim

InvalidTypeForAdditionalHeader

InvalidValueForElement

InvalidValueOfArrayAttribute

InvalidVariableNameForSecret

MissingConfigurationElement

MissingElementForKeyConfiguration

MissingNameForAdditionalClaim

MissingNameForAdditionalHeader

أخطاء النشر المحتملة الأخرى

متغيرات الخطأ

المتغيرات	المكان	مثال
`fault.name="fault_name"`	`fault_name` هو اسم الخطأ، كما هو موضَّح في جدول أخطاء وقت التشغيل أعلاه. اسم الخطأ هو الجزء الأخير من رمز الخطأ.	`fault.name Matches "TokenExpired"`
`JWS.failed`	تحدِّد جميع سياسات JWS المتغيّر نفسه في حال تعذُّر التثبيت.	`jws.JWS-Policy.failed = true`

مثال على الردّ على الخطأ

بالنسبة إلى معالجة الأخطاء، أفضل ممارسة هي إدراج الجزء errorcode من استجابة الخطأ. لا تعتمد على النص في faultstring لأنه قد يتغير.

مثال لقاعدة خطأ

<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

أخطاء في وقت التشغيل

يمكن أن تحدث هذه الأخطاء عند تنفيذ السياسة.

رمز الخطأ	رموز حالة HTTP	السبب
`steps.jwt.FailedToDecode`	401	يحدث ذلك عندما يتعذّر على السياسة فك ترميز JWT. قد يكون JWT مكتوبًا بصيغة غير صحيحة أو غير صالح أو غير قابل للفصل.
`steps.jwt.FailedToResolveVariable`	401	يحدث ذلك عندما لا يكون متغيّر التدفق المحدّد في العنصر `<Source>` ضِمن السياسة متوفّرًا.
`steps.jwt.InvalidToken`	401	يحدث ذلك عندما يكون متغيّر التدفق المحدّد في العنصر `<Source>` ضمن السياسة خارج النطاق أو يتعذّر حلّه.

أخطاء النشر

يمكن أن تحدث هذه الأخطاء عند نشر خادم وكيل يحتوي على هذه السياسة.

اسم الخطأ	السبب	إصلاح
`InvalidEmptyElement`	يحدث ذلك عندما لا يتم تحديد متغيّر التدفق الذي يحتوي على JWT المطلوب فك ترميزه في العنصر `<Source>` للسياسة.

متغيرات الخطأ

المتغيرات	المكان	مثال
`fault.name="fault_name"`	`fault_name` هو اسم الخطأ، كما هو موضَّح في جدول أخطاء وقت التشغيل أعلاه. اسم الخطأ هو الجزء الأخير من رمز الخطأ.	`fault.name Matches "TokenExpired"`
`JWT.failed`	تحدِّد جميع سياسات JWT المتغيّر نفسه في حال تعذُّر التثبيت.	`JWT.failed = true`

مثال على الردّ على الخطأ

رموز الخطأ في سياسة JWT

مثال لقاعدة خطأ

    <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>

سياسة متغيرات استخراج المتغيرات

أخطاء في وقت التشغيل

يمكن أن تحدث هذه الأخطاء عند تنفيذ السياسة.

رمز الخطأ	رموز حالة HTTP	السبب
`steps.extractvariables.ExecutionFailed`	500	يحدث هذا الخطأ في الحالات التالية: حمولة الإدخال (JSON وXML) فارغة. الإدخال (JSON أو XML أو غير ذلك) الذي تم تمريره إلى السياسة غير صالح أو مكتوب بشكلٍ غير صحيح.
`steps.extractvariables.ImmutableVariable`	500	المتغيّر المُستخدَم في السياسة غير قابل للتغيير. تعذَّر على السياسة ضبط هذا المتغيّر.
`steps.extractvariables.InvalidJSONPath`	500	يحدث هذا الخطأ عند استخدام مسار JSON غير صالح في العنصر `JSONPath` ضمن السياسة. على سبيل المثال، إذا لم تكن حمولة JSON تحتوي على الكائن `Name`، ولكن حدّدت `Name` باعتباره المسار في السياسة، سيحدث هذا الخطأ.
`steps.extractvariables.JsonPathParsingFailure`	500	يحدث هذا الخطأ عندما يتعذّر على السياسة تحليل مسار JSON واستخراج البيانات من متغيّر التدفق المحدّد في عنصر `Source`. ويحدث ذلك عادةً إذا لم يكن متغيّر التدفق المحدّد في العنصر `Source` متوفّرًا في التدفق الحالي.
`steps.extractvariables.SetVariableFailed`	500	يحدث هذا الخطأ إذا تعذَّر على السياسة ضبط القيمة على متغيّر. يحدث الخطأ بشكل عام إذا حاولت تخصيص قيم لمتغيّرات متعددة تبدأ أسماؤها بالكلمات نفسها بتنسيق مدمج مفصول بنقاط.
`steps.extractvariables.SourceMessageNotAvailable`	500	يحدث هذا الخطأ إذا كان متغيّر message المحدّد في عنصر `Source` ضمن السياسة : خارج النطاق (غير متاح في المسار المحدّد الذي يتم فيه تنفيذ السياسة) أو لا يمكن حلها (غير محددة)
`steps.extractvariables.UnableToCast`	500	يحدث هذا الخطأ إذا لم تتمكّن السياسة من تحويل القيمة المستخلَصة إلى متغيّر. ويحدث ذلك عادةً إذا حاولت ضبط قيمة أحد أنواع البيانات على متغيّر من نوع آخر.

أخطاء النشر

يمكن أن تحدث هذه الأخطاء عند نشر خادم وكيل يحتوي على هذه السياسة.

اسم الخطأ	السبب	إصلاح
`NothingToExtract`	في حال عدم احتواء السياسة على أي من العناصر `URIPath` أو `QueryParam` أو `Header` أو `FormParam` أو `XMLPayload` أو `JSONPayload`، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات لأنّه لا تتوفّر أي بيانات لاستخراجها.
`NONEmptyPrefixMappedToEmptyURI`	يحدث هذا الخطأ إذا كانت السياسة مرتبطة ببادئة محدّدة في العنصر `Namespace` ضمن العنصر `XMLPayload`، ولكن لم يتم تحديد معرّف موارد منتظم (URI).
`DuplicatePrefix`	يحدث هذا الخطأ إذا كانت السياسة لها البادئة نفسها التي تم تحديدها أكثر من مرة في العنصر `Namespace` ضمن العنصر `XMLPayload`.
`NoXPathsToEvaluate`	إذا كانت السياسة لا تتضمن العنصر `XPath` داخل العنصر `XMLPayload`، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات وسيظهر هذا الخطأ. إذا أردت استخراج متغيّرات من حمولة XML، يجب تحديد العنصر الفرعي `XPath`.
`EmptyXPathExpression`	إذا كانت السياسة تحتوي على تعبير `XPath` فارغ داخل العنصر `XMLPayload`، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات.
`NoJSONPathsToEvaluate`	إذا كانت السياسة لا تتضمن العنصر `JSONPath` داخل العنصر `JSONPayload`، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات وسيظهر هذا الخطأ.
`EmptyJSONPathExpression`	إذا كانت السياسة تحتوي على تعبير `XPath` فارغ داخل العنصر `XMLPayload`، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات.
`MissingName`	سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات إذا كانت السياسة لا تتضمن السمة `name` في أي من عناصر السياسة، مثل `QueryParam` أو `Header` أو `FormParam` أو `Variable`.
`PatternWithoutVariable`	إذا لم تكن السياسة تتضمّن متغيّرًا محدّدًا داخل العنصر `Pattern`، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات. يتطلّب العنصر `Pattern` اسم المتغيّر الذي سيتم تخزين البيانات المستخرجة فيه.
`CannotBeConvertedToNodeset`	إذا كانت السياسة تحتوي على تعبير `XPath` يتم فيه تحديد النوع `Variable` على أنّه nodeset، ولكن لا يمكن تحويل التعبير إلى مجموعة العُقد، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات.
`JSONPathCompilationFailed`	تعذّر على السياسة تجميع مسار JSON محدّد.
`InstantiationFailed`	تعذّر إنشاء مثيل للسياسة.
`XPathCompilationFailed`	إذا لم تكن البادئة أو القيمة المستخدَمة في العنصر `XPath` جزءًا من أي من مساحات الاسم التي تم الإعلان عنها في السياسة، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات.
`InvalidPattern`	إذا كان تعريف العنصر `Pattern` غير صالح في أيٍّ من العناصر، مثل `URIPath` أو `QueryParam` أو `Header` أو `FormParam` أو `XMLPayload` أو `JSONPayload` في السياسة، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات. يُعتبَر العنصر `Pattern` غير صالح إذا لم يتضمّن متغيّرًا. لمزيد من المعلومات عن مطابقة الأنماط، راجِع المقالة لمحة عن المطابقة وإنشاء المتغيّر.

متغيرات الخطأ

المتغيرات	المكان	مثال
`fault.name="fault_name"`	`fault_name` هو اسم الخطأ، كما هو موضَّح في جدول أخطاء وقت التشغيل أعلاه. اسم الخطأ هو الجزء الأخير من رمز الخطأ.	`fault.name = "SourceMessageNotAvailable"`
`extractvariables.policy_name.failed`	`policy_name` هو اسم السياسة التي حدّدها المستخدم التي أدت إلى حدوث الخطأ.	`extractvariables.EV-ParseJsonResponse.failed = true`

مثال على الردّ على الخطأ

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

مثال لقاعدة خطأ

<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

يصف هذا القسم رموز الأخطاء ورسائل الخطأ التي يتم عرضها ومتغيرات الأخطاء التي تضبطها Edge عندما تؤدي هذه السياسة إلى ظهور خطأ. هذه المعلومات مهمة لمعرفة ما إذا كنت تعمل على تطوير قواعد خطأ للتعامل مع الأخطاء. لمزيد من المعلومات، يمكنك الاطّلاع على المعلومات التي يجب معرفتها عن أخطاء السياسة وأخطاء المعالجة.

أخطاء في وقت التشغيل

يمكن أن تحدث هذه الأخطاء عند تنفيذ السياسة.

رمز الخطأ	رموز حالة HTTP	يحدث عند
`steps.jws.GenerationFailed`	401	تعذَّر على السياسة إنشاء JWS.
`steps.jws.InsufficientKeyLength`	401	بالنسبة إلى مفتاح أقل من 32 بايت لخوارزمية HS256
`steps.jws.InvalidClaim`	401	بسبب عدم تطابق مطالبة أو مطالبة، أو عدم تطابق العنوان أو العنوان.
`steps.jws.InvalidCurve`	401	المنحنى المحدد بالمفتاح غير صالح لخوارزمية المنحنى البيضاوي.
`steps.jws.InvalidJsonFormat`	401	تم العثور على تنسيق JSON غير صالح في عنوان JWS.
`steps.jws.InvalidPayload`	401	حمولة JWS غير صالحة.
`steps.jws.InvalidSignature`	401	تم حذف `<DetachedContent>` ولديها حمولة بيانات منفصلة في JWS.
`steps.jws.KeyIdMissing`	401	تستخدم سياسة "التحقّق" رمز JWKS كمصدر للمفاتيح العامة، إلا أنّ سياسة JWS الموقَّعة لا تتضمّن السمة `kid` في العنوان.
`steps.jws.KeyParsingFailed`	401	تعذّر تحليل المفتاح العام من المعلومات الأساسية المحددة.
`steps.jws.MissingPayload`	401	حمولة JWS مفقودة.
`steps.jws.NoAlgorithmFoundInHeader`	401	يحدث عندما تغفل JWS عنوان الخوارزمية.
`steps.jws.SigningFailed`	401	في CREATEJWS لمفتاح أقل من الحد الأدنى للحجم لخوارزميات HS384 أو HS512
`steps.jws.UnknownException`	401	حدث استثناء غير معروف.
`steps.jws.WrongKeyType`	401	تم تحديد نوع خاطئ للمفتاح. على سبيل المثال، إذا حدّدت مفتاح RSA لخوارزمية "منحنى بيضاوي" أو مفتاح منحنى لخوارزمية RSA.

أخطاء النشر

يمكن أن تحدث هذه الأخطاء عند نشر خادم وكيل يحتوي على هذه السياسة.

اسم الخطأ يحدث عند

InvalidAlgorithm القيم الصالحة الوحيدة هي: RS256 وRS384 وRS512 وPS256 وPS384 وPS512 وES256 وES384 وES512 وHS256 وHS384 وHS512.

اسم الخطأ	يحدث عند
`InvalidAlgorithm`	القيم الصالحة الوحيدة هي: 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`	أخطاء النشر المحتملة الأخرى

EmptyElementForKeyConfiguration

FailedToResolveVariable

InvalidConfigurationForActionAndAlgorithmFamily

InvalidConfigurationForVerify

InvalidEmptyElement

InvalidFamiliesForAlgorithm

InvalidKeyConfiguration

InvalidNameForAdditionalClaim

InvalidNameForAdditionalHeader

InvalidPublicKeyId

InvalidPublicKeyValue

InvalidSecretInConfig

InvalidTypeForAdditionalClaim

InvalidTypeForAdditionalHeader

InvalidValueForElement

InvalidValueOfArrayAttribute

InvalidVariableNameForSecret

MissingConfigurationElement

MissingElementForKeyConfiguration

MissingNameForAdditionalClaim

MissingNameForAdditionalHeader

أخطاء النشر المحتملة الأخرى

متغيرات الخطأ

المتغيرات	المكان	مثال
`fault.name="fault_name"`	`fault_name` هو اسم الخطأ، كما هو موضَّح في جدول أخطاء وقت التشغيل أعلاه. اسم الخطأ هو الجزء الأخير من رمز الخطأ.	`fault.name Matches "TokenExpired"`
`JWS.failed`	تحدِّد جميع سياسات JWS المتغيّر نفسه في حال تعذُّر التثبيت.	`jws.JWS-Policy.failed = true`

مثال على الردّ على الخطأ

مثال لقاعدة خطأ

<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>

سياسة CREATEJWT

أخطاء في وقت التشغيل

يمكن أن تحدث هذه الأخطاء عند تنفيذ السياسة.

رمز الخطأ	رموز حالة HTTP	يحدث عند
`steps.jwt.AlgorithmInTokenNotPresentInConfiguration`	401	يحدث ذلك عندما تتضمّن سياسة إثبات الهوية خوارزميات متعدّدة.
`steps.jwt.AlgorithmMismatch`	401	الخوارزمية المحدّدة في سياسة الإنشاء لا تتطابق مع الخوارزمية المتوقعة في سياسة إثبات الملكية. يجب أن تتطابق الخوارزميات المحدّدة.
`steps.jwt.FailedToDecode`	401	تعذَّر على السياسة فك ترميز JWT. من المحتمل أن يكون JWT تالفًا.
`steps.jwt.GenerationFailed`	401	تعذَّر على السياسة إنشاء رمز JWT.
`steps.jwt.InsufficientKeyLength`	401	بالنسبة إلى مفتاح أقل من 32 بايت لخوارزمية HS256، وأقل من 48 بايت لخوارزمية HS386، وأقل من 64 بايت لخوارزمية HS512.
`steps.jwt.InvalidClaim`	401	بسبب عدم تطابق مطالبة أو مطالبة، أو عدم تطابق العنوان أو العنوان.
`steps.jwt.InvalidCurve`	401	المنحنى المحدد بالمفتاح غير صالح لخوارزمية المنحنى البيضاوي.
`steps.jwt.InvalidJsonFormat`	401	تم العثور على تنسيق JSON غير صالح في الرأس أو الحمولة.
`steps.jwt.InvalidToken`	401	يحدث هذا الخطأ عند تعذُّر التحقُّق من توقيع JWT.
`steps.jwt.JwtAudienceMismatch`	401	تعذّرت المطالبة بالجمهور عند إثبات صحة الرمز المميّز.
`steps.jwt.JwtIssuerMismatch`	401	تعذّرت المطالبة من جهة الإصدار بإثبات ملكية الرمز المميّز.
`steps.jwt.JwtSubjectMismatch`	401	تعذّرت المطالبة بالموضوع عند إثبات ملكية الرمز المميّز.
`steps.jwt.KeyIdMissing`	401	تستخدم سياسة "التحقّق" رمز JWKS كمصدر للمفاتيح العامة، ولكنّ سياسة JWT الموقَّعة لا تتضمّن السمة `kid` في العنوان.
`steps.jwt.KeyParsingFailed`	401	تعذّر تحليل المفتاح العام من المعلومات الأساسية المحددة.
`steps.jwt.NoAlgorithmFoundInHeader`	401	يحدث عندما لا يحتوي JWT على عنوان خوارزمية.
`steps.jwt.NoMatchingPublicKey`	401	تستخدم سياسة "التحقّق" مفتاح JWKS كمصدر للمفاتيح العامة، ولكن لا يتم إدراج `kid` في JWT الموقَّع في JWKS.
`steps.jwt.SigningFailed`	401	في CREATEJWT لمفتاح أقل من الحد الأدنى للحجم لخوارزميات HS384 أو HS512
`steps.jwt.TokenExpired`	401	تحاول السياسة التحقّق من رمز مميّز منتهي الصلاحية.
`steps.jwt.TokenNotYetValid`	401	الرمز المميز غير صالح بعد.
`steps.jwt.UnhandledCriticalHeader`	401	إنّ العنوان الذي عثرت عليه سياسة "التحقق من JWT" ضمن عنوان `crit` غير مدرَج في `KnownHeaders`.
`steps.jwt.UnknownException`	401	حدث استثناء غير معروف.
`steps.jwt.WrongKeyType`	401	تم تحديد نوع خاطئ للمفتاح. على سبيل المثال، إذا حدّدت مفتاح RSA لخوارزمية "منحنى بيضاوي" أو مفتاح منحنى لخوارزمية RSA.

أخطاء النشر

يمكن أن تحدث هذه الأخطاء عند نشر خادم وكيل يحتوي على هذه السياسة.

اسم الخطأ	السبب	إصلاح
`InvalidNameForAdditionalClaim`	ستتعذّر عملية النشر إذا كانت المطالبة المستخدَمة في العنصر الفرعي `<Claim>` في العنصر `<AdditionalClaims>` هي أحد الأسماء المسجّلة التالية: `kid` أو `iss` أو `sub` أو `aud` أو `iat` أو `exp` أو `nbf` أو `jti`.
`InvalidTypeForAdditionalClaim`	إذا كانت المطالبة المستخدَمة في العنصر الفرعي `<Claim>` في العنصر `<AdditionalClaims>` ليست من النوع `string` أو `number` أو `boolean` أو `map`، سيتعذّر النشر.
`MissingNameForAdditionalClaim`	إذا لم يتم تحديد اسم المطالبة في العنصر الفرعي `<Claim>` في العنصر `<AdditionalClaims>`، سيتعذّر النشر.
`InvalidNameForAdditionalHeader`	يحدث هذا الخطأ إذا كان اسم المطالبة المستخدَم في العنصر الفرعي `<Claim>` في العنصر `<AdditionalClaims>` هو `alg` أو `typ`.
`InvalidTypeForAdditionalHeader`	إذا كان نوع المطالبة المستخدَم في العنصر الفرعي `<Claim>` في العنصر `<AdditionalClaims>` ليس من النوع `string` أو `number` أو `boolean` أو `map`، سيتعذّر النشر.
`InvalidValueOfArrayAttribute`	يحدث هذا الخطأ عندما لا يتم ضبط قيمة سمة الصفيف في العنصر الفرعي `<Claim>` للعنصر `<AdditionalClaims>` على `true` أو `false`.
`InvalidConfigurationForActionAndAlgorithm`	إذا تم استخدام العنصر `<PrivateKey>` مع خوارزميات HS Family أو العنصر `<SecretKey>` مع خوارزميات RSA Family، سيتعذّر إجراء عملية النشر.
`InvalidValueForElement`	وإذا لم تكن القيمة المحدّدة في العنصر `<Algorithm>` قيمة مسموح بها، سيتعذّر إتمام عملية النشر.
`MissingConfigurationElement`	سيحدث هذا الخطأ إذا لم يتم استخدام العنصر `<PrivateKey>` مع خوارزميات مجموعة RSA أو إذا لم يتم استخدام العنصر `<SecretKey>` مع خوارزميات HS Family.
`InvalidKeyConfiguration`	إذا لم يتم تحديد العنصر الفرعي `<Value>` في العنصرَين `<PrivateKey>` أو `<SecretKey>`، سيتعذّر النشر.
`EmptyElementForKeyConfiguration`	إذا كانت سمة المرجع للعنصر الفرعي `<Value>` للعناصر `<PrivateKey>` أو `<SecretKey>` فارغة أو غير محدّدة، سيتعذّر إتمام عملية النشر.
`InvalidVariableNameForSecret`	يحدث هذا الخطأ إذا كان اسم متغيّر التدفق المحدّد في السمة ref للعنصر الفرعي `<Value>` للعنصر `<PrivateKey>` أو العنصر `<SecretKey>` لا يحتوي على البادئة الخاصة `(private.)`.
`InvalidSecretInConfig`	يحدث هذا الخطأ إذا كان العنصر الفرعي `<Value>` للعنصر `<PrivateKey>` أو `<SecretKey>` لا يحتوي على البادئة الخاصة `(private.)`.
`InvalidTimeFormat`	وإذا كانت القيمة المحدّدة في العنصر `<NotBefore>` لا تستخدم تنسيقًا متوافقًا، لن تنجح عملية النشر.

متغيرات الخطأ

المتغيرات	المكان	مثال
`fault.name="fault_name"`	`fault_name` هو اسم الخطأ، كما هو موضَّح في جدول أخطاء وقت التشغيل أعلاه. اسم الخطأ هو الجزء الأخير من رمز الخطأ.	`fault.name Matches "TokenExpired"`
`JWT.failed`	تحدِّد جميع سياسات JWT المتغيّر نفسه في حال تعذُّر التثبيت.	`JWT.failed = true`

مثال على الردّ على الخطأ

رموز الخطأ في سياسة JWT

مثال لقاعدة خطأ

    <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

أخطاء في وقت التشغيل

يمكن أن تحدث هذه الأخطاء عند تنفيذ السياسة.

رمز الخطأ	رموز حالة HTTP	السبب	إصلاح
`steps.javacallout.ExecutionError`	500	يحدث عندما يقدم رمز Java استثناءً أو يعرض قيمة فارغة أثناء تنفيذ سياسة JavaCallout.

أخطاء النشر

يمكن أن تحدث هذه الأخطاء عند تفعيل الخادم الوكيل الذي يحتوي على السياسة.

اسم الخطأ	سلسلة الخطأ	رموز حالة HTTP	يحدث عند
`ResourceDoesNotExist`	`Resource with name [name] and type [type] does not exist`	لا ينطبق	الملف المحدد في العنصر `<ResourceURL>` غير موجود.
`JavaCalloutInstantiationFailed`	`Failed to instantiate the JavaCallout Class [classname]`	لا ينطبق	ملف الفئة المحدّد في العنصر `<ClassName>` ليس في الوعاء.
`IncompatibleJavaVersion`	`Failed to load java class [classname] definition due to - [reason]`	لا ينطبق	الاطّلاع على سلسلة الخطأ راجِع أيضًا البرامج المتوافقة والإصدارات المتوافقة.
`JavaClassNotFoundInJavaResource`	`Failed to find the ClassName in java resource [jar_name] - [class_name]`	لا ينطبق	الاطّلاع على سلسلة الخطأ
`JavaClassDefinitionNotFound`	`Failed to load java class [class_name] definition due to - [reason]`	لا ينطبق	الاطّلاع على سلسلة الخطأ
`NoAppropriateConstructor`	`No appropriate constructor found in JavaCallout class [class_name]`	لا ينطبق	الاطّلاع على سلسلة الخطأ
`NoResourceForURL`	`Could not locate a resource with URL [string]`	لا ينطبق	الاطّلاع على سلسلة الخطأ

متغيرات الخطأ

المتغيرات	المكان	مثال
`fault.name="fault_name"`	`fault_name` هو اسم الخطأ، كما هو موضَّح في جدول أخطاء وقت التشغيل أعلاه. اسم الخطأ هو الجزء الأخير من رمز الخطأ.	`fault.name Matches "ExecutionError"`
`javacallout.policy_name.failed`	`policy_name` هو اسم السياسة التي حدّدها المستخدم التي أدت إلى حدوث الخطأ.	`javacallout.JC-GetUserData.failed = true`

مثال على الردّ على الخطأ

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

مثال لقاعدة خطأ

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

سياسة JavaScript

يصف هذا القسم رموز الأخطاء ورسائل الخطأ التي يتم عرضها ومتغيّرات الأخطاء التي تضبطها Edge عندما تؤدي هذه السياسة إلى ظهور خطأ. هذه المعلومات مهمة لمعرفة ما إذا كنت تعمل على تطوير قواعد للأخطاء للتعامل مع الأخطاء. لمزيد من المعلومات، يمكنك الاطّلاع على المعلومات التي يجب معرفتها عن الأخطاء المتعلقة بالسياسات وأخطاء المعالجة.

أخطاء في وقت التشغيل

يمكن أن تحدث هذه الأخطاء عند تنفيذ السياسة.

رمز الخطأ	رموز حالة HTTP	السبب	إصلاح
`steps.javascript.ScriptExecutionFailed`	500	يمكن أن تؤدي سياسة JavaScript إلى العديد من الأنواع المختلفة من أخطاء ScriptExecutionتعذّر. تشتمل أنواع الأخطاء الشائعة على RangeError وReferenceError وSyntaxError وTypeError وURIError.
`steps.javascript.ScriptExecutionFailedLineNumber`	500	حدث خطأ في رمز JavaScript. راجع سلسلة الخطأ للحصول على التفاصيل.	لا ينطبق
`steps.javascript.ScriptSecurityError`	500	حدث خطأ متعلق بالأمان عند تنفيذ JavaScript. راجِع سلسلة الخطأ للحصول على التفاصيل.	لا ينطبق

أخطاء النشر

يمكن أن تحدث هذه الأخطاء عند نشر خادم وكيل يحتوي على هذه السياسة.

اسم الخطأ	السبب	إصلاح
`InvalidResourceUrlFormat`	إذا كان تنسيق عنوان URL للمورد المحدّد في `<ResourceURL>` أو العنصر `<IncludeURL>` في سياسة JavaScript غير صالح، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات.
`InvalidResourceUrlReference`	وإذا كان العنصران `<ResourceURL>` أو `<IncludeURL>` يشيران إلى ملف JavaScript غير متوفّر، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات. يجب أن يكون ملف المصدر المشار إليه متوفرًا على مستوى الخادم الوكيل لواجهة برمجة التطبيقات أو البيئة أو مستوى المؤسسة.
`WrongResourceType`	يحدث هذا الخطأ أثناء النشر إذا كانت العناصر `<ResourceURL>` أو `<IncludeURL>` في سياسة JavaScript تشير إلى أي نوع موارد بخلاف jsc (ملف JavaScript).
`NoResourceURLOrSource`	قد يتعذّر نشر سياسة JavaScript مع ظهور هذا الخطأ إذا لم يتم تعريف العنصر `<ResourceURL>` أو إذا لم يتم تحديد عنوان URL للمورد داخل هذا العنصر. العنصر `<ResourceURL>` هو عنصر إجباري. أو تم تعريف العنصر `<IncludeURL>` بدون تحديد عنوان URL للمورد داخل هذا العنصر. إنّ العنصر `<IncludeURL>` اختياري، ولكن إذا تم تعريفه، يجب تحديد عنوان URL للمورد داخل العنصر `<IncludeURL>`.

متغيرات الخطأ

المتغيرات	المكان	مثال
`fault.name="fault_name"`	`fault_name` هو اسم الخطأ، كما هو موضَّح في جدول أخطاء وقت التشغيل أعلاه. اسم الخطأ هو الجزء الأخير من رمز الخطأ.	`fault.name Matches "ScriptExecutionFailed"`
`javascript.policy_name.failed`	`policy_name` هو اسم السياسة التي حدّدها المستخدم التي أدت إلى حدوث الخطأ.	`javascript.JavaScript-1.failed = true`

مثال على الردّ على الخطأ

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

مثال لقاعدة خطأ

<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

أخطاء في وقت التشغيل

يمكن أن تحدث هذه الأخطاء عند تنفيذ السياسة.

رمز الخطأ	رموز حالة HTTP	السبب
`steps.jsonthreatprotection.ExecutionFailed`	500	يمكن أن تؤدي سياسة JSONThreatProtection إلى عدّة أنواع مختلفة من أخطاء التنفيذ الناجح. تحدث معظم هذه الأخطاء عند تجاوز حدّ معيّن تم ضبطه في السياسة. تتضمّن أنواع الأخطاء التالية: طول اسم إدخال العنصر وعدد إدخالات العناصر وعدد عناصر المصفوفة وعمق الحاوية وطول قيمة سلسلة السلسلة. يحدث هذا الخطأ أيضًا عندما تحتوي الحمولة على كائن JSON غير صالح.
`steps.jsonthreatprotection.SourceUnavailable`	500	يحدث هذا الخطأ إذا كان متغيّر message المحدَّد في العنصر `<Source>` أيًا مما يلي: خارج النطاق (غير متاحة في المسار المحدّد الذي يتم فيه تنفيذ السياسة) القيمة ليست من القيم الصالحة `request` أو `response` أو `message`
`steps.jsonthreatprotection.NonMessageVariable`	500	يحدث هذا الخطأ عند ضبط العنصر `<Source>` على متغيّر ليس من نوع message.

أخطاء النشر

بلا عُري

متغيرات الخطأ

المتغيرات	المكان	مثال
`fault.name="fault_name"`	`fault_name` هو اسم الخطأ، كما هو موضَّح في جدول أخطاء وقت التشغيل أعلاه. اسم الخطأ هو الجزء الأخير من رمز الخطأ.	`fault.name Matches "SourceUnavailable"`
`jsonattack.policy_name.failed`	`policy_name` هو اسم السياسة التي حدّدها المستخدم التي أدت إلى حدوث الخطأ.	`jsonattack.JTP-SecureRequest.failed = true`

مثال على الردّ على الخطأ

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

مثال لقاعدة خطأ

<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 رموز الخطأ التالية:

سياسة JSONtoXML

أخطاء في وقت التشغيل

يمكن أن تحدث هذه الأخطاء عند تنفيذ السياسة.

رمز الخطأ	رموز حالة HTTP	السبب
`steps.jsontoxml.ExecutionFailed`	500	بيانات حمولة الإدخال (JSON) فارغة أو أنّ الإدخال (JSON) الذي تم تمريره إلى سياسة JSON إلى XML غير صالح أو مكتوب بصيغة غير صحيحة.
`steps.jsontoxml.InCompatibleTypes`	500	يحدث هذا الخطأ إذا كان نوع المتغيّر المحدّد في العنصر `<Source>` غير متطابق مع العنصر `<OutputVariable>`. ومن الضروري أن يتطابق نوع المتغيّرات المضمّنة في العنصر `<Source>` مع العنصر `<OutputVariable>`. النوعان الصالحان هما `message` و`string`.
`steps.jsontoxml.InvalidSourceType`	500	يحدث هذا الخطأ إذا كان نوع المتغيّر المُستخدَم لتحديد العنصر `<Source>` غير صالح. نوعَا المتغيّرات الصالحَين هما `message` و`string`.
`steps.jsontoxml.OutputVariableIsNotAvailable`	500	يحدث هذا الخطأ إذا كان المتغير المحدّد في العنصر `<Source>` من سياسة JSON إلى XML من نوع سلسلة ولم يتم تعريف العنصر `<OutputVariable>`. يكون العنصر `<OutputVariable>` إلزاميًا عندما يكون المتغيّر المحدّد في العنصر `<Source>` من نوع سلسلة.
`steps.jsontoxml.SourceUnavailable`	500	يحدث هذا الخطأ إذا كان متغيّر message المحدَّد في العنصر `<Source>` لسياسة JSON إلى XML: خارج النطاق (غير متاح في المسار المحدّد الذي يتم فيه تنفيذ السياسة) أو لا يمكن حلها (غير محددة)

أخطاء النشر

بلا عُري

متغيرات الخطأ

المتغيرات	المكان	مثال
`fault.name="fault_name"`	`fault_name` هو اسم الخطأ، كما هو موضَّح في جدول أخطاء وقت التشغيل أعلاه. اسم الخطأ هو الجزء الأخير من رمز الخطأ.	`fault.name Matches "SourceUnavailable"`
`jsontoxml.policy_name.failed`	`policy_name` هو اسم السياسة التي حدّدها المستخدم التي أدت إلى حدوث الخطأ.	`jsontoxml.JSON-to-XML-1.failed = true`

مثال على الردّ على الخطأ

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

مثال لقاعدة خطأ

<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

أخطاء في وقت التشغيل

يمكن أن تحدث هذه الأخطاء عند تنفيذ السياسة.

رمز الخطأ	رموز حالة HTTP	السبب	إصلاح
`steps.keyvaluemapoperations.SetVariableFailed`	500	يحدث هذا الخطأ إذا حاولت استرداد قيمة من ربط قيمة مفتاح مشفّرة وضبط القيمة على متغيّر لا يتضمّن اسمه البادئة `private`. إنّ البادئة المطلوبة لأغراض الأمان الأساسية أثناء تصحيح الأخطاء تخفي القيم المشفّرة من جلسات التتبّع وتصحيح الأخطاء في الخادم الوكيل لواجهة برمجة التطبيقات.
`steps.keyvaluemapoperations.UnsupportedOperationException`	500	يحدث هذا الخطأ إذا تم ضبط السمة `mapIdentifier` على سلسلة فارغة في "سياسة عمليات ربط القيمة الرئيسية".

أخطاء النشر

يمكن أن تحدث هذه الأخطاء عند نشر خادم وكيل يحتوي على هذه السياسة.

اسم الخطأ	السبب	إصلاح
`InvalidIndex`	إذا كانت السمة `index` المحدّدة في العنصر `<Get>` ضمن سياسة عمليات خريطة القيمة الرئيسية صفرًا أو رقمًا سالبًا، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات. يبدأ الفهرس من `1`، لذا يتم اعتبار أنّ الفهرس صفرًا أو عددًا صحيحًا سالبًا غير صالح.
`KeyIsMissing`	يحدث هذا الخطأ إذا كان العنصر `<Key>` غير متوفّر تمامًا أو إذا كان العنصر `<Parameter>` غير متوفّر داخل العنصر `<Key>` ضمن `<Entry>` الخاص بالعنصر `<InitialEntries>` في سياسة عمليات ربط القيم الرئيسية.
`ValueIsMissing`	يحدث هذا الخطأ إذا كان العنصر `<Value>` غير متوفّر أسفل العنصر `<Entry>` للعنصر `<InitialEntries>` ضِمن سياسة عمليات خريطة القيمة الرئيسية.

سياسة LDAP

تستخدم هذه السياسة رموز الخطأ التالية:

رمز الخطأ	الرسالة
`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.`

سياسة تسجيل الرسائل

أخطاء في وقت التشغيل

يمكن أن تحدث هذه الأخطاء عند تنفيذ السياسة.

رمز الخطأ	رموز حالة HTTP	السبب
`steps.messagelogging.StepDefinitionExecutionFailed`	500	الاطّلاع على سلسلة الخطأ

أخطاء النشر

يمكن أن تحدث هذه الأخطاء عند نشر خادم وكيل يحتوي على هذه السياسة.

اسم الخطأ	السبب	إصلاح
`InvalidProtocol`	يمكن أن يتعذّر نشر سياسة MessageLogging مع ظهور هذا الخطأ إذا كان البروتوكول المحدَّد ضمن العنصر `<Protocol>` غير صالح. البروتوكولات الصالحة هي TCP وUDP. لإرسال رسائل سجل النظام عبر TLS/SSL، لا يتم دعم سوى بروتوكول TCP.
`InvalidPort`	قد يتعذّر نشر سياسة MessageLogging مع ظهور هذا الخطأ إذا لم يتم تحديد رقم المنفذ داخل العنصر `<Port>` أو إذا كان غير صالح. يجب أن يكون رقم المنفذ عددًا صحيحًا أكبر من صفر.

متغيرات الخطأ

ملاحظة: تنجح مكالمات الخادم الوكيل عند تعذُّر التسجيل

هناك اختلاف بين أخطاء السياسة وأخطاء تسجيل الرسائل. تتم تعبئة متغيرات التدفق هنا فقط عند تعذُّر السياسة نفسها، وليس عند تعذُّر تسجيل الرسائل. بما أنّه تتم كتابة تسجيل الرسائل أولاً للتخزين المؤقت، سيستمر الخادم الوكيل لواجهة برمجة التطبيقات في التنفيذ الناجح حتى إذا تعذّر تسجيل الرسالة في النهاية (على سبيل المثال، في حال تعذّر الاتصال بموفِّر سجلّ النظام الخارجي). احرِص على التحقّق من سجلّاتك بانتظام للتأكّد من تسجيل الدخول على النحو المتوقّع.

المتغيرات	المكان	مثال
`fault.name="fault_name"`	`fault_name` هو اسم الخطأ، كما هو موضَّح في جدول أخطاء وقت التشغيل أعلاه. اسم الخطأ هو الجزء الأخير من رمز الخطأ.	`fault.name Matches "StepDefinitionExecutionFailed"`
`messagelogging.policy_name.failed`	`policy_name` هو اسم السياسة التي حدّدها المستخدم التي أدت إلى حدوث الخطأ.	`messagelogging.ML-LogMessages.failed = true`

مثال على الردّ على الخطأ

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

مثال لقاعدة خطأ

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

سياسة OASHealthation

أخطاء في وقت التشغيل

يمكن أن تحدث هذه الأخطاء عند تنفيذ السياسة.

رمز الخطأ	رموز حالة HTTP	السبب
`steps.oasvalidation.Failed`	500	لا يمكن التحقّق من صحة نص رسالة الطلب بالاستناد إلى مواصفات OpenAPI التي تم توفيرها.
`steps.oasvalidation.SourceMessageNotAvailable`	500	المتغيّر المحدَّد في العنصر `<Source>` للسياسة إما خارج النطاق أو لا يمكن حلّه.
`steps.oasvalidation.NotMessageVariable`	500	تم ضبط العنصر `<Source>` على متغيّر ليس من نوع message.

أخطاء النشر

يمكن أن تحدث هذه الأخطاء عند نشر خادم وكيل يحتوي على هذه السياسة.

اسم الخطأ	السبب
`ResourceDoesNotExist`	مواصفات OpenAPI المُشار إليها في العنصر `<OASResource>` غير موجودة.
`ResourceCompileFailed`	تحتوي مواصفات OpenAPI المضمّنة في عملية النشر على أخطاء تحول دون تجميعها. ويشير ذلك بشكل عام إلى أنّ المواصفات لم تتوافق مع الإصدار 3.0 من مواصفات OpenAPI.
`BadResourceURL`	لا يمكن معالجة مواصفات OpenAPI المُشار إليها في العنصر `<OASResource>`. يمكن أن يحدث ذلك إذا لم يكن الملف بتنسيق JSON أو YAML أو لم يتم تحديد عنوان URL للملف بشكل صحيح.

متغيرات الخطأ

المتغيرات	المكان	مثال
`fault.name="fault_name"`	`fault_name` هو اسم الخطأ، كما هو موضَّح في جدول أخطاء وقت التشغيل أعلاه. اسم الخطأ هو الجزء الأخير من رمز الخطأ.	`fault.name Matches "ResourceDoesNotExist"`
`oasvalidation.policy_name.failed`	`policy_name` هو اسم السياسة التي حدّدها المستخدم التي أدت إلى حدوث الخطأ.	`oasvalidation.myoaspolicy.failed = true`

سياسة تعبئة ذاكرة التخزين المؤقت

أخطاء في وقت التشغيل

يمكن أن تحدث هذه الأخطاء عند تنفيذ السياسة.

رمز الخطأ	حالة HTTP	يحدث عند
`policies.populatecache.EntryCannotBeCached`	500	يتعذّر تخزين أحد الإدخالات مؤقتًا. وكائن الرسالة الذي يتم تخزينه مؤقتًا ليس مثيلاً لفئة قابلة للتسلسل.

أخطاء النشر

يمكن أن تحدث هذه الأخطاء عند نشر خادم وكيل يحتوي على هذه السياسة.

اسم الخطأ	السبب	إصلاح
`InvalidCacheResourceReference`	يحدث هذا الخطأ إذا تم ضبط العنصر `<CacheResource>` في السياسة PopulateCache على اسم غير متوفر في البيئة التي يتم فيها تفعيل الخادم الوكيل لواجهة برمجة التطبيقات.
`CacheNotFound`	ذاكرة التخزين المؤقت المحددة في العنصر `<CacheResource>` غير موجودة.

متغيرات الخطأ

المتغيرات	المكان	مثال
`fault.name="fault_name"`	`fault_name` هو اسم الخطأ، كما هو موضَّح في جدول أخطاء وقت التشغيل أعلاه. اسم الخطأ هو الجزء الأخير من رمز الخطأ.	`fault.name = "EntryCannotBeCached"`
`populatecache.policy_name.failed`	`policy_name` هو اسم السياسة التي حدّدها المستخدم التي أدت إلى حدوث الخطأ.	`populatecache.POP-CACHE-1.failed = true`

مثال على الردّ على الخطأ

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

مثال لقاعدة خطأ

<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

يوضِّح هذا القسم رسائل الخطأ ومتغيّرات التدفق التي يتم تحديدها عندما تؤدي هذه السياسة إلى ظهور خطأ. هذه المعلومات مهمة لمعرفة ما إذا كنت تعمل على تطوير قواعد خطأ لخادم وكيل. لمزيد من المعلومات، يمكنك الاطّلاع على المعلومات التي يجب معرفتها عن الأخطاء المتعلقة بالسياسات وأخطاء المعالجة.

بادئة رمز الخطأ

لا ينطبق

أخطاء في وقت التشغيل

لا تؤدي هذه السياسة إلى حدوث أي أخطاء في وقت التشغيل.

أخطاء النشر

يمكن أن تحدث هذه الأخطاء عند نشر خادم وكيل يحتوي على هذه السياسة.

اسم الخطأ	السبب	إصلاح
`InvalidCacheResourceReference`	يحدث هذا الخطأ عند ضبط العنصر `<CacheResource>` على اسم غير متوفّر في البيئة التي يتم فيها نشر الخادم الوكيل لواجهة برمجة التطبيقات.
`InvalidTimeout`	وفي حال ضبط العنصر `<CacheLookupTimeoutInSeconds>` على رقم سالب، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات.
`CacheNotFound`	يحدث هذا الخطأ إذا لم يتم إنشاء ذاكرة التخزين المؤقت المحددة المذكورة في رسالة الخطأ على مكون محدد لمعالجة الرسائل.

متغيرات الخطأ

لا ينطبق

مثال على الردّ على الخطأ

لا ينطبق

سياسة إبطال التخزين المؤقت

بادئة رمز الخطأ

لا ينطبق

أخطاء في وقت التشغيل

لا تؤدي هذه السياسة إلى حدوث أي أخطاء في وقت التشغيل.

أخطاء النشر

يمكن أن تحدث هذه الأخطاء عند نشر خادم وكيل يحتوي على هذه السياسة.

اسم الخطأ	السبب	إصلاح
`InvalidCacheResourceReference`	يحدث هذا الخطأ إذا تم ضبط العنصر `<CacheResource>` في السياسة SpamateCache على اسم غير متوفّر في البيئة التي يتم فيها تفعيل الخادم الوكيل لواجهة برمجة التطبيقات.
`CacheNotFound`	يحدث هذا الخطأ إذا لم يتم إنشاء ذاكرة التخزين المؤقت المحددة المذكورة في رسالة الخطأ على مكون محدد لمعالجة الرسائل.

متغيرات الخطأ

لا ينطبق

مثال على الردّ على الخطأ

لا ينطبق

سياسة ResponseCache

بادئة رمز الخطأ

لا ينطبق

أخطاء في وقت التشغيل

لا تؤدي هذه السياسة إلى حدوث أي أخطاء في وقت التشغيل.

أخطاء النشر

يمكن أن تحدث هذه الأخطاء عند نشر خادم وكيل يحتوي على هذه السياسة.

اسم الخطأ	السبب	إصلاح
`InvalidTimeout`	إذا تم ضبط العنصر `<CacheLookupTimeoutInSeconds>` في سياسة ResponseCache على رقم سالب، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات.
`InvalidCacheResourceReference`	يحدث هذا الخطأ إذا تم ضبط العنصر `<CacheResource>` في سياسة ResponseCache على اسم غير متوفّر في البيئة التي يتم فيها تفعيل الخادم الوكيل لواجهة برمجة التطبيقات.
`ResponseCacheStepAttachmentNotAllowedReq`	يحدث هذا الخطأ إذا كانت سياسة ResponseCache نفسها مرتبطة بمسارات طلبات متعدّدة ضمن أي تدفقات في الخادم الوكيل لواجهة برمجة التطبيقات.
`ResponseCacheStepAttachmentNotAllowedResp`	يحدث هذا الخطأ إذا كانت سياسة ResponseCache مرتبطة بمسارات متعدّدة للاستجابة ضمن أي تدفقات من الخادم الوكيل لواجهة برمجة التطبيقات.
`InvalidMessagePatternForErrorCode`	يحدث هذا الخطأ إذا كان العنصر `<SkipCacheLookup>` أو العنصر `<SkipCachePopulation>` في سياسة ResponseCache يحتوي على شرط غير صالح.
`CacheNotFound`	يحدث هذا الخطأ إذا لم يتم إنشاء ذاكرة التخزين المؤقت المحددة المذكورة في رسالة الخطأ على مكون محدد لمعالجة الرسائل.

متغيرات الخطأ

لا ينطبق

مثال على الردّ على الخطأ

لا ينطبق

سياسة OAuthV2

أخطاء في وقت التشغيل

يمكن أن تحدث هذه الأخطاء عند تنفيذ السياسة.

رمز الخطأ	رموز حالة HTTP	السبب	يتم طرحها وفقًا للعمليات
`steps.oauth.v2.access_token_expired`	401	انتهت صلاحية رمز الدخول.	التحقّق من صحة الرمز غير صالح للرمز المميّز
`steps.oauth.v2.access_token_not_approved`	401	تم إبطال رمز الدخول.	VerifyAccessToken
`steps.oauth.v2.apiresource_doesnot_exist`	401	لا يتوفر المورد المطلوب لأي من منتجات واجهة برمجة التطبيقات المرتبطة برمز الدخول.	VerifyAccessToken
`steps.oauth.v2.FailedToResolveAccessToken`	500	كان من المتوقّع أن تعثر السياسة على رمز دخول في متغيّر محدّد في العنصر `<AccessToken>`، ولكن تعذّر حلّ المتغيّر.	GenerateAccessToken
`steps.oauth.v2.FailedToResolveAuthorizationCode`	500	كان من المتوقّع أن تعثر السياسة على رمز تفويض في متغيّر محدّد في العنصر `<Code>`، إلا أنّه تعذّر حلّ المتغيّر.	GenerateAuthorizationCode
`steps.oauth.v2.FailedToResolveClientId`	500	كان من المتوقّع أن تعثر السياسة على معرّف العميل في متغيّر محدّد في العنصر `<ClientId>`، إلا أنّه تعذّر حلّ المتغيّر.	GenerateAccessToken GeneratePrivacyCode GenerateAccessTokenImplicitGrant شاهدAccessToken
`steps.oauth.v2.FailedToResolveRefreshToken`	500	كان من المتوقّع أن تعثر السياسة على رمز مميّز لإعادة التحميل في متغيّر محدّد في العنصر `<RefreshToken>`، ولكن تعذّر حلّ المتغيّر.	RefreshAccessToken
`steps.oauth.v2.FailedToResolveToken`	500	كان من المتوقّع أن تعثر السياسة على رمز مميّز في متغيّر محدّد في العنصر `<Tokens>`، ولكن تعذّر حلّ المتغيّر.	التحقّق من صحة الرمز عدم صلاحية الرمز المميّز
`steps.oauth.v2.InsufficientScope`	403	يحتوي رمز الدخول المقدَّم في الطلب على نطاق لا يتطابق مع النطاق المحدّد في سياسة رمز الدخول للتحقّق من الصحة. للتعرّف على النطاق، يُرجى الاطّلاع على العمل باستخدام نطاقات OAuth2.	VerifyAccessToken
`steps.oauth.v2.invalid_access_token`	401	رمز الدخول الذي تم إرساله من العميل غير صالح.	VerifyAccessToken
`steps.oauth.v2.invalid_client`	401	يظهر اسم الخطأ هذا عندما يتم ضبط السمة `<GenerateResponse>` في السياسة على true ويكون معرِّف العميل الذي تم إرساله في الطلب غير صالح. تأكّد من أنّك تستخدم مفتاح العميل وقيم السر الصحيحتَين لتطبيق المطوِّر المرتبط بالخادم الوكيل. ويتم عادةً إرسال هذه القيم كعنوان تفويض أساسي بتشفير Base64. ملاحظة: ننصحك بتغيير شروط قاعدة الأخطاء الحالية لرصد اسمَي `invalid_client` و`InvalidClientIdentifier` معًا. يمكنك الاطّلاع على ملاحظات الإصدار 16.09.21 للاطّلاع على مزيد من المعلومات وعلى مثال.	إنشاء رمز الوصول ActivateAccessToken
`steps.oauth.v2.invalid_request`	400	يُستخدَم اسم الخطأ هذا لأنواع مختلفة من الأخطاء، وعادةً ما تكون للمعلَمات المفقودة أو غير الصحيحة التي تم إرسالها في الطلب. في حال ضبط `<GenerateResponse>` على `false`، استخدِم متغيّرات الأخطاء (الموضّحة أدناه) لاسترداد تفاصيل حول الخطأ، مثل اسم الخطأ وسببه.	GenerateAccessToken GeneratePrivacyCode GenerateAccessTokenImplicitGrant شاهدAccessToken
`steps.oauth.v2.InvalidAccessToken`	401	لا يحتوي عنوان التفويض على كلمة "الحامل"، وهي مطلوبة. على سبيل المثال: `Authorization: Bearer your_access_token`	VerifyAccessToken
`steps.oauth.v2.InvalidAPICallAsNo\ steps.oauth.v2.ApiProductMatchFound`	401	الخادم الوكيل لواجهة برمجة التطبيقات غير متوفّر في المنتج المرتبط برمز الدخول. ملاحظة: احرص على ضبط المنتج المرتبط برمز الدخول بشكل صحيح. على سبيل المثال، إذا كنت تستخدم أحرف البدل في مسارات الموارد، احرص على استخدامها بشكل صحيح. راجع إنشاء منتجات واجهة برمجة التطبيقات للحصول على مزيد من التفاصيل. يمكنك أيضًا الاطّلاع على هذه المشاركة في منتدى Apigee للحصول على مزيد من الإرشادات حول أسباب هذا الخطأ.	VerifyAccessToken
`steps.oauth.v2.InvalidClientIdentifier`	500	يتم عرض اسم الخطأ هذا عندما يتم ضبط السمة `<GenerateResponse>` في السياسة على false ويكون معرّف العميل الذي تم إرساله في الطلب غير صالح. تأكَّد من أنّك تستخدم مفتاح العميل وقيم السر الصحيحتَين لتطبيق المطوِّر المرتبط بالخادم الوكيل. ويتم عادةً إرسال هذه القيم كعنوان تفويض أساسي بترميز Base64. ملاحظة: في هذه الحالة، كان يُطلق على هذا الخطأ اسم `invalid_client`. ونقترح تغيير شروط قواعد الأخطاء الحالية لرصد كل من اسمَي `invalid_client` و`InvalidClientIdentifier`. يمكنك الاطّلاع على ملاحظات الإصدار 16.09.21 للاطّلاع على مزيد من المعلومات وعلى مثال.	إنشاء رمز الوصول ActivateAccessToken
`steps.oauth.v2.InvalidParameter`	500	يجب أن تحدّد السياسة رمز الدخول أو رمز التفويض، ولكن ليس كليهما.	GenerateAuthCode GenerateAccessTokenImplicitGrant
`steps.oauth.v2.InvalidTokenType`	500	يتطلّب العنصر `<Tokens>/<Token>` تحديد نوع الرمز المميّز (على سبيل المثال، `refreshtoken`). وإذا اجتاز العميل النوع الخطأ، سيظهر هذا الخطأ.	التحقّق من صحة الرمز عدم صلاحية الرمز المميّز
`steps.oauth.v2.MissingParameter`	500	نوع الاستجابة هو `token`، ولكن لم يتم تحديد أي أنواع للمنح.	GenerateAuthCode GenerateAccessTokenImplicitGrant
`steps.oauth.v2.UnSupportedGrantType`	500	حدّد العميل نوع منحة غير متوافق مع السياسة (غير مدرَج في العنصر <supportedGrantTypes>). ملاحظة: هناك حاليًا خطأ يتعذّر فيه عرض أخطاء نوع المنح غير المتوافقة بشكل صحيح. في حال حدوث خطأ في نوع منح الإذن غير متوافق، لا يُدخِل الخادم الوكيل مسار الخطأ على النحو المتوقّع.	GenerateAccessToken GeneratePrivacyCode GenerateAccessTokenImplicitGrant شاهدAccessToken

أخطاء النشر

يمكن أن تحدث هذه الأخطاء عند نشر خادم وكيل يحتوي على هذه السياسة.

اسم الخطأ	السبب
`InvalidValueForExpiresIn`	بالنسبة إلى العنصر `<ExpiresIn>`، تكون القيم الصالحة هي الأعداد الصحيحة الموجبة و`-1`.
`InvalidValueForRefreshTokenExpiresIn`	بالنسبة إلى العنصر `<RefreshTokenExpiresIn>`، تكون القيم الصالحة هي الأعداد الصحيحة الموجبة و`-1`.
`InvalidGrantType`	تم تحديد نوع منحة غير صالح في العنصر `<SupportedGrantTypes>`. راجِع مرجع السياسة للحصول على قائمة بالأنواع الصالحة.
`ExpiresInNotApplicableForOperation`	تأكَّد من أنّ العمليات المحدّدة في عنصر <Operations> تتيح انتهاء الصلاحية. على سبيل المثال، لا يحدث ذلك في عملية CheckToken.
`RefreshTokenExpiresInNotApplicableForOperation`	تأكَّد من أنّ العمليات المحدّدة في عنصر <Operations> تتيح انتهاء صلاحية الرمز المميّز لإعادة التحميل. على سبيل المثال، لا يحدث ذلك في عملية CheckToken.
`GrantTypesNotApplicableForOperation`	تأكَّد من أنّ أنواع المنح المحدّدة في <SupportedGrantTypes> متوافقة للعملية المحدّدة.
`OperationRequired`	يجب تحديد عملية في هذه السياسة باستخدام العنصر `<Operation>`. ملاحظة: إذا كان العنصر `<Operation>` غير متوفّر، ستعرض واجهة المستخدم خطأ التحقّق من صحة المخطط.
`InvalidOperation`	يجب تحديد عملية صالحة في هذه السياسة باستخدام العنصر `<Operation>`. ملاحظة: إذا كان العنصر `<Operation>` غير صالح، ستعرض واجهة المستخدم خطأ التحقق من المخطط.
`TokenValueRequired`	يجب تحديد قيمة `<Token>` للرمز المميز في العنصر `<Tokens>`.

متغيرات الخطأ

ويتم ضبط هذه المتغيّرات عندما تؤدي هذه السياسة إلى ظهور خطأ في وقت التشغيل.

ملاحظة: يمكنك استخدام هذه المتغيّرات لإنشاء شروط "قاعدة خطأ". تتم تعبئة هذه المتغيّرات عند حدوث خطأ في حال ضبط <GenerateResponse> على false. وإذا كانت قيمة <GenerateResponse> هي true، تعرض السياسة ردًا للعميل فورًا في حال حدوث خطأ، ويتم تخطّي مسار الخطأ ولا تتم تعبئة هذه المتغيّرات. للحصول على مزيد من المعلومات، اطّلِع على المعلومات التي يجب معرفتها عن الأخطاء المتعلقة بالسياسات.

المتغيرات	المكان	مثال
`fault.name="fault_name"`	`fault_name` هو اسم الخطأ، كما هو موضَّح في جدول أخطاء وقت التشغيل أعلاه. اسم الخطأ هو الجزء الأخير من رمز الخطأ.	`fault.name = "invalid_request"`
`oauthV2.policy_name.failed`	`policy_name` هو اسم السياسة التي حدّدها المستخدم التي أدت إلى حدوث الخطأ.	`oauthV2.GenerateAccesstoken.failed = true`
`oauthV2.policy_name.fault.name`	`policy_name` هو اسم السياسة التي حدّدها المستخدم التي أدت إلى حدوث الخطأ.	`oauthV2.GenerateAccesstoken.fault.name = invalid_request` ملاحظة: بالنسبة إلى عملية CheckAccessToken، يتضمّن اسم الخطأ هذه اللاحقة: `keymanagement.service` على سبيل المثال: `keymanagement.service.invalid_access_token`
`oauthV2.policy_name.fault.cause`	`policy_name` هو اسم السياسة التي حدّدها المستخدم التي أدت إلى حدوث الخطأ.	`oauthV2.GenerateAccesstoken.cause = Required param : grant_type`

مثال على الردّ على الخطأ

يتم إرسال هذه الاستجابات إلى العميل إذا كان العنصر <GenerateResponse> true.

إذا كانت قيمة <GenerateResponse> هي true، تعرض السياسة أخطاءً بهذا التنسيق للعمليات التي تنشئ الرموز المميّزة والرموز. للحصول على قائمة كاملة، راجِع مرجع الاستجابة لخطأ HTTP في بروتوكول OAuth.

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

إذا تم ضبط السياسة <GenerateResponse> على صحيح، ستعرض السياسة أخطاءً بهذا التنسيق عند إجراء عمليات التحقّق والتحقّق من صحة العمليات. للحصول على قائمة كاملة، يُرجى الاطّلاع على مرجع الاستجابة لخطأ HTTP في بروتوكول OAuth.

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

مثال لقاعدة خطأ

<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

أخطاء في وقت التشغيل

يمكن أن تحدث هذه الأخطاء عند تنفيذ السياسة. أسماء الأخطاء المعروضة أدناه هي السلاسل التي يتم تخصيصها للمتغيّر fault.name عند حدوث خطأ. راجِع القسم متغيّرات الأخطاء أدناه للحصول على مزيد من التفاصيل.

رمز الخطأ	رموز حالة HTTP	السبب
`steps.oauth.v2.access_token_expired`	500	انتهت صلاحية رمز الدخول الذي تم إرساله إلى السياسة.
`steps.oauth.v2.authorization_code_expired`	500	انتهت صلاحية رمز التفويض الذي تم إرساله إلى السياسة.
`steps.oauth.v2.invalid_access_token`	500	رمز الدخول الذي تم إرساله إلى السياسة غير صالح.
`steps.oauth.v2.invalid_client-invalid_client_id`	500	معرّف العميل الذي تم إرساله إلى السياسة غير صالح.
`steps.oauth.v2.invalid_refresh_token`	500	الرمز المميّز لإعادة التحميل الذي تم إرساله إلى السياسة غير صالح.
`steps.oauth.v2.invalid_request-authorization_code_invalid`	500	رمز التفويض الذي تم إرساله إلى السياسة غير صالح.
`steps.oauth.v2.InvalidAPICallAsNoApiProductMatchFound`	401	يُرجى الاطّلاع على هذه المشاركة في منتدى Apigee للحصول على معلومات حول تحديد هذا الخطأ وحلّها.
`steps.oauth.v2.refresh_token_expired`	500	انتهت صلاحية الرمز المميّز لإعادة التحميل الذي تم إرساله إلى السياسة.

أخطاء النشر

يمكنك الرجوع إلى الرسالة التي تم الإبلاغ عنها في واجهة المستخدم للاطّلاع على معلومات عن أخطاء النشر.

متغيرات الخطأ

ويتم ضبط هذه المتغيّرات عندما تؤدي هذه السياسة إلى ظهور خطأ في وقت التشغيل.

المتغيرات	المكان	مثال
`fault.name="fault_name"`	`fault_name` هو اسم الخطأ، كما هو موضَّح في جدول أخطاء وقت التشغيل أعلاه. اسم الخطأ هو الجزء الأخير من رمز الخطأ.	`fault.name Matches "IPDeniedAccess"`
`oauthV2.policy_name.failed`	`policy_name` هو اسم السياسة التي حدّدها المستخدم التي أدت إلى حدوث الخطأ.	`oauthV2.GetTokenInfo.failed = true`
`oauthV2.policy_name.fault.name`	`policy_name` هو اسم السياسة التي حدّدها المستخدم التي أدت إلى حدوث الخطأ.	`oauthV2.GetToKenInfo.fault.name = invalid_client-invalid_client_id`
`oauthV2.policy_name.fault.cause`	`policy_name` هو اسم السياسة التي حدّدها المستخدم التي أدت إلى حدوث الخطأ.	`oauthV2.GetTokenInfo.cause = ClientID is Invalid`

مثال على الردّ على الخطأ

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

مثال لقاعدة خطأ

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

سياسة SetOAuthV2Info

أخطاء في وقت التشغيل

يمكن أن تحدث هذه الأخطاء عند تنفيذ السياسة.

رمز الخطأ	رموز حالة HTTP	السبب
`steps.oauth.v2.access_token_expired`	500	انتهت صلاحية رمز الدخول الذي تم إرساله إلى السياسة.
`steps.oauth.v2.invalid_access_token`	500	رمز الدخول الذي تم إرساله إلى السياسة غير صالح.
`steps.oauth.v2.InvalidAPICallAsNoApiProductMatchFound`	401	يُرجى الاطّلاع على هذه المشاركة في منتدى Apigee للحصول على معلومات حول تحديد هذا الخطأ وحلّها.

أخطاء النشر

يمكنك الرجوع إلى الرسالة التي تم الإبلاغ عنها في واجهة المستخدم للاطّلاع على معلومات عن أخطاء النشر.

متغيرات الخطأ

ويتم ضبط هذه المتغيّرات عندما تؤدي هذه السياسة إلى ظهور خطأ في وقت التشغيل.

المتغيرات	المكان	مثال
`fault.name="fault_name"`	`fault_name` هو اسم الخطأ، كما هو موضَّح في جدول أخطاء وقت التشغيل أعلاه. اسم الخطأ هو الجزء الأخير من رمز الخطأ.	`fault.name = "invalid_access_token"`
`oauthV2.policy_name.failed`	`policy_name` هو اسم السياسة التي حدّدها المستخدم التي أدت إلى حدوث الخطأ.	`oauthV2.SetTokenInfo.failed = true`
`oauthV2.policy_name.fault.name`	`policy_name` هو اسم السياسة التي حدّدها المستخدم التي أدت إلى حدوث الخطأ.	`oauthV2.SetTokenInfo.fault.name = invalid_access_token`
`oauthv2.policy_name.fault.cause`	`policy_name` هو اسم السياسة التي حدّدها المستخدم التي أدت إلى حدوث الخطأ.	`oauthV2.SetTokenInfo.cause = Invalid Access Token`

مثال على الردّ على الخطأ

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

مثال لقاعدة خطأ

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

حذف سياسة OAuthV2Info

أخطاء في وقت التشغيل

يمكن أن تحدث هذه الأخطاء عند تنفيذ السياسة.

رمز الخطأ	رموز حالة HTTP	السبب
`steps.oauth.v2.invalid_access_token`	401	رمز الدخول الذي تم إرساله إلى السياسة غير صالح.
`steps.oauth.v2.invalid_request-authorization_code_invalid`	401	رمز التفويض الذي تم إرساله إلى السياسة غير صالح.
`steps.oauth.v2.InvalidAPICallAsNoApiProductMatchFound`	401	يُرجى الاطّلاع على هذه المشاركة في منتدى Apigee للحصول على معلومات حول تحديد هذا الخطأ وحلّها.

أخطاء النشر

يمكنك الرجوع إلى الرسالة التي تم الإبلاغ عنها في واجهة المستخدم للاطّلاع على معلومات عن أخطاء النشر.

متغيرات الخطأ

ويتم ضبط هذه المتغيّرات عندما تؤدي هذه السياسة إلى ظهور خطأ في وقت التشغيل.

المتغيرات	المكان	مثال
`fault.name="fault_name"`	`fault_name` هو اسم الخطأ، كما هو موضَّح في جدول أخطاء وقت التشغيل أعلاه. اسم الخطأ هو الجزء الأخير من رمز الخطأ.	`fault.name = "invalid_access_token"`
`oauthV2.policy_name.failed`	`policy_name` هو اسم السياسة التي حدّدها المستخدم التي أدت إلى حدوث الخطأ.	`oauthV2.DeleteTokenInfo.failed = true`
`oauthV2.policy_name.fault.name`	`policy_name` هو اسم السياسة التي حدّدها المستخدم التي أدت إلى حدوث الخطأ.	`oauthV2.DeleteTokenInfo.fault.name = invalid_access_token`
`oauthv2.policy_name.fault.cause`	`policy_name` هو اسم السياسة التي حدّدها المستخدم التي أدت إلى حدوث الخطأ.	`oauthV2.DeleteTokenInfo.cause = Invalid Access Token`

مثال على الردّ على الخطأ

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

مثال لقاعدة خطأ

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

سياسة OAuthv1.0a

يحدد نوع سياسة OAuthV1 رموز الخطأ التالية.

بالنسبة إلى رموز خطأ HTTP المتعلّقة ببروتوكول OAuth، يُرجى الاطّلاع على مرجع استجابة خطأ HTTP OAuth.

رمز الخطأ	الرسالة

`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

لم يتم تحديد رموز خطأ لسياسة المعلومات حول الحصول على الإصدار 1.0a من OAuth.

حذف سياسة معلومات OAuthV1

وتؤدي السياسة بنجاح إلى عرض الحالة 200.

إذا تعذّر إتمامها، تعرض السياسة الخطأ 404 وتعرض نتيجة مماثلة لما يلي (بناءً على ما إذا كنت تحذف رمز دخول أو رمز طلب أو أداة تحقّق):

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

أخطاء في وقت التشغيل

يمكن أن تحدث هذه الأخطاء عند تنفيذ السياسة.

رمز الخطأ	رموز حالة HTTP	السبب	إصلاح
`steps.script.ScriptEvaluationFailed`	500	قد تؤدي سياسة PythonScript إلى عرض عدة أنواع مختلفة من أخطاء ScriptExecutionإخفاق. وتشمل أنواع الأخطاء الشائعة NameError وZeroDivisionError.

أخطاء النشر

يمكن أن تحدث هذه الأخطاء عند نشر خادم وكيل يحتوي على هذه السياسة.

اسم الخطأ	السبب	إصلاح
`InvalidResourceUrlFormat`	إذا كان تنسيق عنوان URL للمورد المحدّد في `<ResourceURL>` أو العنصر `<IncludeURL>` في سياسة PythonScript غير صالح، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات.
`InvalidResourceUrlReference`	وإذا كان العنصران `<ResourceURL>` أو `<IncludeURL>` يشيران إلى ملف PythonScript غير متوفر، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات. يجب أن يكون ملف المصدر المشار إليه متوفرًا على مستوى الخادم الوكيل لواجهة برمجة التطبيقات أو البيئة أو مستوى المؤسسة.

متغيرات الخطأ

المتغيرات	المكان	مثال
`fault.name="fault_name"`	`fault_name` هو اسم الخطأ، كما هو موضَّح في جدول أخطاء وقت التشغيل أعلاه. اسم الخطأ هو الجزء الأخير من رمز الخطأ.	`fault.name Matches "ScriptExecutionFailed"`
`pythonscript.policy_name.failed`	`policy_name` هو اسم السياسة التي حدّدها المستخدم التي أدت إلى حدوث الخطأ.	`pythonscript.PythonScript-1.failed = true`

مثال على الردّ على الخطأ

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

مثال لقاعدة خطأ

<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>

سياسة الحصة

أخطاء في وقت التشغيل

يمكن أن تحدث هذه الأخطاء عند تنفيذ السياسة.

رمز الخطأ	رموز حالة HTTP	السبب	إصلاح
`policies.ratelimit.FailedToResolveQuotaIntervalReference`	500	يحدث ذلك في حال عدم تحديد العنصر `<Interval>` في سياسة الحصة. هذا العنصر إلزامي ويتم استخدامه لتحديد الفترة الزمنية التي تسري على الحصة. ويمكن أن تكون الفترة الزمنية دقائق أو ساعات أو أيام أو أسابيع أو أشهرًا على النحو المحدّد في العنصر `<TimeUnit>`.
`policies.ratelimit.FailedToResolveQuotaIntervalTimeUnitReference`	500	يحدث ذلك في حال عدم تحديد العنصر `<TimeUnit>` في سياسة الحصة. هذا العنصر إلزامي ويُستخدم لتحديد الوحدة الزمنية السارية على الحصة. ويمكن أن يكون الفاصل الزمني بالدقائق أو الساعات أو الأيام أو الأسابيع أو الأشهر.
`policies.ratelimit.InvalidMessageWeight`	500	يحدث ذلك إذا كانت قيمة العنصر `<MessageWeight>` المحددة من خلال متغيّر التدفق غير صالحة (قيمة لا تمثّل عددًا صحيحًا).
`policies.ratelimit.QuotaViolation`	500	تم تجاوز الحد الأقصى للحصة المخصّصة لك.	لا ينطبق

أخطاء النشر

اسم الخطأ	السبب	إصلاح
`InvalidQuotaInterval`	إذا لم يكن الفاصل الزمني للحصة المحدّدة في العنصر `<Interval>` عددًا صحيحًا، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات. على سبيل المثال، إذا كانت الفاصل الزمني للحصة المحدّدة هو 0.1 في العنصر `<Interval>`، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات.
`InvalidQuotaTimeUnit`	وإذا كانت الوحدة الزمنية المحدّدة في العنصر `<TimeUnit>` غير متوافقة، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات. الوحدات الزمنية المتوافقة هي `minute` و`hour` و`day` و`week` و`month`.
`InvalidQuotaType`	إذا كان نوع الحصة التي تحدّدها السمة `type` في العنصر `<Quota>` غير صالح، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات. وأنواع الحصص المتوافقة هي `default` و`calendar` و`flexi` و`rollingwindow`.
`InvalidStartTime`	وإذا كان تنسيق الوقت المحدّد في العنصر `<StartTime>` غير صالح، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات. التنسيق الصالح هو `yyyy-MM-dd HH:mm:ss`، وهو تنسيق التاريخ والوقت ISO 8601. على سبيل المثال، إذا كان الوقت المحدّد في العنصر `<StartTime>` هو `7-16-2017 12:00:00`، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات.
`StartTimeNotSupported`	إذا تم تحديد العنصر `<StartTime>` بدون نوع حصته `calendar`، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات. لا يتوافق العنصر `<StartTime>` إلا مع نوع الحصة `calendar`. على سبيل المثال، إذا تم ضبط السمة `type` على `flexi` أو `rolling window` في العنصر `<Quota>`، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات.
`InvalidTimeUnitForDistributedQuota`	سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات في حال ضبط العنصر `<Distributed>` على `true` والعنصر `<TimeUnit>` على `second`. إنّ الوحدة الزمنية `second` غير صالحة للحصة الموزَّعة.
`InvalidSynchronizeIntervalForAsyncConfiguration`	إذا كانت القيمة المحدّدة للعنصر `<SyncIntervalInSeconds>` ضمن العنصر `<AsynchronousConfiguration>` في سياسة الحصة أقل من الصفر، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات.
`InvalidAsynchronizeConfigurationForSynchronousQuota`	في حال ضبط قيمة العنصر `<AsynchronousConfiguration>` على `true` في سياسة حصة، والتي تتضمّن أيضًا إعدادات غير متزامنة تم تحديدها باستخدام العنصر `<AsynchronousConfiguration>`، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات.

متغيرات الخطأ

المتغيرات	المكان	مثال
`fault.name="fault_name"`	`fault_name` هو اسم الخطأ، كما هو موضَّح في جدول أخطاء وقت التشغيل أعلاه. اسم الخطأ هو الجزء الأخير من رمز الخطأ.	`fault.name Matches "QuotaViolation"`
`ratelimit.policy_name.failed`	`policy_name` هو اسم السياسة التي حدّدها المستخدم التي أدت إلى حدوث الخطأ.	`ratelimit.QT-QuotaPolicy.failed = true`

مثال على الردّ على الخطأ

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

مثال لقاعدة خطأ

<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>

إعادة ضبط سياسة الحصص

أخطاء في وقت التشغيل

يمكن أن تحدث هذه الأخطاء عند تنفيذ السياسة.

رمز الخطأ	رموز حالة HTTP	السبب
`policies.resetquota.InvalidRLPolicy`	500	لم يتم تحديد سياسة الحصة المحدّدة في العنصر `<Quota>` ضمن سياسة إعادة ضبط الحصة في الخادم الوكيل لواجهة برمجة التطبيقات، وبالتالي لا تتوفّر أثناء العملية. العنصر `<Quota>` إلزامي ويحدّد سياسة الحصة المستهدفة التي يجب تعديل عدّادها من خلال سياسة إعادة ضبط الحصة.
`policies.resetquota.FailedToResolveAllowCountRef`	لا ينطبق	لا يمكن تحويل المرجع إلى المتغيّر الذي يتضمّن عدد المسموح به في العنصر `<Allow>` في السياسة إلى قيمة. هذا العنصر إلزامي ويحدد المبلغ المطلوب لخفض عدّاد الحصة.
`policies.resetquota.FailedToResolveRLPolicy`	500	لا يمكن حلّ المتغيّر الذي تشير إليه السمة `ref` في العنصر `<Quota>`.

أخطاء النشر

يمكن أن تحدث هذه الأخطاء عند نشر خادم وكيل يحتوي على هذه السياسة.

اسم الخطأ	السبب	إصلاح
`InvalidCount`	إذا لم تكن قيمة العدد المحدّدة في العنصر `<Allow>` في "سياسة إعادة ضبط الحصص" عددًا صحيحًا، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات.

سياسة riseFault

يصف هذا القسم رموز الأخطاء ورسائل الخطأ التي يتم عرضها ومتغيّرات الأخطاء التي تضبطها Edge عندما تؤدي هذه السياسة إلى ظهور خطأ. هذه المعلومات مهمة لمعرفة ما إذا كنت تعمل على تطوير قواعد للأخطاء للتعامل معها. لمزيد من المعلومات، يمكنك الاطّلاع على المعلومات التي يجب معرفتها عن أخطاء السياسة وأخطاء المعالجة.

أخطاء في وقت التشغيل

يمكن أن تحدث هذه الأخطاء عند تنفيذ السياسة.

رمز الخطأ	رموز حالة HTTP	السبب
`steps.raisefault.RaiseFault`	500	الاطّلاع على سلسلة الخطأ

أخطاء النشر

بلا عُري

متغيرات الخطأ

المتغيرات	المكان	مثال
`fault.name="fault_name"`	`fault_name` هو اسم الخطأ، كما هو موضّح في جدول أخطاء وقت التشغيل أعلاه. اسم الخطأ هو الجزء الأخير من رمز الخطأ.	`fault.name = "RaiseFault"`
`raisefault.policy_name.failed`	و`policy_name` هو اسم السياسة الذي حدّده المستخدم التي أدت إلى حدوث الخطأ.	`raisefault.RF-ThrowError.failed = true`

مثال على الردّ على الخطأ

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

سياسة Standard ExpressionProtection

يوضِّح هذا القسم رموز الخطأ والرسائل المعروضة ومتغيرات الأخطاء التي تضبطها Edge عندما تؤدي هذه السياسة إلى ظهور خطأ. هذه المعلومات مهمة لمعرفة ما إذا كنت تعمل على تطوير قواعد للأخطاء للتعامل مع الأخطاء. إذا كنت تريد رصد خطأ وزيادة الخطأ المخصّص، اضبط السمة continueOnError="true" على العنصر الجذر للسياسة. لمزيد من المعلومات، يمكنك الاطّلاع على المعلومات التي يجب معرفتها عن أخطاء السياسة وأخطاء المعالجة.

تتبع الأخطاء الناتجة من سياسات Edge تنسيقًا ثابتًا كما هو موضح في مرجع رمز الخطأ.

أخطاء في وقت التشغيل

يمكن أن تحدث هذه الأخطاء عند تنفيذ السياسة.

رمز الخطأ	مراسلة

ExecutionFailed	تعذّر تنفيذ خطوة تعريف الخطوة URIExpressionProtection {0}. السبب: {1}
InstantiationFailed	تعذّر إنشاء مثيل لـStepDefinition من وصولي>تعبير عن حماية Google {0}
NonMessageVariable	لم يتم تحويل المتغير {0} إلى رسالة
SourceMessageNotAvailable	رسالة {0} غير متاحة من أجل قاعدتي تعبير عن طريق تعبير عادي {1}
ThreatDetected	تم اكتشاف تهديد التعبير العادي في {0}: التعبير العادي: {1} الإدخال: {2}
VariableResolutionFailed	تعذّرت مطابقة المتغير {0}.

أخطاء النشر

رمز الخطأ	مراسلة	إصلاح

CannotBeConvertedToNodeset	StandardExpressionProtection {0}: لا يمكن تحويل نتيجة xpath {1} إلى مجموعة العقدة. السياق {2}
DuplicatePrefix	Standard ExpressionProtection {0}: بادئة مكررة {1}
EmptyJSONPathExpression	RegionExpressionProtection {0}: تعبير JSONPath فارغ
EmptyXPathExpression	RegionExpressionProtection {0}: تعبير XPath فارغ
InvalidRegularExpression	Standard ExpressionProtection {0}: تعبير عادي غير صالح {1}، السياق {2}
JSONPathCompilationFailed	RegionExpressionProtection {0}: تعذّر تجميع jsonpath {1}. السياق {2}
NONblankPrefixMappedToفارتم	Primary ExpressionProtection {0}: لا يمكن ربط البادئة غير الفارغة {1} بمعرّف الموارد المنتظم (URI) فارغ.
NoPatternsToEnforce	Standard ExpressionProtection {0}: ليست هناك أنماط لفرضها في {1}
NothingToEnforce	URIExpressionProtection {0}: يجب استخدام عبارة واحدة على الأقل من URIPath أو QueryParam أو العنوان أو FormParam أو XMLPayload أو JSONPayload
XPathCompilationFailed	StandardExpressionProtection {0}: تعذّر تجميع xpath {1}. السياق {2}

متغيرات الخطأ

المتغيرات	المكان	مثال
`fault.name="fault_name"`	`fault_name` هو اسم الخطأ، كما هو موضّح في الجدول أعلاه.	`fault.name Matches "ThreatDetected"`
`regularexpressionprotection.policy_name.failed`	`policy_name` هو اسم السياسة التي حدّدها المستخدم التي أدت إلى حدوث الخطأ.	`regularexpressionprotection.Regular-Expressions-Protection-1.failed = true`

سياسة SOAPMessageHealthation

أخطاء في وقت التشغيل

يمكن أن تحدث هذه الأخطاء عند تنفيذ السياسة.

رمز الخطأ رموز حالة HTTP السبب إصلاح

steps.messagevalidation.SourceMessageNotAvailable

500

يحدث هذا الخطأ إذا كان أحد المتغيّرين المحدَّدين في العنصر <Source> للسياسة أيًا مما يلي:

خارج النطاق (غير متاحة في المسار المحدّد الذي يتم فيه تنفيذ السياسة)
لا يمكن حلها (غير محددة)

steps.messagevalidation.NonMessageVariable

500

يحدث هذا الخطأ إذا تم ضبط العنصر <Source> في السياسة SOAPMessageHealthation على متغيّر ليس من نوع message.

steps.messagevalidation.Failed 500 يحدث هذا الخطأ إذا تعذّر على سياسة SOAPMessageValidation التحقق من حمولة رسالة الإدخال وفقًا لمخطّط XSD أو تعريف WSDL. وستظهر هذه البيانات أيضًا إذا كانت رسالة الحمولة مكتوبة بتنسيق JSON أو XML بشكلٍ غير صحيح.

أخطاء النشر

يمكن أن تحدث هذه الأخطاء عند نشر خادم وكيل يحتوي على هذه السياسة.

اسم الخطأ	السبب	إصلاح
`InvalidResourceType`	تم ضبط العنصر `<ResourceURL>` في سياسة SOAPMessageHealthation على نوع مورد غير متوافق مع السياسة.
`ResourceCompileFailed`	يحتوي النص البرمجي للمورد المشار إليه في العنصر `<ResourceURL>` ضمن السياسة SOAPMessageHealthation على خطأ يمنع تجميعه.
`RootElementNameUnspecified`	لا يحتوي العنصر `<Element>` المتوفّر في سياسة SOAPMessageHealthation على اسم العنصر الجذر.
`InvalidRootElementName`	يحتوي العنصر `<Element>` في سياسة SOAPMessage بدء الاستخدام على اسم عنصر جذري لا يتوافق مع قواعد XML لتسمية العناصر الصالحة.

سياسة تأكيد SAML

يصف هذا القسم رموز الأخطاء ورسائل الخطأ التي يتم عرضها ومتغيّرات الأخطاء التي تضبطها Edge عندما تؤدي هذه السياسة إلى ظهور خطأ. هذه المعلومات مهمة لمعرفة ما إذا كنت تعمل على تطوير قواعد للأخطاء للتعامل معها. لمزيد من المعلومات، يمكنك الاطّلاع على المعلومات التي يجب معرفتها عن الأخطاء المتعلقة بالسياسات وأخطاء المعالجة.

أخطاء النشر

يمكن أن تحدث هذه الأخطاء عند نشر خادم وكيل يحتوي على هذه السياسة.

اسم الخطأ	السبب	إصلاح
`SourceNotConfigured`	لم يتم تحديد عنصر واحد أو أكثر من العناصر التالية في سياسة تأكيد SAML أو التحقق من صحة SAML: `<Source>` أو `<XPath>` أو `<Namespaces>` أو `<Namespace>`.
`TrustStoreNotConfigured`	إذا كان العنصر `<TrustStore>` فارغًا أو غير محدّد في سياسة التحقّق من صحة SAMLAssertion، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات. يجب توفُّر متجر موثوق به صالح.
`NullKeyStoreAlias`	إذا كان العنصر الفرعي `<Alias>` فارغًا أو غير محدَّد في العنصر `<Keystore>` ضِمن سياسة إنشاء SAML، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات. يجب إدخال اسم مستعار صالح لملف تخزين المفاتيح.
`NullKeyStore`	إذا كان العنصر الفرعي `<Name>` فارغًا أو غير محدَّد في العنصر `<Keystore>` ضِمن سياسة GenerateSAMLAssertion، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات. يجب إدخال اسم صالح لملف تخزين المفاتيح.
`NullIssuer`	إذا كان العنصر `<Issuer>` فارغًا أو لم يتم تحديده في سياسة تأكيد SAML، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات. يجب إدخال قيمة `<Issuer>` صالحة.

متغيرات الخطأ

المتغيرات	المكان	مثال
`fault.name="fault_name"`	`fault_name` هو اسم الخطأ. اسم الخطأ هو الجزء الأخير من رمز الخطأ.	`fault.name = "InvalidMediaTpe"`
`GenerateSAMLAssertion.failed`	بالنسبة إلى إعدادات سياسة تأكيد SAML للتحقّق من الصحة، تكون بادئة الخطأ `ValidateSAMLAssertion`.	`GenerateSAMLAssertion.failed = true`

مثال على الردّ على الخطأ

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

مثال لقاعدة خطأ

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

سياسة وسيلة شرح الخدمة

أخطاء في وقت التشغيل

يمكن أن تحدث هذه الأخطاء عند تنفيذ السياسة.

رمز الخطأ رموز حالة HTTP السبب إصلاح

steps.servicecallout.ExecutionFailed

500

يمكن أن يحدث هذا الخطأ في الحالات التالية:

يُطلَب من السياسة معالجة الإدخال المكتوب بشكلٍ غير صحيح أو غير صالح.
خدمة الهدف في الخلفية تعرض حالة خطأ (بشكل افتراضي، 4xx أو 5xx).

steps.servicecallout.RequestVariableNotMessageType 500 إنّ متغيّر الطلب المحدَّد في السياسة ليس من نوع "الرسائل". على سبيل المثال، إذا كانت القيمة سلسلة أو نوعًا آخر لا يمثّل رسائل، سيظهر لك هذا الخطأ.

steps.servicecallout.RequestVariableNotRequestMessageType 500 لا يكون متغيّر الطلب المحدَّد في السياسة من نوع "Request Message". على سبيل المثال، إذا كان نوع الاستجابة، سترى هذا الخطأ.

أخطاء النشر

يمكن أن تحدث هذه الأخطاء عند نشر خادم وكيل يحتوي على هذه السياسة.

اسم الخطأ	السبب	إصلاح
`URLMissing`	العنصر `<URL>` في `<HTTPTargetConnection>` غير متوفّر أو فارغ.
`ConnectionInfoMissing`	يحدث هذا الخطأ إذا كانت السياسة لا تحتوي على العنصر `<HTTPTargetConnection>` أو `<LocalTargetConnection>`.
`InvalidTimeoutValue`	يحدث هذا الخطأ إذا كانت قيمة `<Timeout>` سالبة أو صفرية.

متغيرات الخطأ

المتغيرات	المكان	مثال
`fault.name="fault_name"`	`fault_name` هو اسم الخطأ، كما هو موضَّح في جدول أخطاء وقت التشغيل أعلاه. اسم الخطأ هو الجزء الأخير من رمز الخطأ.	`fault.name = "RequestVariableNotMessageType"`
`servicecallout.policy_name.failed`	`policy_name` هو اسم السياسة التي حدّدها المستخدم التي أدت إلى حدوث الخطأ.	`servicecallout.SC-GetUserData.failed = true`

مثال على الردّ على الخطأ

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

مثال لقاعدة خطأ

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

سياسة SpikeArrest

يصف هذا القسم رموز الأخطاء ورسائل الخطأ التي يتم عرضها ومتغيّرات الأخطاء التي تضبطها Edge عندما تؤدي هذه السياسة إلى ظهور خطأ. هذه المعلومات مهمة لمعرفة ما إذا كنت تعمل على تطوير قواعد للأخطاء للتعامل معها. لمزيد من المعلومات، يمكنك الاطّلاع على المعلومات التي يجب معرفتها عن الأخطاء المتعلقة بالسياسات وأخطاء المعالجة.

أخطاء في وقت التشغيل

يمكن أن تحدث هذه الأخطاء عند تنفيذ السياسة.

رمز الخطأ	رموز حالة HTTP	السبب
`policies.ratelimit.FailedToResolveSpikeArrestRate`	`500`	يحدث هذا الخطأ إذا تعذّر تحويل المرجع إلى المتغيّر الذي يحتوي على إعداد المعدّل في العنصر `<Rate>` إلى قيمة ضمن سياسة "منع الارتفاع". هذا العنصر إلزامي ويتم استخدامه لتحديد معدّل إيقاف التشغيل المفاجئ، ويكون هذا على شكل `intpm` أو `intps`.
`policies.ratelimit.InvalidMessageWeight`	`500`	يحدث هذا الخطأ إذا كانت القيمة المحدّدة للعنصر `<MessageWeight>` من خلال متغيّر التدفق غير صالحة (قيمة لا تمثّل عددًا صحيحًا).
`policies.ratelimit.SpikeArrestViolation`	`429`	تم تجاوز الحد المسموح به لمعدل الزيارات. ملاحظة: بالنسبة إلى Private Cloud، يكون رمز حالة HTTP التلقائي الذي يتم عرضه هو `500`. لتغيير رمز الحالة الذي تمّ عرضه إلى `429`، يجب ضبط هذه السمة باستخدام طلب البيانات من واجهة برمجة التطبيقات الموضّح في مثال على قاعدة الخطأ.

أخطاء النشر

يمكن أن تحدث هذه الأخطاء عند نشر خادم وكيل يحتوي على هذه السياسة.

اسم الخطأ	السبب	إصلاح
`InvalidAllowedRate`	إذا لم يكن معدّل الإيقاف المؤقّت والمحدد في العنصر `<Rate>` ضِمن "سياسة إيقاف الارتفاع المفاجئ" عددًا صحيحًا أو لم يكن المعدّل يحتوي على `ps` أو `pm` كلاحقة، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات.

متغيرات الخطأ

المتغيرات	المكان	مثال
`fault.name="fault_name"`	`fault_name` هو اسم الخطأ، كما هو موضّح في جدول أخطاء وقت التشغيل أعلاه. اسم الخطأ هو الجزء الأخير من رمز الخطأ.	`fault.name Matches "SpikeArrestViolation"`
`ratelimit.policy_name.failed`	`policy_name` هو اسم السياسة التي حدّدها المستخدم التي أدت إلى حدوث الخطأ.	`ratelimit.SA-SpikeArrestPolicy.failed = true`

مثال على الردّ على الخطأ

في ما يلي مثال على استجابة الخطأ:

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

مثال لقاعدة خطأ

في ما يلي مثال على قاعدة خطأ للتعامل مع خطأ SpikeArrestViolation:

<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

أخطاء في وقت التشغيل

بلا عُري

أخطاء النشر

اسم الخطأ	السبب	إصلاح
`UnsupportedDatatype`	إذا كان نوع المتغيّر الذي حدّدته السمة ref في العنصر `<Statistic>` ضِمن سياسة جامع الإحصاءات غير متوافق، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات. وتشمل أنواع البيانات المتوافقة `string` و`integer` و`float` و`long` و`double` و`boolean`.
`InvalidName`	إذا كان الاسم المستخدَم للإشارة إلى البيانات التي تم جمعها للمتغيّر المحدّد والمحدّد ضمن العنصر `<Statistic>` ضِمن سياسة أداة جمع الإحصاءات يتعارض مع متغيّر من تحديد النظام، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات. ومن المتغيّرات المعروفة التي يحدّدها النظام `organization` و`environment`.
`DatatypeMissing`	في حال عدم توفُّر نوع المتغيّر الذي حدّدته السمة `ref` في العنصر `<Statistic>` لسياسة أداة جمع الإحصاءات، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات.

متغيرات الخطأ

بلا عُري

سياسة CheckAPIKey

أخطاء في وقت التشغيل

يمكن أن تحدث هذه الأخطاء عند تنفيذ السياسة.

رمز الخطأ	رموز حالة HTTP	السبب
`keymanagement.service.CompanyStatusNotActive`	401	تكون حالة الشركة المرتبطة بتطبيق المطوّر الذي يتضمّن مفتاح واجهة برمجة التطبيقات الذي تستخدمه: غير نشطة. وعند ضبط حالة الشركة على "غير نشطة"، لا يمكنك الوصول إلى المطورين أو التطبيقات المرتبطة بهذه الشركة. يمكن لمشرف المؤسسة تغيير حالة الشركة باستخدام واجهة برمجة تطبيقات الإدارة. ويمكنك الاطّلاع على تحديد حالة الشركة.
`keymanagement.service.DeveloperStatusNotActive`	401	إذا أنشأ المطوِّر الذي أنشأ تطبيق المطوّر الذي يتضمّن مفتاح واجهة برمجة التطبيقات الذي تستخدمه، ستكون حالته غير نشطة. عند ضبط حالة مطوِّر التطبيقات على "غير نشط"، يتم إيقاف أي تطبيقات مطوّر برامج أنشأها ذلك المطوّر. ويمكن لمستخدم مشرف لديه الأذونات المناسبة (مثل مشرف المؤسسة) تغيير حالة مطوّر البرامج بإحدى الطرق التالية: Management API: ضبط حالة المطوّر واجهة المستخدم للإدارة: في صفحة تسجيل مطوّري التطبيقات، يمكنك الاطّلاع على تعليمات إيقاف مطوّر برامج (وتفعيله).
`keymanagement.service.invalid_client-app_not_approved`	401	تم إبطال تطبيق المطوِّر المرتبط بمفتاح واجهة برمجة التطبيقات. لا يمكن للتطبيق الذي تم إبطاله الوصول إلى أي من منتجات واجهة برمجة التطبيقات، ولا يمكنه استدعاء أي واجهة برمجة تطبيقات تديرها Apigee Edge. يمكن لمشرف المؤسسة تغيير حالة "تطبيق مطوّر البرامج" باستخدام واجهة برمجة تطبيقات الإدارة. يُرجى الاطّلاع على الموافقة على تطبيق المطوِّر أو إبطاله.
`oauth.v2.FailedToResolveAPIKey`	401	تتوقّع السياسة العثور على مفتاح واجهة برمجة التطبيقات في متغيّر تم تحديده في عنصر <APIKey> الخاص بالسياسة. ينشأ هذا الخطأ عندما لا يكون المتغيّر المتوقّع متوفّرًا (لا يمكن حله).
`oauth.v2.InvalidApiKey`	401	استلم Edge مفتاح واجهة برمجة تطبيقات، ولكنه غير صالح. عندما يبحث Edge عن المفتاح في قاعدة البيانات الخاصة به، يجب أن يتطابق تمامًا مع المفتاح الذي تم إرساله في الطلب. إذا كانت واجهة برمجة التطبيقات تعمل في السابق، تأكَّد من عدم إعادة إنشاء المفتاح. في حال إعادة إنشاء المفتاح، سيظهر لك هذا الخطأ إذا حاولت استخدام المفتاح القديم. للاطّلاع على التفاصيل، يُرجى الاطّلاع على تسجيل التطبيقات وإدارة مفاتيح واجهة برمجة التطبيقات.
`oauth.v2.InvalidApiKeyForGivenResource`	401	تلقّى متصفّح Edge مفتاح واجهة برمجة تطبيقات، وهو صالح، ولكنّه لا يتطابق مع أي مفتاح تمّت الموافقة عليه في "تطبيق المطوّر" والمرتبط بالخادم الوكيل لواجهة برمجة التطبيقات من خلال أحد المنتجات.

ملاحظة: لا يُبلغ متصفّح Edge حاليًا عن الخطأ ApiKeyNotApproved بدقة. بدلاً من ذلك، إذا لم تتم الموافقة على مفتاح (تم ضبط حالته على "تم إبطاله" أو "في انتظار المراجعة")، ستظهر لك رسالة الخطأ errorToresolveAPIKey بدلاً من ذلك. للحصول على مزيد من المعلومات والحلول الممكنة، يُرجى الاطّلاع على هذه المشاركة على منتدى Apigee.

أخطاء النشر

يمكن أن تحدث هذه الأخطاء عند نشر خادم وكيل يحتوي على هذه السياسة.

اسم الخطأ	السبب
`SpecifyValueOrRefApiKey`	لا يحتوي العنصر `<APIKey>` على قيمة أو مفتاح محدد.

متغيرات الخطأ

المتغيرات	المكان	مثال
`fault.name="fault_name"`	`fault_name` هو اسم الخطأ، كما هو موضَّح في جدول أخطاء وقت التشغيل أعلاه. اسم الخطأ هو الجزء الأخير من رمز الخطأ.	`fault.name Matches "FailedToResolveAPIKey"`
`oauthV2.policy_name.failed`	`policy_name` هو اسم السياسة التي حدّدها المستخدم التي أدت إلى حدوث الخطأ.	`oauthV2.VK-VerifyAPIKey.failed = true`

أمثلة للأخطاء

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

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

مثال لقاعدة خطأ

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

سياسة CheckJWS

أخطاء في وقت التشغيل

يمكن أن تحدث هذه الأخطاء عند تنفيذ السياسة.

رمز الخطأ	رموز حالة HTTP	يحدث عند
`steps.jws.AlgorithmInTokenNotPresentInConfiguration`	401	يحدث ذلك عندما تتضمّن سياسة إثبات الهوية خوارزميات متعدّدة.
`steps.jws.AlgorithmMismatch`	401	الخوارزمية المحدّدة في العنوان من خلال سياسة الإنشاء لا تتطابق مع الخوارزمية المتوقَّعة في سياسة "إثبات الملكية". يجب أن تتطابق الخوارزميات المحدّدة.
`steps.jws.ContentIsNotDetached`	401	يتم تحديد `<DetachedContent>` عندما لا تحتوي JWS على حمولة بيانات منفصلة.
`steps.jws.FailedToDecode`	401	تعذَّر على السياسة فك ترميز JWS. من المحتمل أن يكون JWS تالفًا.
`steps.jws.InsufficientKeyLength`	401	بالنسبة إلى مفتاح أقل من 32 بايت لخوارزمية HS256
`steps.jws.InvalidClaim`	401	بسبب عدم تطابق مطالبة أو مطالبة، أو عدم تطابق العنوان أو العنوان.
`steps.jws.InvalidCurve`	401	المنحنى المحدد بالمفتاح غير صالح لخوارزمية المنحنى البيضاوي.
`steps.jws.InvalidJsonFormat`	401	تم العثور على تنسيق JSON غير صالح في عنوان JWS.
`steps.jws.InvalidJws`	401	يحدث هذا الخطأ عند تعذُّر إثبات صحة توقيع JWS.
`steps.jws.InvalidPayload`	401	حمولة JWS غير صالحة.
`steps.jws.InvalidSignature`	401	تم حذف `<DetachedContent>` ولديها حمولة بيانات منفصلة في JWS.
`steps.jws.KeyIdMissing`	401	تستخدم سياسة "التحقّق" رمز JWKS كمصدر للمفاتيح العامة، إلا أنّ سياسة JWS الموقَّعة لا تتضمّن السمة `kid` في العنوان.
`steps.jws.KeyParsingFailed`	401	تعذّر تحليل المفتاح العام من المعلومات الأساسية المحددة.
`steps.jws.MissingPayload`	401	حمولة JWS مفقودة.
`steps.jws.NoAlgorithmFoundInHeader`	401	يحدث عندما تغفل JWS عنوان الخوارزمية.
`steps.jws.NoMatchingPublicKey`	401	تستخدم سياسة "التحقّق" مفتاح JWKS كمصدر للمفاتيح العامة، ولكن لا يتم إدراج `kid` في JWKS الموقَّعة في JWKS.
`steps.jws.UnhandledCriticalHeader`	401	لا يتم إدراج العنوان الذي عثرت عليه سياسة إثبات ملكية JWS ضمن عنوان `crit` في `KnownHeaders`.
`steps.jws.UnknownException`	401	حدث استثناء غير معروف.
`steps.jws.WrongKeyType`	401	تم تحديد نوع خاطئ للمفتاح. على سبيل المثال، إذا حدّدت مفتاح RSA لخوارزمية "منحنى بيضاوي" أو مفتاح منحنى لخوارزمية RSA.

أخطاء النشر

يمكن أن تحدث هذه الأخطاء عند نشر خادم وكيل يحتوي على هذه السياسة.

اسم الخطأ يحدث عند

InvalidAlgorithm القيم الصالحة الوحيدة هي: 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

أخطاء النشر المحتملة الأخرى

متغيرات الخطأ

المتغيرات	المكان	مثال
`fault.name="fault_name"`	`fault_name` هو اسم الخطأ، كما هو موضَّح في جدول أخطاء وقت التشغيل أعلاه. اسم الخطأ هو الجزء الأخير من رمز الخطأ.	`fault.name Matches "TokenExpired"`
`JWS.failed`	تحدِّد جميع سياسات JWS المتغيّر نفسه في حال تعذُّر التثبيت.	`jws.JWS-Policy.failed = true`

مثال على الردّ على الخطأ

مثال لقاعدة خطأ

<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>

سياسة CheckJWT

أخطاء في وقت التشغيل

يمكن أن تحدث هذه الأخطاء عند تنفيذ السياسة.

رمز الخطأ	رموز حالة HTTP	يحدث عند
`steps.jwt.AlgorithmInTokenNotPresentInConfiguration`	401	يحدث ذلك عندما تتضمّن سياسة إثبات الهوية خوارزميات متعدّدة.
`steps.jwt.AlgorithmMismatch`	401	الخوارزمية المحدّدة في سياسة الإنشاء لا تتطابق مع الخوارزمية المتوقعة في سياسة إثبات الملكية. يجب أن تتطابق الخوارزميات المحدّدة.
`steps.jwt.FailedToDecode`	401	تعذَّر على السياسة فك ترميز JWT. من المحتمل أن يكون JWT تالفًا.
`steps.jwt.GenerationFailed`	401	تعذَّر على السياسة إنشاء رمز JWT.
`steps.jwt.InsufficientKeyLength`	401	بالنسبة إلى مفتاح أقل من 32 بايت لخوارزمية HS256، وأقل من 48 بايت لخوارزمية HS386، وأقل من 64 بايت لخوارزمية HS512.
`steps.jwt.InvalidClaim`	401	بسبب عدم تطابق مطالبة أو مطالبة، أو عدم تطابق العنوان أو العنوان.
`steps.jwt.InvalidCurve`	401	المنحنى المحدد بالمفتاح غير صالح لخوارزمية المنحنى البيضاوي.
`steps.jwt.InvalidJsonFormat`	401	تم العثور على تنسيق JSON غير صالح في الرأس أو الحمولة.
`steps.jwt.InvalidToken`	401	يحدث هذا الخطأ عند تعذُّر التحقُّق من توقيع JWT.
`steps.jwt.JwtAudienceMismatch`	401	تعذّرت المطالبة بالجمهور عند إثبات صحة الرمز المميّز.
`steps.jwt.JwtIssuerMismatch`	401	تعذّرت المطالبة من جهة الإصدار بإثبات ملكية الرمز المميّز.
`steps.jwt.JwtSubjectMismatch`	401	تعذّرت المطالبة بالموضوع عند إثبات ملكية الرمز المميّز.
`steps.jwt.KeyIdMissing`	401	تستخدم سياسة "التحقّق" رمز JWKS كمصدر للمفاتيح العامة، ولكنّ سياسة JWT الموقَّعة لا تتضمّن السمة `kid` في العنوان.
`steps.jwt.KeyParsingFailed`	401	تعذّر تحليل المفتاح العام من المعلومات الأساسية المحددة.
`steps.jwt.NoAlgorithmFoundInHeader`	401	يحدث عندما لا يحتوي JWT على عنوان خوارزمية.
`steps.jwt.NoMatchingPublicKey`	401	تستخدم سياسة "التحقّق" مفتاح JWKS كمصدر للمفاتيح العامة، ولكن لا يتم إدراج `kid` في JWT الموقَّع في JWKS.
`steps.jwt.SigningFailed`	401	في CREATEJWT لمفتاح أقل من الحد الأدنى للحجم لخوارزميات HS384 أو HS512
`steps.jwt.TokenExpired`	401	تحاول السياسة التحقّق من رمز مميّز منتهي الصلاحية.
`steps.jwt.TokenNotYetValid`	401	الرمز المميز غير صالح بعد.
`steps.jwt.UnhandledCriticalHeader`	401	إنّ العنوان الذي عثرت عليه سياسة "التحقق من JWT" ضمن عنوان `crit` غير مدرَج في `KnownHeaders`.
`steps.jwt.UnknownException`	401	حدث استثناء غير معروف.
`steps.jwt.WrongKeyType`	401	تم تحديد نوع خاطئ للمفتاح. على سبيل المثال، إذا حدّدت مفتاح RSA لخوارزمية "منحنى بيضاوي" أو مفتاح منحنى لخوارزمية RSA.

أخطاء النشر

يمكن أن تحدث هذه الأخطاء عند نشر خادم وكيل يحتوي على هذه السياسة.

اسم الخطأ	السبب	إصلاح
`InvalidNameForAdditionalClaim`	ستتعذّر عملية النشر إذا كانت المطالبة المستخدَمة في العنصر الفرعي `<Claim>` في العنصر `<AdditionalClaims>` هي أحد الأسماء المسجّلة التالية: `kid` أو `iss` أو `sub` أو `aud` أو `iat` أو `exp` أو `nbf` أو `jti`.
`InvalidTypeForAdditionalClaim`	إذا كانت المطالبة المستخدَمة في العنصر الفرعي `<Claim>` في العنصر `<AdditionalClaims>` ليست من النوع `string` أو `number` أو `boolean` أو `map`، سيتعذّر النشر.
`MissingNameForAdditionalClaim`	إذا لم يتم تحديد اسم المطالبة في العنصر الفرعي `<Claim>` في العنصر `<AdditionalClaims>`، سيتعذّر النشر.
`InvalidNameForAdditionalHeader`	يحدث هذا الخطأ إذا كان اسم المطالبة المستخدَم في العنصر الفرعي `<Claim>` في العنصر `<AdditionalClaims>` هو `alg` أو `typ`.
`InvalidTypeForAdditionalHeader`	إذا كان نوع المطالبة المستخدَم في العنصر الفرعي `<Claim>` في العنصر `<AdditionalClaims>` ليس من النوع `string` أو `number` أو `boolean` أو `map`، سيتعذّر النشر.
`InvalidValueOfArrayAttribute`	يحدث هذا الخطأ عندما لا يتم ضبط قيمة سمة الصفيف في العنصر الفرعي `<Claim>` للعنصر `<AdditionalClaims>` على `true` أو `false`.
`InvalidValueForElement`	وإذا لم تكن القيمة المحدّدة في العنصر `<Algorithm>` قيمة مسموح بها، سيتعذّر إتمام عملية النشر.
`MissingConfigurationElement`	سيحدث هذا الخطأ إذا لم يتم استخدام العنصر `<PrivateKey>` مع خوارزميات مجموعة RSA أو إذا لم يتم استخدام العنصر `<SecretKey>` مع خوارزميات HS Family.
`InvalidKeyConfiguration`	إذا لم يتم تحديد العنصر الفرعي `<Value>` في العنصرَين `<PrivateKey>` أو `<SecretKey>`، سيتعذّر النشر.
`EmptyElementForKeyConfiguration`	إذا كانت سمة المرجع للعنصر الفرعي `<Value>` للعناصر `<PrivateKey>` أو `<SecretKey>` فارغة أو غير محدّدة، سيتعذّر إتمام عملية النشر.
`InvalidConfigurationForVerify`	يحدث هذا الخطأ عند تحديد العنصر `<Id>` داخل العنصر `<SecretKey>`.
`InvalidEmptyElement`	يحدث هذا الخطأ إذا كان العنصر `<Source>` في سياسة "التحقق من JWT" فارغًا. وفي حالة وجوده، يجب تحديده باستخدام اسم متغير تدفق Edge.
`InvalidPublicKeyValue`	إذا كانت القيمة المستخدَمة في العنصر الفرعي `<JWKS>` للعنصر `<PublicKey>` لا تستخدم تنسيقًا صالحًا على النحو المحدّد في RFC 7517، لن تنجح عملية النشر.
`InvalidConfigurationForActionAndAlgorithm`	إذا تم استخدام العنصر `<PrivateKey>` مع خوارزميات HS Family أو العنصر `<SecretKey>` مع خوارزميات RSA Family، سيتعذّر إجراء عملية النشر.

متغيرات الخطأ

المتغيرات	المكان	مثال
`fault.name="fault_name"`	`fault_name` هو اسم الخطأ، كما هو موضَّح في جدول أخطاء وقت التشغيل أعلاه. اسم الخطأ هو الجزء الأخير من رمز الخطأ.	`fault.name Matches "TokenExpired"`
`JWT.failed`	تحدِّد جميع سياسات JWT المتغيّر نفسه في حال تعذُّر التثبيت.	`JWT.failed = true`

مثال على الردّ على الخطأ

رموز الخطأ في سياسة JWT

مثال لقاعدة خطأ

    <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

أخطاء في وقت التشغيل

يمكن أن تحدث هذه الأخطاء عند تنفيذ السياسة.

رمز الخطأ	رموز حالة HTTP	السبب
`steps.xmlthreatprotection.ExecutionFailed`	500	يمكن أن تؤدي سياسة XMLThreatProtection إلى عدّة أنواع مختلفة من أخطاء التنفيذ الناجح. تحدث معظم هذه الأخطاء عند تجاوز حدّ معيّن تم ضبطه في السياسة. وتشمل أنواع الأخطاء هذه: طول اسم العنصر وعدد العناصر الثانوية وعمق العقدة وعدد السمات وطول اسم السمة، وغيرها الكثير. يمكنك الاطّلاع على القائمة الكاملة في موضوع تحديد مشاكل وقت تشغيل سياسة XMLThreatProtection وحلّها.
`steps.xmlthreatprotection.InvalidXMLPayload`	500	يحدث هذا الخطأ إذا لم تكن حمولة رسالة الإدخال التي حدّدها العنصر `<Source>` لسياسة XMLThreatProtection مستند XML صالحًا.
`steps.xmlthreatprotection.SourceUnavailable`	500	يحدث هذا الخطأ إذا كان متغيّر message المحدَّد في العنصر `<Source>` أيًا مما يلي: خارج النطاق (غير متاحة في المسار المحدّد الذي يتم فيه تنفيذ السياسة) القيمة ليست من القيم الصالحة `request` أو `response` أو `message`
`steps.xmlthreatprotection.NonMessageVariable`	500	يحدث هذا الخطأ عند ضبط العنصر `<Source>` على متغيّر ليس من نوع message.

ملاحظات:

اسم الخطأ Executionتعذّرت المعالجة هو اسم الخطأ التلقائي، وسيتم عرضه بغض النظر عن نوع الخطأ الذي تم رصده. ومع ذلك، يمكن تغيير هذا الإعداد التلقائي من خلال ضبط سمة على مستوى المؤسسة. عند ضبط هذه السمة، سيعكس اسم الخطأ الخطأ الفعلي. على سبيل المثال، "TextExceeded" أو "AttrValueExceeded". راجِع ملاحظات الاستخدام للحصول على التفاصيل.
الحالة 500 HTTP هي الحالة التلقائية، ولكن يمكن تغيير حالة HTTP إلى 400 في ما يتعلق بأخطاء تدفق الطلبات من خلال ضبط موقع على مستوى المؤسسة. راجِع ملاحظات الاستخدام للحصول على التفاصيل.

أخطاء النشر

بلا عُري

متغيرات الخطأ

المتغيرات	المكان	مثال
`fault.name="fault_name"`	`fault_name` هو اسم الخطأ، كما هو موضَّح في جدول أخطاء وقت التشغيل أعلاه. اسم الخطأ هو الجزء الأخير من رمز الخطأ.	`fault.name Matches "SourceUnavailable"`
`xmlattack.policy_name.failed`	`policy_name` هو اسم السياسة التي حدّدها المستخدم التي أدت إلى حدوث الخطأ.	`xmlattack.XPT-SecureRequest.failed = true`

مثال على الردّ على الخطأ

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

مثال لقاعدة خطأ

<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

أخطاء في وقت التشغيل

يمكن أن تحدث هذه الأخطاء عند تنفيذ السياسة.

رمز الخطأ	رموز حالة HTTP	السبب
`steps.xmltojson.ExecutionFailed`	500	يحدث هذا الخطأ عندما تكون حمولة بيانات الإدخال (XML) فارغة أو عندما يكون ملف XML الذي تم إدخاله غير صالح أو مشكّل بطريقة غير صحيحة.
`steps.xmltojson.InCompatibleType`	500	يحدث هذا الخطأ إذا كان نوع المتغيّر المحدّد في العنصر `<Source>` غير متطابق مع العنصر `<OutputVariable>`. ومن الضروري أن يتطابق نوع المتغيّرات المضمّنة في العنصر `<Source>` مع العنصر `<OutputVariable>`.
`steps.xmltojson.InvalidSourceType`	500	يحدث هذا الخطأ إذا كان نوع المتغيّر المستخدَم لتحديد العنصر `<Source>` غير صالح.أنواع المتغيّرات الصالحة هي الرسالة والسلسلة.
`steps.xmltojson.OutputVariableIsNotAvailable`	500	يحدث هذا الخطأ إذا كان المتغيّر المحدّد في العنصر `<Source>` لسياسة XML إلى JSON من نوع سلسلة ولم يتم تعريف العنصر `<OutputVariable>`. يكون العنصر `<OutputVariable>` إلزاميًا عندما يكون المتغيّر المحدّد في العنصر `<Source>` من نوع سلسلة.
`steps.xmltojson.SourceUnavailable`	500	يحدث هذا الخطأ إذا كان متغيّر message المحدَّد في العنصر `<Source>` لسياسة XML إلى JSON: خارج النطاق (غير متاح في المسار المحدّد الذي يتم فيه تنفيذ السياسة) أو لا يمكن حلها (غير محددة)

أخطاء النشر

يمكن أن تحدث هذه الأخطاء عند نشر خادم وكيل يحتوي على هذه السياسة.

اسم الخطأ	السبب	إصلاح
`EitherOptionOrFormat`	إذا لم تتم الإشارة إلى أحد العنصرَين `<Options>` أو `<Format>` في سياسة XML إلى JSON، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات.
`UnknownFormat`	إذا كان تنسيق العنصر `<Format>` ضمن سياسة XML إلى JSON غير معروف، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات. وتشمل التنسيقات المحدَّدة مسبقًا: `xml.com` و`yahoo` و`google` و`badgerFish`.

متغيرات الخطأ

المتغيرات	المكان	مثال
`fault.name="fault_name"`	`fault_name` هو اسم الخطأ، كما هو موضَّح في جدول أخطاء وقت التشغيل أعلاه. اسم الخطأ هو الجزء الأخير من رمز الخطأ.	`fault.name = "SourceUnavailable"`
`xmltojson.policy_name.failed`	`policy_name` هو اسم السياسة التي حدّدها المستخدم التي أدت إلى حدوث الخطأ.	`xmltojson.XMLtoJSON-1.failed = true`

مثال على الردّ على الخطأ

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

مثال لقاعدة خطأ

<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>

سياسة BigQueryransform

أخطاء في وقت التشغيل

يمكن أن تحدث هذه الأخطاء عند تنفيذ السياسة.

رمز الخطأ	رموز حالة HTTP	السبب	إصلاح
`steps.xsl.XSLSourceMessageNotAvailable`	500	يحدث هذا الخطأ إذا كان متغيّر الرسالة أو السلسلة المحدَّد في العنصر `<Source>` في سياسة XSL Transform خارج النطاق (أي أنّه غير متوفّر في المسار المحدّد الذي يتم فيه تنفيذ السياسة) أو لا يمكن حلّه (لم يتم تحديده).
`steps.xsl.XSLEvaluationFailed`	500	يحدث هذا الخطأ إذا كانت حمولة بيانات XML المدخلة غير متوفرة/غير صحيحة أو إذا تعذَّر أو يتعذّر على سياسة BigQueryransform تحويل ملف XML المدخل استنادًا إلى قواعد التحويل المتوفرة في ملف XSL. قد يكون هناك العديد من الأسباب المختلفة لتعذُّر تنفيذ سياسة WebRTC. سيوفر سبب عدم ظهور رسالة الخطأ مزيدًا من المعلومات حول السبب.

أخطاء النشر

يمكن أن تحدث هذه الأخطاء عند نشر خادم وكيل يحتوي على هذه السياسة.

اسم الخطأ	السبب	إصلاح
`XSLEmptyResourceUrl`	إذا كان العنصر `<ResourceURL>` في سياسة تحويل XSL فارغًا، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات.
`XSLInvalidResourceType`	إذا لم يكن نوع المورد المحدّد في العنصر `<ResourceURL>` ضمن سياسة XSL Transform من النوع `xsl`، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات.