أنت تعرض مستندات Apigee Edge.
انتقل إلى
مستندات Apigee X. معلومات
تساعدك واجهة سطر الأوامر (CLI) في apigee-remote-service-cli
توفير وإدارة Apigee Adapter لـ Envoy.
أوامر الربط
يربط Binding خدمة تم نشرها على شبكة Istio المتداخلة بمنتج Apigee API. تتيح لك واجهة برمجة التطبيقات إنشاء عمليات الربط وإزالتها وإدراجها.
ملاحظة: في واجهة مستخدم "إنشاء منتج"، يمكنك تحديد خدمة واحدة أو أكثر مع منتج. ويعادل ذلك إنشاء الربط باستخدام واجهة سطر الأوامر.إضافة ربط
تُضيف عملية الربط هذه هدفًا بعيدًا إلى منتج واجهة برمجة التطبيقات.
الاستخدام
بالنسبة إلى 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 Hybrid:
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. يحدّد عناوين URL للإدارة وبيئة التشغيل بالنسبة إلى Edge Cloud | |
--opdk
|
يمكنك ضبط هذه العلامة في حال استخدام Apigee Edge for Private Cloud. | |
-o, --org
|
سلسلة | (مطلوب) مؤسسة Apigee. يجب أن تكون مشرف مؤسسة. |
-p, --password
|
سلسلة | (مطلوبة للمصادقة الأساسية فقط) كلمة مرور Apigee. يمكنك اختياريًا تحديد
كلمة المرور في ملف .netrc . وفي هذه الحالة، لن يُطلب منك
تقديم كلمة المرور في سطر الأوامر. يمكن أيضًا مراجعة
استخدام .netrc لبيانات الاعتماد
|
-r, --runtime
|
سلسلة | عنوان URL الأساسي لوقت تشغيل Apigee (مطلوب للمختلط أو opdk) |
-t, --token
|
سلسلة | (مطلوب لمصادقة رمز OAuth المميز فقط) رمز OAuth أو SAML المميز الذي تنشئه من معلومات حسابك في Apigee للحصول على معلومات حول إنشاء الرموز المميزة، راجع استخدام get_token الوصول إلى واجهة برمجة تطبيقات الإدارة باستخدام SAML |
-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. يحدّد عناوين URL للإدارة وبيئة التشغيل بالنسبة إلى Edge Cloud | |
--opdk
|
يمكنك ضبط هذه العلامة في حال استخدام Apigee Edge for Private Cloud. | |
-o, --org
|
سلسلة | (مطلوب) مؤسسة Apigee. يجب أن تكون مشرف مؤسسة. |
-p, --password
|
سلسلة | (مطلوبة للمصادقة الأساسية فقط) كلمة مرور Apigee. يمكنك اختياريًا تحديد
كلمة المرور في ملف .netrc . وفي هذه الحالة، لن يُطلب منك
تقديم كلمة المرور في سطر الأوامر. يمكن أيضًا مراجعة
استخدام .netrc لبيانات الاعتماد
|
-r, --runtime
|
سلسلة | عنوان URL الأساسي لوقت تشغيل Apigee (مطلوب للمختلط أو opdk) |
-t, --token
|
سلسلة | (مطلوب لمصادقة رمز OAuth فقط) رمز OAuth أو SAML الذي تنشئه من معلومات حسابك على Apigee للحصول على معلومات حول إنشاء الرموز المميزة، راجع استخدام get_token الوصول إلى واجهة برمجة تطبيقات الإدارة باستخدام SAML |
-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:
إزالة عملية ربط
إزالة ربط خدمة Remote Service في Envoy من منتج واجهة برمجة التطبيقات
ملاحظة: يمكنك أيضًا إزالة ربط خدمة عن بُعد في Envoy من خلال إزالة اسم الخدمة من المنتج في واجهة مستخدم Edge.الاستخدام
بالنسبة إلى 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 Hybrid:
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. يحدّد عناوين URL للإدارة وبيئة التشغيل بالنسبة إلى Edge Cloud | |
--opdk
|
يمكنك ضبط هذه العلامة في حال استخدام Apigee Edge for Private Cloud. | |
-o, --org
|
سلسلة | (مطلوب) مؤسسة Apigee. يجب أن تكون مشرف مؤسسة. |
-p, --password
|
سلسلة | (مطلوبة للمصادقة الأساسية فقط) كلمة مرور Apigee. يمكنك اختياريًا تحديد
كلمة المرور في ملف .netrc . في هذه الحالة، لن يُطلب منك
تقديم كلمة المرور في سطر الأوامر. يُرجى الاطّلاع أيضًا على
استخدام ملف .netrc لبيانات الاعتماد.
|
-r, --runtime
|
سلسلة | عنوان URL الأساسي لوقت تشغيل Apigee (مطلوب للمختلط أو opdk) |
-t, --token
|
سلسلة | (مطلوب لمصادقة رمز OAuth المميز فقط) رمز OAuth أو SAML المميز الذي تنشئه من معلومات حسابك في Apigee للحصول على معلومات حول إنشاء الرموز المميزة، راجع استخدام get_token الوصول إلى واجهة برمجة تطبيقات الإدارة باستخدام SAML |
-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، وإعداد شهادة، وإنشاء بيانات الاعتماد التي ستحتاج إلى
إعداد محوّل Apigee لجهاز Envoy.
الاستخدام
إذا كنت تستخدم 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 (يضبط عنوان URL للإدارة وبيئة التشغيل) | |
-m, --management
|
سلسلة | (مطلوب في حال استخدام Apigee Private Cloud) عنوان URL الأساسي لإدارة Apigee.
عناوين URL التلقائية: https://api.enterprise.apigee.com
|
-n, --namespace
|
سلسلة | إصدار الإعدادات على هيئة Envoy ConfigMap في مساحة الاسم المحدّدة. |
--opdk
|
سلسلة | Apigee OPDK. |
-o, --organization
|
سلسلة | (مطلوب) مؤسستك في Apigee. يجب أن تكون مشرفًا في المؤسسة. |
-p, --password
|
سلسلة | (مطلوبة للمصادقة الأساسية فقط) كلمة مرور Apigee. يمكنك اختياريًا تحديد
كلمة المرور في ملف .netrc . في هذه الحالة، لن يُطلب منك
تقديم كلمة المرور في سطر الأوامر. يمكن أيضًا مراجعة
استخدام .netrc لبيانات الاعتماد
|
--rotate-int
|
int | إذا كانت n > 0، إنشاء مفتاح خاص جديد والاحتفاظ n من المفاتيح العامة (المختلط فقط) |
-r, --runtime
|
سلسلة | عنوان URL الأساسي لوقت تشغيل Apigee (مطلوب للإصدار المختلط أو opdk) |
-s, --secret
|
سلسلة | تحدِّد هذه السياسة المفتاح السرّي الذي يعرضه apigee-remote-service-cli provision .
الأمر.
|
--strength
|
int | (اختياري) يحدد هذا الإعداد قوة التشفير لشهادات طبقة المقابس الآمنة (SSL) المستخدمة في توفير المتطلبات اللازمة محوّل. القيمة التلقائية 2048 |
-t, --token
|
سلسلة | (المختلط فقط) Apigee OAuth أو رمز SAML المميّز |
-u, --username
|
سلسلة | (مطلوب للمصادقة الأساسية فقط) اسم مستخدم Apigee (يكون عادةً عنوان بريد إلكتروني).
يمكنك اختياريًا تحديد اسم المستخدم في ملف .netrc .
يُرجى الاطّلاع أيضًا على استخدام ملف .netrc لبيانات الاعتماد.
|
-v, --verbose
|
(اختياري) يؤدي إلى عرض مخرجات مطوّلة. | |
--virtual-hosts
|
سلسلة | لإلغاء المضيفات الافتراضية الافتراضية، التي تكون "تلقائية، آمنة". استخدِم هذا الخيار إذا كنت لديها مضيفات افتراضية محددة لبيئة مؤسسة Edge غير هذه الإعدادات الافتراضية. اطّلِع على مستندات Edge للتعرّف على المضيفين الظاهريين. |
--years
|
int | (اختياري) عدد السنوات قبل شهادة طبقة المقابس الآمنة (SSL) المستخدَمة في توفير المتطلبات اللازمة تنتهي صلاحيته. الإعدادات التلقائية: 1 |
مثال
تأكَّد من الحصول على ناتج الأمر provision
في الملف، والذي يتم استخدامه.
كمدخل لمهايئ Apigee الآخر لعمليات Envoy.
مثال على 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 hybrid:
apigee-remote-service-cli token create -c [config_file] --id [consumer_key] --secret [consumer_secret] -r [runtime] -o [org] -e [env]
المعلمات
المعلمات | النوع | الوصف |
---|---|---|
-c, --config
|
سلسلة | (مطلوب) المسار إلى ملف إعداد Apigee Remote Service. نصيحة: عند تحديد
لهذا الخيار، يمكنك حذف معظم معلمات الأوامر الأخرى. عرض
استخدام الخيار --config
|
-e, --env
|
سلسلة | (مطلوبة) بيئة في مؤسستك |
-h, --help
|
يعرض المساعدة لمعلمات الأوامر. | |
--insecure
|
السماح باتصالات الخوادم غير الآمنة عند استخدام طبقة المقابس الآمنة | |
-o, --org
|
سلسلة | (مطلوب) مؤسسة Apigee. يجب أن تكون مشرف مؤسسة. |
-r, --runtime
|
سلسلة | عنوان URL الأساسي لوقت تشغيل Apigee (مطلوب فقط للمختلط أو opdk). |
-v, --verbose
|
(اختياري) يؤدي إلى عرض مخرجات مطوّلة. |
مثال
apigee-remote-service-cli token create -o myorg -e test -i YUmlZAcBKNsTAelJqPZFl3sh58ObATX9 -s icTARgaKHqvUH1dq -c config.yaml
الناتج
بعد النجاح، ستظهر لك ناتج رمز JST المميّز على النحو التالي: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 Hybrid:
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
|
سلسلة | عنوان URL الأساسي لوقت تشغيل 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 في خريطة قيمة المفتاح (KVM) المشفَّرة. تتمثل عملية إنشاء يسمى زوج المفاتيح الجديد تدوير المفاتيح. عند تدوير المفاتيح، سيتم إنشاء زوج مفاتيح خاص/عام جديد وتخزينه في "istio" KVM في مؤسسة/بيئة 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 Remote Service. نصيحة: عند تحديد
لهذا الخيار، يمكنك حذف معظم معلمات الأوامر الأخرى. عرض
استخدام الخيار --config
|
-e, --env
|
سلسلة | (مطلوبة) بيئة في مؤسستك |
-h, --help
|
تعرِض هذه العلامة معلومات المساعدة حول مَعلمات الأمر. | |
--insecure
|
السماح باتصالات الخوادم غير الآمنة عند استخدام طبقة المقابس الآمنة | |
--truncate
|
int | عدد الشهادات المطلوب الاحتفاظ بها في jwks (الإعداد الافتراضي 2) |
-o, --org
|
سلسلة | (مطلوب) مؤسسة Apigee. يجب أن تكون مشرف مؤسسة. |
-r, --runtime
|
سلسلة | عنوان URL الأساسي لوقت تشغيل 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 لبيانات الاعتماد
تختار "apigee-remote-service-cli
" تلقائيًا username
password
(للمصادقة الأساسية عند الحاجة) من .netrc
في الدليل الرئيسي إذا كنت تستخدم Edge Public Cloud ولديك إدخال
الجهاز api.enterprise.apigee.com
. إذا كنت تستخدم Apigee Private Cloud،
تكون قيمة الجهاز هي نفسها عنوان URL الخاص بـ 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