16.08.17 - सार्वजनिक क्लाउड के रिलीज़ नोट के लिए Apigee Edge

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

हमने 30 अगस्त, 2016 को Apigee Edge का नया वर्शन, पब्लिक क्लाउड के लिए लॉन्च किया था.

नई सुविधाएं और अपडेट

इस रिलीज़ में शामिल नई सुविधाओं और अपडेट के बारे में यहां बताया गया है.

Assign Message और Raise Fault में JSON पेलोड

इस सुधार के बाद, JSON मैसेज को सही तरीके से फ़ॉर्मैट करने के लिए, किसी भी तरीके का इस्तेमाल करने की ज़रूरत नहीं है. साथ ही, अमान्य JSON बनाए बिना, कर्ली ब्रेसिज़ का इस्तेमाल करके वैरिएबल तय किए जा सकते हैं. उदाहरण के लिए, यहां दिए गए कोड से JSON मैसेज में message.content की वैल्यू डाली जाती है:

<Payload contentType="application/json">{"message" : "{message.content}"}</Payload>

अगर आपने किसी तरीके का इस्तेमाल किया है, तो आपका कोड पहले की तरह काम करता रहेगा. वैरिएबल दिखाने के लिए, कर्ली ब्रेसिज़ के बजाय variablePrefix और variableSuffix का भी इस्तेमाल किया जा सकता है.

Assign Message नीति और Raise Fault नीति के रेफ़रंस वाले दस्तावेज़ों में, <Set><Payload> एलिमेंट देखें. (APIRT-1160)

XML to JSON नीति में सुधार

XML to JSON नीति में ये सुविधाएं जोड़ी गई हैं. नीति को इस तरह कॉन्फ़िगर किया जा सकता है:

• कन्वर्ज़न के दौरान, कुछ एक्सएमएल एलिमेंट को कलेक्शन के तौर पर ट्रीट करना. इससे JSON दस्तावेज़ में वैल्यू, स्क्वेयर ब्रैकेट '[ ]' में दिखती हैं.
• आखिरी JSON दस्तावेज़ में, एक्सएमएल दस्तावेज़ के क्रम में मौजूद लेवल को हटाना या खत्म करना.

ज़्यादा जानकारी के लिए, XML to JSON नीति देखें. (APIRT-1144)

एपीआई प्रॉडक्ट के संसाधन पाथ में एक से ज़्यादा वाइल्डकार्ड

