रनटाइम से जुड़ी गड़बड़ियों का कैटलॉग

Apigee Edge का दस्तावेज़ देखा जा रहा है.
Apigee X के दस्तावेज़ पर जाएं. जानकारी

Apigee Edge में गड़बड़ियां

जब Apigee Edge के ज़रिए एपीआई अनुरोध किए जाते हैं, तो Apigee Edge के कॉम्पोनेंट राउटर और मैसेज प्रोसेसर या बैकएंड सर्वर, क्लाइंट ऐप्लिकेशन को गड़बड़ियां दिखा सकते हैं.

मैसेज प्रोसेसर से जुड़ी गड़बड़ियां

मैसेज प्रोसेसर, Apigee Edge का मुख्य कॉम्पोनेंट है. यह नीतियों को प्रोसेस करता है और बैकएंड सर्वर के साथ इंटरैक्ट करता है. अगर कोई समस्या मिलती है, तो यह गड़बड़ियां दिखा सकता है. जैसे:

  • इंटरनेट कनेक्शन से जुड़ी समस्याएं, टीएलएस हैंडशेक की प्रक्रिया पूरी न हो पाना, बैकएंड सर्वर का उपलब्ध न होना, बैकएंड सर्वर से कम्यूनिकेट करने के दौरान जवाब न मिलना
  • नीति के पालन के दौरान होने वाली गड़बड़ियां
  • अमान्य एचटीटीपी हेडर, एन्कोडिंग, पाथ, एचटीटीपी की खास बातों का पालन न करना, प्रॉडक्ट की सीमाओं से ज़्यादा प्रॉडक्ट शामिल करना वगैरह:
    • क्लाइंट ऐप्लिकेशन से भेजे गए एचटीटीपी अनुरोध के साथ

      • या

    • बैकएंड सर्वर से भेजे गए एचटीटीपी रिस्पॉन्स के साथ
  • और भी बहुत कुछ

मैसेज प्रोसेसर से सैंपल में गड़बड़ी हुई

मैसेज प्रोसेसर हमेशा एचटीटीपी स्टेटस कोड के साथ-साथ, गड़बड़ी का मैसेज और JSON फ़ॉर्मैट में गड़बड़ी का कोड दिखाता है. उदाहरण के लिए:

क्लाइंट ऐप्लिकेशन को रिस्पॉन्स कोड मिलता है. इसका उदाहरण नीचे दिया गया है: 

HTTP/1.1 414 Request-URI Too Long

मैसेज प्रोसेसर से गड़बड़ी का रिस्पॉन्स, इस फ़ॉर्मैट में दिखता है: 

{
   "fault":{
      "faultstring":"request line size exceeding 7,168",
      "detail":{
         "errorcode":"protocol.http.TooBigLine"
      }
   }
}

गड़बड़ी के जवाब में मौजूद फ़ील्ड की जानकारी:

फ़ील्ड ब्यौरा
faultstring इसमें गड़बड़ी का मैसेज होता है, जिसमें गड़बड़ी की संभावित वजह के बारे में बताया जाता है
errorcode गड़बड़ी से जुड़ा गड़बड़ी कोड (इसे गड़बड़ी का कोड भी कहा जाता है)

रनटाइम से जुड़ी गड़बड़ी का कैटलॉग

गड़बड़ी के इस कैटलॉग में, रनटाइम के दौरान दिखने वाली गड़बड़ी के कोड के बारे में पूरी जानकारी दी गई है. ये कोड, नीति से जुड़ी गड़बड़ियों के लिए नहीं होते. ये कोड, Apigee Edge Message Processor कॉम्पोनेंट से दिखाए जाते हैं. इसमें हर गड़बड़ी कोड के लिए यह जानकारी शामिल होती है:

  • एचटीटीपी स्टेटस कोड
  • गड़बड़ी का मैसेज
  • गड़बड़ी की संभावित वजहें
  • एचटीटीपी से जुड़ी कोई खास जानकारी और/या प्रॉडक्ट की सीमाएं
  • गड़बड़ी की वजह का पता लगाने के लिए निर्देश देने वाली प्लेबुक और वीडियो. साथ ही, उन गड़बड़ियों को खुद ठीक करने के लिए, कारगर समाधान (जहां उपलब्ध हों)
  • गड़बड़ी को खुद ठीक करने के लिए, लागू किया जा सकने वाला तरीका

गड़बड़ी कोड की ये कैटगरी शामिल हैं:

किसी खास गड़बड़ी कोड के लिए ऊपर दी गई जानकारी देखने के लिए, टेबल को फ़िल्टर करें. इसके लिए, नीचे दिए गए खोजें बॉक्स का इस्तेमाल करें. टेबल में मौजूद किसी भी फ़ील्ड में, स्टेटस कोड या किसी भी कॉन्टेंट को खोजा जा सकता है.

गड़बड़ी का कोड ब्यौरा ठीक करें

flow.*

flow.APITimedOut
  • एचटीटीपी स्टेटस कोड:
 504 Gateway Timeout
  • गड़बड़ी का मैसेज:
 API timed out
  • संभावित वजह:

यह गड़बड़ी तब होती है, जब:

  • बैकएंड सर्वर, किसी खास एपीआई प्रॉक्सी के लिए, प्रॉपर्टी api.timeout से कॉन्फ़िगर किए गए टाइम आउट की अवधि के अंदर जवाब नहीं देता.
  • ज़्यादा गणना वाले ऑपरेशन, ज़्यादा ट्रैफ़िक या खराब परफ़ॉर्मेंस की वजह से, नीति लागू होने में ज़्यादा समय लगता है.

ध्यान दें: इस प्लेबुक में, गड़बड़ी के कोड messaging.adaptors.http.flow.GatewayTimeout को हल करने के निर्देश दिए गए हैं. हालांकि, flow.APITimedOut गड़बड़ी के कोड को हल करने के लिए भी, इस प्लेबुक का इस्तेमाल किया जा सकता है.

