इस पेज का अनुवाद Cloud Translation API से किया गया है.

स्ट्रीमिंग से जुड़े अनुरोध और जवाब

आपको Apigee Edge दस्तावेज़ दिख रहा है.
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है इस पेज पर जाएं Apigee X दस्तावेज़. जानकारी

इस विषय में आपको इन चीज़ों के बारे में जानकारी मिलेगी

इस विषय को पढ़ने के बाद, आप यह जान पाएंगे:

Apigee Edge पर अनुरोध और जवाब की स्ट्रीमिंग क्या है
अनुरोध और जवाब को स्ट्रीम करने की सुविधा का इस्तेमाल कब करना चाहिए
अनुरोध और जवाब को स्ट्रीम करने की सुविधा चालू करने का तरीका

अनुरोध और जवाब स्ट्रीमिंग क्या है?

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

मुझे स्ट्रीमिंग की सुविधा कब चालू करनी चाहिए?

अगर आपका एपीआई प्रॉक्सी बहुत बड़े अनुरोधों और/या रिस्पॉन्स (साइज़ की सीमाओं के लिए, स्ट्रीमिंग के लिए मुझे और क्या पता होना चाहिए नीचे दिया गया है), तो हो सकता है कि आप स्ट्रीमिंग चालू करना चाहें.

ध्यान दें: अगर आपका एपीआई ज़्यादा डेटा का अनुरोध करता है या ज़्यादा डेटा दिखाता है, तो आपको यह एचटीटीपी दिख सकता है गड़बड़ी:

{"fault":"{\"detail\":{\"errorcode\":\"protocol.http.TooBigBody\"},\"faultstring\":\"Body buffer overflow\"}"}

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

स्ट्रीमिंग के बारे में मुझे और क्या पता होना चाहिए?

Edge Cloud में मैसेज पेलोड का साइज़ 10 एमबी तक सीमित है निजी क्लाउड, भले ही स्ट्रीमिंग की सुविधा चालू हो. स्ट्रीम नहीं किए गए अनुरोधों और जवाबों में, सीमा से ज़्यादा इस साइज़ की वजह से protocol.http.TooBigBody गड़बड़ी होती है.

लाइव स्ट्रीमिंग करने के दौरान, आपको अनुरोध/रिस्पॉन्स के साइज़ की सीमा, प्रॉडक्ट के मुताबिक लागू की गई 10 एमबी से ज़्यादा नहीं होनी चाहिए, Apigee, स्ट्रीमिंग के दौरान इस सीमा को पार करने का सुझाव नहीं देता है. साथ ही, यह उन समस्याओं को सपोर्ट नहीं कर सकता जो उस सीमा को पार करने से पैदा होती हैं. जैसे, परफ़ॉर्मेंस से जुड़ी समस्याएं, टाइम आउट वगैरह. अगर आपको टाइम आउट या गेटवे गड़बड़ी मिलती है, तो संभावित समस्या के हल के लिए गड़बड़ी के मैसेज का संदर्भ देखें चरण पूरे करें.

10 एमबी से बड़े पेलोड के लिए, Apigee का सुझाव है कि हस्ताक्षर किए गए यूआरएल पैटर्न, Apigee Javaकॉलआउट में मौजूद हैं. इन यूआरएल पैटर्न को Edge कॉलआउट: GitHub पर साइन किए गए यूआरएल जनरेटर का उदाहरण.

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

Edge for Private Cloud की रिलीज़, 4.16.01 से पहले की रिलीज़ के लिए:

मैसेज प्रोसेसर पर, मैसेज प्रोसेसर पर http.properties फ़ाइल में बदलाव करके मैसेज प्रोसेस करने की सुविधा को बढ़ाने के लिए HTTPResponse.body.buffer.limit पैरामीटर में सीमा तय करें और फिर रीस्टार्ट करें मैसेज प्रोसेसर चुन सकते हैं.
Edge for Private Cloud के वर्शन 4.16.01 और इसके बाद के वर्शन के लिए:
1. फ़ाइल /<inst_root>/apigee/customer/application/message-processor.properties में बदलाव करें. अगर वह फ़ाइल मौजूद नहीं है, तो उसे बनाएं.
2. conf_http_HTTPResponse.body.buffer.limit सेट करें प्रॉपर्टी को message-processor.properties में जोड़ना होगा. इसके लिए उदाहरण:
  conf_http_HTTPResponse.body.buffer.limit=5m