एपीआई प्रॉडक्ट में संसाधन पाथ तय करते समय, किसी संसाधन पाथ में एक से ज़्यादा जगहों पर वाइल्डकार्ड शामिल किए जा सकते हैं. उदाहरण के लिए, /team/*/invoices/** से एपीआई कॉल की अनुमति मिलती है. इसमें /team के बाद कोई भी एक वैल्यू और invoices/ के बाद कोई भी संसाधन पाथ शामिल किया जा सकता है. एपीआई कॉल पर अनुमति वाला यूआरआई होगा proxyBasePath/team/finance/invoices/company/a.

अगर इस रिलीज़ के बाद, आपके मौजूदा एपीआई प्रॉडक्ट के संसाधन पाथ उम्मीद के मुताबिक काम नहीं करते हैं, तो पहले जैसा व्यवहार वापस लाने के लिए, अपने संगठन पर यह प्रॉपर्टी सेट करें: features.enableStandardWildCardMatchForAPIProductResources = true

(MGMT-3273)

JavaScript में क्रिप्टो फ़ंक्शन

ज़्यादा परफ़ॉर्मेंस वाले JavaScript crypto फ़ंक्शन का नया सेट उपलब्ध है . इसका इस्तेमाल, हैश ऑब्जेक्ट बनाने, पाने, और अपडेट करने के लिए किया जा सकता है. जैसे: MD5, SHA-1, SHA256, SHA512. क्रिप्टो ऑब्जेक्ट की मदद से, अलग-अलग फ़ॉर्मैट में तारीख भी पाई जा सकती है. ज़्यादा जानकारी के लिए, JavaScript ऑब्जेक्ट मॉडल देखें. (APIRT-2886)

Java Callout JAR वर्शन की जांच करना

किसी एपीआई प्रॉक्सी पर Java JAR संसाधन अपलोड करते समय, HTTP 400 स्टेटस कोड मिलता है . यह कोड, 500 के बजाय तब मिलता है, जब Java संसाधन का वर्शन, Edge के साथ काम करने वाले Java के वर्शन के साथ काम नहीं करता. काम करने वाले सॉफ़्टवेयर और उनके वर्शन में, इसकी जानकारी दी गई है. (MGMT-3420)

एपीआई प्रॉक्सी के संसाधनों की पुष्टि करना

जब आपके पास एनवायरमेंट या संगठन के स्कोप में सेव की गई एपीआई प्रॉक्सी की संसाधन फ़ाइलें (जैसे, JavaScript या Java JAR) होती हैं, तो पुष्टि करने वाले फ़्रेमवर्क के लिए, यह ज़रूरी नहीं है कि उन संसाधनों को एपीआई प्रॉक्सी लेवल पर भी शामिल किया जाए. ऐसा करने पर, इंपोर्ट के लिए प्रॉक्सी बंडल की पुष्टि हो जाती है. अब संसाधनों की पुष्टि, इंपोर्ट के समय नहीं, बल्कि डिप्लॉयमेंट के समय होती है. (MGMT-1430)

एपीआई प्रॉक्सी के लिए टाइम आउट कॉन्फ़िगर करना

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

1. सबसे पहले, लोड बैलेंसर, राउटर, और मैसेज प्रोसेसर को तीन मिनट में टाइम आउट होने के लिए कॉन्फ़िगर करें.
2. इसके बाद, काम की प्रॉक्सी को तीन मिनट में टाइम आउट होने के लिए कॉन्फ़िगर करें. वैल्यू को मिलीसेकंड में तय करें. उदाहरण के लिए:

   <ProxyEndpoint name="default">
     <HTTPProxyConnection>
       <BasePath>/v1/weather</BasePath>
       <Properties>
         <!-- api.timeout is in milliseconeds -->
         <Property name="api.timeout">180000</Property>
       </Properties>
       ...

3. हालांकि, ध्यान दें कि सिस्टम के टाइम आउट बढ़ाने से परफ़ॉर्मेंस से जुड़ी समस्याएं हो सकती हैं. ऐसा इसलिए, क्योंकि api.timeout सेटिंग के बिना सभी प्रॉक्सी, लोड बैलेंसर, राउटर, और मैसेज प्रोसेसर के नए और ज़्यादा टाइम आउट का इस्तेमाल करती हैं. इसलिए, उन अन्य एपीआई प्रॉक्सी को कम टाइम आउट का इस्तेमाल करने के लिए कॉन्फ़िगर करें जिन्हें ज़्यादा टाइम आउट की ज़रूरत नहीं है. उदाहरण के लिए, यहां दिए गए कोड से, एपीआई प्रॉक्सी को एक मिनट में टाइम आउट होने के लिए सेट किया जाता है:
   <Property name="api.timeout">60000</Property>

क्लाउड के ग्राहक, Edge के टाइम आउट में बदलाव नहीं कर सकते. हालांकि, वे एपीआई प्रॉक्सी के टाइम आउट को कॉन्फ़िगर कर सकते हैं, इसके लिए, यह ज़रूरी है कि टाइम आउट, Edge के मैसेज प्रोसेसर के स्टैंडर्ड टाइम आउट (57 सेकंड) से कम हो.

वैल्यू में वैरिएबल नहीं डाला जा सकता. इस प्रॉपर्टी के बारे में, एंडपॉइंट की प्रॉपर्टी के रेफ़रंस में बताया गया है. (APIRT-1778)

मैसेज लॉगिंग नीति के लिए TLS/SSL

<KeyStore> और <TrustStore> को SSLInfo कॉन्फ़िगरेशन में मैसेज लॉगिंग नीति पर सेट किया जा सकता है, जिससे लॉगिंग सेवा के साथ एक और दो-तरफ़ा TLS/SSL की अनुमति मिलती है. मैसेज लॉगिंग नीति पर SSLInfo को उसी तरह कॉन्फ़िगर किया जाता है जिस तरह प्रॉक्सी TargetEndpoint पर किया जाता है. हालांकि, मैसेज लॉगिंग TLS/SSL सिर्फ़ टीसीपी प्रोटोकॉल के साथ काम करता है. (APIRT-1858)

ठीक की गई गड़बड़ियां

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