संसाधनों को मैनेज करें

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

नीचे दिए गए सेक्शन में बताए गए तरीके से, संसाधनों को समझें और मैनेज करें.

संसाधनों के बारे में जानकारी

कई तरह की नीतियां, संसाधनों पर निर्भर करती हैं. संसाधन ऐसी फ़ाइलें होती हैं जो एपीआई प्रॉक्सी से अटैच होने पर, नीति के ज़रिए लागू किए जाने वाले कोड या कॉन्फ़िगरेशन को लागू करती हैं. कुछ मामलों में, जैसे कि JavaScript और JavaCallout के लिए, नीति सिर्फ़ एपीआई प्रॉक्सी में अटैचमेंट पॉइंट तय करती है. इस पॉइंट पर कुछ कोड को एक्ज़ीक्यूट करना होता है. JavaScript या JavaCallout नीति, किसी संसाधन का पॉइंटर होती है.

यहां दिए गए JavaScript के सैंपल में, एचटीटीपी अनुरोध के पाथ को proxy.basepath वैरिएबल की वैल्यू पर सेट किया गया है.

request.headers["RequestPath"] = context.getVariable("proxy.basepath");

संसाधन के टाइप

यहां दी गई टेबल में, संसाधन के टाइप के बारे में खास जानकारी दी गई है:

रिसॉर्स के टाइप ब्यौरा
JAR (java) JAR फ़ाइल में मौजूद Java क्लास, जिन्हें JavaCallout नीतियों से रेफ़र किया जाता है.
JavaScript (js) JavaScript नीतियों में शामिल JavaScript.
JavaScript (jsc) कंपाइल किया गया JavaScript, जिसे JavaScript नीतियों के ज़रिए रेफ़र किया जाता है.
Hosted target (hosted) होस्ट किए गए टारगेट पर डिप्लॉय करने के लिए Node.js फ़ाइलें. Node.js को Edge बैकएंड टारगेट ऐप्लिकेशन के तौर पर डिप्लॉय किया जा सकता है.
Node (node) Node.js फ़ाइलें. इनमें मुख्य Node.js फ़ाइल, उससे जुड़ी सोर्स फ़ाइलें, और मॉड्यूल डिपेंडेंसी शामिल हैं.
Python (py) PythonScript नीतियों में शामिल की गई Python स्क्रिप्ट. संसाधन, "प्योर Python" (सिर्फ़ Python भाषा में) में लागू किए जाने चाहिए.
WSDL (wsdl) SOAPMessageValidation नीतियों से जुड़ी WSDL फ़ाइलें.
XSD (xsd) SOAPMessageValidation नीतियों के ज़रिए रेफ़र किए गए एक्सएमएल स्कीमा.
XSL Transformations (xsl) XSLTransform नीतियों के ज़रिए रेफ़र किए गए XSLT ट्रांसफ़ॉर्मेशन.

संसाधन कहां सेव किए जाते हैं

संसाधन, इन तीन जगहों में से किसी एक में सेव किए जा सकते हैं:

  • एपीआई प्रॉक्सी का रिवीज़न: संसाधन सिर्फ़ उन एपीआई प्रॉक्सी रिवीज़न के लिए उपलब्ध होते हैं जिनमें संसाधन शामिल किए गए हैं. उदाहरण के लिए, एपीआई प्रॉक्सी के पहले वर्शन में JavaScript रिसॉर्स शामिल किया जा सकता है. इसके बाद, प्रॉक्सी के दूसरे वर्शन में Python स्क्रिप्ट का इस्तेमाल करने के लिए, JavaScript रिसॉर्स को बदला जा सकता है. पहले वर्शन के पास सिर्फ़ JavaScript संसाधन का ऐक्सेस है. वहीं, दूसरे वर्शन के पास सिर्फ़ Python संसाधन का ऐक्सेस है.
  • एनवायरमेंट: किसी एनवायरमेंट (उदाहरण के लिए, test या prod) में सेव किए जाने पर, संसाधन उसी एनवायरमेंट में डिप्लॉय की गई किसी भी एपीआई प्रॉक्सी के लिए उपलब्ध होते हैं.
  • संगठन: किसी संगठन में सेव किए गए संसाधन, किसी भी एनवायरमेंट में डिप्लॉय की गई किसी भी एपीआई प्रॉक्सी के लिए उपलब्ध होते हैं.

