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

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

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

1. नीति के टाइप के इंस्टेंस को कॉन्फ़िगर करें.
2. फ़्लो में नीति के इंस्टेंस अटैच करें.

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

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

फ़्लो में नीति अटैच करना

फ़्लो में नीति अटैच करने के लिए:

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

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

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

     • स्पेस को डैश से बदल दिया जाता है.

     • लगातार डैश को एक डैश से बदल दिया जाता है.

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

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

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

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

फ़्लो में नीति अटैच किए बिना उसे जोड़ना

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

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

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

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

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

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

किसी नीति के इंस्टेंस को मिटाने के लिए, नेविगेटर व्यू में नीति की एंट्री पर माउस ले जाएं. एंट्री की दाईं ओर मौजूद गोल घेरे में मौजूद 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>

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

नीतियों को कोड व्यू में, कट करके चिपकाया भी जा सकता है. GitHub पर मौजूद सैंपल में शामिल नीतियों को फिर से इस्तेमाल करने का यह एक शानदार तरीका है.

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

इस विषय में इस्तेमाल की जाने वाली कोटा नीति से जुड़े दस्तावेज़ों के लिए, कोटा नीति देखें.