Apigee Edge दस्तावेज़ देखा जा रहा है.
Apigee X दस्तावेज़ पर जाएं. जानकारी
यहां दिए गए सेक्शन में बताए गए तरीके से संसाधनों को समझें और उन्हें मैनेज करें.
संसाधनों के बारे में जानकारी
अलग-अलग तरह की नीतियां, संसाधनों पर निर्भर करती हैं. संसाधन ऐसी फ़ाइलें होती हैं जो एपीआई प्रॉक्सी से अटैच होने पर, उस कोड या कॉन्फ़िगरेशन को लागू करती हैं जो किसी नीति से लागू होता है. JavaScript और Javaकॉल की तरह ही कुछ मामलों में, नीति सिर्फ़ एपीआई प्रॉक्सी में एक अटैचमेंट पॉइंट के बारे में बताती है, जहां कुछ कोड को काम करना चाहिए. JavaScript या Javaकॉल की नीति का इस्तेमाल, संसाधन के बारे में बताने के लिए किया जाता है.
नीचे दिया गया JavaScript, एचटीटीपी अनुरोध के पाथ को
proxy.basepath
वैरिएबल की वैल्यू पर सेट करता है.
request.headers["RequestPath"] = context.getVariable("proxy.basepath");
संसाधन के टाइप
यहां दी गई टेबल में अलग-अलग तरह के संसाधनों के बारे में खास जानकारी दी गई है:
संसाधन प्रकार | ब्यौरा |
---|---|
JAR (java) |
JAR फ़ाइल में मौजूद Java क्लास, जिनका रेफ़रंस Java कॉलआउट की नीतियों में दिया गया है. |
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 स्क्रिप्ट. संसाधनों को "pure Python" (सिर्फ़ Python भाषा में) में लागू किया जाना चाहिए. |
WSDL (wsdl) |
ऐसी WSDL फ़ाइलें जिनके बारे में SOAPMessageValidation की नीतियों में बताया गया है. |
XSD (xsd) |
ऐसे एक्सएमएल स्कीमा जिनके बारे में SOAPMessageDescription की नीतियों में बताया गया है. |
XSL Transformations (xsl) |
XSLT ट्रांसफ़ॉर्मेशन, जिनके बारे में XSLTransform की नीतियों में बताया गया है. |
संसाधन कहां सेव किए जाते हैं
संसाधनों को इन तीन में से किसी एक जगह पर सेव किया जा सकता है:
- एपीआई प्रॉक्सी में बदलाव: संसाधन सिर्फ़ एपीआई प्रॉक्सी में उन बदलावों के लिए उपलब्ध हैं जिनमें संसाधन शामिल किए गए हैं. उदाहरण के लिए, आपके पास एपीआई प्रॉक्सी के वर्शन 1 वाला JavaScript संसाधन शामिल करने का विकल्प है. इसके बाद, प्रॉक्सी के दूसरे वर्शन में Python स्क्रिप्ट का इस्तेमाल करने के लिए, इसे लागू करने की प्रोसेस में बदलाव किया जा सकता है. बदलाव 1 के पास सिर्फ़ JavaScript के संसाधन का ऐक्सेस है. वहीं, दूसरे वर्शन के पास सिर्फ़ Python संसाधन का ऐक्सेस है.
- एनवायरमेंट: किसी एनवायरमेंट (जैसे कि
test
याprod
) में सेव करने पर, संसाधन उसी एनवायरमेंट में डिप्लॉय किए गए किसी भी एपीआई प्रॉक्सी के लिए उपलब्ध हो जाते हैं. - संगठन: किसी संगठन में सेव किए जाने पर, संसाधन किसी भी एनवायरमेंट में डिप्लॉय किए गए, किसी भी एपीआई प्रॉक्सी के लिए उपलब्ध होते हैं.
डेटा स्टोर करने की जगहें इन यूआरआई में उपलब्ध हैं, जिनकी जानकारी Resource files API में दी गई है और बाद में एपीआई का इस्तेमाल करके संसाधनों को मैनेज करें में इनके बारे में बताया गया है:
- संगठन:
/organizations/{org}/resourcefiles
- ऐप्लिकेशन का मौजूदा वर्शन:
/organizations/{org}/environments/{env}/resourcefiles
- एपीआई प्रॉक्सी:
/organizations/{org}/apis/{api}/revisions/{rev}/resources
इस टेबल में ऐसे तरीके बताए गए हैं जिनका इस्तेमाल करके, डेटा स्टोर करने की हर जगह के लिए रिसॉर्स बनाए जा सकते हैं, अपडेट किए जा सकते हैं, और मिटाए जा सकते हैं:
रिपॉज़िटरी | बनाएं | देखें | अपडेट करें | मिटाएं | ||||
---|---|---|---|---|---|---|---|---|
API | यूज़र इंटरफ़ेस (यूआई) | API | यूज़र इंटरफ़ेस (यूआई) | API | यूज़र इंटरफ़ेस (यूआई) | API | यूज़र इंटरफ़ेस (यूआई) | |
API प्रॉक्सी संशोधन | ||||||||
एनवायरमेंट | ||||||||
संगठन |
उदाहरण के लिए, test
एनवायरमेंट के लिए उपलब्ध सभी JavaScript फ़ाइलें, यहां दी गई रिपॉज़िटरी में सेव की जाती हैं. साथ ही, ये test
एनवायरमेंट में चल रहे किसी भी एपीआई प्रॉक्सी के लिए उपलब्ध होती हैं:
/organizations/{org}/environments/test/resourcefiles/jsc
संसाधन के नाम का रिज़ॉल्यूशन
Edge, संसाधन के नामों को सबसे खास से लेकर सबसे सामान्य स्कोप तक दिखाता है. संसाधन के नामों का समाधान "चेन के ऊपर", एपीआई प्रॉक्सी रिविज़न लेवल से लेकर एनवायरमेंट लेवल और संगठन लेवल (सिर्फ़ एज) तक किया जाता है.
मान लें कि आपने एक ही संसाधन को दो अलग-अलग डेटा स्टोर करने की जगहों में भरा है — एपीआई प्रॉक्सी में बदलाव किया गया है और prod
एनवायरमेंट में.
उस एपीआई प्रॉक्सी पर ध्यान दें जिसे नीचे दी गई नीति के मुताबिक कॉन्फ़िगर किया गया है:
<Javascript name='PathSetterPolicy' timeLimit='200'> <ResourceURL>jsc://pathSetter.js</ResourceURL> </Javascript>
नीति का रेफ़रंस, साफ़ तौर पर किसी रिपॉज़िटरी (डेटा स्टोर करने की जगह) में नहीं बदला जा सकता. सबसे ज़्यादा जानकारी वाले पहले संसाधन का नाम, नीति में मौजूद संसाधन के नाम से मेल खाता है.
इसलिए, जब एपीआई प्रॉक्सी को prod
एनवायरमेंट में डिप्लॉय किया जाता है, तो यह नीति एनवायरमेंट के स्कोप वाले pathSetter.js
रिसॉर्स को इस्तेमाल करेगी.
test
एनवायरमेंट में डिप्लॉय करने पर, यह नीति एपीआई प्रॉक्सी रिविज़न के स्कोप वाले संसाधन का इस्तेमाल करेगी. ऐसा इसलिए, क्योंकि एनवायरमेंट के स्कोप वाला रिसॉर्स, prod
एनवायरमेंट में होता है, न कि test
एनवायरमेंट में.
Java के संसाधन से जुड़े दिशा-निर्देश
कर्ल में कई विकल्पों, जैसे कि -T
, --data-binary
या -F
विकल्प का इस्तेमाल करके, कंपाइल किए गए Java रिसॉर्स को JAR फ़ाइलों के तौर पर जोड़ा जा सकता है, न कि -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
यह भी देखें:
- Java के सबसे सही तरीके: एपीआई प्रॉक्सी के डिज़ाइन और डेवलपमेंट के लिए सबसे सही तरीके
- Java कुकबुक का उदाहरण: XSL Transform नीति
Node.js संसाधन से जुड़े दिशा-निर्देश
एपीआई प्रॉक्सी में Node.js स्क्रिप्ट का रेफ़रंस देने पर, एपीआई प्रॉक्सी के TargetEndpoint
कॉन्फ़िगरेशन में मौजूद <ResourceURL>
एलिमेंट का इस्तेमाल किया जा सकता है, जैसा कि मौजूदा एपीआई प्रॉक्सी में Node.js को जोड़ना में बताया गया है. उदाहरण के लिए:
<ScriptTarget> <ResourceURL>node://hello-world.js</ResourceURL> </ScriptTarget>
वह Node.js स्क्रिप्ट और उसके साथ काम करने वाले सभी मॉड्यूल, एपीआई प्रॉक्सी रिविज़न के दायरे (प्रॉक्सी बंडल की /resources/node
डायरेक्ट्री में) में होने चाहिए. एपीआई प्रॉक्सी एडिटर में, स्क्रिप्ट सेक्शन में Node.js संसाधन जोड़ने से यह काम होता है. एपीआई प्रॉक्सी रिविज़न के दायरे में संसाधन को स्टोर करने के लिए, एपीआई (import और अपडेट करें) का इस्तेमाल भी करता है.
यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके संसाधनों को मैनेज करें
नीचे दिए गए सेक्शन में बताए गए तरीके से यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके, एपीआई प्रॉक्सी रिविज़न के दायरे में आने वाले संसाधनों को मैनेज करें.
यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके संसाधन देखें
एक API प्रॉक्सी संशोधन के दायरे में आने वाले संसाधन देखने के लिए:
-
apigee.com/edge में साइन इन करें.
- बाएं नेविगेशन बार में, डेवलप करें > एपीआई प्रॉक्सी चुनें.
- सूची में वह API प्रॉक्सी चुनें जिसके लिए आप संसाधन बनाना चाहते हैं.
एपीआई प्रॉक्सी एडिटर खुलता है और 'खास जानकारी' टैब डिफ़ॉल्ट रूप से दिखता है. - डेवलप करें टैब पर क्लिक करें.
- अगर ज़रूरी हो, तो बदलाव ड्रॉप-डाउन में जाकर बदलाव को चुनें.
एपीआई प्रॉक्सी रिविज़न के दायरे में आने वाले संसाधन, नेविगेटर व्यू के संसाधन सेक्शन में दिए गए हैं.
यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके संसाधन बनाना
यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके, एपीआई प्रॉक्सी रिविज़न के दायरे में आने वाले संसाधन बनाने के लिए:
- एपीआई प्रॉक्सी रिविज़न के दायरे में आने वाले संसाधन देखें.
- नया संसाधन वाला डायलॉग बॉक्स खोलने के लिए, नेविगेटर व्यू में संसाधन सेक्शन में जाकर, + पर क्लिक करें.
- नीचे दी गई चीज़ें डालें:
फ़ील्ड ब्यौरा सोर्स नई फ़ाइल बनाने या फ़ाइल इंपोर्ट करने के लिए, इनमें से कोई विकल्प चुनें. फ़ाइल टाइप ड्रॉप-डाउन सूची से, संसाधन टाइप चुनें. फ़ाइल नाम फ़ाइल का नाम. चुने गए फ़ाइल टाइप के लिए, फ़ाइल नाम का एक्सटेंशन मान्य होना चाहिए.
यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके संसाधन अपडेट करना
यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके, संसाधन के दायरे को एपीआई प्रॉक्सी रिविज़न के दायरे में अपडेट करने के लिए:
- एपीआई प्रॉक्सी रिविज़न के दायरे में आने वाले संसाधन देखें.
- 'संसाधन' सेक्शन में नेविगेटर व्यू में, उस संसाधन पर क्लिक करें जिसे अपडेट करना है.
ध्यान दें: JAR फ़ाइलों के लिए, अपने कर्सर को उस संसाधन पर रखें जिसमें आपको बदलाव करना है और पर क्लिक करें. - ज़रूरत के हिसाब से संसाधन अपडेट करें.
ध्यान दें: नई JAR फ़ाइल अपलोड करने के बाद, अपडेट करें पर क्लिक करें.
यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके संसाधन मिटाएं
यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके, एपीआई प्रॉक्सी रिविज़न के दायरे वाले संसाधन को डिटेल करने के लिए:
- एपीआई प्रॉक्सी रिविज़न के दायरे में आने वाले संसाधन देखें.
- संसाधन के तहत नेविगेटर व्यू में, ऐक्शन मेन्यू देखने के लिए अपने कर्सर को उस संसाधन पर रखें जिसे आपको मिटाना है.
- पर क्लिक करें.
- कार्रवाई की पुष्टि करने के लिए, मिटाएं पर क्लिक करें.
एपीआई का इस्तेमाल करके संसाधनों को मैनेज करें
यहां दिए गए सेक्शन में बताए गए तरीके से, एपीआई का इस्तेमाल करके संसाधनों को मैनेज करें.
एपीआई का इस्तेमाल करके संसाधन बनाएं
ऐसे संसाधन बनाएं जिनका दायरा एपीआई प्रॉक्सी बदलाव, एनवायरमेंट या संगठन (सिर्फ़ 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
यहां दिए गए उदाहरण में बताया गया है कि अपने कंप्यूटर से संसाधन को फ़ाइल के तौर पर कैसे अपलोड करें. कर्ल में बाइनरी अपलोड के लिए, -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"
}
ज़्यादा जानकारी के लिए, एपीआई प्रॉक्सी वर्शन में बदलाव करने के लिए संसाधन फ़ाइल इंपोर्ट करना लेख पढ़ें.
वैकल्पिक रूप से, अपडेट API प्रॉक्सी संशोधन API का उपयोग इस तरह से किया जा सकता है:
- संसाधन फ़ाइल बनाएं.
- संसाधन फ़ाइल को किसी एपीआई प्रॉक्सी कॉन्फ़िगरेशन बंडल में जोड़ें.
- इनमें से किसी एक एपीआई का इस्तेमाल करके बंडल अपलोड करें:
एपीआई का इस्तेमाल करके, एनवायरमेंट के हिसाब से संसाधन बनाना
नीचे दिए गए रिसॉर्स को POST
अनुरोध भेजकर, एपीआई की मदद से ऐसा JavaScript रिसॉर्स बनाएं जो किसी एनवायरमेंट के हिसाब से हो:
/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
यहां दिए गए उदाहरण में बताया गया है कि अपने कंप्यूटर से संसाधन को फ़ाइल के तौर पर कैसे अपलोड करें. कर्ल में बाइनरी अपलोड के लिए, -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
इस उदाहरण में, आपके कंप्यूटर पर मौजूद कंप्यूटर से फ़ाइल के तौर पर संसाधन को अपडेट करने का तरीका बताया गया है. कर्ल में बाइनरी अपलोड के लिए, -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"
}
ज़्यादा जानकारी के लिए, एपीआई प्रॉक्सी वर्शन में बदलाव करने के लिए संसाधन फ़ाइल इंपोर्ट करना लेख पढ़ें.
वैकल्पिक रूप से, अपडेट API प्रॉक्सी संशोधन API का उपयोग इस तरह से किया जा सकता है:
- एपीआई प्रॉक्सी कॉन्फ़िगरेशन बंडल को डाउनलोड करने के लिए, नीचे दिए गए विकल्पों के साथ एक्सपोर्ट एपीआई प्रॉक्सी एपीआई का इस्तेमाल करें:
format
क्वेरी पैरामीटर कोbundle
पर सेट करेंAccept
हेडर कोapplication/zip
पर सेट करें
- एपीआई प्रॉक्सी कॉन्फ़िगरेशन बंडल में, संसाधन फ़ाइल अपडेट करें.
- Update API प्रॉक्सी संशोधन 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
यहां दिए गए उदाहरण में, आपके कंप्यूटर से किसी फ़ाइल का इस्तेमाल करके रिसॉर्स फ़ाइल को अपडेट करने का तरीका बताया गया है. कर्ल में बाइनरी अपलोड के लिए, -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 प्रॉक्सी के 1 वर्शन से 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"
}
वैकल्पिक रूप से, अपडेट API प्रॉक्सी संशोधन API का उपयोग इस तरह से किया जा सकता है:
- एपीआई प्रॉक्सी कॉन्फ़िगरेशन बंडल को डाउनलोड करने के लिए, नीचे दिए गए विकल्पों के साथ एक्सपोर्ट एपीआई प्रॉक्सी एपीआई का इस्तेमाल करें:
format
क्वेरी पैरामीटर कोbundle
पर सेट करेंAccept
हेडर कोapplication/zip
पर सेट करें
- एपीआई प्रॉक्सी कॉन्फ़िगरेशन बंडल से संसाधन फ़ाइल मिटाएं.
- Update API प्रॉक्सी संशोधन 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 को अनुरोध 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 की नीति पढ़ें.