प्लेबुक

flow.SharedFlowNotFound
  • एचटीटीपी स्टेटस कोड:
 500 Internal Server Error
  • गड़बड़ी का मैसेज:
 Shared Flow {shared_flow_name} Not Found
  • संभावित वजह:

यह गड़बड़ी तब होती है, जब शेयर किया गया कोई फ़्लो:

  • मौजूद नहीं है

    • या

  • मौजूद है, लेकिन डिप्लॉय नहीं किया गया है
प्लेबुक

messaging.adaptors.http.flow

messaging.adaptors.http.flow.ApplicationNotFound
  • एचटीटीपी स्टेटस कोड:
 404 Not Found
  • गड़बड़ी का मैसेज:
 Unable to identify proxy for host: {virtual_host} and url: {pathsuffix}
  • संभावित वजह:

यह गड़बड़ी, इनमें से किसी एक स्थिति में होती है:

  1. एपीआई प्रॉक्सी यह है:
    1. किसी चुनिंदा वर्चुअल होस्ट पर अनुरोध स्वीकार करने के लिए कॉन्फ़िगर नहीं किया गया है
    2. अनुरोध में इस्तेमाल किए गए किसी खास पाथ पर अनुरोध स्वीकार करने के लिए कॉन्फ़िगर नहीं किया गया है
    3. उस खास एनवायरमेंट में डिप्लॉय नहीं किया गया है जिसमें एपीआई अनुरोध किए जा रहे हैं
    4. एक या उससे ज़्यादा मैसेज प्रोसेसर पर डिप्लॉय नहीं किया गया है
  2. एपीआई अनुरोध करने के लिए इस्तेमाल किया जा रहा खास एनवायरमेंट, एक या उससे ज़्यादा मैसेज प्रोसेसर पर लोड नहीं हुआ है
 प्लेबुक
यह गड़बड़ी तब भी आ सकती है, जब एक से ज़्यादा वर्चुअल होस्ट के होस्ट का उपनाम और पोर्ट नंबर एक ही हो. प्लेबुक

messaging.adaptors.http.flow.DecompressionFailureAtRequest
  • एचटीटीपी स्टेटस कोड:
 400 Bad Request
  • गड़बड़ी का मैसेज:
 Decompression failure at request
  • संभावित वजह:

यह गड़बड़ी सिर्फ़ तब होती है, जब:

  • एचटीटीपी अनुरोध हेडर में बताई गई एन्कोडिंग Content-Encoding मान्य है और यह Apigee Edge के साथ काम करती है,

    • लेकिन

  • एचटीटीपी अनुरोध के हिस्से के तौर पर क्लाइंट से भेजा गया पेलोड फ़ॉर्मैट, Content-Encoding हेडर में बताए गए एन्कोडिंग फ़ॉर्मैट से मेल नहीं खाता
प्लेबुक

messaging.adaptors.http.flow.DecompressionFailureAtResponse
  • एचटीटीपी स्टेटस कोड:
 502 Bad Gateway
  • गड़बड़ी का मैसेज:
 Decompression failure at response
  • संभावित वजह:

यह गड़बड़ी सिर्फ़ तब होती है, जब:

  • बैकएंड/टारगेट सर्वर के एचटीटीपी रिस्पॉन्स हेडर Content-Encoding में बताई गई एन्कोडिंग मान्य हो और वह Apigee Edge के साथ काम करती हो,

    • लेकिन

  • एचटीटीपी रिस्पॉन्स के हिस्से के तौर पर, बैकएंड/टारगेट सर्वर से भेजा गया पेलोड फ़ॉर्मैट, Content-Encoding हेडर में बताए गए एन्कोडिंग फ़ॉर्मैट से मेल नहीं खाता
प्लेबुक

messaging.adaptors.http.flow.ErrorResponseCode
  • एचटीटीपी स्टेटस कोड:
 500

प्लेबुक

वीडियो

  • गड़बड़ी का मैसेज:
 बैकएंड सर्वर के लागू होने के तरीके के हिसाब से, गड़बड़ी का मैसेज और फ़ॉर्मैट अलग-अलग हो सकता है.
  • संभावित वजह:
 यह गड़बड़ी तब होती है, जब बैकएंड सर्वर, Apigee Edge को स्टेटस कोड 500 के साथ जवाब देता है.
  • एचटीटीपी स्टेटस कोड:
 503

प्लेबुक

वीडियो

  • गड़बड़ी का मैसेज:
 बैकएंड सर्वर के लागू होने के तरीके के हिसाब से, गड़बड़ी का मैसेज और फ़ॉर्मैट अलग-अलग हो सकता है.
  • संभावित वजह:
 यह गड़बड़ी तब होती है, जब बैकएंड सर्वर, Apigee Edge को स्टेटस कोड 503 के साथ जवाब देता है.
  • एचटीटीपी स्टेटस कोड:
 504 PLAYBOOK
  • गड़बड़ी का मैसेज:
 बैकएंड सर्वर के लागू होने के तरीके के हिसाब से, गड़बड़ी का मैसेज और फ़ॉर्मैट अलग-अलग हो सकता है.
  • संभावित वजह:
 यह गड़बड़ी तब होती है, जब बैकएंड सर्वर, Apigee Edge को स्टेटस कोड 504 के साथ जवाब देता है.

ध्यान दें: क्लाइंट ऐप्लिकेशन को भेजे गए गड़बड़ी के मैसेज के हिस्से के तौर पर, गड़बड़ी का कोड messaging.adaptors.http.flow.ErrorResponseCode नहीं दिखाया जाता. ऐसा इसलिए होता है, क्योंकि जब भी बैकएंड सर्वर, गड़बड़ी और 4XX या 5XX में से किसी भी स्टेटस कोड के साथ जवाब देता है, तो Apigee Edge इस गड़बड़ी कोड को सेट करता है. गड़बड़ी के इस कोड को एपीआई मॉनिटरिंग, NGINX ऐक्सेस लॉग या आंकड़ों के डेटाबेस में देखा जा सकता है.

