KeyValueMapOperations नीति

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

क्या

यह नीति के हिसाब से, Apigee Edge में उपलब्ध, की वैल्यू मैप (केवीएम) स्टोर का ऐक्सेस देता है. कॉन्फ़िगर करके, नाम वाले मौजूदा मैप में से की/वैल्यू पेयर को सेव, वापस पाया, और मिटाया जा सकता है KeyValueMapOperations नीतियां, जो PUT, GET या DELETE कार्रवाइयों के बारे में बताती हैं. (इनमें से कम से कम एक ये कार्रवाइयां नीति के तहत की जानी चाहिए.)

वीडियो

केवीएम के बारे में ज़्यादा जानने के लिए, ये वीडियो देखें.

सैंपल

<KeyValueMapOperations async="false" continueOnError="false" enabled="true" name="FooKVM" mapIdentifier="FooKVM">
  <DisplayName>FooKVM</DisplayName>
  <ExpiryTimeInSecs>86400</ExpiryTimeInSecs>
  <Scope>environment</Scope>
  <Put>
    <Key>
      <Parameter>FooKey_1</Parameter>
    </Key>
    <Value>foo</Value>
    <Value>bar</Value>
  </Put>
</KeyValueMapOperations>

<KeyValueMapOperations mapIdentifier="FooKVM" async="false" continueOnError="false" enabled="true" name="GetKVM">
  <DisplayName>GetKVM</DisplayName>
  <ExpiryTimeInSecs>86400</ExpiryTimeInSecs>
  <Scope>environment</Scope>
  <Get assignTo="foo_variable" index="2">
    <Key>
      <Parameter>FooKey_1</Parameter>
    </Key>
  </Get>
</KeyValueMapOperations>

<KeyValueMapOperations name="putUrl" mapIdentifier="urlMapper">
   <Scope>apiproxy</Scope>
   <Put override="true">
      <Key>
         <Parameter ref="urlencoding.requesturl.hashed"/>
      </Key>
      <Value ref="urlencoding.longurl.encoded"/>
      <Value ref="request.queryparam.url"/>
   </Put>
</KeyValueMapOperations>

{
    "entry" :[ 
        {
            "name" : "ed24e12820f2f900ae383b7cc4f2b31c402db1be",
            "value" : "http://tinyurl.com/38lwmlr,http://apigee.com"
        }
    ],
    "name" : "urlMapper"
}

<KeyValueMapOperations name="getUrl" mapIdentifier="urlMapper">
   <Scope>apiproxy</Scope>
   <Get assignTo="urlencoding.shorturl" index='1'>
      <Key>
         <Parameter ref="urlencoding.requesturl.hashed"/> 
      </Key>
   </Get>
</KeyValueMapOperations>

<KeyValueMapOperations name="getEncrypted" mapIdentifier="encrypted_map">
   <Scope>apiproxy</Scope>
   <Get assignTo="private.encryptedVar" index='1'>
      <Key>
         <Parameter>foo</Parameter> 
      </Key>
   </Get>
</KeyValueMapOperations>

एलिमेंट का रेफ़रंस

एलिमेंट का रेफ़रंस, KeyValueMapOperations के एलिमेंट और एट्रिब्यूट के बारे में बताता है नीति:

<KeyValueMapOperations async="false" continueOnError="false" 
    enabled="true" name="Key-Value-Map-Operations-1" 
    mapIdentifier="urlMapper" >
   <DisplayName>Key Value Map Operations 1</DisplayName>
   <Scope>environment</Scope>
   <ExpiryTimeInSecs>300</ExpiryTimeInSecs>
   <InitialEntries>
      <Entry>
         <Key>
            <Parameter>key_name_literal</Parameter>
         </Key>
         <Value>value_literal</Value>
      </Entry>
      <Entry>
         <Key>
            <Parameter>variable_name</Parameter>
         </Key>
         <Value>value_1_literal</Value>
         <Value>value_2_literal</Value>
      </Entry>
   </InitialEntries>
   <Put override="false">
      <Key>
         <Parameter>key_name_literal</Parameter>
      </Key>
      <Value ref="variable_name"/>
   </Put>
   <Get assignTo="myvar" index="1">
      <Key>
         <Parameter ref="variable_name"/>
      </Key>
   </Get>
   <Delete>
      <Key>
         <Parameter>key_name_literal</Parameter>
      </Key>
   </Delete>
