संदर्भ

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

apigee-remote-service-cli कमांड लाइन इंटरफ़ेस (सीएलआई) आपकी मदद करता है Envoy के लिए Apigee अडैप्टर का प्रावधान और उसे मैनेज करना.

बाइंडिंग कमांड

बाइंडिंग, Istio मेश में डिप्लॉय की गई सेवा को Apigee एपीआई प्रॉडक्ट से जोड़ती है. सीएलआई की मदद से, बाइंडिंग बनाई जा सकती हैं, उन्हें हटाया जा सकता है, और उनकी सूची देखी जा सकती है.

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

बाइंडिंग जोड़ना

एपीआई प्रॉडक्ट में रिमोट टारगेट बाइंडिंग जोड़ता है.

इस्तेमाल

Edge Public Cloud के लिए:

apigee-remote-service-cli bindings add [service_name] [product_name]  -o [organization] -e [environment] -u [username] -p [password] -c [config]

Edge Private Cloud के लिए:

apigee-remote-service-cli bindings add [service_name] [product_name]  -o [organization] -e [environment] -u [username] -p [password] -r [runtime] -c [config]

Apigee हाइब्रिड के लिए:

apigee-remote-service-cli bindings add [service_name] [product_name]  -o [organization] -e [environment] -t [token]

पैरामीटर

पैरामीटर टाइप ब्यौरा
-c, --config स्ट्रिंग (ज़रूरी है) Apigee Remote Service की कॉन्फ़िगरेशन फ़ाइल का पाथ. सलाह: यह विकल्प चुनने पर, कमांड के ज़्यादातर अन्य पैरामीटर को छोड़ा जा सकता है. देखें --config विकल्प का इस्तेमाल करके.
-e, --env स्ट्रिंग (ज़रूरी है) आपके संगठन में एक एनवायरमेंट.
-h, --help कमांड पैरामीटर के लिए सहायता दिखाता है.
--insecure एसएसएल का इस्तेमाल करते समय, असुरक्षित सर्वर कनेक्शन को अनुमति दें
--legacy अगर Apigee Edge Cloud का इस्तेमाल किया जा रहा है, तो यह फ़्लैग सेट करें. यह मैनेजमेंट और रनटाइम यूआरएल को सेट करता है इस्तेमाल करें.
--opdk अगर प्राइवेट क्लाउड के लिए Apigee Edge का इस्तेमाल किया जा रहा है, तो यह फ़्लैग सेट करें.
-o, --org स्ट्रिंग (ज़रूरी) Apigee संगठन. आपके पास संगठन के एडमिन की भूमिका होनी चाहिए.
-p, --password स्ट्रिंग आपका Apigee पासवर्ड, सिर्फ़ बुनियादी पुष्टि के लिए ज़रूरी है. वैकल्पिक रूप से, यह बताया जा सकता है .netrc फ़ाइल में पासवर्ड. अगर ऐसा किया जाता है, तो आपको कमांड लाइन पर अपना पासवर्ड डालें. इन्हें भी देखें क्रेडेंशियल के लिए .netrc का इस्तेमाल करना.
-r, --runtime स्ट्रिंग Apigee रनटाइम बेस यूआरएल (हाइब्रिड या opdk के लिए ज़रूरी है).
-t, --token स्ट्रिंग (सिर्फ़ OAuth टोकन की पुष्टि करने के लिए ज़रूरी है) आपने जो OAuth या एसएएमएल टोकन जनरेट किया है आपके Apigee खाते की जानकारी से. टोकन जनरेट करने के बारे में जानकारी के लिए, यहां देखें get_token का इस्तेमाल करना और एसएएमएल के साथ मैनेजमेंट एपीआई को ऐक्सेस करें.
-u, --username स्ट्रिंग (सिर्फ़ बुनियादी पुष्टि करने के लिए ज़रूरी है) आपका Apigee उपयोगकर्ता नाम (आम तौर पर, एक ईमेल पता). आपके पास .netrc फ़ाइल में उपयोगकर्ता नाम डालने का विकल्प होता है. अगर ऐसा किया जाता है, तो आपको कमांड लाइन पर अपना उपयोगकर्ता नाम देने की ज़रूरत नहीं है. यहां जाएं: साथ ही, क्रेडेंशियल के लिए .netrc का इस्तेमाल करना भी.
-v, --verbose (ज़रूरी नहीं) ज़्यादा शब्दों में जवाब दिया जाता है.