संसाधन फ़ाइलें एपीआई में बताए गए तरीके के मुताबिक, ये रिपॉज़िटरी इन यूआरआई पर उपलब्ध हैं. इसके बारे में बाद में एपीआई का इस्तेमाल करके संसाधनों को मैनेज करना लेख में बताया गया है:

  • संगठन: /organizations/{org}/resourcefiles
  • एनवायरमेंट: /organizations/{org}/environments/{env}/resourcefiles
  • एपीआई प्रॉक्सी: /organizations/{org}/apis/{api}/revisions/{rev}/resources

यहां दी गई टेबल में, हर रिपॉज़िटरी के लिए संसाधन बनाने, अपडेट करने, और मिटाने के तरीके बताए गए हैं:

रिपॉज़िटरी बनाएं देखें अपडेट करें मिटाएं
एपीआई यूज़र इंटरफ़ेस (यूआई) एपीआई यूज़र इंटरफ़ेस (यूआई) एपीआई यूज़र इंटरफ़ेस (यूआई) एपीआई यूज़र इंटरफ़ेस (यूआई)
एपीआई प्रॉक्सी का वर्शन
परिवेश
संगठन

उदाहरण के लिए, test एनवायरमेंट के लिए उपलब्ध सभी JavaScript फ़ाइलें, इस रिपॉज़िटरी में सेव की जाती हैं. साथ ही, test एनवायरमेंट में चल रही किसी भी एपीआई प्रॉक्सी के लिए उपलब्ध होती हैं:

/organizations/{org}/environments/test/resourcefiles/jsc

संसाधन के नाम को हल करना

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

मान लें कि आपने एक ही संसाधन को दो अलग-अलग रिपॉज़िटरी में पॉप्युलेट किया है — एपीआई प्रॉक्सी का वर्शन और prod एनवायरमेंट.

नीचे दी गई नीति के साथ कॉन्फ़िगर किए गए एपीआई प्रॉक्सी पर विचार करें:

<Javascript name='PathSetterPolicy' timeLimit='200'>
    <ResourceURL>jsc://pathSetter.js</ResourceURL>
</Javascript>

नीति के रेफ़रंस को साफ़ तौर पर किसी रिपॉज़िटरी पर रिज़ॉल्व नहीं किया जा सकता. सबसे छोटे स्कोप वाले उस पहले संसाधन का नाम बदला जाता है जिसका नाम, नीति में दिए गए संसाधन के नाम से मेल खाता है.

इसलिए, जब एपीआई प्रॉक्सी को एनवायरमेंट prod में डिप्लॉय किया जाता है, तो नीति, एनवायरमेंट के स्कोप वाले pathSetter.js संसाधन के लिए लागू होगी.

test एनवायरमेंट में डिप्लॉय किए जाने पर, नीति को एपीआई प्रॉक्सी के संशोधन के दायरे में आने वाले संसाधन के तौर पर हल किया जाएगा. इसकी वजह यह है कि एनवायरमेंट के दायरे में आने वाला संसाधन, prod एनवायरमेंट में है, न कि test एनवायरमेंट में.

Java संसाधन के लिए दिशा-निर्देश

curl में कई विकल्पों का इस्तेमाल करके, कंपाइल किए गए Java संसाधनों को JAR फ़ाइलों के तौर पर जोड़ा जा सकता है. जैसे, -T, --data-binary या -F विकल्प (-d विकल्प नहीं). उदाहरण के लिए:

