KeyValueMapOperations নীতি

আপনি Apigee Edge ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন দেখুন। তথ্য

কী

Apigee Edge-এ উপলভ্য কী ভ্যালু ম্যাপ (KVM) স্টোরে নীতি-ভিত্তিক অ্যাক্সেস প্রদান করে। PUT, GET বা DELETE অপারেশন নির্দিষ্ট করে এমন KeyValueMapOperations নীতি কনফিগার করে আগে থেকে থাকা নামযুক্ত ম্যাপ থেকে কী/ভ্যালু পেয়ার স্টোর, রিট্রিভ ও মুছে ফেলা যেতে পারে। (নীতিকে এইসব অপারেশনের মধ্যে অন্তত একটি অপারেশন পারফর্ম করতে হবে।)

ভিডিও

KVM সম্পর্কে আরও জানতে নিম্নলিখিত ভিডিও দেখুন।

নমুনা

<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> উপাদান

ম্যানেজমেন্ট UI প্রক্সি এডিটরে নীতিটিকে একটি ভিন্ন, প্রাকৃতিক-ভাষা নামের সাথে লেবেল করতে name বৈশিষ্ট্য ছাড়াও ব্যবহার করুন।

<DisplayName>Policy Display Name</DisplayName>

<Delete> এলিমেন্ট

নির্দিষ্ট কী/ভ্যালু পেয়ার মুছে দেয়। <Get>, <Put> অথবা <Delete>-এর মধ্যে অন্তত একটি ব্যবহার করতে হবে।

প্যারেন্ট এলিমেন্টে mapIdentifier অ্যাট্রিবিউট সহ KVM-এর নাম উল্লেখ করতে ভুলবেন না। যেমন:

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

<Entry> এলিমেন্ট

কী-ভ্যালু ম্যাপের জন্য সিড ভ্যালু, যা কী-ভ্যালু ম্যাপ ইনিশিয়ালাইজ করার সময় পপুলেট করা হয়।

পাবলিক ক্লাউডের জন্য Edge-এর ক্ষেত্রে, কী-এর সাইজ ২ কেবি পর্যন্ত সীমিত থাকে। যেমন:

<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 থেকে এর ক্যাশে করা ভ্যালু রিফ্রেশ করে।

০ বা -১ মান অথবা এই এলিমেন্ট বাদ দেওয়া হলে, এর অর্থ হল ৩০০ সেকেন্ডের ডিফল্ট মান ব্যবহার করা হবে। যেমন:

<ExpiryTimeInSecs>600</ExpiryTimeInSecs>

KVM হল একটি দীর্ঘমেয়াদী পারসিস্টেন্স মেকানিজম যা NoSQL ডেটাবেসে কী ও ভ্যালু সেভ করে। এই কারণে, রানটাইমে KVM থেকে রিড করলে প্রক্সি পারফর্ম্যান্স কমে যেতে পারে। পারফর্ম্যান্স উন্নত করতে, রানটাইম চলাকালীন Edge-এ মেমরিতে KVM কী/ভ্যালু ক্যাশে করার জন্য একটি বিল্ট-ইন মেকানিজম আছে। এই KVM অপারেশন নীতি সবসময় GET অপারেশনের জন্য ক্যাশে থেকে পড়ে।

<ExpiryTimeInSecs> এলিমেন্ট আপনাকে কন্ট্রোল করতে দেয় যে, KVM থেকে আবার রিফ্রেশ করার আগে, নীতিতে ব্যবহৃত কী/ভ্যালু কতক্ষণ ক্যাশে স্টোর করা থাকবে। তবে, GET ও PUT অপারেশন কীভাবে ক্যাশে এক্সপায়ার হওয়াকে প্রভাবিত করে, তার মধ্যে কিছু পার্থক্য আছে।

GET - KVM GET অপারেশন প্রথমবার এক্সিকিউট করার সময়, KVM থেকে অনুরোধ করা কী/ভ্যালু (যার নাম নীতির মূল mapIdentifier অ্যাট্রিবিউটে উল্লেখ করা আছে) ক্যাশে লোড করা হয়। পরবর্তী GET অপারেশনের জন্য সেগুলি সেখানে থাকে যতক্ষণ না নিম্নলিখিত ঘটনাগুলির মধ্যে একটি ঘটে:

• <ExpiryTimeInSecs>-এ উল্লেখ করা সেকেন্ডের সংখ্যা শেষ হয়ে যায়।
  অথবা
• KVM নীতিতে PUT অপারেশন আগে থেকে থাকা মানকে ওভাররাইট করে (পরবর্তী অংশে ব্যাখ্যা করা হয়েছে)।

PUT - PUT অপারেশন নির্দিষ্ট KVM-এ কী/ভ্যালু লেখে। PUT যদি এমন কোনও কী-তে লেখে যা আগে থেকেই ক্যাশে আছে, তাহলে সেই ক্যাশে অবিলম্বে রিফ্রেশ করা হয় এবং এখন নীতিতে নির্দিষ্ট করা সেকেন্ডের সংখ্যার জন্য <ExpiryTimeInSecs> এলিমেন্টে নতুন মান থাকে।

উদাহরণ - KVM ক্যাশে করা

1. GET অপারেশন "rating"-এর ভ্যালু রিট্রিভ করে, যা ক্যাশে "10" ভ্যালু যোগ করে। নীতিতে <ExpiryTimeInSecs>-এর মান হল ৬০।
2. ৩০ সেকেন্ড পরে, GET নীতি আবার এক্সিকিউট হয় এবং ক্যাশে থেকে "10" মানটি রিট্রিভ করে।
3. ৫ সেকেন্ড পরে, একটি PUT নীতি "রেটিং"-এর ভ্যালু আপডেট করে "৮" করে দেয় এবং <ExpiryTimeInSecs> PUT নীতিতে ২০ হয়। নতুন ভ্যালু দিয়ে ক্যাশে অবিলম্বে রিফ্রেশ করা হয়, যা এখন ২০ সেকেন্ডের জন্য ক্যাশে থাকবে বলে সেট করা হয়েছে। (PUT না হলে, প্রথম GET-এর মাধ্যমে অরিজিনালি পপুলেট করা ক্যাশে আরও ৩০ সেকেন্ডের জন্য থেকে যেত, যা অরিজিনাল ৬০ সেকেন্ড থেকে অবশিষ্ট থাকত।)
4. ১৫ সেকেন্ড পরে, আরেকটি GET এক্সিকিউট হয় এবং "8" ভ্যালু রিট্রিভ করে।

<Get> এলিমেন্ট

উল্লিখিত কী-এর ভ্যালু ফিরিয়ে আনে। <Get>, <Put> অথবা <Delete>-এর মধ্যে অন্তত একটি ব্যবহার করতে হবে।

প্যারেন্ট এলিমেন্টে mapIdentifier অ্যাট্রিবিউট সহ KVM-এর নাম উল্লেখ করতে ভুলবেন না।

KVM থেকে একাধিক আইটেম রিট্রিভ করতে, আপনি নীতিতে একাধিক Get ব্লক যোগ করতে পারেন।

KVM থেকে একটি আইটেম পাওয়া

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

KVM থেকে একাধিক আইটেম পাওয়া

নিচের উদাহরণে, নিম্নলিখিত কী ও ভ্যালু সহ একটি KVM আছে বলে ধরে নিন। এছাড়াও, সর্বকালের সবচেয়ে জনপ্রিয় সিনেমার একটি চলমান তালিকা সেভ করার পাশাপাশি, KVM সব বড় সিনেমার পরিচালকের নাম সেভ করে।

বর্তমান সবচেয়ে জনপ্রিয় সিনেমা এবং তার ডিরেক্টরের নাম পেতে আমরা এখানে 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>

API প্রক্সি কল করা হলে, Edge নিম্নলিখিত ভেরিয়েবল তৈরি করে যা আপনি API প্রক্সি ফ্লোতে ব্যবহার করতে পারবেন:

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

অ্যাট্রিবিউট

নিচের সারণীতে <Get> এলিমেন্টের অ্যাট্রিবিউট সম্পর্কে বর্ণনা করা হয়েছে:

<Get assignTo="private.myvar">