उदाहरण

./apigee-remote-service-cli bindings add httpbin.org envoy-test -o myorg -e test -u user@example.com -c config.yaml -p xxxxxx
product envoy-test is now bound to: httpbin.org

लिस्ट बाइंडिंग

रिमोट सर्विस से जुड़े सभी एपीआई प्रॉडक्ट की सूची बनाएं.

इस्तेमाल

Edge Public Cloud के लिए:

apigee-remote-service-cli bindings list -o [organization] -e [environment] -u [username] -p [password]

Edge Private Cloud के लिए:

apigee-remote-service-cli bindings list -o [organization] -e [environment] -u [username] -p [password] -r [runtime] 

पैरामीटर

पैरामीटर टाइप ब्यौरा
-c, --config स्ट्रिंग (ज़रूरी है) Apigee Remote Service की कॉन्फ़िगरेशन फ़ाइल का पाथ. सलाह: यह विकल्प चुनने पर, कमांड के ज़्यादातर अन्य पैरामीटर को छोड़ा जा सकता है. देखें --config विकल्प का इस्तेमाल करके.
-e, --env स्ट्रिंग (ज़रूरी है) आपके संगठन में एक एनवायरमेंट.
-h, --help कमांड पैरामीटर के लिए सहायता दिखाता है.
--insecure एसएसएल का इस्तेमाल करते समय, असुरक्षित सर्वर कनेक्शन को अनुमति दें
--legacy अगर Apigee Edge Cloud का इस्तेमाल किया जा रहा है, तो यह फ़्लैग सेट करें. यह मैनेजमेंट और रनटाइम यूआरएल को सेट करता है इस्तेमाल करें.
--opdk अगर प्राइवेट क्लाउड के लिए Apigee Edge का इस्तेमाल किया जा रहा है, तो यह फ़्लैग सेट करें.
-o, --org स्ट्रिंग (ज़रूरी) Apigee संगठन. आपके पास संगठन के एडमिन की भूमिका होनी चाहिए.
-p, --password स्ट्रिंग आपका Apigee पासवर्ड, सिर्फ़ बुनियादी पुष्टि के लिए ज़रूरी है. आपके पास .netrc फ़ाइल में पासवर्ड डालने का विकल्प होता है. ऐसा करने पर, आपको कमांड लाइन पर अपना पासवर्ड डालने की ज़रूरत नहीं होगी. इन्हें भी देखें क्रेडेंशियल के लिए .netrc का इस्तेमाल करना.
-r, --runtime स्ट्रिंग Apigee रनटाइम बेस यूआरएल (हाइब्रिड या opdk के लिए ज़रूरी है).
-t, --token स्ट्रिंग (सिर्फ़ OAuth टोकन की पुष्टि करने के लिए ज़रूरी है) आपने जो OAuth या एसएएमएल टोकन जनरेट किया है आपके Apigee खाते की जानकारी से. टोकन जनरेट करने के बारे में जानकारी के लिए, यहां देखें get_token का इस्तेमाल करना और एसएएमएल के साथ मैनेजमेंट एपीआई को ऐक्सेस करें.
-u, --username स्ट्रिंग (सिर्फ़ बुनियादी पुष्टि के लिए ज़रूरी है) आपका Apigee उपयोगकर्ता नाम (आम तौर पर एक ईमेल पता). आपके पास .netrc फ़ाइल में उपयोगकर्ता नाम डालने का विकल्प होता है. ऐसा करने पर, आपको कमांड लाइन पर अपना उपयोगकर्ता नाम डालने की ज़रूरत नहीं है. यहां जाएं: साथ ही, क्रेडेंशियल के लिए .netrc का इस्तेमाल करना भी.
-v, --verbose (ज़रूरी नहीं) ज़्यादा जानकारी वाला आउटपुट दिखाता है.

उदाहरण