messaging.adaptors.http.flow.GatewayTimeout
  • एचटीटीपी स्टेटस कोड:
 504 Gateway Timeout
  • गड़बड़ी का मैसेज:
 Gateway Timeout
  • संभावित वजह:
 यह गड़बड़ी तब होती है, जब मैसेज प्रोसेसर पर कॉन्फ़िगर की गई I/O टाइम आउट अवधि के अंदर बैकएंड सर्वर, Apigee Edge मैसेज प्रोसेसर को जवाब नहीं देता है.
प्लेबुक

messaging.adaptors.http.flow.LengthRequired
  • एचटीटीपी स्टेटस कोड:
 411 Length Required
  • गड़बड़ी का मैसेज:
 'Content-Length' is missing
  • संभावित वजह:

यह गड़बड़ी तब होती है, जब Apigee Edge को भेजे गए एचटीटीपी POST और PUT अनुरोधों के हिस्से के तौर पर, क्लाइंट ऐप्लिकेशन से Content-Length हेडर पास नहीं किया जाता.

ध्यान दें: इस गड़बड़ी की वजह से जो अनुरोध पूरे नहीं होते उन्हें ट्रेस टूल में कैप्चर नहीं किया जा सकता. ऐसा इसलिए, क्योंकि मैसेज प्रोसेसर, अनुरोध को प्रोसेस करने और एपीआई प्रॉक्सी में किसी भी नीति को लागू करने से काफ़ी पहले, इस पुष्टि की प्रोसेस को पूरा करता है.
  • एचटीटीपी स्पेसिफ़िकेशन:
 आरएफ़सी सेक्शन 3.3.2: Content-Length

ठीक करें

इस गड़बड़ी को ठीक करने के लिए, नीचे दिया गया तरीका अपनाएं:

  1. पक्का करें कि क्लाइंट ऐप्लिकेशन, Apigee Edge को भेजे गए एचटीटीपी POST और PUT अनुरोधों के हिस्से के तौर पर, हेडर Content-Length को हमेशा पास करता हो. उदाहरण के लिए:

    curl -X POST https://HOSTALIAS/PATH -d '{"name": "abc"}' -H "Content-Length: 15"

  2. भले ही, POST और PUT अनुरोधों के साथ खाली पेलोड पास किया जा रहा हो, फिर भी पक्का करें कि हेडर Content-Length: 0 पास किया गया हो. उदाहरण के लिए:

    curl -X POST https://HOSTALIAS/PATH -H "Content-Length: 0"

messaging.adaptors.http.flow.NoActiveTargets
  • एचटीटीपी स्टेटस कोड:
 503 Service Unavailable
  • गड़बड़ी का मैसेज:
 The Service is temporarily unavailable
  • संभावित वजह:

Apigee Edge में TargetServer का इस्तेमाल करने पर, यह गड़बड़ी इनमें से किसी एक स्थिति में होती है:

  1. कस्टम ऑथराइज़ेशन सर्वर की मदद से, बैकएंड सर्वर होस्ट के गलत डीएनएस रिज़ॉल्यूशन की वजह से, आईपी पतों में गड़बड़ी हुई. इसकी वजह से, कनेक्शन से जुड़ी गड़बड़ियां हुईं.
  2. कनेक्शन टाइम आउट की गड़बड़ियां इन वजहों से होती हैं:
    1. बैकएंड सर्वर पर फ़ायरवॉल की पाबंदी, Apigee Edge को बैकएंड सर्वर से कनेक्ट होने से रोकती है.
    2. Apigee Edge और बैकएंड सर्वर के बीच नेटवर्क कनेक्टिविटी से जुड़ी समस्याएं.
  3. TargetServer में दिया गया होस्ट गलत है या इसमें अनचाहे वर्ण (जैसे, स्पेस) हैं.

प्लेबुक

वीडियो
यह गड़बड़ी तब भी हो सकती है, जब टारगेट सर्वर की परफ़ॉर्मेंस की जांच पर नज़र रखने के लिए कॉन्फ़िगर की गई जांच काम न करे.

प्लेबुक

वीडियो

messaging.adaptors.http.flow.RequestTimeOut
  • एचटीटीपी स्टेटस कोड:
 408 Request Timeout
  • गड़बड़ी का मैसेज:
 Request timed out
  • संभावित वजह:
 यह गड़बड़ी तब होती है, जब Message Processor कॉम्पोनेंट पर कॉन्फ़िगर किए गए I/O टाइम आउट अवधि के लिए, Apigee Edge Message Processor को क्लाइंट ऐप्लिकेशन से अनुरोध पेलोड नहीं मिलता.

ठीक करें

पक्का करें कि क्लाइंट ऐप्लिकेशन, अनुरोध का पेलोड, Apigee Edge के मैसेज प्रोसेसर कॉम्पोनेंट पर कॉन्फ़िगर किए गए I/O टाइम आउट अवधि के अंदर भेजे.

messaging.adaptors.http.flow.ServiceUnavailable
  • एचटीटीपी स्टेटस कोड:
 503 Service Unavailable
  • गड़बड़ी का मैसेज:
 The Service is temporarily unavailable
  • संभावित वजह:

यह गड़बड़ी इनमें से किसी एक स्थिति में होती है:

  1. कस्टम ऑथराइज़ेशन सर्वर की मदद से, बैकएंड सर्वर के गलत डीएनएस रिज़ॉल्यूशन की वजह से, आईपी पतों में गड़बड़ी हुई. इस वजह से, कनेक्शन से जुड़ी गड़बड़ियां हुईं.
  2. कनेक्शन का समय खत्म होने में होने वाली गड़बड़ियां, इस वजह से होती हैं:
    1. बैकएंड सर्वर पर फ़ायरवॉल की पाबंदी, Apigee Edge को बैकएंड सर्वर से कनेक्ट होने से रोकती है.
    2. Apigee Edge और बैकएंड सर्वर के बीच नेटवर्क कनेक्शन से जुड़ी समस्याएं.
  3. टारगेट एंडपॉइंट में तय किया गया टारगेट सर्वर होस्ट गलत है या उसमें अनचाहे वर्ण (जैसे, स्पेस) हैं.

PLAYBOOK

DNS विफलता:

वीडियो

नेटवर्क कनेक्टिविटी:

वीडियो
यह गड़बड़ी तब भी आ सकती है, जब बैकएंड सर्वर समय से पहले कनेक्शन बंद कर दे. इस दौरान, मैसेज प्रोसेसर, बैकएंड सर्वर को अनुरोध पेलोड भेज रहा होगा. प्लेबुक

messaging.adaptors.http.flow.SslHandshakeFailed
  • एचटीटीपी स्टेटस कोड:
 503 Service Unavailable
  • गड़बड़ी का मैसेज:
 SSL Handshake failed {error_message}
  • संभावित वजह:

यह गड़बड़ी, Apigee Edge के मैसेज प्रोसेसर और बैकएंड सर्वर के बीच एसएसएल हैंडशेक प्रोसेस के दौरान तब होती है, जब:

  1. Apigee Edge के मैसेज प्रोसेसर का ट्रस्टस्टोर:
    • इसमें एक ऐसी सर्टिफ़िकेट चेन शामिल है जो बैकएंड सर्वर की पूरी सर्टिफ़िकेट चेन से मेल नहीं खाती

      • या

    • इसमें बैकएंड सर्वर की पूरी सर्टिफ़िकेट चेन शामिल नहीं है
  2. बैकएंड सर्वर से मिली सर्टिफ़िकेट चेन:
    • इसमें ऐसा एफ़क्यूडीएन शामिल है जो टारगेट एंडपॉइंट में बताए गए होस्ट नेम से मेल नहीं खाता

      • या

    • इसमें गलत/अधूरी सर्टिफ़िकेट चेन है

प्लेबुक

वीडियो

messaging.adaptors.http.flow.UnexpectedEOFAtTarget
  • एचटीटीपी स्टेटस कोड:
 502 Bad Gateway
  • गड़बड़ी का मैसेज:
 Unexpected EOF at target
  • संभावित वजह:

यह गड़बड़ी इनमें से किसी एक स्थिति में होती है:

  1. Apigee Edge में TLS/SSL कनेक्शन के साथ काम करने के लिए, TargetServer को ठीक से कॉन्फ़िगर नहीं किया गया है.
  2. जब Apigee Edge, बैकएंड सर्वर से जवाब का इंतज़ार कर रहा हो, तब बैकएंड सर्वर अचानक कनेक्शन बंद कर सकता है.
  3. Apigee और बैकएंड सर्वर पर, अलाइव टाइम आउट को गलत तरीके से कॉन्फ़िगर करके रखें.
प्लेबुक

messaging.runtime.*

messaging.runtime.RouteFailed
  • एचटीटीपी स्टेटस कोड:
 500 Internal Server Error
  • गड़बड़ी का मैसेज:
 Unable to route the message to a TargetEndpoint
  • संभावित वजह:

यह गड़बड़ी तब होती है, जब Apigee Edge, किसी भी TargetEndपॉइंट पर अनुरोध को रूट नहीं कर पाता है, क्योंकि:

  • कोई ऐसा रूट नियम (<RouteRule>) शर्त नहीं है जो प्रोक्सी में अनुरोध से मैच करता हो

    • और

  • ProxyEndpoint में, रूट का कोई डिफ़ॉल्ट नियम तय नहीं किया गया है (यानी, <RouteRule> बिना किसी शर्त के)

ठीक करें

इस गड़बड़ी को ठीक करने के लिए, यह तरीका अपनाएं:

  1. अपने ProxyEndpoint में बताए गए रूट नियमों की समीक्षा करें और उनमें बदलाव करें, ताकि यह पक्का किया जा सके कि आपके अनुरोध से मेल खाने वाला कम से कम एक रूट नियम हो.
  2. अगर आपके पास कई RouteRules हैं, तो बिना किसी शर्त के डिफ़ॉल्ट रूट नियम तय करना एक अच्छा तरीका है.
  3. पक्का करें कि डिफ़ॉल्ट रूट का नियम, शर्तों पर आधारित रूट की सूची में हमेशा सबसे आखिर में दिया गया हो, क्योंकि ProxyEndpoint में नियमों का आकलन ऊपर से नीचे की ओर किया जाता है.

ProxyEndpoint में <RouteRule> शर्तों को तय करने के बारे में ज़्यादा जानने के लिए, शर्तों के हिसाब से टारगेट देखें.

messaging.runtime.SenseRaiseFault
  • एचटीटीपी स्टेटस कोड:
 403 Forbidden
  • गड़बड़ी का मैसेज:
 Sense Fault
  • संभावित वजह:
 यह गड़बड़ी तब होती है, जब एपीआई अनुरोध किसी ऐसे क्लाइंट आईपी पते से किया जाता है जिसे Apigee Sense के नियमों के तहत ब्लॉक किया गया हो.

ठीक करें

इस गड़बड़ी को ठीक करने के लिए, इन निर्देशों का पालन करें:

  1. पुष्टि करें कि आपने किसी क्लाइंट के आईपी पते को ब्लॉक किया है. इसके लिए, Apigee Sense में कॉन्फ़िगर किए गए नियमों की जांच करें. अगर यह ब्लॉक है, तो इसका मतलब है कि यह सही तरीके से काम कर रहा है.
  2. अगर किसी क्लाइंट के आईपी पते को ब्लॉक नहीं किया गया है, लेकिन आपको अब भी यह गड़बड़ी दिख रही है, तो Apigee Edge की सहायता टीम से संपर्क करें.