<InitialEntries> এলিমেন্ট

কী-ভ্যালু ম্যাপের জন্য সিড ভ্যালু, যা কী-ভ্যালু ম্যাপ ইনিশিয়ালাইজ করার সময় তাতে পপুলেট করা হয়। প্যারেন্ট এলিমেন্টে mapIdentifier অ্যাট্রিবিউট সহ KVM-এর নাম উল্লেখ করতে ভুলবেন না । যেমন:

<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>

এই এলিমেন্ট ব্যবহার করার সময়, আপনি যদি ম্যানেজমেন্ট UI-তে প্রক্সির ডিপ্লয় করা ভার্সনে নীতি সেভ করেন অথবা এই এলিমেন্ট সহ API প্রক্সি বান্ডেল ডিপ্লয় করেন, তাহলে KVM-এ কী অটোমেটিক তৈরি হয়ে যায় (এনক্রিপ্ট করা হয় না)। নীতিতে দেওয়া ভ্যালু KVM-এর ভ্যালুর থেকে আলাদা হলে, প্রক্সি ডেপ্লয় করার সময় KVM-এর ভ্যালু ওভাররাইট হয়ে যায়। আগে থেকে থাকা কী/ভ্যালুর সাথে নতুন কী/ভ্যালু যোগ করা হয়।

এই এলিমেন্ট দ্বারা পপুলেট করা কী ও ভ্যালু অবশ্যই লিটেরাল হতে হবে। যেমন, এই এলিমেন্টের মধ্যে <Parameter ref="request.queryparam.key"> কাজ করে না।

পাবলিক ক্লাউড ও প্রাইভেট ক্লাউড, দু'টির ক্ষেত্রেই Edge-এর কী সাইজ ২ কেবি পর্যন্ত সীমাবদ্ধ। KVM ভ্যালু ২ কেবি পর্যন্ত সীমিত।

এনক্রিপ্টেড KVM তৈরি করতে, Key/Value Maps ম্যানেজমেন্ট API ব্যবহার করুন।

<Key> এলিমেন্ট

কী/ভ্যালু ম্যাপ এন্ট্রিতে কী নির্দিষ্ট করে। একটি কী কম্পোজিট হতে পারে, যার অর্থ হল কী তৈরি করার জন্য একাধিক প্যারামিটার যোগ করা যেতে পারে। যেমন, userID এবং role একসাথে মিশিয়ে key তৈরি করা হতে পারে। যেমন:

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

কীওয়ার্ডের নাম কীভাবে সেট করবেন সেই সম্পর্কে নির্দিষ্ট তথ্য পেতে, <Parameter> এলিমেন্টটি দেখতে ভুলবেন না।

পাবলিক ক্লাউডের জন্য Edge-এ, কী সাইজ ২ কেবি পর্যন্ত সীমিত থাকে। আরও জানতে পাবলিক ক্লাউড API ও প্রাইভেট ক্লাউড API-এর মধ্যে পার্থক্য দেখুন।

<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>

Key এলিমেন্টে একাধিক Parameter এলিমেন্ট থাকলে, কার্যকর কী স্ট্রিং হল প্রতিটি প্যারামিটারের ভ্যালুর কনক্যাটেনেশন, যা ডবল আন্ডারস্কোর দিয়ে যোগ করা হয়। যেমন, উপরের উদাহরণে, apiproxy.name ভেরিয়েবলের ভ্যালু "abc1" হলে, কার্যকর কী হবে targeturl__abc1__weight।

আপনি কোনও কী/ভ্যালু এন্ট্রি পাচ্ছেন, আপডেট করছেন বা মুছে দিচ্ছেন, কী ভ্যালু ম্যাপে কী-এর নামের সাথে কী-এর নাম অবশ্যই মিলতে হবে। নির্দেশিকা পেতে কী নেম নির্দিষ্ট করা এবং রিট্রিভ করা দেখুন।

অ্যাট্রিবিউট

নিচের সারণীতে <Parameter> এলিমেন্টের অ্যাট্রিবিউট সম্পর্কে বর্ণনা করা হয়েছে:

<Put> এলিমেন্ট