</KeyValueMapOperations>

<KeyValueMapOperations> एट्रिब्यूट

नीचे दिए गए उदाहरण में, <KeyValueMapOperations> टैग पर एट्रिब्यूट दिखाए गए हैं:

<KeyValueMapOperations async="false" continueOnError="false" enabled="true" name="Key-Value-Map-Operations-1" mapIdentifier="map_name">

नीचे दी गई टेबल में, खास तौर पर <KeyValueMapOperations> टैग के एट्रिब्यूट के बारे में बताया गया है:

यहां दी गई टेबल में, ऐसे एट्रिब्यूट के बारे में बताया गया है जो नीति के सभी पैरंट एलिमेंट में एक जैसे होते हैं:

<DisplayName> एलिमेंट

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

<DisplayName>Policy Display Name</DisplayName>

<Delete> एलिमेंट

तय किए गए की/वैल्यू पेयर को मिटाता है. <Get> में से कम से कम एक, <Put> या <Delete> का इस्तेमाल करना ज़रूरी है.

mapIdentifier एट्रिब्यूट के साथ केवीएम का नाम ज़रूर बताएं पैरंट एलिमेंट के लिए. उदाहरण के लिए:

<Delete>
   <Key>
      <Parameter>key_name_literal</Parameter>
   </Key>
</Delete>

<Entry> एलिमेंट

की-वैल्यू मैप के लिए सीड वैल्यू, जो मुख्य वैल्यू वाले मैप में अपने-आप तब भर जाती हैं, जब यह शुरू किया गया.

Edge for Public Cloud के लिए, कुंजी का साइज़ 2 केबी से ज़्यादा नहीं होना चाहिए. उदाहरण के लिए:

<InitialEntries>
   <Entry>
      <Key>
         <Parameter>key_name_literal</Parameter>
      </Key>
      <Value>v1</Value>
   </Entry>
   <Entry>
      <Key>
         <Parameter>key_name_variable</Parameter>
      </Key>
      <Value>v3</Value>
      <Value>v4</Value>
   </Entry>
</InitialEntries>

<ExclusiveCache> एलिमेंट

समर्थन नहीं होना या रुकना. इसके बजाय, <Scope> एलिमेंट का इस्तेमाल करें.

<ExpiryTimeInSecs> एलिमेंट

यह नीति सेकंड में अवधि तय करती है. इसके बाद Edge, कैश मेमोरी में सेव की गई वैल्यू को दर्ज किया गया KVM.

0 या -1 की वैल्यू या इस एलिमेंट को शामिल न करने का मतलब है कि 300 सेकंड की डिफ़ॉल्ट वैल्यू यह है इस्तेमाल किया गया. उदाहरण के लिए:

<ExpiryTimeInSecs>600</ExpiryTimeInSecs>

KVM, लंबे समय तक चलने वाला एक स्थायी तरीका है. यह NoSQL डेटाबेस में कुंजियों और वैल्यू को सेव करता है. इस वजह से, रनटाइम के दौरान केवीएम से पढ़ने से प्रॉक्सी परफ़ॉर्मेंस धीमा हो सकती है. बेहतर बनाने के लिए की मदद से काम करता है, तो एज में रनटाइम के दौरान केवीएम कुंजियों/वैल्यू को मेमोरी में कैश करने के लिए, ऐज़ पहले से मौजूद होता है. केवीएम से जुड़ी कार्रवाइयों की नीति, जीईटी ऑपरेशन के लिए हमेशा कैश मेमोरी से डेटा लेती है.

