تحديد المشاكل وحلّها في ما يتعلّق بنشر سياسة ذاكرة التخزين المؤقت للاستجابة

أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. info

InvalidTimeout

رسالة الخطأ

يتعذّر نشر خادم وكيل لواجهة برمجة التطبيقات من خلال واجهة مستخدم Edge أو واجهة برمجة تطبيقات إدارة Edge، وتظهر رسالة الخطأ التالية:

Error Saving Revision revision_number
CacheLookupTimeoutInSeconds value value should be greater than zero.

مثال على رسالة الخطأ

Error Saving Revision 2
CacheLookupTimeoutInSeconds -1 value should be greater than zero.

مثال على لقطة شاشة الخطأ

السبب

إذا تم ضبط العنصر <CacheLookupTimeoutInSeconds> في سياسة ResponseCache على رقم سالب، سيتعذّر نشر خادم وكيل لواجهة برمجة التطبيقات.

على سبيل المثال، إذا كانت قيمة <CacheLookupTimeoutInSeconds> هي -1، سيتعذّر نشر خادم وكيل لواجهة برمجة التطبيقات.

التشخيص

1. حدِّد القيمة غير الصالحة المستخدَمة للعنصر <CacheLookupTimeoutInSeconds> في سياسة ResponseCache. يمكنك العثور على هذه المعلومات في رسالة الخطأ. على سبيل المثال، في الخطأ التالي، القيمة غير الصالحة المستخدَمة للعنصر <CacheLookupTimeoutInSeconds> هي -1:

   CacheLookupTimeoutInSeconds -1 value should be greater than zero.
   

2. افحص جميع سياسات ResponseCache في خادم وكيل واجهة برمجة التطبيقات المحدّد الذي حدث فيه الخطأ. يمكن أن تكون هناك سياسة واحدة أو أكثر من سياسات ResponseCache التي تم فيها تحديد العنصر <CacheLookupTimeoutInSeconds>.

   على سبيل المثال، يضبط إعداد السياسة التالي <CacheLookupTimeoutInSeconds> على -1، وهو ما يتطابق مع ما ورد في رسالة الخطأ:

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <ResponseCache async="false" continueOnError="false" enabled="true" name="Response-Cache-1">
       <DisplayName>Response Cache-1</DisplayName>
       <Properties/>
       <CacheKey>
           <Prefix/>
           <KeyFragment ref="request.uri" type="string"/>
       </CacheKey>
       <Scope>Exclusive</Scope>
       <ExpirySettings>
           <ExpiryDate/>
           <TimeOfDay/>
           <TimeoutInSec ref="">3600</TimeoutInSec>
       </ExpirySettings>
       <CacheLookupTimeoutInSeconds>-1</CacheLookupTimeoutInSeconds>
   </ResponseCache>
   

3. إذا تم تحديد <CacheLookupTimeoutInSeconds> كعدد صحيح سالب، سيكون ذلك هو سبب الخطأ.

الدقة

تأكَّد من أنّ قيمة العنصر <CacheLookupTimeoutInSeconds> في سياسة ResponseCache يتم تحديدها دائمًا كعدد صحيح غير سالب.

لتصحيح مثال سياسة ResponseCache الموضّح أعلاه، يمكنك تعديل <CacheLookupTimeoutInSeconds> element إلى 30.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ResponseCache async="false" continueOnError="false" enabled="true" name="Response-Cache-1">
    <DisplayName>Response Cache-1</DisplayName>
    <Properties/>
    <CacheKey>
        <Prefix/>
        <KeyFragment ref="request.uri" type="string"/>
    </CacheKey>
    <Scope>Exclusive</Scope>
    <ExpirySettings>
        <ExpiryDate/>
        <TimeOfDay/>
        <TimeoutInSec ref="">3600</TimeoutInSec>
    </ExpirySettings>
    <CacheLookupTimeoutInSeconds>30</CacheLookupTimeoutInSeconds>
</ResponseCache>

InvalidCacheResourceReference

رسالة الخطأ

يتعذّر نشر خادم وكيل لواجهة برمجة التطبيقات من خلال واجهة مستخدم Edge أو واجهة برمجة تطبيقات إدارة Edge، وتظهر رسالة الخطأ التالية:

Error Deploying Revision revision_number to environment
Invalid cache resource reference cache_resource in Step definition response_cache_policy_name. Context Revision:revision_number;APIProxy:ResponseCache;Organization:organization;Environment:environment

مثال على رسالة الخطأ

Error Deploying Revision 2 to prod
Invalid cache resource reference itemscache in Step definition ItemsResponseCache. Context Revision:2;APIProxy:StoresInventory;Organization:kkalckstein-eval;Environment:prod

مثال على لقطة شاشة الخطأ

السبب

يحدث هذا الخطأ إذا تم ضبط العنصر <CacheResource> في سياسة ResponseCache على اسم غير متوفّر في البيئة التي يتم نشر خادم API الوكيل فيها.

التشخيص

1. حدِّد ذاكرة التخزين المؤقت غير الصالحة المستخدَمة في العنصر <CacheResource> من سياسة "ذاكرة التخزين المؤقت للاستجابة" والبيئة التي حدث فيها الخطأ. يمكنك العثور على كلتا القيمتين في رسالة الخطأ. على سبيل المثال، في الخطأ التالي، يكون اسم ذاكرة التخزين المؤقت غير الصالحة هو itemscache واسم البيئة هو prod.

   Invalid cache resource reference itemscache in Step definition ItemsResponseCache. Context Revision:2;APIProxy:StoresInventory;Organization:kkalckstein-eval;Environment:prod
   

2. افحص جميع سياسات ResponseCache في خادم وكيل واجهة برمجة التطبيقات المحدّد الذي حدث فيه الخطأ. حدِّد سياسة ResponseCache المحدّدة التي تم فيها تحديد ذاكرة التخزين المؤقت غير الصالحة (المحدّدة في الخطوة 1) في العنصر <CacheResource>.

   على سبيل المثال، تحدّد السياسة التالية قيمة <CacheResource> على أنّها itemscache، وهو ما يتطابق مع ما ورد في رسالة الخطأ:

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <ResponseCache async="false" continueOnError="false" enabled="true" name="ItemsResponseCache">
     <DisplayName>ItemsResponseCache</DisplayName>
     <Properties/>
     <CacheKey>
         <Prefix/>
         <KeyFragment ref="request.uri" type="string"/>
     </CacheKey>
     <CacheResource>itemscache</CacheResource>
     <Scope>Exclusive</Scope>
     <ExpirySettings>
         <ExpiryDate/>
         <TimeOfDay/>
         <TimeoutInSec ref="">3600</TimeoutInSec>
     </ExpirySettings>
     <SkipCacheLookup/>
     <SkipCachePopulation/>
   </ResponseCache>
   

3. تأكَّد مما إذا كان قد تم تحديد ذاكرة التخزين المؤقت (التي تم تحديدها في الخطوة 2) في البيئة المحدّدة (التي تم تحديدها في الخطوة 1).

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

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

   

   بما أنّ ذاكرة التخزين المؤقت التي تحمل الاسم itemscache غير محدّدة في بيئة prod، سيظهر لك الخطأ التالي:

   Invalid cache resource reference does_not_exist in Step definition Response-Cache-1. Context Revision:2;APIProxy:ResponseCache;Organization:kkalckstein-eval;Environment:prod
   

الدقة

تأكَّد من إنشاء اسم ذاكرة التخزين المؤقت المحدّد في العنصر <CacheResource> في البيئة التي تريد نشر خادم وكيل واجهة برمجة التطبيقات فيها.

راجِع إنشاء ذاكرة تخزين مؤقت للبيئة وتعديلها للحصول على معلومات حول كيفية إنشاء ذاكرة التخزين المؤقت.

ResponseCacheStepAttachmentNotAllowedReq

رسالة الخطأ

يتعذّر نشر خادم وكيل لواجهة برمجة التطبيقات من خلال واجهة مستخدم Edge أو واجهة برمجة تطبيقات إدارة Edge، وتظهر رسالة الخطأ التالية:

Error Deploying Revision revision_number to environment
Response cache step definition response_cache_policy_name can not be attached more than once in the request path.

مثال على رسالة الخطأ

Error Deploying Revision 2 to test
Response cache step definition Response-Cache-1 can not be attached more than once in the request path.

مثال على لقطة شاشة الخطأ

السبب