protocol.http.* - Caused due to bad request

protocol.http.BadFormData
  • एचटीटीपी स्टेटस कोड:
 500 Internal Server Error
  • गड़बड़ी का मैसेज:
 Bad Form Data
  • संभावित वजह:

यह गड़बड़ी सिर्फ़ तब होती है, जब ये सभी शर्तें पूरी होती हैं:

  1. क्लाइंट ने Apigee Edge को जो एचटीटीपी अनुरोध भेजा है उसमें ये चीज़ें शामिल हैं:
    • Content-Type: application/x-www-form-urlencoded, और
    • फ़ॉर्म में प्रतिशत के निशान (%) के साथ डेटा या प्रतिशत के निशान (%) के बाद अमान्य हेक्साडेसिमल वर्ण, जो फ़ॉर्म - सेक्शन 17.13.4.1 के मुताबिक इस्तेमाल करने की अनुमति नहीं है.
  2. Apigee Edge में एपीआई प्रॉक्सी, उन खास फ़ॉर्म पैरामीटर को पढ़ता है जिनमें ऐसे वर्ण होते हैं जिनका इस्तेमाल, अनुरोध फ़्लो में ExtractVariables या AssignMessage नीति का इस्तेमाल करके नहीं किया जा सकता.
प्लेबुक

protocol.http.DuplicateHeader
  • एचटीटीपी स्टेटस कोड:
 400 Bad Request
  • गड़बड़ी का मैसेज:
 Duplicate Header "{header_name}"
  • संभावित वजह:
 यह गड़बड़ी तब होती है, जब क्लाइंट ऐप्लिकेशन से Apigee Edge को भेजे गए एचटीटीपी अनुरोध के हिस्से के तौर पर, कोई ऐसा एचटीटीपी हेडर एक से ज़्यादा बार दिखता है जिसकी डुप्लीकेट कॉपी Apigee Edge में मौजूद नहीं होनी चाहिए. साथ ही, यह भी ज़रूरी है कि उस हेडर की वैल्यू एक जैसी या अलग-अलग हों.
  • एचटीटीपी स्पेसिफ़िकेशन:
 आरएफ़सी 7230, सेक्शन 3.2.2: फ़ील्ड का क्रम
PLAYBOOK

protocol.http.EmptyHeaderName
  • एचटीटीपी स्टेटस कोड:
 400 Bad Request
  • गड़बड़ी का मैसेज:
 Header name cannot be empty
  • संभावित वजह:
 यह गड़बड़ी तब होती है, जब क्लाइंट ऐप्लिकेशन से Apigee Edge को एचटीटीपी रिक्वेस्ट के हिस्से के तौर पर भेजा गया हेडर का नाम खाली हो.
  • एचटीटीपी स्पेसिफ़िकेशन:
 आरएफ़सी 7230, सेक्शन 3.2: हेडर फ़ील्ड

ठीक करें

पक्का करें कि क्लाइंट ऐप्लिकेशन से Apigee Edge को भेजे गए एचटीटीपी अनुरोध में, आरएफ़सी 7230, सेक्शन 3.2: हेडर फ़ील्ड के मुताबिक हेडर का मान्य नाम शामिल हो.

protocol.http.HeaderNameWithNonAsciiChar
  • एचटीटीपी स्टेटस कोड:
 400 Bad Request
  • गड़बड़ी का मैसेज:
 Header {header_name} contains non ascii character {character}
  • संभावित वजह:
 यह गड़बड़ी तब होती है, जब क्लाइंट ऐप्लिकेशन से Apigee Edge को एचटीटीपी अनुरोध के हिस्से के तौर पर भेजे गए हेडर के नाम में, ASCII के बाहर के वर्ण शामिल हों.
  • एचटीटीपी स्पेसिफ़िकेशन:

आरएफ़सी 7230, सेक्शन 3.2: हेडर फ़ील्ड और आरएफ़सी 7230, सेक्शन 3.2.6: फ़ील्ड वैल्यू कॉम्पोनेंट

ठीक करें

पक्का करें कि Apigee Edge को भेजे गए क्लाइंट के एचटीटीपी अनुरोध में, हेडर के नामों में ऐसे वर्ण न हों जो आरएफ़सी 7230, सेक्शन 3.2.6: फ़ील्ड वैल्यू कॉम्पोनेंट के मुताबिक, एएससीआईआई से अलग हों.

protocol.http.HeaderWithInvalidChar
  • एचटीटीपी स्टेटस कोड:
 400 Bad Request
  • गड़बड़ी का मैसेज:
 Header {header_name} contains invalid character {character}
  • संभावित वजह:
 यह गड़बड़ी तब होती है, जब क्लाइंट ऐप्लिकेशन से Apigee Edge को एचटीटीपी अनुरोध के हिस्से के तौर पर भेजे गए हेडर के नाम में अमान्य वर्ण शामिल हों. जैसे, बराबर (=), कॉमा (,), सेमीकोलन (;), टैब, सीआरएलएफ़, और न्यूलाइन वर्ण.
  • एचटीटीपी स्पेसिफ़िकेशन:

आरएफ़सी 7230, सेक्शन 3.2: हेडर फ़ील्ड और आरएफ़सी 7230, सेक्शन 3.2.6: फ़ील्ड वैल्यू कॉम्पोनेंट

ठीक करें

पक्का करें कि क्लाइंट ऐप्लिकेशन से Apigee Edge को भेजे गए एचटीटीपी अनुरोध में, हेडर के नामों में कोई अमान्य वर्ण न हो. ऐसा, आरएफ़सी 7230, सेक्शन 3.2.6: फ़ील्ड वैल्यू कॉम्पोनेंट के मुताबिक होना चाहिए