apigee-remote-service-cli bindings list -o myorg -e test -u user@example.com -c config.yaml -p abc123
PI Products
============
Bound
-----
envoy-test:
  Quota: 5 requests every 1 minute
  Target bindings:
    httpbin.org
  Paths:
httpbin:
  Quota: 5 requests every 1 minute
  Target bindings:
    httpbin.org
  Paths:
    /httpbin
    /

Unbound
-------
product-1:
  Quota: 100 requests every 1 hour
product-2:
  Quota: 1000 requests every 1 month
product-3:
product-4:

बाइंडिंग हटाना

किसी एपीआई प्रॉडक्ट से Envoy के लिए रिमोट सेवा की बाइंडिंग हटाएं.

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

इस्तेमाल

Edge Public Cloud के लिए:

apigee-remote-service-cli bindings remove [service_name] [product_name]  -o [organization] -e [environment] -u [username] -p [password] -c [config]

Edge Private Cloud के लिए:

apigee-remote-service-cli bindings remove [service_name] [product_name]  -o [organization] -e [environment] -u [username] -p [password] -r [runtime] -c [config]

Apigee हाइब्रिड के लिए:

apigee-remote-service-cli bindings remove [service_name] [product_name]  -o [organization] -e [environment] -t [token]

पैरामीटर

पैरामीटर टाइप ब्यौरा
-c, --config स्ट्रिंग (ज़रूरी है) Apigee Remote Service की कॉन्फ़िगरेशन फ़ाइल का पाथ. सलाह: यह विकल्प चुनने पर, कमांड के ज़्यादातर अन्य पैरामीटर को छोड़ा जा सकता है. --config विकल्प का इस्तेमाल करना देखें.
-e, --env स्ट्रिंग (ज़रूरी है) आपके संगठन में एक एनवायरमेंट.
-h, --help कमांड पैरामीटर के लिए सहायता दिखाता है.
--insecure एसएसएल का इस्तेमाल करते समय, असुरक्षित सर्वर कनेक्शन को अनुमति दें
--legacy अगर Apigee Edge Cloud का इस्तेमाल किया जा रहा है, तो यह फ़्लैग सेट करें. यह मैनेजमेंट और रनटाइम यूआरएल को सेट करता है इस्तेमाल करें.
--opdk अगर प्राइवेट क्लाउड के लिए Apigee Edge का इस्तेमाल किया जा रहा है, तो यह फ़्लैग सेट करें.
-o, --org स्ट्रिंग (ज़रूरी) Apigee संगठन. आपके पास संगठन के एडमिन की भूमिका होनी चाहिए.
-p, --password स्ट्रिंग आपका Apigee पासवर्ड, सिर्फ़ बुनियादी पुष्टि के लिए ज़रूरी है. वैकल्पिक रूप से, यह बताया जा सकता है .netrc फ़ाइल में पासवर्ड. अगर ऐसा किया जाता है, तो आपको कमांड लाइन पर अपना पासवर्ड डालें. इन्हें भी देखें क्रेडेंशियल के लिए .netrc का इस्तेमाल करना.
-r, --runtime स्ट्रिंग Apigee रनटाइम बेस यूआरएल (हाइब्रिड या opdk के लिए ज़रूरी है).
-t, --token स्ट्रिंग (सिर्फ़ OAuth टोकन की पुष्टि करने के लिए ज़रूरी है) आपने जो OAuth या एसएएमएल टोकन जनरेट किया है आपके Apigee खाते की जानकारी से. टोकन जनरेट करने के बारे में जानकारी के लिए, यहां देखें get_token का इस्तेमाल करना और एसएएमएल के साथ मैनेजमेंट एपीआई को ऐक्सेस करें.
-u, --username स्ट्रिंग (सिर्फ़ बुनियादी पुष्टि के लिए ज़रूरी है) आपका Apigee उपयोगकर्ता नाम (आम तौर पर एक ईमेल पता). आपके पास .netrc फ़ाइल में उपयोगकर्ता नाम डालने का विकल्प भी होता है. ऐसा करने पर, आपको कमांड लाइन पर अपना उपयोगकर्ता नाम डालने की ज़रूरत नहीं होती. क्रेडेंशियल के लिए .netrc का इस्तेमाल करना भी देखें.
-v, --verbose (ज़रूरी नहीं) ज़्यादा शब्दों में जवाब दिया जाता है.