<ExpiryTimeInSecs> एलिमेंट की मदद से, यह कंट्रोल किया जा सकता है कि बटन या वैल्यू कितनी देर तक चालू रखें केवीएम से फिर से रीफ़्रेश करने से पहले, नीति में इस्तेमाल किए गए डेटा को कैश मेमोरी में सेव किया जाता है. हालांकि, GET और PUT जैसी कार्रवाइयां, कैश मेमोरी की समयसीमा पर कैसे असर डालती हैं, इसके बीच कुछ अंतर हैं.

GET - जब पहली बार KVM GET ऑपरेशन लागू होता है, तो अनुरोध किया गया केवीएम की कुंजियां/वैल्यू (जिसका नाम नीति के रूट mapIdentifier में दिया गया हो एट्रिब्यूट) कैश मेमोरी में लोड कर दी जाती हैं, जहां वे बाद के जीईटी ऑपरेशन के लिए तब तक बनी रहती हैं, जब तक इनमें से कोई एक ये चीज़ें होती हैं:

• <ExpiryTimeInSecs> में तय किए गए सेकंड की समयसीमा खत्म हो जाती है.
  अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है या
• केवीएम नीति में PUT कार्रवाई, मौजूदा वैल्यू को बदल देती है (इसके बारे में आगे बताया गया है).

PUT - PUT ऑपरेशन तय किए गए केवीएम के लिए कुंजियां/वैल्यू लिखता है. अगर PUT एक ऐसी कुंजी पर लिखता है जो पहले से कैश में मौजूद है, वह कैश तुरंत रीफ़्रेश हो जाती है और अब रुक जाती है नीति की <ExpiryTimeInSecs> एलिमेंट.

उदाहरण - केवीएम को कैश मेमोरी में सेव करना

1. जीईटी ऑपरेशन "रेटिंग" का मान फिर से हासिल करता है जो "10" वैल्यू जोड़ता है पर जाकर उसे कैश मेमोरी में सेव करें. कॉन्टेंट बनाने नीति के लिए, <ExpiryTimeInSecs> की वैल्यू 60 है.
2. 30 सेकंड बाद, जीईटी नीति फिर से लागू होती है और "10" को वापस लाती है को कैश मेमोरी में सेव करता है.
3. 5 सेकंड बाद, PUT नीति "रेटिंग" के मान को अपडेट करती है "8" तक, और पीयूटी नीति के लिए, <ExpiryTimeInSecs> है 20. कैश मेमोरी तुरंत सेव की जाती है नई वैल्यू के साथ रीफ़्रेश किया जाएगा. यह वैल्यू अब कैश मेमोरी में 20 सेकंड तक रहने के लिए सेट की गई है. (अगर PUT ऐसा नहीं हुआ था, पहले GET से पॉप्युलेट किया गया कैश अब भी दूसरे के लिए मौजूद रहेगा 30 सेकंड, मूल वीडियो के 60 सेकंड बचे हैं.)
4. 15 सेकंड बाद, दूसरा जीईटी "8" वैल्यू को एक्ज़ीक्यूट करके फिर से हासिल करता है.

<Get> एलिमेंट

बताई गई कुंजी का मान हासिल करता है. <Get> में से कम से कम एक, <Put> या <Delete> का इस्तेमाल करना ज़रूरी है.

पक्का करें कि आपने कन्वर्ज़न ट्रैकिंग में, mapIdentifier एट्रिब्यूट के साथ KVM का नाम पैरंट एलिमेंट.

एक से ज़्यादा आइटम वापस पाने के लिए, नीति में एक से ज़्यादा Get ब्लॉक शामिल किए जा सकते हैं से बाहर रखी गई हैं.

केवीएम से एक आइटम पाना