protocol.http.InvalidPath
  • एचटीटीपी स्टेटस कोड:
 400 Bad Request
  • गड़बड़ी का मैसेज:
 Invalid path {path}
  • संभावित वजह:
 यह गड़बड़ी तब होती है, जब क्लाइंट ऐप्लिकेशन से Apigee Edge को भेजे गए एचटीटीपी अनुरोध के यूआरएल के पाथ में ऐसे वर्ण शामिल हों जिनकी अनुमति आरएफ़सी 3986 के सेक्शन 3.3: पाथ में दी गई जानकारी के मुताबिक नहीं है.
  • एचटीटीपी की जानकारी:

आरएफ़सी 3986, सेक्शन 3: सिंटैक्स कॉम्पोनेंट और आरएफ़सी 3986, सेक्शन 3.3: पाथ

ठीक करें

पक्का करें कि क्लाइंट ऐप्लिकेशन से Apigee Edge को भेजे गए एचटीटीपी अनुरोध यूआरएल के पाथ में, ऐसे कोई वर्ण न हों जिनकी अनुमति आरएफ़सी 3986, सेक्शन 3.3: पाथ के मुताबिक न हो.

protocol.http.TooBigBody
  • एचटीटीपी स्टेटस कोड:
 413 Request Entity Too Large
  • गड़बड़ी का मैसेज:
 Body buffer overflow
  • संभावित वजह:
 यह गड़बड़ी तब होती है, जब Apigee Edge को एचटीटीपी अनुरोध के हिस्से के तौर पर क्लाइंट ऐप्लिकेशन से भेजा गया पेलोड साइज़, Apigee Edge में तय की गई सीमा से ज़्यादा हो.
  • सीमाएं:
 Apigee Edge की सीमाएं
प्लेबुक

protocol.http.TooBigHeaders
  • एचटीटीपी स्टेटस कोड:
 431 Request Header Fields Too Large
  • गड़बड़ी का मैसेज:
 request headers size exceeding {limit}
  • संभावित वजह:
 Apigee Edge को एचटीटीपी अनुरोध के हिस्से के तौर पर, क्लाइंट ऐप्लिकेशन से भेजे गए सभी अनुरोध हेडर का कुल साइज़, Apigee Edge में तय की गई सीमा से ज़्यादा है.
  • एचटीटीपी स्पेसिफ़िकेशन:
 आरएफ़सी 6585, सेक्शन 5: 431 अनुरोध के हेडर के फ़ील्ड बहुत बड़े हैं
  • सीमाएं:
 Apigee Edge की सीमाएं
प्लेबुक

protocol.http.TooBigLine
  • एचटीटीपी स्टेटस कोड:
 414 Request-URI Too Long
  • गड़बड़ी का मैसेज:
 request line size exceeding {limit}
  • संभावित वजह:
 गड़बड़ी का यह मैसेज तब दिखता है, जब एचटीटीपी अनुरोध के हिस्से के तौर पर Apigee Edge को क्लाइंट ऐप्लिकेशन से भेजा गया अनुरोध लाइन का साइज़, Apigee Edge में तय सीमा से ज़्यादा हो.
  • सीमाएं:
 Apigee Edge की सीमाएं
प्लेबुक

protocol.http.UnsupportedEncoding
  • एचटीटीपी स्टेटस कोड:
 415 Unsupported Media
  • गड़बड़ी का मैसेज:
 Unsupported Encoding "{encoding}"
  • संभावित वजह:
 यह गड़बड़ी तब होती है, जब एचटीटीपी रिस्पॉन्स के हिस्से के तौर पर क्लाइंट से भेजे गए Content-Encoding हेडर में ऐसा कोडिंग/पेलोड फ़ॉर्मैट होता है जो Apigee Edge के साथ काम नहीं करता.
  • एचटीटीपी स्पेसिफ़िकेशन:
 आरएफ़सी 7231, सेक्शन 6.5.13: 415 मीडिया टाइप इस्तेमाल नहीं किया जा सकता
प्लेबुक

protocol.http.* - Caused by target

protocol.http.BadPath
  • एचटीटीपी स्टेटस कोड:
 500 Internal Server Error
  • गड़बड़ी का मैसेज:
 Invalid request path
  • संभावित वजह:
 यह गड़बड़ी तब होती है, जब फ़्लो वैरिएबल target.url से दिखाए गए बैकएंड सर्वर के अनुरोध यूआरएल में, फ़ॉरवर्ड स्लैश (/) के बजाय, सवाल के निशान (?) से शुरू होने वाला पाथ शामिल हो, जो अमान्य है.
  • एचटीटीपी स्पेसिफ़िकेशन:

आरएफ़सी 3986, सेक्शन 3: सिंटैक्स कॉम्पोनेंट और आरएफ़सी 3986, सेक्शन 3.3: पाथ
प्लेबुक

protocol.http.DuplicateHeader
  • एचटीटीपी स्टेटस कोड:
 502 Bad Gateway
  • गड़बड़ी का मैसेज:
 Duplicate Header "{header_name}"
  • संभावित वजह:
 यह गड़बड़ी तब होती है, जब Apigee Edge में डुप्लीकेट एचटीटीपी हेडर की अनुमति नहीं होती है. हालांकि, बैकएंड सर्वर से Apigee Edge को भेजे गए एचटीटीपी रिस्पॉन्स के हिस्से के तौर पर, एक ही या अलग-अलग वैल्यू के साथ एक से ज़्यादा बार दिखता है.
  • एचटीटीपी स्पेसिफ़िकेशन:
 आरएफ़सी 7230, सेक्शन 3.2.2: फ़ील्ड का क्रम
प्लेबुक