उदाहरण

./apigee-remote-service-cli bindings remove httpbin.org envoy-test -o myorg -e test -u user@example.com -c config.yaml -p xxxxxx
product envoy-test is no longer bound to: httpbin.org

सहायता आदेश

apigee-remote-service-cli के सभी निर्देशों के लिए, ऑनलाइन मदद दी जाती है. बस टाइप करें:

apigee-remote-service-cli help

किसी भी निर्देश के बारे में मदद पाने के लिए, यह टाइप करें:

apigee-remote-service-cli [command] help

उदाहरण के लिए:

apigee-remote-service-cli provision help

प्रॉविज़निंग का निर्देश

apigee-remote-service-cli provision निर्देश आपके Apigee में प्रॉक्सी इंस्टॉल करता है Edge मैनेज करने के लिए, सर्टिफ़िकेट सेट अप किया जाता है, और ज़रूरी क्रेडेंशियल जनरेट किए जाते हैं Envoy के लिए Apigee अडैप्टर कॉन्फ़िगर करें.

इस्तेमाल

अगर Edge Public Cloud का इस्तेमाल किया जा रहा है, तो:

apigee-remote-service-cli provision -o $ORG -e $ENV -u $USERNAME -p $PASSWORD

अगर आप Edge Private Cloud का इस्तेमाल करते हैं, तो:

apigee-remote-service-cli provision --opdk -o $ORG -e $ENV -u $USERNAME --management $MGMT_SERVER_URL --runtime $RUNTIME_URL -p $PASSWORD

पैरामीटर

पैरामीटर टाइप ब्यौरा
-c, --config स्ट्रिंग Apigee रिमोट सेवा कॉन्फ़िगरेशन फ़ाइल का पाथ. अहम जानकारी: जब इस विकल्प से, ज़्यादातर अन्य कमांड पैरामीटर को छोड़ा जा सकता है. देखें --config विकल्प का इस्तेमाल करके.
-e, --environment स्ट्रिंग (ज़रूरी है) आपके संगठन में एक एनवायरमेंट.
-f, --force-proxy-install (ज़रूरी नहीं) अगर ऐसा है, तो remote-service प्रॉक्सी को हर हाल में फिर से इंस्टॉल किया जाता है आपके संगठन में पहले से इंस्टॉल है.
-h, --help कमांड पैरामीटर के बारे में सहायता दिखाता है.
-k, --key स्ट्रिंग इससे वापस मिली कुंजी के बारे में पता चलता है apigee-remote-service-cli provision निर्देश.
--legacy Apigee SaaS (मैनेजमेंट और रनटाइम यूआरएल सेट करता है)
-m, --management स्ट्रिंग अगर Apigee Private Cloud का इस्तेमाल किया जा रहा है, तो यह ज़रूरी है. आपके Apigee मैनेजमेंट का बेस यूआरएल. डिफ़ॉल्ट: https://api.enterprise.apigee.com
-n, --namespace स्ट्रिंग बताए गए नेमस्पेस में, Envoy ConfigMap के तौर पर कॉन्फ़िगरेशन दें.
--opdk स्ट्रिंग Apigee ओपीडीके.
-o, --organization स्ट्रिंग (ज़रूरी है) आपका Apigee संगठन. आपको संगठन का एडमिन होना ज़रूरी है.
-p, --password स्ट्रिंग (सिर्फ़ बुनियादी पुष्टि के लिए ज़रूरी है) आपका Apigee पासवर्ड. आपके पास .netrc फ़ाइल में पासवर्ड डालने का विकल्प होता है. अगर ऐसा किया जाता है, तो आपको कमांड लाइन पर अपना पासवर्ड डालें. क्रेडेंशियल के लिए .netrc का इस्तेमाल करना लेख भी देखें.
--rotate-int int अगर n > 0, नई निजी कुंजी जनरेट करें और n सार्वजनिक कुंजियां रखें (सिर्फ़ हाइब्रिड)
-r, --runtime स्ट्रिंग Apigee रनटाइम का बेस यूआरएल (हाइब्रिड या OPDK के लिए ज़रूरी है)
-s, --secret स्ट्रिंग apigee-remote-service-cli provision कमांड से मिला गुप्त पासवर्ड बताता है.
--strength int (वैकल्पिक) यह प्रावधान, अडैप्टर. डिफ़ॉल्ट 2048
-t, --token स्ट्रिंग (सिर्फ़ हाइब्रिड) Apigee OAuth या एसएएमएल टोकन.
-u, --username स्ट्रिंग (सिर्फ़ बुनियादी पुष्टि के लिए ज़रूरी है) आपका Apigee उपयोगकर्ता नाम (आम तौर पर एक ईमेल पता). आपके पास .netrc फ़ाइल में उपयोगकर्ता नाम डालने का विकल्प भी होता है. क्रेडेंशियल के लिए .netrc का इस्तेमाल करना भी देखें.
-v, --verbose (ज़रूरी नहीं) ज़्यादा शब्दों में जवाब दिया जाता है.
--virtual-hosts स्ट्रिंग यह ऐसे डिफ़ॉल्ट वर्चुअल होस्ट को बदल देता है जो "डिफ़ॉल्ट, सुरक्षित" होते हैं. इस विकल्प का इस्तेमाल तब करें, जब आपके एज संगठन के एनवायरमेंट के लिए, डिफ़ॉल्ट के अलावा वर्चुअल होस्ट तय किए गए हों. जानने के लिए Edge दस्तावेज़ देखें वर्चुअल होस्ट के बारे में जानकारी.
--years int (वैकल्पिक) प्रावधान में उपयोग किए गए SSL प्रमाणपत्र से पहले के सालों की संख्या समय-सीमा खत्म. डिफ़ॉल्ट: 1

