यूज़र इंटरफ़ेस (यूआई) में नीतियों को अटैच और कॉन्फ़िगर करना

Apigee Edge का दस्तावेज़ देखा जा रहा है.
Go to the Apigee X documentation. info

एपीआई प्रॉक्सी में, नीति के आधार पर काम करने की क्षमताएं जोड़ने के लिए, दो चरणों वाली प्रोसेस अपनानी होती है:

1. किसी नीति के टाइप का इंस्टेंस कॉन्फ़िगर करना.
2. नीति के इंस्टेंस को किसी फ़्लो से जोड़ना.

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

SpikeArrest, आम तौर पर इस्तेमाल की जाने वाली नीतियों में से एक है. SpikeArrest, मैसेज के ट्रैफ़िक में अचानक होने वाली बढ़ोतरी को रोकता है. इससे, बैकएंड सेवाओं पर ज़्यादा लोड पड़ने से रोका जा सकता है.

किसी फ़्लो में नीति जोड़ना

किसी फ़्लो में नीति जोड़ने के लिए:

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

   • डिसप्ले नेम: नीति के लिए, कोई खास डिसप्ले नेम. यूज़र इंटरफ़ेस (यूआई) डिफ़ॉल्ट नाम जनरेट करेगा. हालांकि, सलाह दी जाती है कि नीति के लिए कोई ऐसा नाम बनाएं जिससे उसके बारे101} में पता चले. इससे, आपके संगठन के अन्य डेवलपर को यह समझने में आसानी होगी कि नीति किस काम के लिए बनाई गई है.

   • नाम: नीति के लिए, कोई खास नाम. नीति का नाम, डिसप्ले नेम से मेल खाता है. हालांकि, इसमें ये अपवाद लागू होते हैं:

     • स्पेस की जगह डैश का इस्तेमाल किया जाता है.

     • लगातार डैश की जगह, एक डैश का इस्तेमाल किया जाता है.

     • डैश, अंडरस्कोर, और स्पेस को छोड़कर (जिन्हें ऊपर बताए गए तरीके से बदला जाता है), ऐसे वर्ण हटा दिए जाते हैं जो अल्फ़ान्यूमेरिक नहीं होते. जैसे, पाउंड साइन, प्रतिशत साइन, ऐंपरसैंड, वगैरह.

6. जोड़ें पर क्लिक करें.

   नीति, चुने गए फ़्लो से जुड़ जाती है.

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

किसी फ़्लो में जोड़े बिना नीति जोड़ना

किसी फ़्लो में जोड़े बिना नीति जोड़ने के लिए, जो गड़बड़ियों को ठीक करने के लिए काम की है, + पर क्लिक करें. यह बटन, नेविगेटर व्यू में नीतियां बार में है. इससे, नीति जोड़ें डायलॉग खुल जाएगा. इसके बाद, नीति जोड़ें. नीति जोड़ने का तरीका, पिछले सेक्शन में चरण 4 से 6 में बताया गया है.

ऐसी नीति जो किसी फ़्लो से नहीं जुड़ी होती है उसे नीतियां सूची में, "अलग की गई" आइकॉन के साथ फ़्लैग किया जाता है. जैसा कि पिछली इमेज में, एपीआई कुंजी मैसेज नीति के बगल में दिखाया गया है.

नीति बनाने के बाद, उसे किसी फ़्लो से जोड़ा जा सकता है. इसके लिए, नीतियां सूची से नीति को खींचकर, डिज़ाइनर व्यू में मौजूद उस फ़्लो पर छोड़ें जिससे आपको नीति जोड़नी है.

किसी फ़्लो से नीतियां अलग करना

किसी फ़्लो से नीति अलग करने के लिए, वह फ़्लो चुनें. फ़्लो के डिज़ाइनर व्यू में, नीति के आइकॉन पर माउस का कर्सर घुमाएं. आइकॉन में दिखने वाले सर्कल में मौजूद X पर क्लिक करें.

नीति का इंस्टेंस मिटाना

नीति का इंस्टेंस मिटाने के लिए, Navigator व्यू में, नीति की एंट्री पर माउस का कर्सर घुमाएं. एंट्री के दाईं ओर दिखने वाले सर्कल में मौजूद X पर क्लिक करें.

यूज़र इंटरफ़ेस (यूआई) में नीतियां कॉन्फ़िगर करना

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

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<SpikeArrest async="false" continueOnError="false" enabled="true" name="spikearrest-1">
  <DisplayName>SpikeArrest-1</DisplayName>
  <FaultRules/>
  <Properties/>
  <Identifier ref="request.header.some-header-name"/>
  <MessageWeight ref="request.header.weight"/>
  <Rate>30ps</Rate>
</SpikeArrest>

**कोड** व्यू में, नीति के एक्सएमएल कॉन्फ़िगरेशन में सीधे बदलाव करके, नीति को कॉन्फ़िगर किया जा सकता है. उदाहरण के लिए, Spike Arrest नीति के लिए, मैसेज की पीक रेट को शुरुआती तौर पर, हर सेकंड 30 मैसेज पर सेट किया जाता है. नीति के लिए एक्सएमएल में, <Rate> एलिमेंट की वैल्यू बदलकर, पीक रेट को बदला जा सकता है. नीतियों को कॉन्फ़िगर करने के बारे में ज़्यादा जानने के लिए, नीति का रेफ़रंस देखें.

कोड व्यू में, नीतियों को कट और पेस्ट भी किया जा सकता है. GitHub पर उपलब्ध सैंपल से, नीतियों को फिर से इस्तेमाल करने का यह एक बेहतरीन तरीका है.

**कोड** व्यू में, नीति की परिभाषा में बदलाव करने पर, वे बदलाव **प्रॉपर्टी इंस्पेक्टर** में दिखते हैं. इसका उल्टा भी सही है. प्रॉपर्टी इंस्पेक्टर में बदलाव करने पर, वे कोड व्यू में एक्सएमएल में दिखते हैं.

इस विषय में इस्तेमाल की गई कोटा नीति के बारे में खास जानकारी के लिए, कोटा नीति देखें.