curl "http://{mgmt_server}:{port}/v1/organizations/{org}/environments/{env}/resourcefiles?name={jar_file}&type=java" \
  -X POST \
  --data-binary @{jar_file} \
  -H "Content-Type: application/octet-stream" \
  -u email:password
curl -v "http://{mgmt_server}:{port}/v1/organizations/{org}/environments/{env}/resourcefiles?name={jar_file}&type=java"
  -X POST \
  -H "Content-Type: application/octet-stream" \
  -T "{jar_file}" \
  -u email:password
curl -v "http://{mgmt_server}:{port}/v1/organizations/{org}/environments/{env}/resourcefiles?name={jar_file}&type=java"
  -X POST \
  -H "Content-Type: application/multipart/form-data" \
  -F "file=@{jar_file}" \
  -u email:password

यह भी देखें:

Node.js के संसाधन से जुड़े दिशा-निर्देश

एपीआई प्रॉक्सी में Node.js स्क्रिप्ट का रेफ़रंस देते समय, एपीआई प्रॉक्सी के TargetEndpoint कॉन्फ़िगरेशन में मौजूद <ResourceURL> एलिमेंट का इस्तेमाल करें. इसके बारे में किसी मौजूदा एपीआई प्रॉक्सी में Node.js जोड़ना लेख में बताया गया है. उदाहरण के लिए:

<ScriptTarget>
    <ResourceURL>node://hello-world.js</ResourceURL>
</ScriptTarget>

Node.js स्क्रिप्ट और उससे जुड़े सभी मॉड्यूल, एपीआई प्रॉक्सी के संशोधन के दायरे में होने चाहिए. ये प्रॉक्सी बंडल की /resources/node डायरेक्ट्री में होने चाहिए. एपीआई प्रॉक्सी एडिटर में, स्क्रिप्ट सेक्शन में Node.js रिसॉर्स जोड़ने से यह काम पूरा हो जाता है. इसी तरह, एपीआई प्रॉक्सी के संशोधन के स्कोप में संसाधन को सेव करने के लिए, एपीआई (import और update) का इस्तेमाल किया जाता है.

यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके संसाधनों को मैनेज करना

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

यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके संसाधन देखना

किसी एपीआई प्रॉक्सी के वर्शन के स्कोप में मौजूद संसाधन देखने के लिए:

  1. apigee.com/edge में साइन इन करें.

  2. बाईं ओर मौजूद नेविगेशन बार में, डेवलप करें > एपीआई प्रॉक्सी चुनें.
  3. सूची में से वह एपीआई प्रॉक्सी चुनें जिसके लिए आपको संसाधन बनाना है.
    एपीआई प्रॉक्सी एडिटर खुलता है और डिफ़ॉल्ट रूप से, खास जानकारी वाला टैब दिखता है.
  4. डेवलप करें टैब पर क्लिक करें.
  5. अगर ज़रूरी हो, तो बदलाव ड्रॉप-डाउन में जाकर, बदलाव चुनें.

    एपीआई प्रॉक्सी के संशोधन के दायरे में आने वाले संसाधन, नेविगेटर व्यू में संसाधन सेक्शन में दिखते हैं.

यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके संसाधन बनाना

यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके, एपीआई प्रॉक्सी के किसी वर्शन के लिए स्कोप किए गए संसाधन बनाने के लिए:

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

यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके किसी संसाधन को अपडेट करना

यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके, एपीआई प्रॉक्सी के किसी वर्शन के स्कोप वाले संसाधन को अपडेट करने के लिए:

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

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

यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके, एपीआई प्रॉक्सी के किसी वर्शन के स्कोप वाले संसाधन को वापस लाने के लिए:

  1. एपीआई प्रॉक्सी के वर्शन के हिसाब से तय किए गए स्कोप वाले संसाधन देखें.
  2. 'संसाधन' में जाकर, नेविगेटर व्यू में उस संसाधन पर कर्सर घुमाएं जिसे आपको मिटाना है. इससे कार्रवाइयों का मेन्यू दिखेगा.
  3. पर क्लिक करें.
  4. कार्रवाई की पुष्टि करने के लिए, मिटाएं पर क्लिक करें.