उदाहरण

पक्का करें कि आपने provision कमांड के आउटपुट को उसी फ़ाइल में कैप्चर किया हो जिसका इस्तेमाल किया गया है Envoy ऑपरेशन के लिए अन्य Apigee अडैप्टर के इनपुट के तौर पर.

Edge Public Cloud का उदाहरण:

apigee-remote-service-cli provision --legacy --username $USER --password $PASSWORD --organization $ORG --environment $ENV > config.yaml

Apigee हाइब्रिड का उदाहरण:

apigee-remote-service-cli provision --organization $ORG --environment $ENV --runtime $RUNTIME --namespace $NAMESPACE --token $TOKEN > config.yaml

टोकन कमांड

किसी एपीआई पासकोड के बजाय, पुष्टि किए गए एपीआई प्रॉक्सी कॉल करने के लिए, JWT टोकन का इस्तेमाल किया जा सकता है. टोकन कमांड की मदद से, इस काम के लिए JWT टोकन बनाए जा सकते हैं, उनकी जांच की जा सकती है, और उन्हें घुमाया जा सकता है.

कोई JWT टोकन बनाएं

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

इस्तेमाल

Edge Public Cloud के लिए:
apigee-remote-service-cli token create -c [config_file] --id [consumer_key] --secret [consumer_secret] -o [org] -e [env]
Edge Private Cloud के लिए:
apigee-remote-service-cli token create -c [config_file] --id [consumer_key] --secret [consumer_secret] -r [runtime] -o [org] -e [env]
Apigee हाइब्रिड के लिए:
apigee-remote-service-cli token create -c [config_file] --id [consumer_key] --secret [consumer_secret] -r [runtime] -o [org] -e [env]

पैरामीटर