কী-ভ্যালু ম্যাপ এনক্রিপ্ট করা বা এনক্রিপ্ট করা না থাকুক, কী-ভ্যালু ম্যাপে একটি কী/ভ্যালু পেয়ার লেখে। প্যারেন্ট এলিমেন্টে mapIdentifier অ্যাট্রিবিউটে নির্দিষ্ট করা কী-ভ্যালু ম্যাপ না থাকলে, ম্যাপটি অটোমেটিক তৈরি হয়ে যায় (এনক্রিপ্ট না করা হিসেবে)। কী ভ্যালু ম্যাপ আগে থেকেই থাকলে, কী/ভ্যালু এতে যোগ করা হয়।

এনক্রিপ্টেড কী ভ্যালু ম্যাপ তৈরি করতে,কী/ভ্যালু ম্যাপ ম্যানেজমেন্ট API ব্যবহার করুন; অথবা UI-তে এনক্রিপ্টেড এনভায়রনমেন্ট-স্কোপড KVM তৈরি করতে,এনভায়রনমেন্ট কী ভ্যালু ম্যাপ তৈরি ও এডিট করা দেখুন।

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

অ্যাট্রিবিউট

নিচের সারণীতে <Put> এলিমেন্টের অ্যাট্রিবিউট সম্পর্কে বর্ণনা করা হয়েছে:

<Scope> এলিমেন্ট

কী-ভ্যালু ম্যাপের অ্যাক্সেসিবিলিটির সীমানা নির্ধারণ করে। ডিফল্ট স্কোপ হল environment, অর্থাৎ, ডিফল্ট হিসেবে, কোনও এনভায়রনমেন্টে (যেমন, টেস্ট বা প্রোডাকশন) রান করা সব API প্রক্সি ম্যাপ এন্ট্রি শেয়ার করে। আপনি স্কোপ apiproxy হিসেবে সেট করলে, কী ভ্যালু ম্যাপের এন্ট্রি শুধুমাত্র সেই API প্রক্সি অ্যাক্সেস করতে পারবে যা ম্যাপে ভ্যালু লেখে।

মনে রাখবেন, কোনও ম্যাপ বা ম্যাপ এন্ট্রি অ্যাক্সেস করার সময়, ম্যাপ তৈরি করার সময় আপনি যে স্কোপ ভ্যালু ব্যবহার করেছিলেন, আপনাকে সেই একই ভ্যালু উল্লেখ করতে হবে। যেমন, ম্যাপটি যদি 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> এলিমেন্ট যোগ করে মাল্টি-পার্ট ভ্যালু নির্দিষ্ট করতে পারবেন। রান টাইমে ভ্যালু একত্রিত করা হয়।

নিচের উদাহরণে, KVM-এ দুটি কী যোগ করা হয়েছে:

• ভ্যালু 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, API প্রক্সি নাম হল 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 হল ভ্যালু। প্রতিটি কী/ভ্যালু পেয়ারকে key value ম্যাপে এন্ট্রি হিসেবে স্টোর করা হয়। একটি কী-ভ্যালু ম্যাপে অনেক এন্ট্রি সেভ করা যায়।

কী ভ্যালু ম্যাপ ব্যবহারের একটি উদাহরণ এখানে দেওয়া হল। ধরে নিন, আপনাকে বিভিন্ন ব্যাকএন্ড এনভায়রনমেন্টের সাথে যুক্ত IP অ্যাড্রেসের একটি তালিকা সেভ করতে হবে। আপনি ipAddresses নামের একটি কী-ভ্যালু ম্যাপ তৈরি করতে পারেন, যেখানে এন্ট্রি হিসেবে কী/ভ্যালু পেয়ারের একটি তালিকা থাকবে। যেমন, এই JSON এই ধরনের ম্যাপের প্রতিনিধিত্ব করতে পারে:

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