एपीआई का इस्तेमाल करके संसाधनों को मैनेज करना

एपीआई का इस्तेमाल करके संसाधनों को मैनेज करें. इसके बारे में यहां बताया गया है.

एपीआई का इस्तेमाल करके संसाधन बनाना

नीचे दिए गए सेक्शन में बताए गए तरीके से, ऐसे संसाधन बनाएं जो किसी एपीआई प्रॉक्सी के संशोधन, एनवायरमेंट या संगठन (सिर्फ़ Edge) के दायरे में आते हों.

एपीआई का इस्तेमाल करके, एपीआई प्रॉक्सी के किसी वर्शन के लिए स्कोप किए गए संसाधन बनाना

एपीआई का इस्तेमाल करके, एपीआई प्रॉक्सी के किसी वर्शन के स्कोप वाला संसाधन बनाएं. इसके लिए, यहां दिए गए संसाधन को POST अनुरोध भेजें: https://api.enterprise.apigee.com/v1/organizations/{org}/apis/{api}/revisions/{rev}/resourcefiles

अपने अनुरोध के साथ यह जानकारी दें:

  • name क्वेरी पैरामीटर को संसाधन के नाम पर सेट करें
  • type क्वेरी पैरामीटर को ज़रूरी संसाधन टाइप पर सेट करें
  • संसाधन फ़ाइल के कॉन्टेंट को application/octet-stream या multipart/form-data के तौर पर पास करें)

यहां दिए गए उदाहरण में, helloworld एपीआई प्रॉक्सी के पहले वर्शन के लिए, pathSetter.js नाम की JavaScript फ़ाइल बनाई गई है:

curl -X POST https://api.enterprise.apigee.com/v1/organizations/myorg/apis/helloworld/revisions/1/resourcefiles?name=pathSetter.js&type=jsc
  -H "Content-type:application/octet-stream" \
  -d 'request.headers["RequestPath"] = context.getVariable("proxy.basepath");' \
  -u email:password

यहां दिए गए उदाहरण में, संसाधन को अपनी लोकल मशीन से फ़ाइल के तौर पर अपलोड करने का तरीका बताया गया है. यह ज़रूरी है कि curl में बाइनरी अपलोड करने के लिए, -F का इस्तेमाल किया जाए. इससे, एनवायरमेंट या संगठन के स्कोप वाली JavaScript फ़ाइलों को JavaScript नीति के तहत ऐक्सेस किया जा सकेगा.

curl -X POST https://api.enterprise.apigee.com/v1/organizations/myorg/apis/helloworld/revisions/1/resourcefiles?name=pathSetter.js&type=jsc
  -H "Content-type:multipart/form-data" \
  -F file=@pathSetter.js \
  -u email:password

यहां दोनों एपीआई कॉल से मिलने वाले जवाब का एक उदाहरण दिया गया है.

{
  "name": "pathSetter.js",
  "type": "jsc"
}

ज़्यादा जानकारी के लिए, एपीआई प्रॉक्सी के किसी वर्शन के लिए संसाधन फ़ाइल इंपोर्ट करना लेख पढ़ें.

इसके अलावा, एपीआई प्रॉक्सी के वर्शन को अपडेट करने वाले एपीआई का इस्तेमाल इस तरह किया जा सकता है:

  1. संसाधन फ़ाइल बनाएं.
  2. संसाधन फ़ाइल को एपीआई प्रॉक्सी कॉन्फ़िगरेशन बंडल में जोड़ें.
  3. इनमें से किसी एक एपीआई का इस्तेमाल करके बंडल अपलोड करें:

एपीआई का इस्तेमाल करके, किसी एनवायरमेंट के लिए स्कोप किए गए संसाधन बनाना