पैरामीटर टाइप ब्यौरा
-c, --config स्ट्रिंग (ज़रूरी है) Apigee रिमोट सेवा कॉन्फ़िगरेशन फ़ाइल का पाथ. अहम जानकारी: जब इस विकल्प से, ज़्यादातर अन्य कमांड पैरामीटर को छोड़ा जा सकता है. देखें --config विकल्प का इस्तेमाल करके.
-e, --env स्ट्रिंग (ज़रूरी है) आपके संगठन में एक एनवायरमेंट.
-h, --help यह कमांड पैरामीटर के लिए सहायता दिखाता है.
--insecure एसएसएल का इस्तेमाल करते समय, असुरक्षित सर्वर कनेक्शन को अनुमति दें.
-o, --org स्ट्रिंग (ज़रूरी) Apigee संगठन. आपके पास संगठन के एडमिन की भूमिका होनी चाहिए.
-r, --runtime स्ट्रिंग Apigee रनटाइम बेस यूआरएल (सिर्फ़ हाइब्रिड या opdk के लिए ज़रूरी है).
-v, --verbose (ज़रूरी नहीं) ज़्यादा शब्दों में जवाब दिया जाता है.

उदाहरण

apigee-remote-service-cli token create -o myorg -e test -i YUmlZAcBKNsTAelJqPZFl3sh58ObATX9 -s icTARgaKHqvUH1dq -c config.yaml

आउटपुट

कामयाब होने पर, आपको नीचे दिए गए जैसा एक जेएसटी टोकन आउटपुट दिखेगा:
eyJraWQiOiIxIiwidHlwIjoiSldUIiwiYWxnIjoiUlMyNTYifQ.eyJhY2Nlc3NfdG9rZW4iOiJ0a2tlVzVKQTY2a0pZYTB4bFV1cVBsUW1BMU43IiwiYXVkIjoiaXN0aW8iLCJuYmYiOjE1MzAxMzg1OTEsImFwaV9wcm9kdWN0X2xpc3QiOlsiaXN0aW8tcHJvZHVjdCJdLCJhcHBsaWNhdGlvbl9uYW1lIjoiaXN0aW8tYXBwIiwiZGV2ZWxvcGVyX2VtYWlsIjoicFluZ2Zsb3lkQGdvb2dsZS5jb20iLCJpc3MiOiJodHRwczovL2FwaWdlZXNlYXJjaC10ZXN0LmFwaWdlZS5uZXQvaXN0aW8tYXV0aC90b2tlbiIsImV4cCI6MTUzMDEzOTQ5MSwiaWF0IjoxNTMwMTM4NTkxLCJqdGkiOiIxODgzMzViZi0wMmE4LTRjZGUsOGFkOS0yMWJmNDZjNmRjZDkiLCJjbGllbnRfaWQiOiJZVW1sWkFjQktOc1RBZWxKcVBZRmwzc2g1OE9iQVRYOSJ9.AL7pKSTmond-NSPRNNHVbIzTdAnZjOXcjQ-BbOJ_8lsQvF7PuiOUrGIhY5XTcJusisKgbCdtIxBl8Wq1EiQ_fKnUc3JYYOqzpTB5bGoFy0Yqbfu96dneuWyzgZnoQBkqwZkbQTIg7WNTGx1TJX-UTePvBPxAefiAbaEUcigX9tTsXPoRJZOTrm7IOeKpxpB_gQYkxQtV1_NbERxjTPyMbHdMWal9_xRVzSt7mpTGudMN9OR-VtQ1uXA67GOqhZWcOzq57qImOiCMbaoKnKUADevyWjX_VscN5ZZUtzQUQhTrmv8aR69-uVhMIPKp9juMyYKaYn2IsYZEeCWfhfV45Q

JWT टोकन की जांच करना

इस निर्देश की मदद से, JWT टोकन की जांच की जा सकती है. टोकन की जांच करना भी देखें.

इस्तेमाल

Edge Public Cloud के लिए:
apigee-remote-service-cli token inspect -o [organization] -e [environment] -f [token_file]
Edge Private Cloud के लिए:
apigee-remote-service-cli token inspect -o [organization] -e [environment] -f [token_file] --runtime [host_alias]
Apigee हाइब्रिड के लिए:
apigee-remote-service-cli token inspect -o [organization] -e [environment] -f [token_file] --runtime [host_alias]

पैरामीटर