3. मैसेज प्रोसेसर को रीस्टार्ट करें:
  > /<inst_root>/apigee/apigee-service/bin/apigee-service Edge-message-प्रोसेसर रीस्टार्ट करो
4. सभी मैसेज प्रोसेसर के लिए यह तरीका दोहराएं.

स्ट्रीमिंग की सुविधा चालू होने पर, Apigee का सुझाव है कि आप नीतियां अटैच न करें जिसे अनुरोध या रिस्पॉन्स पेलोड का ऐक्सेस चाहिए. इस तरह की नीतियों से इसकी वजह से एपीआई प्रॉक्सी में गड़बड़ियां होती हैं या बफ़रिंग चालू होती है. इससे पेलोड का साइज़, संख्याओं तक सीमित हो जाता है ऊपर दी गई सूची में शामिल है. साथ ही, यह बड़े पेलोड को संभालकर रखने के लिए स्ट्रीमिंग की सुविधा को चालू नहीं करता है. आप अटैच कर सकते हैं ऐसी नीतियां जो अनुरोध/जवाब के मुख्य हिस्से से इंटरैक्ट नहीं करतीं. जैसे, पुष्टि करना या मैसेज जानकारी लॉग करने से जुड़ी नीतियां.

अनुरोध और जवाब को स्ट्रीम करने की सुविधा चालू करने का तरीका

अनुरोध स्ट्रीमिंग की सुविधा चालू करने के लिए, आपको request.streaming.enabled जोड़ना होगा प्रॉपर्टी को प्रॉक्सी बंडल में ProxyEndpoint और TargetEndpoint की परिभाषाओं के मुताबिक जोड़ना होगा और उसे true. इसी तरह, रिस्पॉन्स स्ट्रीमिंग को चालू करने के लिए, response.streaming.enabled प्रॉपर्टी को सेट करें.

आप इन कॉन्फ़िगरेशन फ़ाइलों को अपने प्रॉक्सी. अगर ऐप्लिकेशन को स्थानीय तौर पर डेवलप किया जा रहा है, तो ये डेफ़िनिशन फ़ाइलें apiproxy/proxies में होंगी और apiproxy/targets.

इस सैंपल में, TargetEndpoint में अनुरोध और रिस्पॉन्स, दोनों की स्ट्रीमिंग चालू करने का तरीका बताया गया है परिभाषा शामिल नहीं है.

<TargetEndpoint name="default">
  <HTTPTargetConnection>
    <URL>http://mocktarget.apigee.net</URL>
    <Properties>
      <Property name="response.streaming.enabled">true</Property>
      <Property name="request.streaming.enabled">true</Property>
      <Property name="supports.http10">true</Property>
      <Property name="request.retain.headers">User-Agent,Referer,Accept-Language</Property>
      <Property name="retain.queryparams">apikey</Property>
    </Properties>
  </HTTPTargetConnection>
</TargetEndpoint>

इस उदाहरण में, ProxyEndpoint में रिस्पॉन्स को चालू करने और स्ट्रीमिंग का अनुरोध करने का तरीका बताया गया है परिभाषा:

<ProxyEndpoint name="default">
  <HTTPProxyConnection>
    <BasePath>/v1/weather</BasePath>
    <Properties>
      <Property name="allow.http10">true</Property>
      <Property name="response.streaming.enabled">true</Property>
      <Property name="request.streaming.enabled">true</Property>
    </Properties>
  </HTTPProxyConnection>
</ProxyEndpoint>

एंडपॉइंट की परिभाषाओं को कॉन्फ़िगर करने के बारे में ज़्यादा जानने के लिए, एंडपॉइंट प्रॉपर्टी का रेफ़रंस लेख पढ़ें.

मिलता-जुलता कोड सैंपल

GitHub पर एपीआई प्रॉक्सी सैंपल को डाउनलोड और इस्तेमाल करना आसान है. इसके बारे में जानकारी के लिए सैंपल एपीआई प्रॉक्सी का इस्तेमाल करना देखें डाउनलोड और इस्तेमाल कर सकते हैं.

स्ट्रीमिंग की सुविधा देने वाले सैंपल प्रॉक्सी में ये शामिल हैं:

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