एपीआई का इस्तेमाल करके, किसी एनवायरमेंट के लिए स्कोप किया गया JavaScript रिसॉर्स बनाएं. इसके लिए, नीचे दिए गए रिसॉर्स को POST अनुरोध भेजें: /organizations/{org}/environments/{env}/resourcefiles

अपने अनुरोध के साथ यह जानकारी दें:

  • name क्वेरी पैरामीटर को संसाधन के नाम पर सेट करें
  • type क्वेरी पैरामीटर को ज़रूरी संसाधन टाइप पर सेट करें
  • संसाधन फ़ाइल के कॉन्टेंट को application/octet-stream या multipart/form-data के तौर पर पास करें)

यहां दिए गए उदाहरण में, अनुरोध के मुख्य हिस्से में कॉन्टेंट पास करके, JavaScript संसाधन बनाने का तरीका बताया गया है.

curl -X POST https://api.enterprise.apigee.com/v1/organizations/myorg/environments/test/resourcefiles?name=pathSetter.js&type=jsc
  -H "Content-type:application/octet-stream" \
  -d 'request.headers["RequestPath"] = context.getVariable("proxy.basepath");' \
  -u email:password

यहां दिए गए उदाहरण में, संसाधन को अपनी लोकल मशीन से फ़ाइल के तौर पर अपलोड करने का तरीका बताया गया है. यह ज़रूरी है कि curl में बाइनरी अपलोड करने के लिए, -F का इस्तेमाल किया जाए. इससे, एनवायरमेंट या संगठन के स्कोप वाली JavaScript फ़ाइलों को JavaScript नीति के तहत ऐक्सेस किया जा सकेगा.

curl -X POST https://api.enterprise.apigee.com/v1/organizations/myorg/environments/test/resourcefiles?name=pathSetter.js&type=jsc
  -H "Content-type:multipart/form-data" \
  -F file=@pathSetter.js \
  -u email:password

यहां जवाब का एक उदाहरण दिया गया है:

{
  "name" : "pathSetter.js",
  "type" : "jsc"
}

एपीआई का इस्तेमाल करके, संगठन के दायरे में आने वाले संसाधन बनाना

एपीआई का इस्तेमाल करके, किसी संगठन के लिए स्कोप किया गया संसाधन बनाने के लिए, इस संसाधन को POST अनुरोध जारी करें: https://api.enterprise.apigee.comv1/organizations/{org}/resourcefiles

अपने अनुरोध के साथ यह जानकारी दें:

  • name क्वेरी पैरामीटर को संसाधन के नाम पर सेट करें
  • type क्वेरी पैरामीटर को रिसॉर्स फ़ाइल के टाइप पर सेट करें (संसाधन के टाइप देखें)
  • संसाधन फ़ाइल के कॉन्टेंट को application/octet-stream या multipart/form-data के तौर पर पास करें)

ज़्यादा जानकारी के लिए, किसी संगठन के लिए संसाधन फ़ाइल इंपोर्ट करना लेख पढ़ें.

एपीआई का इस्तेमाल करके संसाधन देखना

यहां दिए गए सेक्शन में, एपीआई का इस्तेमाल करके संसाधनों को देखने का तरीका बताया गया है.

एपीआई का इस्तेमाल करके सभी संसाधन देखना

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

उदाहरण के लिए, एपीआई का इस्तेमाल करके एनवायरमेंट के स्कोप वाले संसाधनों के लिए संसाधन देखने के लिए, यहां दिए गए संसाधन को GET अनुरोध भेजें: https://api.enterprise.apigee.com/v1/organizations/{org}/environments/{env}/resourcefiles

यहां दिए गए उदाहरण में, test एनवायरमेंट में मौजूद सभी संसाधनों की सूची दी गई है:

curl -X GET "https://api.enterprise.apigee.com/v1/organizations/my-organization/environments/test/resourcefiles/{type}" \
  -u email:password

यहां जवाब का एक उदाहरण दिया गया है.

{
  "resourceFile": [
{
  "name" : "pathSetter.js",
  "type" : "jsc"
}
  ]
}