<Get assignTo="myvar" index="1">         
   <Key>             
      <Parameter>key_name_literal</Parameter>         
   </Key>     
</Get>

एक केवीएम से कई आइटम पाएं

नीचे दिए गए उदाहरण में, नीचे दी गई कुंजियों और वैल्यू के साथ एक KVM की कल्पना करें. इसके अलावा अब तक की सबसे लोकप्रिय फ़िल्मों की चल रही सूची को सेव करने के लिए, केवीएम स्टोर सभी बड़ी फ़िल्मों के निर्देशक का नाम हो.

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

<Get assignTo="top.movie.pick" index="1">
   <Key>
      <Parameter>top_movies</Parameter>
   </Key>
</Get>
<Get assignTo="movie.director">
   <Key>
      <Parameter ref="top.movie.pick"/>
   </Key>
</Get>

एपीआई प्रॉक्सी को कॉल करने पर, Edge ये चीज़ें बनाता है एपीआई प्रॉक्सी फ़्लो में इस्तेमाल किए जा सकने वाले वैरिएबल:

• top.movie.pick=Princess Bride
• movie.director=Rob Reiner

विशेषताएं

नीचे दिए गए टेबल में <Get> एलिमेंट के एट्रिब्यूट के बारे में बताया गया है:

<Get assignTo="private.myvar">

<InitialEntries> एलिमेंट

की-वैल्यू मैप के लिए सीड वैल्यू, जो शुरू होने पर, की-वैल्यू मैप में अपने-आप भर जाती हैं. यह पक्का करें कि mapIdentifier एट्रिब्यूट के साथ केवीएम का नाम चालू हो पैरंट एलिमेंट. उदाहरण के लिए:

<InitialEntries>
   <Entry>
      <Key>
         <Parameter>key_name_literal</Parameter>
      </Key>
      <Value>v1</Value>
   </Entry>
   <Entry>
      <Key>
         <Parameter>key_name_variable</Parameter>
      </Key>
      <Value>v3</Value>
      <Value>v4</Value>
   </Entry>
</InitialEntries>

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

इस एलिमेंट से भरी गई कुंजियां और वैल्यू, लिटरल होनी चाहिए. उदाहरण के लिए, <Parameter ref="request.queryparam.key"> इस एलिमेंट में काम नहीं करता.

Edge के लिए सार्वजनिक क्लाउड और एज फॉर द प्राइवेट यह. केवीएम की वैल्यू 2 केबी तक सीमित होती है.

एन्क्रिप्ट (सुरक्षित) किया गया KVM बनाने के लिए, Key/Value Maps management API का इस्तेमाल करें.

<Key> एलिमेंट

की/वैल्यू मैप एंट्री में कुंजी के बारे में बताता है. एक कुंजी कंपोज़िट हो सकती है, जिसका मतलब है कि कुंजी बनाने के लिए एक पैरामीटर जोड़ा जा सकता है. उदाहरण के लिए, userID और key बनाने के लिए, role को जोड़ा जा सकता है. उदाहरण के लिए:

<Key>
    <Parameter>key_name_literal</Parameter>
</Key>

पैरामीटर बनाने के तरीके की जानकारी के लिए, <Parameter> एलिमेंट ज़रूर देखें कुंजी का नाम सेट करें.

Edge for Public Cloud के साथ, कुंजी का साइज़ 2 केबी से ज़्यादा नहीं होना चाहिए. ज़्यादा जानकारी के लिए, Public Cloud API और Private Cloud API के लिए Edge के बीच अंतर लेख पढ़ें.

<Parameter> एलिमेंट

की/वैल्यू पेयर में कुंजी के बारे में बताता है. यह एलिमेंट बनाते, रखते समय, कुंजी/वैल्यू पेयर को वापस पाना या मिटाना.

नाम बताने के लिए, इनका इस्तेमाल करें:

• लिटरल स्ट्रिंग

  <Key>
    <Parameter>literal</Parameter>
  </Key>
  

• ref एट्रिब्यूट का इस्तेमाल करके, रन टाइम के दौरान हासिल किया जाने वाला वैरिएबल

  <Key>
    <Parameter ref="variable_name"/>
  </Key>
  

• लिटरल और वैरिएबल रेफ़रंस का कॉम्बिनेशन

  <Key>
    <Parameter>targeturl</Parameter>
    <Parameter ref="apiproxy.name"/>
    <Parameter>weight</Parameter>
  </Key>
  

जब मुख्य एलिमेंट में कई पैरामीटर एलिमेंट शामिल होते हैं, तो मुख्य स्ट्रिंग के तौर पर हर पैरामीटर की वैल्यू को जोड़ने की प्रोसेस, डबल अंडरस्कोर से जुड़ी होती है. उदाहरण के लिए, ऊपर दिए गए उदाहरण में, अगर apiproxy.name वैरिएबल की वैल्यू "abc1" है, तो लागू होने वाली कुंजी targeturl__abc1__weight होगी.

चाहे आप कोई कुंजी/वैल्यू एंट्री पा रहे हों, अपडेट कर रहे हों या मिटा रहे हों, कुंजी का नाम कुंजी का नाम देख सकते हैं. देखें तय करना और दिशा-निर्देशों के लिए, मुख्य नामों को वापस पाना.

विशेषताएं

नीचे दिए गए टेबल में <Parameter> एलिमेंट के एट्रिब्यूट के बारे में बताया गया है:

<Put> एलिमेंट

की/वैल्यू पेयर को की-वैल्यू मैप में लिखता है, चाहे मुख्य वैल्यू मैप एन्क्रिप्ट (सुरक्षित) किया गया हो या एन्क्रिप्ट (सुरक्षित) नहीं किया गया है. अगर कुंजी मान मैप mapIdentifier एट्रिब्यूट में पैरंट एलिमेंट मौजूद नहीं है, तो मैप अपने-आप बन जाता है (जैसा कि एन्क्रिप्ट (सुरक्षित) नहीं किया गया है). अगर कुंजी मान मैप पहले से मौजूद है, तो कुंजी/वैल्यू इसमें जोड़ दी जाती है.

एन्क्रिप्ट (सुरक्षित) की गई कुंजी की वैल्यू वाला मैप बनाने के लिए, इसका इस्तेमाल करें Key/Value Maps Management API; या एनवायरमेंट की वैल्यू मैप बनाना और उनमें बदलाव करना देखें का इस्तेमाल करें.

<Put override="false">         
   <Key>             
      <Parameter ref="mykeyvar"/>         
   </Key>         
   <Value ref="myvalvar1"/>     
</Put>

विशेषताएं

नीचे दिए गए टेबल में <Put> एलिमेंट के एट्रिब्यूट के बारे में बताया गया है:

<Scope> एलिमेंट

की-वैल्यू वाले मैप के लिए, सुलभता की सीमा तय करता है. डिफ़ॉल्ट दायरा यह है environment का मतलब है कि डिफ़ॉल्ट रूप से, मैप की एंट्री को सभी एपीआई प्रॉक्सी के ज़रिए शेयर किया जाता है किसी एनवायरमेंट में चलाना (उदाहरण के लिए, टेस्ट या प्रोडक्शन). अगर आपने स्कोप को apiproxy है, तो की वैल्यू मैप की एंट्री सिर्फ़ उस एपीआई प्रॉक्सी के ज़रिए ऐक्सेस की जा सकती हैं जो मैप पर वैल्यू लिखता है.

ध्यान दें कि किसी मैप या मैप एंट्री को ऐक्सेस करते समय, आपको वही स्कोप वैल्यू देनी होगी जिसका आपने इस्तेमाल किया था जब मैप बनाया गया था. उदाहरण के लिए, अगर मैप को apiproxy है, तो आपको इसकी वैल्यू वापस पाने के लिए, apiproxy स्कोप का इस्तेमाल करना होगा, परिवर्तन करने या प्रविष्टियां हटाने में मदद करता है.