يحدث هذا الخطأ إذا تم ربط سياسة ResponseCache نفسها بمسارات طلبات متعددة ضمن أي تدفقات لخادم وكيل لواجهة برمجة التطبيقات.

على سبيل المثال، إذا كانت لديك سياسة ResponseCache نفسها مرفقة في Preflow لطلب كلّ من نقاط نهاية الخادم الوكيل ونقطة نهاية الهدف، سيحدث هذا الخطأ.

التشخيص

1. حدِّد اسم سياسة ResponseCache التي تم ربطها أكثر من مرة. يمكنك العثور على هذه المعلومات في رسالة الخطأ. على سبيل المثال، في الخطأ التالي، يكون اسم سياسة ResponseCache هو Response‑Cache‑1.

   Error Deploying Revision 2 to test
   Response cache step definition Response-Cache-1 can not be attached more than once in the request path.
   

2. افحص جميع مسارات الطلبات في خادم الوكيل ونقاط النهاية المستهدَفة لخادم وكيل واجهة برمجة التطبيقات حيث حدث الخطأ. إذا تم إرفاق سياسة ResponseCache نفسها في مسارَي طلب أو أكثر، سيكون ذلك هو سبب الخطأ.

   في المثال التالي، تم ضبط سياسة ResponseCache نفسها Response-Cache-1 في مسار الطلب لنقطة نهاية الخادم الوكيل التلقائية PreFlow، ونقطة نهاية الاستهداف التلقائية PreFlow:

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <ProxyEndpoint name="default">
       <Description/>
       <FaultRules/>
       <PreFlow name="PreFlow">
           <Request>
               <Step>
                   <Name>Response-Cache-1</Name>
               </Step>
           </Request>
       ...
   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <TargetEndpoint name="default">
       <Description/>
       <FaultRules/>
       <PreFlow name="PreFlow">
           <Request/>
           <Response/>
       </PreFlow>
       <PostFlow name="PostFlow">
           <Request>
               <Step>
                   <Name>Response-Cache-1</Name>
               </Step>
           </Request>
       ...
   

الدقة

تأكَّد من ربط سياسة ResponseCache بمسار طلب واحد فقط في جميع مسارات خادم وكيل واجهة برمجة التطبيقات.

لتصحيح المثال الموضّح أعلاه، أزِل سياسة ResponseCache Response-Cache-1 من أحد مسارَي الطلب.

ResponseCacheStepAttachmentNotAllowedResp

رسالة الخطأ

يتعذّر نشر خادم وكيل لواجهة برمجة التطبيقات من خلال واجهة مستخدم Edge أو واجهة برمجة تطبيقات إدارة Edge، وتظهر رسالة الخطأ التالية:

Error Deploying Revision revision_number to environment
Response cache step definition response_cache_policy_name can not be attached more than once in the response path.

مثال على رسالة الخطأ

Error Deploying Revision 2 to test
Response cache step definition Response-Cache-1 can not be attached more than once in the response path.

مثال على لقطة شاشة الخطأ

السبب

يحدث هذا الخطأ إذا تم ربط سياسة ResponseCache نفسها بمسارات استجابة متعددة ضمن أي تدفقات لخادم وكيل لواجهة برمجة التطبيقات.

على سبيل المثال، إذا كانت لديك السياسة نفسها ResponseCache مرفقة في Preflow الاستجابة لكلّ من نقاط نهاية الوكيل والهدف، سيحدث هذا الخطأ.

التشخيص

1. حدِّد اسم سياسة ResponseCache التي تم ربطها أكثر من مرة. يمكنك العثور على هذه المعلومات في رسالة الخطأ. على سبيل المثال، في الخطأ التالي، يكون اسم سياسة ResponseCache هو Response-Cache-1.

   Error Deploying Revision 2 to test
   Response cache step definition Response-Cache-1 can not be attached more than once in the response path.
   

