इस पेज का अनुवाद Cloud Translation API से किया गया है.

Acurl का इस्तेमाल किया जा रहा है

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

acurl⁽¹⁾ सुविधा, स्टैंडर्ड curl के चारों ओर सुविधा रैपर देती है आदेश. acurl:

यह आपके Apigee क्रेडेंशियल को OAuth2 ऐक्सेस टोकन के लिए एक्सचेंज करता है.
ऐक्सेस टोकन की समयसीमा खत्म होने का पता लगाता है. साथ ही, नया ऐक्सेस टोकन पाने के लिए रीफ़्रेश टोकन का इस्तेमाल करता है.
एपीआई अनुरोध के Authorization हेडर में उस टोकन को पास करता है.

OAuth2 की मदद से, Edge API एंडपॉइंट को कॉल करने के लिए ऐक्सेस टोकन का इस्तेमाल किया जाता है. इनमें ये शामिल हैं LDAP और SAML वर्कफ़्लो.

अगर Edge API को ऐक्सेस करने के लिए OAuth2 का इस्तेमाल किया जा रहा है, लेकिन acurl का इस्तेमाल नहीं किया जा रहा है, तो आपको इन बातों का ध्यान रखना चाहिए एक ऐक्सेस टोकन पाएं और उसे खुद एपीआई अनुरोध के हेडर में जोड़ें. पाने का एक तरीका है. ऐक्सेस टोकन get_token यूटिलिटी के पास है.

acurl इंस्टॉल करें

acurl का इस्तेमाल करने से पहले, आपको ये काम करने होंगे इसे इंस्टॉल करें.

एक्यूल सिंटैक्स

acurl यूटिलिटी इस सिंटैक्स का इस्तेमाल करती है:

acurl API_URL -u USERNAME:PASSWORD [-m MFACODE]

या

acurl API_URL -p PASSCODE

कहां:

विकल्प	ज़रूरी है?	जानकारी
`API_URL`	ज़रूरी है	Apigee Edge एपीआई एंडपॉइंट. एंडपॉइंट की पूरी सूची देखने के लिए, Apigee Edge API का रेफ़रंस देखें.
`USERNAME`	ज़रूरी नहीं. उपयोगकर्ता नाम और पासवर्ड या फिर पासवर्ड डालना ज़रूरी है.	आपका Apigee उपयोगकर्ता नाम, जो आम तौर पर आपके Apigee खाते से जुड़ा ईमेल पता होता है. पहली बार `get_token` को कॉल करने पर, आपको अपना उपयोगकर्ता नाम या पासवर्ड पास करना होगा. आपको अपना ईमेल पास करने की ज़रूरत नहीं होगी पता दोबारा तब तक सबमिट करें, जब तक ऐक्सेस और रीफ़्रेश टोकन की समयसीमा खत्म नहीं हो जाती. अगर टोकन कैश मेमोरी में सेव किए जा रहे हैं का उपयोग करते हैं, तो आपको प्रत्येक कॉल में अपना उपयोगकर्ता नाम दर्ज करना होगा.
`PASSWORD`	ज़रूरी नहीं. उपयोगकर्ता नाम और पासवर्ड या फिर पासवर्ड डालना ज़रूरी है.	आपके Apigee खाते का पासवर्ड. पासवर्ड भूल जाने पर, आपको इसे पहली बार `acurl` का इस्तेमाल करते समय डालें. इसके अलावा, बाद में होने वाले ऐसे कॉल के लिए भी मान्य आईडी डालें रीफ़्रेश टोकन. अगर आपको सीधे निर्देश में अपना पासवर्ड इस्तेमाल नहीं करना है, तो पासवर्ड की जगह एक बार इस्तेमाल होने वाला कोड पासवर्ड डालें.
`MFACODE`	ज़रूरी नहीं	कुछ समय के लिए छह अंकों वाला एक से ज़्यादा तरीकों का इस्तेमाल करें ऑथेंटिकेशन (MFA) कोड. अगर `-u` का इस्तेमाल किया जा रहा है और MFA चालू है, तो यह कोड ज़रूरी है. अगर इसे छोड़ा जाता है, तो आपको प्रॉम्प्ट दिखाया जाएगा (जब तक कि पासवर्ड मोड में न हो). अगर आपके पास MFA चालू नहीं है या आपका कोई स्क्रिप्टेड फ़्लो है, तो प्रॉम्प्ट से बचने के लिए, `-m ""` तय करें.
`PASSCODE`	ज़रूरी नहीं. उपयोगकर्ता नाम और पासवर्ड या फिर पासवर्ड डालना ज़रूरी है.	एक बार इस्तेमाल होने वाला पासवर्ड, जिसका इस्तेमाल आप पासवर्ड डालें. एसएएमएल आईडीपी से पुष्टि करते समय पासवर्ड की ज़रूरत होती है और इसका इस्तेमाल किया जा सकता है का इस्तेमाल करें.

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

