तीसरा चरण: एक्सटेंशन की कॉलआउट नीति का इस्तेमाल करना

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

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

एक्सटेंशन के लिए सहायता जोड़ने पर, ExtensionCallout नीति को कॉन्फ़िगर किए गए एक्सटेंशन से जोड़ा जाता है. एक्सटेंशन के कॉन्फ़िगरेशन की सेटिंग से यह तय होता है कि एक्सटेंशन, बैकएंड रिसॉर्स के साथ कैसे इंटरैक्ट करता है. ExtensionCallout नीति, एपीआई प्रॉक्सी में खास तौर पर कॉन्फ़िगर किए गए इस एक्सटेंशन को इंटिग्रेट करती है.

अपनी एपीआई प्रॉक्सी में कोई एक्सटेंशन जोड़ने के लिए:

  1. Apigee Edge कंसोल में, डेवलप करें व्यू में अपनी एपीआई प्रॉक्सी खोलें.

    एक्सटेंशन बनाने के लिए, संगठन का एडमिन होना ज़रूरी है. हालांकि, कोई भी उपयोगकर्ता भूमिका, एपीआई प्रॉक्सी में एक्सटेंशन जोड़ सकती है.

  2. नेविगेटर पैनल में, PreFlow चुनें.

  3. कोई नीति जोड़ने के लिए, सबसे ऊपर दाएं कोने में मौजूद + चरण बटन पर क्लिक करें.

  4. चरण जोड़ें डायलॉग में, बाईं ओर मौजूद नीति की सूची में, एक्सटेंशन कॉलआउट पर क्लिक करें.

    अगर आपको सूची में ExtensionCallout नीति नहीं दिखती है, तो पक्का करें कि आपने Edge का नया यूज़र इंटरफ़ेस (यूआई) इस्तेमाल किया हो. इसके अलावा, फ़िलहाल Apigee एक्सटेंशन, Apigee Edge Cloud Enterprise के ग्राहकों के लिए ही उपलब्ध है.

  5. दाईं ओर मौजूद पैनल में, नीति को कॉन्फ़िगर करने के लिए विकल्प चुनें:
    फ़ील्ड ब्यौरा
    डिसप्ले नेम नीति का डिसप्ले नेम डालें.
    नाम नीति के लिए, प्रोग्राम के हिसाब से इस्तेमाल किया जाने वाला नाम डालें. यह नाम, प्रॉक्सी में यूनीक होना चाहिए.
    एक्सटेंशन इस्तेमाल करने के लिए एक्सटेंशन चुनें. यह वही एक्सटेंशन है जिसे आपने पहले कॉन्फ़िगर किया था.
    कार्रवाइयां "लॉग करें" कार्रवाई चुनें.
  6. जोड़ें पर क्लिक करें.
  7. फ़्लो व्यू में, नीति का कॉन्फ़िगरेशन XML देखने के लिए, उस पर क्लिक करें.

    एक्सटेंशन जोड़ने पर, आपको नीति का उदाहरण XML मिलेगा. ध्यान दें कि इसमें स्कीमा शामिल है इससे यह पता चलता है कि <Input> एलिमेंट के लिए कॉन्फ़िगरेशन को कैसे स्ट्रक्चर किया जाए. (` <Output> एलिमेंट स्कीमा को अनदेखा किया जा सकता है. ऐसा इसलिए, क्योंकि एक्सटेंशन "लॉग करें" कार्रवाई से कोई रिस्पॉन्स बॉडी नहीं मिलती.)

  8. अपनी नीति के XML में बदलाव करें, ताकि वह इस तरह दिखे:
    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <ConnectorCallout async="false" continueOnError="true" enabled="true" name="Extension-Callout-Beta-1">
      <DisplayName>Logging Extension</DisplayName>
      <Connector>my-logging-extension</Connector>
      <Action>log</Action>
      <Input>{
        "logName": "example-log",
        "metadata": {
          "resource": {
            "type": "global",
            "labels": {
              "project_id": "my-gcp-project"
            }
          }
        },
        "message": "This is a test"
      }</Input>
    </ConnectorCallout><!--
    Input JSON Schema for package=gcp-stackdriver-logging version=0.0.4
    {"type":"object","properties":{"logName":{"type":"string"},"metadata":{"type":"string"},"message":{"type":"string"}},"required":["logName","message"]}
    -->
    <!--
    Output JSON Schema for package=gcp-stackdriver-logging version=0.0.4
    {"type":"object","properties":{"content":{"type":"string"}},"required":[]}
    -->

    यहां, <Input> से यह तय होता है:

    • logName उस लॉग का नाम है जिसमें लिखना है. अगर यह मौजूद नहीं है, तो इसे एक्सटेंशन बनाएगा.
    • metadata वह जानकारी है जिसका इस्तेमाल, Stackdriver कंसोल में लॉग ब्राउज़ करने के लिए किया जा सकता है.
    • message वह लॉग मैसेज है जिसे आपको लिखना है.
  9. सेव करें बटन पर क्लिक करें.

अगला चरण

पहला चरण दूसरा चरण तीसरा चरण चौथा चरण: प्रॉक्सी डिप्लॉय करना पांचवा चरण