2. افحص جميع مسارات الطلبات في خادم الوكيل ونقاط النهاية المستهدَفة لخادم وكيل واجهة برمجة التطبيقات حيث حدث الخطأ. إذا تم إرفاق سياسة ResponseCache نفسها في مسارَي ردّ أو أكثر، سيكون ذلك هو سبب الخطأ.

   في المثال التالي، يتم ضبط سياسة ResponseCache نفسها Response-Cache-1 في مسار الردّ لنقطة نهاية الخادم الوكيل التلقائية PreFlow، ونقطة نهاية الاستهداف التلقائية PreFlow:

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <ProxyEndpoint name="default">
       <Description/>
       <FaultRules/>
       <PreFlow name="PreFlow">
           <Request>
               <Step>
                   <Name>Response-Cache</Name>
               </Step>
           </Request>
           <Response>
               <Step>
                   <Name>Response-Cache-1</Name>
               </Step>
           </Response>
       </PreFlow>
       ...
   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <TargetEndpoint name="default">
       <Description/>
       <FaultRules/>
       <PreFlow name="PreFlow">
           <Request/>
           <Response/>
       </PreFlow>
       <PostFlow name="PostFlow">
           <Request/>
           <Response>
               <Step>
                   <Name>Response-Cache-1</Name>
               </Step>
           </Response>
       </PostFlow>
       ...
   

الدقة

تأكَّد من ربط سياسة ResponseCache بمسار استجابة واحد فقط في جميع مسارات خادم وكيل واجهة برمجة التطبيقات.

لتصحيح المثال الموضّح أعلاه، عليك إزالة سياسة ResponseCache Response-Cache-1 من أحد مسارَي الردّ.

InvalidMessagePatternForErrorCode

رسالة الخطأ

يتعذّر نشر خادم وكيل لواجهة برمجة التطبيقات من خلال واجهة مستخدم Edge أو واجهة برمجة تطبيقات إدارة Edge، وتظهر إحدى رسالتَي الخطأ التاليتين:

Error Deploying Revision revision_number to environment
Invalid message pattern found for error code steps.cache.InvalidSkipCacheLookUpCondition.

أو

Error Deploying Revision revision_number to environment
Invalid message pattern found for error code steps.cache.InvalidSkipCachePopulationCondition.

مثال على رسالة الخطأ

Error Deploying Revision 2 to prod
Invalid message pattern found for error code steps.cache.InvalidSkipCacheLookUpCondition.

أو

Error Deploying Revision 2 to prod
Invalid message pattern found for error code steps.cache.InvalidSkipCachePopulationCondition.

مثال على لقطة شاشة الخطأ

أو

السبب

يحدث هذا الخطأ إذا كان العنصر <SkipCacheLookup> أو <SkipCachePopulation> في سياسة ResponseCache يحتوي على شرط غير صالح.

التشخيص

1. افحص جميع سياسات ResponseCache في خادم API الوكيل الذي حدث فيه الخطأ وتحقّق مما إذا كانت هناك أي سياسات تتضمّن شروطًا محدّدة للعنصرين <SkipCacheLookup> و/أو <SkipCachePopulation>.

2. تحقَّق مما إذا كانت الحالة المحدّدة للعنصر <SkipCacheLookup> و/أو العنصر <SkipCachePopulation> غير صالحة. إذا كانت الإجابة بنعم، هذا هو سبب الخطأ.

   في المثال التالي، يستخدم العنصر <SkipCachePopulation> عامل JavaScript === للتحقّق من تساوي القيمة والنوع، وهو أمر غير صالح.

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <ResponseCache async="false" continueOnError="false" enabled="true" name="Response-Cache-1">
       <DisplayName>Response Cache-1</DisplayName>
       <Properties/>
       <CacheKey>
           <Prefix/>
           <KeyFragment ref="request.uri" type="string"/>
       </CacheKey>
       <Scope>Exclusive</Scope>
       <ExpirySettings>
           <ExpiryDate/>
           <TimeOfDay/>
           <TimeoutInSec ref="">3600</TimeoutInSec>
       </ExpirySettings>
       <CacheLookupTimeoutInSeconds>2</CacheLookupTimeoutInSeconds>
       <SkipCacheLookup>request.header.bypass-cache === "true"</SkipCacheLookup>
   </ResponseCache>
   

   بما أنّ عامل التشغيل === غير صالح، سيظهر لك الخطأ التالي:

   Invalid message pattern found for error code steps.cache.InvalidSkipCacheLookUpCondition.
   

الدقة

احرص على أن تكون الحالة المحدّدة للعنصر <SkipCacheLookup> و/أو العنصر <SkipCachePopulation> صالحة دائمًا.