पैरामीटर टाइप ब्यौरा
-c, --config स्ट्रिंग (ज़रूरी है) Apigee Remote Service की कॉन्फ़िगरेशन फ़ाइल का पाथ. सलाह: यह विकल्प चुनने पर, कमांड के ज़्यादातर अन्य पैरामीटर को छोड़ा जा सकता है. देखें --config विकल्प का इस्तेमाल करके.
-e, --env स्ट्रिंग (ज़रूरी है) आपके संगठन में एक एनवायरमेंट.
-h, --help यह कमांड पैरामीटर के लिए सहायता दिखाता है.
--insecure एसएसएल का इस्तेमाल करते समय, असुरक्षित सर्वर कनेक्शन को अनुमति दें.
-o, --org स्ट्रिंग (ज़रूरी) Apigee संगठन. आपके पास संगठन के एडमिन की भूमिका होनी चाहिए.
-r, --runtime स्ट्रिंग Apigee रनटाइम बेस यूआरएल (सिर्फ़ हाइब्रिड या opdk के लिए ज़रूरी है).
-v, --verbose (ज़रूरी नहीं) ज़्यादा शब्दों में जवाब दिया जाता है.

उदाहरण

apigee-remote-service-cli token inspect -c config.yaml <<< $TOKEN

आउटपुट

सफल होने पर, आपको इस तरह का आउटपुट दिखेगा:
{
	"aud": [
		"remote-service-client"
	],
	"exp": 1591741549,
	"iat": 1591740649,
	"iss": "https://apigee-docs-test.apigee.net/remote-service/token",
	"jti": "99325d2e-6440-4278-9f7f-b252a1a79e53",
	"nbf": 1591740649,
	"access_token": "VfzpXzBGAQ07po0bPMKY4JgQjus",
	"api_product_list": [
		"httpbin"
	],
	"application_name": "httpbin",
	"client_id": "GYDGHy5TRpV8AejXCOlreP7dPVepA8H",
	"developer_email": "user@example.com",
	"scope": ""
}
verifying...
token ok.

JWT टोकन घुमाएं

JWT जनरेट करने के बाद, आपको सार्वजनिक/निजी पासकोड में बदलाव करना पड़ सकता है Apigee Edge के पास मौजूद इस पेयर को, एन्क्रिप्ट (सुरक्षित) किए गए की-वैल्यू मैप (केवीएम) में सेव किया गया है. जनरेट करने की यह प्रोसेस तो कुंजी का नया जोड़ा, 'की रोटेशन' कहते हैं. कुंजियों को घुमाने पर, एक नया निजी/सार्वजनिक कुंजी का जोड़ा जनरेट और सेव किया जाता है. आपके Apigee Edge संगठन/एनवायरमेंट में केवीएम. साथ ही, पुरानी सार्वजनिक कुंजी, उसके मूल कुंजी आईडी की वैल्यू के साथ बनी रहती है.

इस्तेमाल

अगर Edge Public Cloud का इस्तेमाल किया जा रहा है, तो:
apigee-remote-service-cli token rotate-cert -c [config_file] -o [organization] -e [environment] -k [provision_key] -s [provision_secret] --kid [new_key_id]
अगर आप Edge Private Cloud का इस्तेमाल करते हैं, तो:
apigee-remote-service-cli token rotate-cert -o [organization] -e [environment] -u [username] -p [password] -k [provision_key] -s [provision_secret] --kid [new_key_id]

पैरामीटर

पैरामीटर टाइप ब्यौरा
-c, --config स्ट्रिंग (ज़रूरी है) Apigee रिमोट सेवा कॉन्फ़िगरेशन फ़ाइल का पाथ. सलाह: यह विकल्प चुनने पर, कमांड के ज़्यादातर अन्य पैरामीटर को छोड़ा जा सकता है. देखें --config विकल्प का इस्तेमाल करके.
-e, --env स्ट्रिंग (ज़रूरी है) आपके संगठन में एक एनवायरमेंट.
-h, --help कमांड पैरामीटर के लिए सहायता दिखाता है.
--insecure एसएसएल का इस्तेमाल करते समय, असुरक्षित सर्वर कनेक्शन को अनुमति दें
--truncate int jwks में सेव किए जाने वाले सर्टिफ़िकेट की संख्या (डिफ़ॉल्ट रूप से दो)
-o, --org स्ट्रिंग (ज़रूरी) Apigee संगठन. आपके पास संगठन के एडमिन की भूमिका होनी चाहिए.
-r, --runtime स्ट्रिंग Apigee रनटाइम का बेस यूआरएल (हाइब्रिड या opdk के लिए ज़रूरी है).
-v, --verbose (ज़रूरी नहीं) ज़्यादा शब्दों में जवाब दिया जाता है.