एपीआई का इस्तेमाल करके किसी संसाधन का कॉन्टेंट देखना

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

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

उदाहरण के लिए, एपीआई का इस्तेमाल करके किसी एनवायरमेंट में मौजूद संसाधन का कॉन्टेंट देखने के लिए, इस संसाधन को GET अनुरोध भेजें: https://api.enterprise.apigee.com/v1/organizations/{org}/environments/{env}/resourcefiles/{type}/name

यहां दिए गए उदाहरण में, test एनवायरमेंट में मौजूद pathSetter.js JavaScript रिसॉर्स फ़ाइल का कॉन्टेंट दिखाया गया है:

curl -X GET https://api.enterprise.apigee.com/v1/organizations/myorg/environments/test/resourcefiles/jsc/pathSetter.js" \
  -H "Accept: application/json" \
  -u email:password

यहां जवाब का एक उदाहरण दिया गया है:

request.headers["RequestPath"] = context.getVariable("proxy.basepath");

एपीआई का इस्तेमाल करके रिसॉर्स अपडेट करना

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

एपीआई का इस्तेमाल करके, एपीआई प्रॉक्सी के किसी वर्शन के स्कोप में आने वाले संसाधनों को अपडेट करना

एपीआई का इस्तेमाल करके, एपीआई प्रॉक्सी के किसी वर्शन के स्कोप वाले संसाधन को अपडेट करें. इसके लिए, यहां दिए गए संसाधन को PUT अनुरोध भेजें: https://api.enterprise.apigee.com/v1/organizations/{org}/apis/{api}/revisions/{rev}/resourcefiles/{type}/{name}

संसाधन फ़ाइल के कॉन्टेंट को application/octet-stream या multipart/form-data के तौर पर पास करें)

यहां दिए गए उदाहरण में, helloworld एपीआई प्रॉक्सी के पहले वर्शन के लिए, pathSetter नाम के JavaScript रिसॉर्स को अपडेट किया गया है:

curl -X PUT https://api.enterprise.apigee.com/v1/organizations/myorg/apis/helloworld/revisions/1/resourcefiles/jsc/pathSetter.js
  -H "Content-type:application/octet-stream" \
  -d 'request.headers["RequestPath"] = context.getVariable("proxy.basepath");' \
  -u email:password

यहां दिए गए उदाहरण में, लोकल मशीन से फ़ाइल के तौर पर संसाधन को अपडेट करने का तरीका बताया गया है. यह ज़रूरी है कि curl में बाइनरी अपलोड करने के लिए, -F का इस्तेमाल किया जाए. इससे, एनवायरमेंट या संगठन के स्कोप वाली JavaScript फ़ाइलों को JavaScript नीति के तहत ऐक्सेस किया जा सकेगा.

curl -X PUT https://api.enterprise.apigee.com/v1/organizations/myorg/apis/helloworld/revisions/1/resourcefiles/jsc/pathSetter.js
  -H "Content-type:multipart/form-data" \
  -F file=@pathSetter.js \
  -u email:password

यहां दोनों एपीआई कॉल से मिलने वाले जवाब का एक उदाहरण दिया गया है.

{
  "name": "pathSetter.js",
  "type": "jsc"
}

ज़्यादा जानकारी के लिए, एपीआई प्रॉक्सी के किसी वर्शन के लिए संसाधन फ़ाइल इंपोर्ट करना लेख पढ़ें.

इसके अलावा, एपीआई प्रॉक्सी के वर्शन को अपडेट करने वाले एपीआई का इस्तेमाल इस तरह किया जा सकता है:

  1. Export API proxy API का इस्तेमाल करके, एपीआई प्रॉक्सी कॉन्फ़िगरेशन बंडल डाउनलोड करें. इसके लिए, ये विकल्प इस्तेमाल करें:
    • format क्वेरी पैरामीटर को bundle पर सेट करें
    • Accept हेडर को application/zip पर सेट करें
  2. एपीआई प्रॉक्सी कॉन्फ़िगरेशन बंडल में मौजूद संसाधन फ़ाइल को अपडेट करें.
  3. Update API proxy revision API का इस्तेमाल करके बंडल अपलोड करें