protocol.http.EmptyHeaderName
  • एचटीटीपी स्टेटस कोड:
 502 Bad Gateway
  • गड़बड़ी का मैसेज:
 Header name cannot be empty
  • संभावित वजह:
 यह गड़बड़ी तब होती है, जब Apigee Edge को एचटीटीपी रिस्पॉन्स के हिस्से के तौर पर, बैकएंड सर्वर से भेजा गया हेडर का नाम खाली हो.
  • एचटीटीपी स्पेसिफ़िकेशन:
 आरएफ़सी 7230, सेक्शन 3.2: हेडर फ़ील्ड

ठीक करें

पक्का करें कि बैकएंड सर्वर से Apigee Edge को भेजे गए एचटीटीपी रिस्पॉन्स में, आरएफ़सी 7230, सेक्शन 3.2: हेडर फ़ील्ड के मुताबिक हेडर का मान्य नाम शामिल हो.

protocol.http.EmptyPath
  • एचटीटीपी स्टेटस कोड:
 500 Internal Server Error
  • गड़बड़ी का मैसेज:
 Request path cannot be empty
  • संभावित वजह:
 यह गड़बड़ी तब होती है, जब फ़्लो वैरिएबल target.url से दिखाए गए बैकएंड सर्वर के एचटीटीपी अनुरोध यूआरएल में खाली पाथ होता है.
  • एचटीटीपी की जानकारी:

आरएफ़सी 3986, सेक्शन 3: सिंटैक्स कॉम्पोनेंट और आरएफ़सी 3986, सेक्शन 3.3: पाथ
प्लेबुक

protocol.http.HeaderNameWithNonAsciiChar
  • एचटीटीपी स्टेटस कोड:
 502 Bad Gateway
  • गड़बड़ी का मैसेज:
 Header {header_name} contains non ascii character {character}
  • संभावित वजह:
 गड़बड़ी का यह मैसेज तब दिखता है, जब बैकएंड सर्वर, Apigee के एचटीटीपी रिस्पॉन्स के हिस्से के तौर पर हेडर के नाम में गैर-ASCII वर्ण शामिल करता है.
  • एचटीटीपी स्पेसिफ़िकेशन:

आरएफ़सी 7230, सेक्शन 3.2: हेडर फ़ील्ड और आरएफ़सी 7230, सेक्शन 3.2.6: फ़ील्ड वैल्यू कॉम्पोनेंट

ठीक करें

पक्का करें कि Apigee Edge को भेजे गए बैकएंड सर्वर के एचटीटीपी रिस्पॉन्स में, आरएफ़सी 7230, सेक्शन 3.2.6: फ़ील्ड वैल्यू कॉम्पोनेंट के मुताबिक, हेडर नामों में बिना ASCII वाले वर्ण शामिल न हों.

protocol.http.HeaderWithInvalidChar
  • एचटीटीपी स्टेटस कोड:
 502 Bad Gateway
  • गड़बड़ी का मैसेज:
 Header {header_name} contains invalid character {character}
  • संभावित वजह:
 यह गड़बड़ी तब होती है, जब एचटीटीपी रिस्पॉन्स के हिस्से के तौर पर, बैकएंड सर्वर से भेजे गए हेडर के नाम में अमान्य वर्ण शामिल हों. जैसे, बराबर (=), कॉमा (,), सेमीकोलन (;), टैब, CRLF, और न्यूलाइन वर्ण.
  • एचटीटीपी स्पेसिफ़िकेशन:

आरएफ़सी 7230, सेक्शन 3.2: हेडर फ़ील्ड और आरएफ़सी 7230, सेक्शन 3.2.6: फ़ील्ड वैल्यू के कॉम्पोनेंट

ठीक करें

पक्का करें कि Apigee Edge को भेजे गए बैकएंड सर्वर के एचटीटीपी रिस्पॉन्स में, हेडर के नामों में कोई अमान्य वर्ण न हो. ऐसा, आरएफ़सी 7230, सेक्शन 3.2.6: फ़ील्ड वैल्यू कॉम्पोनेंट के मुताबिक होना चाहिए

protocol.http.ProxyTunnelCreationFailed
  • एचटीटीपी स्टेटस कोड:
 503 Service Unavailable
  • गड़बड़ी का मैसेज:
 Proxy refused to create tunnel with response status {status code}
  • संभावित वजह:

यह गड़बड़ी, प्रॉक्सी सर्वर की मदद से Apigee Edge और बैकएंड सर्वर के बीच टनल बनाते समय होती है. इसकी वजह, फ़ायरवॉल, ऐक्सेस कंट्रोल लिस्ट (एसीएल), डीएनएस से जुड़ी समस्याएं, बैकएंड सर्वर की उपलब्धता वगैरह हो सकती है.

ध्यान दें: गड़बड़ी के मैसेज (faultstring) में मौजूद स्टेटस कोड से, समस्या की मुख्य वजह का पता चलता है.
प्लेबुक

protocol.http.Response306Reserved
  • एचटीटीपी स्टेटस कोड:
 502 Bad Gateway
  • गड़बड़ी का मैसेज:
 Response Status code 306 is reserved, so can't be used.
  • संभावित वजह:

यह गड़बड़ी तब होती है, जब बैकएंड सर्वर ने Apigee Edge को 306 स्टेटस कोड के साथ जवाब दिया हो.

306 स्टेटस कोड, एचटीटीपी स्पेसिफ़िकेशन के पिछले वर्शन में तय किया गया था. मौजूदा एचटीटीपी स्पेसिफ़िकेशन के मुताबिक, यह कोड रिज़र्व है और इसका इस्तेमाल नहीं किया जाना चाहिए.
  • एचटीटीपी स्पेसिफ़िकेशन:
 आरएफ़सी 7231, सेक्शन 6.3.5: 306 रिज़र्व है

ठीक करें