acurl https://api.enterprise.apigee.com/v1/organizations/ahamilton-eval
acurl https://api.enterprise.apigee.com/v1/organizations/ahamilton-eval -u ahamilton@apigee.com
acurl https://api.enterprise.apigee.com/v1/organizations/ahamilton-eval -u ahamilton@apigee.com -p 424242
acurl https://api.enterprise.apigee.com/v1/organizations/ahamilton-eval -u ahamilton@apigee.com:mypassw0rd
acurl https://api.enterprise.apigee.com/v1/organizations/ahamilton-eval -u ahamilton@apigee.com:mypassw0rd -m 123456

ऊपर दिखाए गए विकल्पों के अलावा, acurl सभी curl स्वीकार करता है के विकल्प. उदाहरण के लिए, हेडर पास करें, एचटीटीपी वर्ब के बारे में बताएं, बॉडी जोड़ें, और curl के स्टैंडर्ड विकल्पों की मदद से, कितने शब्दों में जानकारी दी जाए:

विकल्प	`acurl meaning`	`curl meaning`
-u	`username`	`username`
-मिनट	`MFA code`	`max time` (लंबी अवधि के `--max-time` फ़ॉर्मैट का इस्तेमाल करना ज़रूरी है)
-पेज	`passcode`	`proxy tunnel` (लंबी अवधि के `--proxytunnel` फ़ॉर्मैट का इस्तेमाल करना ज़रूरी है)
-v	`verbose`	`verbose`
-घं॰	`help`	`help` (लंबी अवधि के `--help` फ़ॉर्मैट का इस्तेमाल करना ज़रूरी है)

acurl -v -X POST -H 'Content-Type: application/json' \
    https://api.enterprise.apigee.com/v1/organizations/ahamilton-eval/apiproducts/myproduct/attributes/attr \
    -u ahamilton@apigee.com -d '{"value":42}'

सही तरीके से acurl कॉल करने पर, आपको उपयोगकर्ता के किस Edge API एंडपॉइंट के हिसाब से नतीजे मिलते हैं कॉल किया गया. इसके अलावा, acurl में ऐक्सेस और रीफ़्रेश टोकन, दोनों सेव किए जाते हैं ~/.sso-cli में.

क्रेडेंशियल (पासवर्ड और MFA या पासवर्ड) डाले बिना कॉल करना जारी रखा जा सकता है ऐक्सेस टोकन और रीफ़्रेश टोकन की समयसीमा खत्म होने की जानकारी. जैसा कि टोकन की समयसीमा खत्म होने की तारीख में बताया गया है.

कर्ल से माइग्रेट करें

अगर आप curl का इस्तेमाल कर रहे हैं, तो acurl सुविधा पर माइग्रेट करने की प्रोसेस आसान है और क्रेडेंशियल को मैन्युअल तौर पर कोड में बदलने की ज़रूरत नहीं होती. उपयोगिता को डाउनलोड और इंस्टॉल करने के बाद, आप बदलें:

curl -u username

अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है इनके साथ:

acurl -u username

acurl यूटिलिटी आपके वीडियो को कोड में बदल देगी क्रेडेंशियल इस्तेमाल करती हैं और कभी-कभी नए टोकन पेयर पाने के लिए, आपको ज़रूरी अतिरिक्त क्रेडेंशियल मांगती है.

मशीन उपयोगकर्ताओं के लिए, curl की जगह acurl यूटिलिटी का भी इस्तेमाल किया जा सकता है. ज़्यादा जानकारी के लिए, मशीन उपयोगकर्ताओं के लिए OAuth2 और एसएएमएल ज़ोन में मशीन उपयोगकर्ता देखें.

acurl को पहली बार कॉल करें

acurl की मदद से पहली बार एपीआई को कॉल करने पर, आपको अपने Apigee क्रेडेंशियल की जानकारी देनी होती है ( आपके Apigee खाते का उपयोगकर्ता नाम और पासवर्ड या पासवर्ड) ताकि acurl उन्हें किसी ऐक्सेस टोकन और रीफ़्रेश टोकन के लिए बदल सकता है.

नीचे दिए गए उदाहरण में, acurl के साथ एक शुरुआती कॉल दिखाया गया है, ताकि संगठन एंडपॉइंट:

acurl https://api.enterprise.apigee.com/v1/organizations/ahamilton-eval \
  -u ahamilton@apigee.com
Enter the password for user 'ahamilton@apigee.com':
[hidden input]
Enter the six-digit code (no spaces) if 'ahamilton@apigee.com' is MFA-enabled or press ENTER:
1a2b3c
{
  "createdAt" : 1491854501264,
  "createdBy" : "noreply_iops@apigee.com",
  "displayName" : "ahamilton",
  "environments" : [ "prod", "test" ],
  "lastModifiedAt" : 1491854501264,
  "lastModifiedBy" : "noreply_iops@apigee.com",
  "name" : "ahamilton",
  "properties" : {
    "property" : [ {
      "name" : "features.isSmbOrganization",
      "value" : "false"
    }, {
      "name" : "features.isCpsEnabled",
      "value" : "true"
    } ]
  },
  "type" : "trial"
}

acurl यूटिलिटी को एक ऐक्सेस टोकन मिलता है और वह उसे Edge API एंडपॉइंट:

curl -H "Authorization: Bearer oauth2_access_token" ...

ऐक्सेस टोकन को स्थानीय तौर पर ~/.sso-cli में सेव किया जाता है और इसका इस्तेमाल इनके लिए किया जाता है से कनेक्ट करने के लिए किया जा सकता है.

ऐक्सेस टोकन की समयसीमा खत्म होने के बाद, acurl अपने-आप रीफ़्रेश टोकन का इस्तेमाल करके इन्हें ऐक्सेस करता है कोई नया ऐक्सेस टोकन जोड़ें. रीफ़्रेश टोकन की समयसीमा खत्म होने पर, acurl आपको एक सूचना भेजेगा आपके Apigee क्रेडेंशियल के लिए.

इस अनुरोध को "ahamilton-eval" के बारे में जानकारी मिलती है संगठन. इनकी पूरी सूची के लिए, Edge API एंडपॉइंट, Apigee Edge API का संदर्भ देखें.

⁽¹⁾ कॉपीराइट 2023 Google LLC
acurl टूल को "सॉफ़्टवेयर" के तौर पर उपलब्ध कराया गया है के अंतर्गत Google Cloud Platform के आपके इस्तेमाल को कंट्रोल करने वाला कानूनी समझौता. इसमें सेवा भी शामिल है खास शर्तें https://cloud.google.com/terms/service-terms पर उपलब्ध हैं.