لتصحيح مثال سياسة ResponseCache الموضّحة أعلاه، يمكنك تعديل <SkipCacheLookup> لاستخدام عامل التشغيل =:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ResponseCache async="false" continueOnError="false" enabled="true" name="Response-Cache-1">
    <DisplayName>Response Cache-1</DisplayName>
    <Properties/>
    <CacheKey>
        <Prefix/>
        <KeyFragment ref="request.uri" type="string"/>
    </CacheKey>
    <Scope>Exclusive</Scope>
    <ExpirySettings>
        <ExpiryDate/>
        <TimeOfDay/>
        <TimeoutInSec ref="">3600</TimeoutInSec>
    </ExpirySettings>
    <CacheLookupTimeoutInSeconds>2</CacheLookupTimeoutInSeconds>
    <SkipCacheLookup>request.header.bypass-cache = "true"</SkipCacheLookup>
</ResponseCache>

CacheNotFound

رسالة الخطأ

يؤدي نشر خادم وكيل لواجهة برمجة التطبيقات من خلال واجهة مستخدم Edge أو واجهة برمجة تطبيقات إدارة Edge إلى ظهور رسالة خطأ على النحو التالي، ويتم وضع علامة "تم النشر جزئيًا" على حالة نشر خادم وكيل لواجهة برمجة التطبيقات:

Error: Cache : cache_resource, not found in organization : organization__environment.

مثال على رسالة الخطأ

Error Cache : Response-Cache-1, not found in organization : kkalckstein-eval__prod

السبب

يحدث هذا الخطأ إذا لم يتم إنشاء ذاكرة التخزين المؤقت المحدّدة المذكورة في رسالة الخطأ على أحد مكونات "معالج الرسائل".

الدقة

إذا كنت تستخدم السحابة الإلكترونية الخاصة، اتّبِع التعليمات التالية:

1. أدرِج عمليات نشر خادم وكيل لواجهة برمجة التطبيقات وحدِّد "معالِجات الرسائل" التي تتضمّن الخطأ steps.cache.CacheNotFound.

   مثال على الناتج

   curl -u $USERID:$USERPASSWORD http://<management-server-host>:8080/v1/organizations/<org-name>/environments/<env-name>/apis/<apiproxy-name>/revisions/<revision-number>/deployments
   {
     "aPIProxy" : "ResponseCache",
     "environment" : [ {
       "configuration" : {
         "basePath" : "/",
         "configVersion" : "SHA-512:45d3f39783414d3859bf2dec4135d8f5f9960ee6b2d361db2799c82693a8e3f8b95dbbb37c547eb3c0a3819d8ca51727f390502bcaefdf1f113263521a9023b6",
         "steps" : [ ]
       },
       "name" : "prod",
       "server" : [ {
         "pod" : {
           "name" : "pod1",
           "region" : "us-central1"
         },
         "status" : "deployed",
         "type" : [ "message-processor" ],
         "uUID" : "f2e5e34a-5630-43a9-8fef-48a5b9da76d1"
       }, {
         "pod" : {
           "name" : "pod1",
           "region" : "us-central1"
         },
         "status" : "deployed",
         "type" : [ "message-processor" ],
         "uUID" : "879a6538-a5e0-4503-b142-9cb2b4e0623d"
       }, {
       "error" : "Cache : Response-Cache-1, not found in organization : kkalckstein-eval__prod",
       "errorCode" : "steps.cache.CacheNotFound",
       "status" : "error",
       "type" : [ "message-processor" ],
        "uUID" : "a8f9ce0b-c32d-48a9-b26c-9c75d8bf467d"
   },
   ...
       "state" : "deployed"
     } ],
     "name" : "2",
     "organization" : "kkalckstein-eval"
   

2. دوِّن معرّفات UUID الخاصة بـ "معالج الرسائل" التي يظهر فيها الخطأ steps.cache.CacheNotFound. تحديد اسم المضيف/عنوان IP الخاص بـ "معالج الرسائل" من رقم التعريف الفريد العالمي (UUID)

3. سجِّل الدخول إلى "معالج الرسائل" المحدّد وأعِد تشغيله باستخدام الأمر التالي:

   apigee-service edge-message-processor restart

إذا كنت من مستخدمي السحابة الإلكترونية العامة أو إذا استمرت المشكلة في السحابة الإلكترونية الخاصة، يُرجى التواصل مع فريق دعم Apigee للحصول على المساعدة.