আপনি এই স্ট্রাকচার ব্যবহার করে IP অ্যাড্রেসের একটি স্টোর তৈরি করতে পারেন যা রানটাইমে নীতি দ্বারা IP হোয়াইটলিস্ট বা ব্ল্যাকলিস্ট প্রয়োগ করতে, ডায়নামিক উপায়ে ব্যাকএন্ড টার্গেট অ্যাড্রেস বেছে নিতে এবং আরও অনেক কিছু করতে ব্যবহার করা যেতে পারে। সাধারণত, KeyValueMapOperations নীতিটি দীর্ঘস্থায়ী তথ্য সেভ বা রিট্রিভ করতে ব্যবহৃত হয় যা একাধিক অনুরোধ/উত্তর ট্রানজ্যাকশনে আবার ব্যবহার করতে হয়।

KeyValueMapOperations নীতির মাধ্যমে বা সরাসরি Apigee Edge ম্যানেজমেন্ট API-এর মাধ্যমে কী/ভ্যালু ম্যাপ ম্যানিপুলেট করা যেতে পারে। সংস্থা কী/ভ্যালু ম্যাপ API API সম্পর্কে বিস্তারিত জানতে ম্যানেজমেন্ট API রেফারেন্স দেখুন। আপনি API ব্যবহার করে, যেমন, কী/ভ্যালু স্টোরে বড় ডেটা সেট আপলোড করতে পারেন অথবা কী/ভ্যালু ম্যাপ এন্ট্রি ম্যানেজ করার জন্য স্ক্রিপ্ট তৈরি করতে পারেন। KeyValueMapOperations নীতি ব্যবহার করে API অ্যাক্সেস করার আগে আপনাকে API-এর সাথে একটি কী/ভ্যালু ম্যাপ তৈরি করতে হবে।

কী নামের উল্লেখ ও তা পাওয়া

<Parameter> ও <Value> এলিমেন্টের সাহায্যে, আপনি কোনও লিটারাল ভ্যালু (যেখানে ভ্যালু ওপেনিং ও ক্লোজিং ট্যাগের মধ্যে থাকে) নির্দিষ্ট করতে পারেন অথবা রানটাইমে যে ভেরিয়েবলের ভ্যালু ব্যবহার করা উচিত তার নাম নির্দিষ্ট করতে ref অ্যাট্রিবিউট ব্যবহার করতে পারেন।

Parameter এলিমেন্টটি বিশেষ উল্লেখের দাবি রাখে, কারণ এটি তৈরি করা কী-এর নাম নির্ধারণ করে, পাশাপাশি আপনি যে কী-এর নাম পুনরুদ্ধার বা মুছে ফেলতে চান সেটিও নির্ধারণ করে। নিচে দুটি উদাহরণ দেওয়া হল। প্রথমটি আক্ষরিকভাবে একটি কীয়ের নাম নির্দিষ্ট করে এবং দ্বিতীয়টি একটি ভেরিয়েবেল ব্যবহার করে একটি কীয়ের নাম নির্দিষ্ট করে। ধরে নেওয়া যাক, KVM-এ কী তৈরি করার জন্য নিম্নলিখিতগুলি ব্যবহার করা হয়:

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

প্রথম ক্ষেত্রে, "key_name_literal"-এর আক্ষরিক মান KVM-এ key নাম হিসেবে সেভ করা হয়। দ্বিতীয় উদাহরণে, key.name.variable-এ যে ভ্যালু থাকবে সেটিই KVM-এর কী-এর নাম হয়ে যাবে। যেমন, key.name.variable-এ যদি ভ্যালু foo থাকে, তাহলে কী-এর নাম হবে "foo"।

আপনি যখন GET অপারেশন (বা DELETE অপারেশন দিয়ে মুছে ফেলা) সহ কী ও কী ভ্যালু রিট্রিভ করতে চান, তখন <Parameter> সেটিংকে KVM-এর কী নামের সাথে ম্যাচ করতে হবে। যেমন, KVM-এ কী-এর নাম "foo" হলে, আপনি <Parameter>foo</Parameter>-এর মাধ্যমে লিটেরাল ভ্যালু নির্দিষ্ট করতে পারেন অথবা এমন কোনও ভেরিয়েবল নির্দিষ্ট করতে পারেন যাতে "foo"-এর মতো হুবহু ভ্যালু আছে, যেমন: <Parameter ref="variable.containing.foo"/>।

সম্পর্কিত বিষয়

• সংস্থা কী/ভ্যালু ম্যাপ API