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

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

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

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

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

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

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

      • या

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

मैसेज प्रोसेसर की गड़बड़ी का नमूना

मैसेज प्रोसेसर हमेशा एक एचटीटीपी स्टेटस कोड के बाद गड़बड़ी का मैसेज दिखाता है. साथ ही, यह 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 के मैसेज प्रोसेसर कॉम्पोनेंट से मिले हैं. इसमें हर गड़बड़ी कोड के लिए, नीचे दी गई जानकारी शामिल होती है:

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

यहां गड़बड़ी कोड की कैटगरी दी गई हैं:

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

गड़बड़ी का कोड ब्यौरा समाधान

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 प्लेबुक
  • गड़बड़ी का मैसेज:
 गड़बड़ी का मैसेज और उसका फ़ॉर्मैट, बैकएंड सर्वर लागू करने के तरीके के हिसाब से अलग-अलग हो सकता है.
  • संभावित वजह:
 यह गड़बड़ी तब होती है, जब बैकएंड सर्वर, 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 Message प्रोसेसर को जवाब नहीं देता.
प्लेबुक

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

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

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

समाधान

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

  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
  • संभावित वजह:
 यह गड़बड़ी तब होती है, जब Apigee Edge के मैसेज प्रोसेसर को, मैसेज प्रोसेसर कॉम्पोनेंट पर कॉन्फ़िगर किए गए, I/O टाइम आउट अवधि के लिए क्लाइंट ऐप्लिकेशन से अनुरोध पेलोड नहीं मिलता है.

समाधान

पक्का करें कि क्लाइंट ऐप्लिकेशन, 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. टारगेट एंडपॉइंट में बताया गया टारगेट सर्वर होस्ट गलत है या उसमें अनचाहे वर्ण (जैसे कि स्पेस) हैं.

प्लेबुक

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/एसएसएल कनेक्शन के साथ काम करने के लिए, 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, अनुरोध को किसी भी TargetEndpoints को अनुरोध नहीं भेज पाता, क्योंकि:

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

    • और

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

समाधान

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

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

प्रॉक्सीEndpoint में <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 या AssignmentsMessage नीति का इस्तेमाल करने की अनुमति नहीं दी जाती है.
प्लेबुक

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

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: फ़ील्ड वैल्यू कॉम्पोनेंट के मुताबिक, हेडर के नामों में गैर-ASCII वर्ण शामिल न हों.

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

आरएफ़सी 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 Edge को मिले एचटीटीपी रिस्पॉन्स के हिस्से के तौर पर, बैकएंड सर्वर से भेजे गए हेडर के नाम में गैर-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}
  • संभावित वजह:
 यह गड़बड़ी तब होती है, जब बैकएंड सर्वर से भेजे गए हेडर के नाम में, बराबर (=), कॉमा (,), सेमीकोलन (;), टैब, सीआरएलएफ़, और न्यूलाइन वर्ण जैसे अमान्य वर्ण शामिल हों.
  • एचटीटीपी के बारे में खास जानकारी:

आरएफ़सी 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
  • संभावित वजह:
 बैकएंड सर्वर, "Allow" हेडर के बिना, 405 Method Not Allowed स्टेटस कोड के साथ जवाब देता है.
  • एचटीटीपी के बारे में खास जानकारी:

आरएफ़सी 7231, सेक्शन 6.5.5: 405 तरीके की अनुमति नहीं है और आरएफ़सी 7231, सेक्शन 7.4.1: अनुमति दें
प्लेबुक

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 Edge में दी गई सीमा से ज़्यादा हो.
  • सीमाएं:
 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 फ़ाइल में कोई सर्टिफ़िकेट मौजूद न हो.

समाधान

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