स्टेटस कोड 306 रिज़र्व है. इसलिए, पक्का करें कि Apigee Edge को जवाब भेजते समय, आपका बैकएंड सर्वर इस स्टेटस कोड का इस्तेमाल न करे.

protocol.http.Response405WithoutAllowHeader
  • एचटीटीपी स्टेटस कोड:
 502 Bad Gateway
  • गड़बड़ी का मैसेज:
 Received 405 Response without Allow Header
  • संभावित वजह:
 बैकएंड सर्वर, "अनुमति दें" हेडर के बिना 405 Method Not Allowed स्टेटस कोड के साथ जवाब देता है.
  • एचटीटीपी स्पेसिफ़िकेशन:

आरएफ़सी 7231, सेक्शन 6.5.5: 405 Method Not Allowed और आरएफ़सी 7231, सेक्शन 7.4.1: Allow
प्लेबुक

protocol.http.ResponseWithBody
  • एचटीटीपी स्टेटस कोड:
 502 Bad Gateway
  • गड़बड़ी का मैसेज:
 Received {status_code} Response with message body
  • संभावित वजह:

यह गड़बड़ी तब होती है, जब बैकएंड सर्वर से Apigee Edge को मिलने वाला एचटीटीपी रिस्पॉन्स 204 No Content या 205 Reset Content हो, लेकिन उसमें रिस्पॉन्स बॉडी और/या इनमें से एक या एक से ज़्यादा हेडर शामिल हों:

  • Content-Length
  • Content-Encoding
  • Transfer-Encoding
  • एचटीटीपी स्पेसिफ़िकेशन:

आरएफ़सी 7231, सेक्शन 6.3.5: 204 कोई कॉन्टेंट नहीं और आरएफ़सी 7231, सेक्शन 6.3.6: 205 कॉन्टेंट रीसेट करें
प्लेबुक

protocol.http.TooBigBody
  • एचटीटीपी स्टेटस कोड:
 502 Bad Gateway
  • गड़बड़ी का मैसेज:
 Body buffer overflow
  • संभावित वजह:
 यह गड़बड़ी तब होती है, जब Apigee Edge को एचटीटीपी अनुरोध के हिस्से के तौर पर क्लाइंट ऐप्लिकेशन से भेजा गया पेलोड साइज़, Apigee Edge में तय की गई सीमा से ज़्यादा हो.
  • सीमाएं:
 Apigee Edge की सीमाएं
प्लेबुक

protocol.http.TooBigHeaders
  • एचटीटीपी स्टेटस कोड:
 502 Bad Gateway
  • गड़बड़ी का मैसेज:
 response headers size exceeding {limit}
  • संभावित वजह:
 यह गड़बड़ी तब होती है, जब Apigee Edge को एचटीटीपी रिस्पॉन्स के हिस्से के तौर पर, बैकएंड सर्वर से भेजे गए सभी रिस्पॉन्स हेडर का कुल साइज़, Apigee Edge में तय की गई सीमा से ज़्यादा हो.
  • सीमाएं:
 Apigee Edge की सीमाएं
प्लेबुक

protocol.http.TooBigLine
  • एचटीटीपी स्टेटस कोड:
 502 Bad Gateway
  • गड़बड़ी का मैसेज:
 response line size exceeding {limit}
  • संभावित वजह:
 गड़बड़ी का यह मैसेज तब दिखता है, जब बैकएंड सर्वर, Apigee Edge को एचटीटीपी रिस्पॉन्स के हिस्से के तौर पर रिस्पॉन्स लाइन का साइज़, Apigee एज में तय सीमा से ज़्यादा हो.
  • सीमाएं:
 Apigee Edge की सीमाएं
प्लेबुक

protocol.http.UnsupportedEncoding
  • एचटीटीपी स्टेटस कोड:
 415 Unsupported Media
  • गड़बड़ी का मैसेज:
 Unsupported Encoding "{encoding}"
  • संभावित वजह:
 यह गड़बड़ी तब होती है, जब एचटीटीपी रिस्पॉन्स के हिस्से के तौर पर, बैकएंड सर्वर से भेजे गए Content-Encoding हेडर में, कोड में बदलने का ऐसा/पेलोड फ़ॉर्मैट शामिल होता है जो Apigee Edge के साथ काम नहीं करता.
  • एचटीटीपी स्पेसिफ़िकेशन:
 आरएफ़सी 7231, सेक्शन 6.5.13: 415 मीडिया टाइप इस्तेमाल नहीं किया जा सकता
प्लेबुक

security.util.*

security.util.KeyAliasNotFound
  • एचटीटीपी स्टेटस कोड:
 500 Internal Server Error
  • गड़बड़ी का मैसेज:
 KeyAlias {KeyAlias_name} is not found in Keystore {Keystore_Name}
  • संभावित वजह:

यह गड़बड़ी तब होती है, जब TargetEndpoint या TargetServer में दिया गया KeyAlias वह खास कीस्टोर में नहीं मिलता है.

ठीक करें

पक्का करें कि TargetEndpoint या TargetServer में बताई गई KeyAlias मौजूद हो और वह किसी खास कीस्टोर का हिस्सा हो.

security.util.TrustStoreWithNoCertificates
  • एचटीटीपी स्टेटस कोड:
 500 Internal Server Error
  • गड़बड़ी का मैसेज:
 TrustStore {truststore_name} has no certificates
  • संभावित वजह:

यह गड़बड़ी तब होती है, जब TargetEndpoint या TargetServer के टारगेट में बताए गए Truststore में कोई सर्टिफ़िकेट नहीं है.

ठीक करें

अगर आपको बैकएंड सर्वर के सर्टिफ़िकेट की पुष्टि करनी है और आपको TargetEndpoint या TargetServer में ट्रस्टस्टोर का इस्तेमाल करना है, तो पक्का करें कि ट्रस्टस्टोर में बैकएंड सर्वर के मान्य सर्टिफ़िकेट मौजूद हों.