<Scope>environment</Scope>

<Value> एलिमेंट

कुंजी की वैल्यू बताता है. आप मान को एक लिटरल स्ट्रिंग के रूप में या इसका इस्तेमाल करके ref एट्रिब्यूट को रन टाइम पर मिले वैरिएबल के तौर पर देखें:

<!-- Specify a literal value -->
<Value>literal<Value>

या:

<!-- Specify the name of variable value to be populated at run time. -->
<Value ref="variable_name"/>

किसी हिस्से के बारे में बताने के लिए, एक से ज़्यादा <Value> एलिमेंट भी शामिल किए जा सकते हैं वैल्यू. रन टाइम के दौरान वैल्यू को जोड़ा जाता है.

यहां दिए गए उदाहरण में, केवीएम में दो कुंजियां जोड़ी गई हैं:

• v1,v2 मानों वाली कुंजी k1
• v3,v4 मानों वाली कुंजी k2

<InitialEntries>         
   <Entry>             
      <Key>
         <Parameter>k1</Parameter>
      </Key>
      <Value>v1</Value>
      <Value>v2</Value>     
   </Entry>
   <Entry>
      <Key>
         <Parameter>k2</Parameter>
      </Key>
      <Value>v3</Value>
      <Value>v4</Value>
   </Entry>
</InitialEntries>

यहां दिए गए उदाहरण में, दो वैल्यू का इस्तेमाल करके एक पासकोड बनाया गया है. मान लें कि संगठन की नाम foo_org है, एपीआई प्रॉक्सी का नाम bar है, और एनवायरमेंट है test:

• bar,test मानों वाली कुंजी foo_org

<Put>
    <Key>
        <Parameter ref="organization.name"/>
    </Key>
    <Value ref="apiproxy.name"/>
    <Value ref="environment.name"/>
</Put>

विशेषताएं

नीचे दिए गए टेबल में <Value> एलिमेंट के एट्रिब्यूट के बारे में बताया गया है:

गड़बड़ी का रेफ़रंस

Edge नीतियों की वजह से मिली गड़बड़ियां, गड़बड़ी कोड के रेफ़रंस में बताए गए तरीके से एक जैसे फ़ॉर्मैट का इस्तेमाल करती हैं.

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

रनटाइम से जुड़ी गड़बड़ियां

नीति के लागू होने पर ये गड़बड़ियां हो सकती हैं.

डिप्लॉयमेंट से जुड़ी गड़बड़ियां

ये गड़बड़ियां तब हो सकती हैं, जब इस नीति वाले किसी प्रॉक्सी को डिप्लॉय किया जाता है.

स्कीमा

इस्तेमाल की जानकारी

की-वैल्यू मैप की खास जानकारी के लिए, की वैल्यू मैप के साथ काम करना देखें.

की वैल्यू वाला मैप स्टोर, फ़ॉर्मैट की गई डेटा के लिए लाइटवेट परसिस्टेंस मैकेनिज़्म देता है की/वैल्यू पेयर. नीतियों या कोड की मदद से, रनटाइम के दौरान इन्हें ऐक्सेस किया जा सकता है. मैप में सभी चीज़ें शामिल होती हैं key=value फ़ॉर्मैट में आर्बिट्रेरी डेटा.

उदाहरण के लिए, localhost=127.0.0.1, zip_code=94110 या first_name=felix. पहले उदाहरण में, localhost एक कुंजी है, और 127.0.0.1 एक मान है. हर कुंजी/वैल्यू पेयर को कुंजी में एंट्री के तौर पर सेव किया जाता है वैल्यू मैप. की-वैल्यू वाले मैप में कई एंट्री सेव की जा सकती हैं.