एपीआई का इस्तेमाल करके, किसी एनवायरमेंट के दायरे में आने वाले संसाधनों को अपडेट करना

एपीआई का इस्तेमाल करके, किसी ऐसे संसाधन को अपडेट करें जो किसी एनवायरमेंट के स्कोप में है. इसके लिए, यहां दिए गए संसाधन को PUT अनुरोध भेजें: /organizations/{org}/environments/{env}/resourcefiles/{type}/{name}

संसाधन फ़ाइल के कॉन्टेंट को application/octet-stream या multipart/form-data के तौर पर पास करें.

यहां दिए गए उदाहरण में, अनुरोध बॉडी में कॉन्टेंट पास करके JavaScript संसाधन को अपडेट करने का तरीका बताया गया है.

curl -X PUT https://api.enterprise.apigee.com/v1/organizations/myorg/environments/test/resourcefiles/jsc/pathSetter.js
  -H "Content-type:application/octet-stream" \
  -d 'request.headers["RequestPath"] = context.getVariable("proxy.basepath");' \
  -u email:password

यहां दिए गए उदाहरण में, आपकी लोकल मशीन की किसी फ़ाइल का इस्तेमाल करके रिसोर्स फ़ाइल को अपडेट करने का तरीका बताया गया है. यह ज़रूरी है कि curl में बाइनरी अपलोड करने के लिए, -F का इस्तेमाल किया जाए. इससे, एनवायरमेंट या संगठन के स्कोप वाली JavaScript फ़ाइलों को JavaScript नीति के तहत ऐक्सेस किया जा सकेगा.

curl -X PUT https://api.enterprise.apigee.com/v1/organizations/myorg/environments/test/resourcefiles/jsc/pathSetter.js
  -H "Content-type:multipart/form-data" \
  -F file=@pathSetter.js \
  -u email:password

यहां जवाब का एक उदाहरण दिया गया है:

{
  "name" : "pathSetter.js",
  "type" : "jsc"
}

एपीआई का इस्तेमाल करके, संगठन के दायरे में आने वाले संसाधनों को अपडेट करना

एपीआई का इस्तेमाल करके, किसी ऐसे संसाधन को अपडेट करने के लिए जो किसी संगठन के दायरे में आता है, इस संसाधन को POST अनुरोध भेजें: https://api.enterprise.apigee.comv1/organizations/{org}/resourcefiles/{type}/{name}

संसाधन फ़ाइल के कॉन्टेंट को application/octet-stream या multipart/form-data के तौर पर पास करें)

ज़्यादा जानकारी के लिए, किसी संगठन के लिए संसाधन फ़ाइल इंपोर्ट करना लेख पढ़ें,

एपीआई का इस्तेमाल करके संसाधन मिटाना

यहां दिए गए सेक्शन में बताए गए तरीके से, किसी एपीआई प्रॉक्सी के वर्शन, एनवायरमेंट या संगठन (सिर्फ़ Edge) के स्कोप वाले संसाधन को मिटाएं.

एपीआई का इस्तेमाल करके, एपीआई प्रॉक्सी के किसी वर्शन के स्कोप में मौजूद संसाधनों को मिटाना

एपीआई का इस्तेमाल करके, एपीआई प्रॉक्सी के किसी वर्शन के स्कोप में मौजूद संसाधन को मिटाने के लिए, इस संसाधन को DELETE अनुरोध भेजें: https://api.enterprise.apigee.com/v1/organizations/{org}/apis/{api}/revisions/{rev}/resourcefiles/{type}/{name}

यहां दिए गए उदाहरण में, helloworld API प्रॉक्सी के पहले वर्शन से pathSetter.js JavaScript रिसॉर्स फ़ाइल को मिटाया गया है:

curl -X GET "https://api.enterprise.apigee.com/v1/organizations/my-organization/apis/helloworld/revisions/1/resourcefiles/jsc/pathSetter.js" \
  -u email:password
  

यहां जवाब का एक उदाहरण दिया गया है.

{
  "name" : "pathSetter.js",
  "type" : "jsc"
}

इसके अलावा, एपीआई प्रॉक्सी के वर्शन को अपडेट करने वाले एपीआई का इस्तेमाल इस तरह किया जा सकता है:

  1. Export API proxy API का इस्तेमाल करके, एपीआई प्रॉक्सी कॉन्फ़िगरेशन बंडल डाउनलोड करें. इसके लिए, इन विकल्पों का इस्तेमाल करें:
    • format क्वेरी पैरामीटर को bundle पर सेट करें
    • Accept हेडर को application/zip पर सेट करें
  2. एपीआई प्रॉक्सी कॉन्फ़िगरेशन बंडल से संसाधन फ़ाइल मिटाएं.
  3. Update API proxy revision API का इस्तेमाल करके बंडल अपलोड करें

एपीआई का इस्तेमाल करके, किसी एनवायरमेंट के स्कोप में मौजूद संसाधन मिटाना

एपीआई का इस्तेमाल करके, किसी एनवायरमेंट के स्कोप वाले संसाधन को मिटाएं. इसके बारे में यहां बताया गया है.

एपीआई का इस्तेमाल करके, किसी एनवायरमेंट के स्कोप वाले संसाधन को मिटाने के लिए, इस संसाधन को DELETE अनुरोध भेजें: https://api.enterprise.apigee.com/v1/organizations/{org}/environments/{env}/resourcefiles/{type}/{name}

यहां दिए गए उदाहरण में, test एनवायरमेंट से pathSetter.js JavaScript रिसॉर्स फ़ाइल को मिटाया गया है:

curl -X GET "https://api.enterprise.apigee.com/v1/organizations/my-organization/environments/test/resourcefiles/jsc/pathSetter.js" \
  -u email:password

यहां जवाब का एक उदाहरण दिया गया है.

{
  "name" : "pathSetter.js",
  "type" : "jsc"
}

एपीआई का इस्तेमाल करके, संगठन के दायरे में आने वाले संसाधनों को मिटाना (सिर्फ़ Edge के लिए)

एपीआई का इस्तेमाल करके, किसी संगठन के स्कोप वाले संसाधन को मिटाने के लिए, इस संसाधन को DELETE अनुरोध भेजें: https://api.enterprise.apigee.comv1/organizations/{org}/resourcefiles/{type}/{name}

ज़्यादा जानकारी के लिए, किसी संगठन से संसाधन फ़ाइल मिटाना लेख पढ़ें.

संसाधन ऐक्सेस करना

संसाधन को ऐक्सेस करने का तरीका, संसाधन के टाइप पर निर्भर करता है. ज़्यादा जानकारी के लिए, नीति से जुड़ा दस्तावेज़ देखें.

इस सेक्शन में दिए गए उदाहरणों में, pathSetter.js नाम की JavaScript रिसॉर्स बनाने और उसे मैनेज करने का तरीका बताया गया है. इससे JavaScript टाइप की नीतियां, इस रिसॉर्स का रेफ़रंस दे सकती हैं.

JavaScript को Request PostFlow से अटैच करने के लिए, PathSetterPolicy.xml नाम की नीति बनाएं. यह नीति, pathSetter.js फ़ाइल को रेफ़रंस करती है:

<Javascript name='PathSetterPolicy' timeLimit='200'>
    <ResourceURL>jsc://pathSetter.js</ResourceURL>
</Javascript>

इसके बाद, एंडपॉइंट कॉन्फ़िगरेशन में नीति का रेफ़रंस दें:

<PostFlow>
  <Request>
    <Step><Name>PathSetterPolicy</Name></Step>
  </Request>
<PostFlow>

ज़्यादा जानकारी के लिए, JavaScript की नीति देखें.