आपको 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 को एज बैकएंड टारगेट ऐप्लिकेशन के तौर पर डिप्लॉय कर सकते हैं. |
Node (node) |
Node.js फ़ाइलों में, मुख्य Node.js फ़ाइल और इससे जुड़ी सोर्स फ़ाइलें, और मॉड्यूल डिपेंडेंसी शामिल होती हैं. |
Python (py) |
PythonScript की नीतियों से जुड़ी Python स्क्रिप्ट. रिसॉर्स को "शुद्ध Python" (सिर्फ़ Python भाषा में) में लागू किया जाना चाहिए. |
WSDL (wsdl) |
WSDL की वे फ़ाइलें जिनके बारे में SOAPMessageAllowed नीतियों में बताया गया है. |
XSD (xsd) |
SOAPMessageपुष्टि नीति के तहत बताए गए एक्सएमएल स्कीमा. |
XSL Transformations (xsl) |
XSLTransform की नीतियों में रेफ़र किए गए XSLT ट्रांसफ़ॉर्मेशन. |
जहां संसाधन सेव किए जाते हैं
संसाधनों को इनमें से किसी एक जगह पर सेव किया जा सकता है:
- एपीआई प्रॉक्सी में बदलाव: रिसॉर्स सिर्फ़ उन एपीआई प्रॉक्सी संशोधनों के लिए उपलब्ध हैं जिनमें रिसॉर्स शामिल हैं. उदाहरण के लिए, किसी एपीआई प्रॉक्सी के वर्शन 1 के साथ JavaScript रिसॉर्स को शामिल किया जा सकता है. इसके बाद, प्रॉक्सी के बदलाव 2 में Python स्क्रिप्ट का इस्तेमाल करने के लिए, इसे लागू करने के तरीके में बदलाव किया जा सकता है. पहले वर्शन में सिर्फ़ JavaScript के संसाधन का ऐक्सेस होता है और दूसरे बदलाव में सिर्फ़ Python संसाधन का ऐक्सेस होता है.
- एनवायरमेंट: जब किसी एनवायरमेंट (उदाहरण के लिए,
test
याprod
) में इसे स्टोर किया जाता है, तो एक ही एनवायरमेंट में लागू किए गए सभी एपीआई प्रॉक्सी के लिए रिसॉर्स उपलब्ध होते हैं. - संगठन: किसी संगठन में स्टोर किए जाने पर, संसाधन किसी भी माहौल में लागू किए गए किसी भी API प्रॉक्सी के लिए उपलब्ध होते हैं.
डेटा स्टोर करने की जगहें, नीचे दिए गए यूआरआई में उपलब्ध हैं, जैसा कि संसाधन फ़ाइल एपीआई में बताया गया है और बाद में एपीआई का इस्तेमाल करके संसाधन मैनेज करें:
- संगठन:
/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 संसाधन के दिशा-निर्देश
आपके पास JAR फ़ाइलों में कंपाइल किए गए Java रिसॉर्स को जोड़ने का विकल्प होता है. इसके लिए, कर्ल में एक से ज़्यादा विकल्प इस्तेमाल किए जाते हैं. जैसे, -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
यह भी देखें:
- Java के सबसे सही तरीके: एपीआई प्रॉक्सी डिज़ाइन और डेवलपमेंट के सबसे सही तरीके
- Java कुकबुक का उदाहरण: XSL Transform Policy
Node.js के लिए संसाधन से जुड़े दिशा-निर्देश
जब आप किसी एपीआई प्रॉक्सी में Node.js स्क्रिप्ट का रेफ़रंस देते हैं, तो आप एपीआई प्रॉक्सी के TargetEndpoint
कॉन्फ़िगरेशन में मौजूद <ResourceURL>
एलिमेंट का इस्तेमाल करके ऐसा करते हैं.इसके बारे में ऊपर बताया गया है कि किसी मौजूदा एपीआई प्रॉक्सी में Node.js जोड़ना उदाहरण के लिए:
<ScriptTarget> <ResourceURL>node://hello-world.js</ResourceURL> </ScriptTarget>
उस Node.js स्क्रिप्ट और सभी मॉड्यूल को एपीआई प्रॉक्सी में बदलाव करने के दायरे में होना चाहिए
(प्रॉक्सी बंडल की /resources/node
डायरेक्ट्री). एपीआई प्रॉक्सी एडिटर में, स्क्रिप्ट सेक्शन में Node.js रिसॉर्स को जोड़कर यह किया जाता है. इसलिए, एपीआई प्रॉक्सी में बदलाव के दायरे में रिसॉर्स को सेव करने के लिए, एपीआई इंपोर्ट करें और अपडेट करें का इस्तेमाल किया जाता है.
यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके संसाधनों को मैनेज करें
यहां दिए गए सेक्शन में, यूज़र इंटरफ़ेस (यूआई) के हिसाब से एपीआई प्रॉक्सी संशोधन के दायरे वाले संसाधनों को मैनेज करें.
यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके संसाधन देखें
किसी 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"
}
ज़्यादा जानकारी के लिए, एपीआई प्रॉक्सी में बदलाव करने के लिए संसाधन फ़ाइल इंपोर्ट करें देखें.
इसके अलावा, अपडेट एपीआई प्रॉक्सी रिवीज़न एपीआई का इस्तेमाल इस तरह किया जा सकता है:
- संसाधन फ़ाइल बनाएं.
- संसाधन फ़ाइल को एपीआई प्रॉक्सी कॉन्फ़िगरेशन बंडल में जोड़ें.
- इनमें से किसी एक एपीआई का इस्तेमाल करके, बंडल को अपलोड करें:
एपीआई का इस्तेमाल करके, एनवायरमेंट के हिसाब से संसाधन बनाएं
इस तरह के रिसॉर्स के लिए, 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"
}
ज़्यादा जानकारी के लिए, एपीआई प्रॉक्सी में बदलाव करने के लिए संसाधन फ़ाइल इंपोर्ट करें देखें.
इसके अलावा, अपडेट एपीआई प्रॉक्सी रिवीज़न एपीआई का इस्तेमाल इस तरह किया जा सकता है:
- नीचे दिए गए विकल्पों के साथ एक्सपोर्ट एपीआई प्रॉक्सी प्रॉक्सी एपीआई का इस्तेमाल करके, एपीआई प्रॉक्सी कॉन्फ़िगरेशन बंडल डाउनलोड करें:
format
क्वेरी पैरामीटर कोbundle
पर सेट करेंAccept
हेडर कोapplication/zip
पर सेट करें
- एपीआई प्रॉक्सी कॉन्फ़िगरेशन बंडल में संसाधन फ़ाइल अपडेट करें.
- एपीआई प्रॉक्सी अपडेट एपीआई को अपडेट करें का इस्तेमाल करके बंडल अपलोड करें
एपीआई का इस्तेमाल करके, एनवायरमेंट के लिए स्कोप वाले संसाधनों को अपडेट करें
यहां दिए गए संसाधन के लिए 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 प्रॉक्सी के पहले वर्शन से 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"
}
इसके अलावा, अपडेट एपीआई प्रॉक्सी रिवीज़न एपीआई का इस्तेमाल इस तरह किया जा सकता है:
- नीचे दिए गए विकल्पों के साथ एक्सपोर्ट एपीआई प्रॉक्सी प्रॉक्सी एपीआई का इस्तेमाल करके, एपीआई प्रॉक्सी कॉन्फ़िगरेशन बंडल डाउनलोड करें:
format
क्वेरी पैरामीटर कोbundle
पर सेट करेंAccept
हेडर कोapplication/zip
पर सेट करें
- एपीआई प्रॉक्सी कॉन्फ़िगरेशन बंडल से संसाधन फ़ाइल मिटाएं.
- एपीआई प्रॉक्सी अपडेट एपीआई को अपडेट करें का इस्तेमाल करके बंडल अपलोड करें
एपीआई का इस्तेमाल करके, एनवायरमेंट के दायरे वाले संसाधन को मिटाएं
आगे के सेक्शन में बताए गए तरीके से, एपीआई का इस्तेमाल करके एनवायरमेंट के दायरे वाले संसाधन को मिटाएं.
एपीआई का इस्तेमाल करके, एनवायरमेंट के लिए उपलब्ध किसी संसाधन को मिटाने के लिए, इस संसाधन पर 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 को अनुरोध के पोस्टफ़्लो के साथ अटैच करने के लिए, 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 की नीति देखें.