यहां की-वैल्यू मैप इस्तेमाल करने का एक उदाहरण दिया गया है. मान लीजिए कि आपको आईपी पतों की एक सूची सेव करनी है विभिन्न बैकएंड के साथ संबद्ध का इस्तेमाल करें. आप ipAddresses नाम का एक की-वैल्यू मैप बना सकते हैं, जिसमें कुंजी/वैल्यू पेयर की सूची, एंट्री के तौर पर. उदाहरण के लिए, यह JSON ऐसा मैप दिखा सकता है:

{
  "entry" : [ {
    "name" : "Development",
    "value" : "65.87.18.18"
  }, {
    "name" : "Staging",
    "value" : "65.87.18.22"
  } ],
  "name" : "ipAddresses"
}

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

कुंजी/मान मैप, KeyValueMapOperations नीति के ज़रिए या सीधे Apigee Edge मैनेजमेंट एपीआई. Organization key/value Maps API API के बारे में ज़्यादा जानकारी के लिए, management API का रेफ़रंस देखें. एपीआई का इस्तेमाल इन कामों के लिए किया जा सकता है उदाहरण के लिए, पासकोड/वैल्यू स्टोर में बड़े डेटा सेट अपलोड करना या कुंजी/वैल्यू को मैनेज करने के लिए स्क्रिप्ट बनाना के रूप में दिखाई जाती है. आपको API के साथ ऐक्सेस करने से पहले एक कुंजी/मान मैप बनाना होगा KeyValueMapOperations नीति.

कुंजी के नाम तय करना और उन्हें वापस पाना

<Parameter> और <Value> एलिमेंट का इस्तेमाल करके, ये काम किए जा सकते हैं लिटरल वैल्यू (जहां वैल्यू ओपनिंग और क्लोज़िंग टैग के बीच में होती है) होती है या फिर इसका इस्तेमाल करती है ref एट्रिब्यूट का इस्तेमाल करके, उस वैरिएबल का नाम बताएं जिसके मान का इस्तेमाल इस वैरिएबल पर किया जाना चाहिए रनटाइम.

पैरामीटर एलिमेंट को खास तौर पर बताया जाना चाहिए, क्योंकि यह उस कुंजी का नाम तय करता है बनाया जाता है, और साथ ही वह कुंजी नाम जिसे आप पुनर्प्राप्त करना या हटाना चाहते हैं. नीचे दो उदाहरण दिए गए हैं. पहला नाम खास तौर पर किसी कुंजी के बारे में बताता है और दूसरा कुंजी नाम वैरिएबल का इस्तेमाल करके बताता है. मान लें कि केवीएम में कुंजियां बनाने के लिए, नीचे दी गई चीज़ों का इस्तेमाल होता है:

<Parameter>key_name_literal</Parameter>
<Parameter ref="key.name.variable"/>

पहले उदाहरण में, "key_name_literal" की लिटरल वैल्यू को नाम. दूसरे उदाहरण में, key.name.variable में जो भी वैल्यू है वह कुंजी का नाम डालें. उदाहरण के लिए, अगर key.name.variable में मान foo है, तो कुंजी का नाम "foo" होगा.

जब किसी जीईटी ऑपरेशन की मदद से किसी कुंजी और 'की' वैल्यू को फिर से हासिल करना हो (या किसी DELETE कार्रवाई), <पैरामीटर> सेटिंग को केवीएम में मौजूद कुंजी के नाम से मेल खाना चाहिए. इसके लिए उदाहरण के लिए, अगर KVM में कुंजी का नाम "foo" है, तो आप <Parameter>foo</Parameter> या कोई ऐसा वैरिएबल तय करें जिसमें मान "foo", जैसे: <Parameter ref="variable.containing.foo"/>.

मिलते-जुलते विषय

• संगठन की कुंजी/वैल्यू मैप एपीआई