उदाहरण

apigee-remote-service-cli token rotate-cert -c config.yaml -o myorg -e test -k 2e238ffa15dc5ab6a1e97868e7581f6c60ddb8575478582c256d8b7e5b2677a8 -s 51058077223fa7b683c3bea845c5cca138340d1d5583922b6d465f9f918a4b08

आउटपुट

certificate successfully rotated

क्रेडेंशियल के लिए .netrc का इस्तेमाल करना

अगर आप Edge Public Cloud का इस्तेमाल कर रहे हैं और आपके पास मशीन api.enterprise.apigee.com के लिए एंट्री है, तो apigee-remote-service-cli आपकी होम डायरेक्ट्री में मौजूद .netrc फ़ाइल से username और password (ज़रूरत पड़ने पर बुनियादी पुष्टि के लिए) को अपने-आप चुन लेता है. अगर आप Apigee Private Cloud का इस्तेमाल कर रहे हैं, तो मशीन वैल्यू आपके management यूआरएल (उदाहरण के लिए: http://192.162.55.100) जैसी ही होगी. Edge Public Cloud पर, उदाहरण के लिए:
machine api.enterprise.apigee.com
login jdoe@google.com
password abc123
Edge Private Cloud पर, उदाहरण के लिए:
machine http://192.162.55.100
login jdoe@google.com
password abc123

वर्शन निर्देश

सीएलआई वर्शन प्रिंट करें.

apigee-remote-service-cli version

--config निर्देश विकल्प का इस्तेमाल किया जा रहा है

--config विकल्प से जगह की जानकारी मिलती है provision कमांड से जनरेट की गई कॉन्फ़िगरेशन फ़ाइल का. इस विकल्प का एक मददगार फ़ायदा यह है कि की मदद से ज़्यादातर ऐसे कमांड पैरामीटर को स्किप किया जा सकता है जो सीएलआई, कॉन्फ़िगरेशन फ़ाइल से लेता है. इन विकल्पों में ये शामिल हैं:
  • संगठन
  • वातावरण
  • रनटाइम
  • मैनेजमेंट
  • असुरक्षित
  • नाम स्थान
  • लेगसी
  • opdk

उदाहरण के लिए, provision कमांड को इस तरह से चलाया जा सकता है:

apigee-remote-service-cli provision --config='old-config.yaml' > new-config.yaml

कॉन्फ़िगरेशन फ़ाइल

इस सेक्शन में कॉन्फ़िगरेशन फ़ाइल का एक उदाहरण दिया गया है, जिसमें सभी विकल्प मौजूद हैं.

global:
  temp_dir: /tmp/apigee-istio
  keep_alive_max_connection_age: 10m
  api_address: :5000
  metrics_address: :5001
  tls:
    cert_file: tls.crt
    key_file: tls.key
tenant:
  internal_api: https://istioservices.apigee.net/edgemicro
  remote_service_api: https://org-test.apigee.net/remote-service
  org_name: org
  env_name: env
  key: mykey
  secret: mysecret
  client_timeout: 30s
  allow_unverified_ssl_cert: false
products:
  refresh_rate: 2m
analytics:
  legacy_endpoint: false
  file_limit: 1024
  send_channel_size: 10
  collection_interval: 10s
  fluentd_endpoint: apigee-udca-myorg-test.apigee.svc.cluster.local:20001
  tls:
    ca_file: /opt/apigee/tls/ca.crt
    cert_file: /opt/apigee/tls/tls.crt
    key_file: /opt/apigee/tls/tls.key
    allow_unverified_ssl_cert: false
auth:
  api_key_claim: claim
  api_key_cache_duration: 30m
  api_key_header: x-api-key
  api_target_header: :authority
  reject_unauthorized: true
  jwks_poll_interval: 0s