Edge for Private Cloud v4.18.05
Edge कॉन्फ़िगरेशन वाले एक जैसे टास्क करने के लिए, apigee-adminapi.sh सुविधा का इस्तेमाल करें
जिसे आप Edge management API की मदद से कॉल कर सकते हैं. इस सुविधा का फ़ायदा
apigee-adminapi.sh की सुविधा काम करती है:
- आसान कमांड-लाइन इंटरफ़ेस का इस्तेमाल करना
- टैब आधारित आदेश पूरा करने की सुविधा लागू करती है
- मदद और इस्तेमाल के बारे में जानकारी देता है
- अगर आपने एपीआई को इस्तेमाल करने का फ़ैसला किया है, तो इससे जुड़े एपीआई कॉल दिखाए जा सकते हैं
apigee-adminapi.sh यूटिलिटी,
apigee-provision उपयोगिता. apigee-provision यूटिलिटी असल में
apigee-adminapi.sh उपयोगिता का काम.
दोनों के बीच मुख्य अंतर ये हैं:
apigee-adminapi.shयूटिलिटी ऐसे ऐटॉमिक काम करती है जो अलग-अलग Edge API कॉल कर सकते हैं. उदाहरण के लिए, संगठन, एनवायरमेंट, और वर्चुअल कॉन्टेंट बनाने के लिए होस्ट को तीन अलग-अलगapigee-adminapi.shकमांड की ज़रूरत है, जो तीन से जुड़े हैं एपीआई कॉल.apigee-provisionयूटिलिटी को इस तरह से डिज़ाइन किया गया है कि यह पूरी तरह से हाई-लेवल पर काम कर सके एक कमांड में कार्रवाई करता है. उदाहरण के लिए, संगठन, एनवायरमेंट, और एक कॉन्फ़िगरेशन फ़ाइल पास करके, एकapigee-provisionनिर्देश वाला वर्चुअल होस्ट सभी ज़रूरी जानकारी.
Edge दस्तावेज़ जहां भी ज़रूरी हो वहां दोनों सुविधाएं इस्तेमाल करता है.
apigee-adminapi.sh इंस्टॉल किया जा रहा है
जब आप इसे इंस्टॉल करते हैं तो apigee-adminapi.sh यूटिलिटी अपने आप इंस्टॉल हो जाती है:
apigee-provision या apigee-validate यूटिलिटी.
उपयोगिता को निम्न स्थान पर इंस्टॉल किया गया है:
/opt/apigee/apigee-adminapi/bin/apigee-adminapi.sh
/opt/apigee/apigee-adminapi/bin/apigee-adminapi.sh सिंटैक्स
apigee-adminapi.sh यूटिलिटी एक सामान्य कमांड लाइन सिंटैक्स का इस्तेमाल करती है. किसी भी समय, इसका इस्तेमाल करें
टैब बटन का इस्तेमाल करें.
सभी संभावित कमांड देखने के लिए, बिना किसी विकल्प के सुविधा शुरू करें:
/opt/apigee/apigee-adminapi/bin/apigee-adminapi.sh
अगर apigee-adminapi.sh टाइप करने के बाद, Tab बटन दबाया जाता है, तो आपको संभावित कॉलम की सूची दिखेगी विकल्प:
analytics classification logsessions regions securityprofile userroles buildinfo GET orgs runtime servers users
Tab बटन, निर्देश के कॉन्टेक्स्ट के आधार पर विकल्प दिखाता है. अगर Tab बटन दबाया जाता है, तो टाइप करने के बाद:
/opt/apigee/apigee-adminapi/bin/apigee-adminapi.sh orgs
आपको orgs निर्देश को पूरा करने के लिए संभावित विकल्प दिखेंगे:
add apis apps delete envs list pods userroles
किसी भी निर्देश के लिए सहायता दिखाने के लिए, -h विकल्प का इस्तेमाल करें. उदाहरण के लिए, यदि आप
-h विकल्प नीचे दिया गया है:
/opt/apigee/apigee-adminapi/bin/apigee-adminapi.sh orgs -h
यह सुविधा, इस सेवा के सभी संभावित विकल्पों के लिए सहायता से जुड़ी पूरी जानकारी दिखाती है
orgs निर्देश. आउटपुट का पहला आइटम
orgs add निर्देश:
+++++++++++++++++++++++++++++++++++++++++++
orgs add
Required:
-o ORG Organization name
Optional:
-H HEADER add http header in request
--admin ADMIN_EMAIL admin email address
--pwd ADMIN_PASSWORD admin password
--host EDGE_SERVER edge server to make request to
--port EDGE_PORT port to use for the http request
--ssl set EDGE_PROTO to https, defaults to http
--debug ( set in debug mode, turns on verbose in curl )
-h Displays Help
पैरामीटर सेट करना कमांड-लाइन स्विच और एनवायरमेंट वैरिएबल का इस्तेमाल करके
आपको कमांड-लाइन स्विच का इस्तेमाल करके या एनवायरमेंट वैरिएबल. कमांड लाइन के आगे एक डैश (-) या डबल डैश लगाएं (--) डालें.
उदाहरण के लिए, "संगठनों के जोड़ना" के लिए, ऊपर दिए गए सहायता लेख से आदेश देते हैं, तो आप संगठन का नाम इनमें से कोई एक:
-oकमांड लाइन स्विच का इस्तेमाल करके:/opt/apigee/apigee-adminapi/bin/apigee-adminapi.sh orgs -o testOrg
ORGनाम का एनवायरमेंट वैरिएबल सेट करने के लिए:> export ORG=testOrg
/opt/apigee/apigee-adminapi/bin/apigee-adminapi.sh orgs
अगर आप निर्देश के लिए किसी भी ज़रूरी पैरामीटर को छोड़ देते हैं, तो यूटिलिटी एक गड़बड़ी मैसेज दिखाती है
जो पैरामीटर मौजूद नहीं हैं. उदाहरण के लिए, अगर आपने --host या
बनाते समय, एज मैनेजमेंट सर्वर के बारे में बताने वाला EDGE_SERVER एनवायरमेंट वैरिएबल
किसी संगठन को इंस्टॉल करने पर, आपको गड़बड़ी का यह मैसेज दिखता है:
Error with required variable or parameter ADMIN_PASSWORD....OK ADMIN_EMAIL....OK EDGE_SERVER....null
एनवायरमेंट वैरिएबल के तौर पर अक्सर सेट किए जाने वाले दो सामान्य पैरामीटर, sys admin ईमेल पते हैं मैनेजमेंट सर्वर का पता और आईपी पता:
export ADMIN_EMAIL=foo@bar.com
export EDGE_SERVER=192.168.56.101
किसी फ़ाइल को apigee-adminapi.sh पर पास करना उपयोगिता
कुछ apigee-adminapi.sh बिजली, पानी जैसी सुविधाओं के निर्देश
अनुरोध का मुख्य हिस्सा लेने वाले PUT और POST API कॉल के लिए. उदाहरण के लिए, वर्चुअल विंडो
होस्ट एक POST API कॉल से मेल खाता है, जिसे
अनुरोध का मुख्य हिस्सा.
इन कामों के लिए apigee-adminapi.sh सुविधा का इस्तेमाल करते समय
एक वर्चुअल होस्ट बनाते हैं, या कोई ऐसा निर्देश देते हैं जो अनुरोध का मुख्य भाग लेता है, तो आप सभी
कमांड लाइन पर ज़रूरी जानकारी डालें, जैसा कि नीचे बताया गया है:
/opt/apigee/apigee-adminapi/bin/apigee-adminapi.sh orgs envs virtual_hosts add -e prod -o testOrg --host localhost --admin foo@bar.com -v myVHostUtil -p 9005 -a 192.168.56.101:9005
इसके अलावा, आपके पास अनुरोध में शामिल की गई जानकारी वाली फ़ाइल पास करने का भी विकल्प है पोस्ट का मुख्य हिस्सा. उदाहरण के लिए, वर्चुअल होस्ट को परिभाषित करने वाली फ़ाइल लेने के लिए नीचे दिया गया निर्देश दिया जाता है:
/opt/apigee/apigee-adminapi/bin/apigee-adminapi.sh orgs envs virtual_hosts add -e prod -o testOrg --host localhost --admin foo@bar.com -f vhostcreate
जहां vhostcreate फ़ाइल में कॉल का पीओएसटी मुख्य हिस्सा होता है. इस उदाहरण में,
यह एक्सएमएल फ़ॉर्मैट में बनाए गए अनुरोध का मुख्य हिस्सा है:
<VirtualHost name="myVHostUtil">
<HostAliases>
<HostAlias>192.168.56.101:9005</HostAlias>
</HostAliases>
<Interfaces/>
<Port>9005</Port>
</VirtualHost>
डीबग और एपीआई की जानकारी दिखाई जा रही है
दिखाने के लिए apigee-adminapi.sh यूटिलिटी में --debug विकल्प का इस्तेमाल करें
कमांड के बारे में ज़्यादा जानकारी. इस जानकारी में इससे जनरेट किया गया कर्ल निर्देश शामिल है
कार्रवाई करने के लिए apigee-adminapi.sh यूटिलिटी.
उदाहरण के लिए, यह निर्देश --debug विकल्प का इस्तेमाल करता है:
/opt/apigee/apigee-adminapi/bin/apigee-adminapi.sh orgs add -o testOrg2 --admin foo@bar.com --host localhost --debug
इसके बाद, जनरेट किया गया कर्ल कमांड के साथ-साथ यह आउटपुट दिखाता है:
curl -H Content-Type: application/xml -v -X POST -s -k -w \n==> %{http_code}
-u ***oo@bar.com:***** http://localhost:8080/v1/o -d <Organization name="testOrg2"
type="paid"/>
* About to connect() to localhost port 8080 (#0)
* Trying ::1... connected
* Connected to localhost (::1) port 8080 (#0)
* Server auth using Basic with user 'foo@bar.com'
> POST /v1/o HTTP/1.1
> Authorization: Basic c2dp234234NvbkBhcGlnZ2342342342342341Q5
> User-Agent: curl/7.19.7 (x86_64-redhat-linux-gnu) libcurl/7.19.7 NSS/3.19.1
Basic ECC zlib/1.2.3 libidn/1.18 libssh2/1.4.2
> Host: localhost:8080
> Accept: */*
> Content-Type: application/xml
> Content-Length: 43
>
} [data not shown]
< HTTP/1.1 201 Created
< Content-Type: application/json
< Date: Tue, 03 May 2016 02:08:32 GMT
< Content-Length: 291
<
{ [data not shown]
* Connection #0 to host localhost left intact
* Closing connection #0