Başvuru Kaynakları

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi

apigee-remote-service-cli komut satırı arayüzü (KSA), Apigee Adapter for Envoy'u sağlamanıza ve yönetmenize yardımcı olur.

List bindings komutu

Uzak hizmete bağlı tüm API ürünlerini listeleyin.

Kullanım

apigee-remote-service-cli bindings list [flags]

Parametreler

Parametreler Varlık Ürünlerle birlikte kullanılır Açıklama
-c,
‑‑config 		Zorunlu Tümü (Dize) Apigee Uzak Hizmet yapılandırma dosyasının yolu.
İpucu: Bu işaret, CLI bunları doğrudan yapılandırma dosyasından çekebildiğinden diğer komut parametrelerinin çoğunu atlamanıza olanak tanır. ‑‑config seçeneğini kullanma başlıklı makaleyi inceleyin.
-e,
‑‑environment 		Zorunlu Tümü (Dize) Kuruluşunuzdaki bir ortam.
-h,
‑‑help 		İsteğe bağlı Tümü Komut parametreleriyle ilgili yardımı gösterir.
‑‑insecure İsteğe bağlı Tümü SSL kullanırken güvenli olmayan sunucu bağlantılarına izin verilir.
‑‑legacy Zorunlu Yalnızca Edge Public Cloud Apigee Edge for Public Cloud kullanıyorsanız bu işareti ayarlamanız gerekir. Apigee Edge Public Cloud için yönetim ve çalışma zamanı URL'lerini ayarlar.
-m,
‑‑management 		Zorunlu Yalnızca Edge Private Cloud (Dize) Apigee Edge Private Cloud yüklemenizin yönetim tabanı URL'si. Varsayılan: https://api.enterprise.apigee.com
‑‑mfa Zorunlu Yalnızca Edge Public Cloud (Dize) Apigee Edge for Public Cloud'unuz için çok öğeli yetkilendirme jetonu. Yalnızca Apigee Edge hesabınızda MFA ayarlanmışsa gereklidir.
‑‑opdk Zorunlu Yalnızca Edge Private Cloud Apigee Edge for Private Cloud kullanıyorsanız bu işareti ayarlamanız gerekir.
-o,
‑‑organization 		Zorunlu Tümü (Dize) Bir Apigee kuruluşu. Kuruluş yöneticisi olmanız gerekir.
-p,
‑‑password 		Zorunlu
(Yalnızca Temel Kimlik Doğrulama)		 Yalnızca Edge Public ve Private Cloud (Dize) Apigee şifreniz. İsteğe bağlı olarak şifreyi .netrc dosyasında belirtebilirsiniz. Ayrıca Kimlik bilgileri için .netrc kullanma başlıklı makaleyi de inceleyin.
-r,
‑‑runtime 		Zorunlu Yalnızca Edge Private Cloud ve Apigee Hybrid (Dize) Özel bulutunuzun veya Apigee hibrit örneğinizin çalışma zamanı URL'sini belirtir. URL, https:// ile başlamalıdır. Örneğin: https://apitest.apigee-hybrid-docs.net
‑‑tls‑cert
‑‑tls‑key
‑‑tls‑ca 		İsteğe bağlı Yalnızca Edge Private Cloud (Dize) mTLS bağlantısı için istemci tarafı TLS sertifikasını, özel anahtarı ve kök CA'yı belirtir.
-t,
‑‑token 		Zorunlu
(Yalnızca OAuth jetonu kimlik doğrulaması)		 Tümü (Dize) Apigee hesap bilgilerinizden oluşturduğunuz bir OAuth veya SAML jetonu. Sağlanan diğer tüm kimlik bilgilerini geçersiz kılar.
-u,
‑‑username 		Zorunlu
(Yalnızca Temel Kimlik Doğrulama)		 Yalnızca Edge Public ve Private Cloud (Dize) Apigee kullanıcı adınız (genellikle bir e-posta adresi). İsteğe bağlı olarak kullanıcı adını bir .netrc dosyasında belirtebilirsiniz. Bu durumda komut satırında kullanıcı adınızı girmeniz gerekmez. Ayrıca Kimlik bilgileri için .netrc dosyasını kullanma başlıklı makaleyi de inceleyin.
-v,
‑‑verbose 		İsteğe bağlı Tümü (İsteğe bağlı) Ayrıntılı çıkış üretir.

Örnek

apigee-remote-service-cli bindings list -o myorg -e test -u user@example.com \
-c config.yaml -p abc123

Örnek çıkış 

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:

Yardım komutu

Tüm apigee-remote-service-cli komutları için online yardım sağlanır. Şunu yazmanız yeterli:

apigee-remote-service-cli help

Herhangi bir komutla ilgili yardım almak için şunu yazın:

apigee-remote-service-cli [command] help

Örneğin:

apigee-remote-service-cli provision help

Temel hazırlık komutu

apigee-remote-service-cli provision komutu, Apigee Edge kuruluşunuza iki API proxy'si yükler, sertifika ayarlar ve Apigee Adapter for Envoy'u yapılandırmak için ihtiyacınız olacak kimlik bilgilerini oluşturur.

Kullanım

apigee-remote-service-cli provision [flags]

Parametreler

Parametreler Varlık Ürünlerle birlikte kullanılır Açıklama
‑‑analytics-sa İsteğe bağlı Yalnızca Apigee Hybrid ve Apigee X

(Dize) Bu işareti, hizmet hesabının Apigee Analytics Agent rolüne sahip olduğu bir Google Cloud hizmet hesabı anahtar dosyasının yolunu belirtmek için kullanın. SA, analiz verilerini doğrudan Apigee'ye yüklemek için bağdaştırıcı tarafından kullanılır. Apigee Hybrid kullanıyorsanız bu seçenek, Hybrid çalışma zamanını bir kümeye, bağdaştırıcıyı ise başka bir kümeye yüklemenize olanak tanır.
-c,
‑‑config 		Zorunlu Tümü (Dize) Apigee Uzak Hizmet yapılandırma dosyasının yolu.
İpucu: Bu işaret, CLI bunları doğrudan yapılandırma dosyasından çekebildiğinden diğer komut parametrelerinin çoğunu atlamanıza olanak tanır. ‑‑config seçeneğini kullanma başlıklı makaleyi inceleyin.
-e,
‑‑environment 		Zorunlu Tümü (Dize) Kuruluşunuzdaki bir ortam.
-f, ‑‑force-proxy-install İsteğe bağlı Tümü (İsteğe bağlı) Kuruluşunuzda zaten yüklüyse remote-service proxy'sinin yeniden yüklenmesini zorunlu kılar.
-h,
‑‑help 		İsteğe bağlı Tümü Komut parametreleriyle ilgili yardımı gösterir.
‑‑insecure İsteğe bağlı Tümü SSL kullanırken güvenli olmayan sunucu bağlantılarına izin verilir.
‑‑legacy Zorunlu Yalnızca Edge Public Cloud Apigee Edge for Public Cloud kullanıyorsanız bu işareti ayarlamanız gerekir. Apigee Edge Public Cloud için yönetim ve çalışma zamanı URL'lerini ayarlar.
-m,
‑‑management 		Zorunlu Yalnızca Edge Private Cloud (Dize) Apigee Edge Private Cloud yüklemenizin yönetim tabanı URL'si. Varsayılan: https://api.enterprise.apigee.com
‑‑mfa Zorunlu Yalnızca Edge Public Cloud Apigee Edge Public Cloud için çok öğeli yetkilendirme jetonu. Yalnızca Apigee Edge hesabınızda MFA ayarlanmışsa gereklidir.
-n, ‑‑namespace İsteğe bağlı Tümü (Dize) Yapılandırmayı belirtilen ad alanında Envoy ConfigMap olarak yayınlayın. Varsayılan: apigee
‑‑opdk Zorunlu Yalnızca Edge Private Cloud Apigee Edge for Private Cloud kullanıyorsanız bu işareti ayarlamanız gerekir.
-o,
‑‑organization 		Zorunlu Tümü (Dize) Bir Apigee kuruluşu. Sağlama yapmak için kuruluş yöneticisi olmanız gerekir.
-p,
‑‑password 		Zorunlu
(Yalnızca Temel Kimlik Doğrulama)		 Yalnızca Edge Public ve Private Cloud (Dize) Apigee şifreniz. İsteğe bağlı olarak şifreyi
.netrc dosyasında belirtebilirsiniz. Bu durumda komut satırında şifrenizi girmeniz gerekmez. Ayrıca Kimlik bilgileri için .netrc kullanma başlıklı makaleyi de inceleyin.
‑‑rotate-int İsteğe bağlı Yalnızca Apigee Hybrid (Tam sayı) n > 0 ise yeni bir özel anahtar oluşturun ve n ortak anahtarı saklayın (yalnızca karma)
-r,
‑‑runtime 		Zorunlu Yalnızca Edge Private Cloud ve Apigee Hybrid (Dize) Özel bulutunuzun veya Apigee hibrit örneğinizin çalışma zamanı URL'sini belirtir. URL, https:// ile başlamalıdır. Örneğin: https://apitest.apigee-hybrid-docs.net
‑‑tls‑cert
‑‑tls‑key
‑‑tls‑ca 		İsteğe bağlı Yalnızca Edge Private Cloud (Dize) mTLS bağlantısı için istemci tarafı TLS sertifikasını, özel anahtarı ve kök CA'yı belirtir.
-t,
‑‑token 		Zorunlu
(Yalnızca OAuth jetonu kimlik doğrulaması)		 Tümü (Dize) Apigee hesap bilgilerinizden oluşturduğunuz bir OAuth veya SAML jetonu. Sağlanan diğer tüm kimlik bilgilerini geçersiz kılar.
-u,
‑‑username 		Zorunlu
(Yalnızca Temel Kimlik Doğrulama)		 Yalnızca Edge Public ve Private Cloud (Dize) Apigee kullanıcı adınız (genellikle bir e-posta adresi). İsteğe bağlı olarak kullanıcı adını bir .netrc dosyasında belirtebilirsiniz. Ayrıca Kimlik bilgileri için .netrc dosyasını kullanma başlıklı makaleyi de inceleyin.
-v,
‑‑verbose 		İsteğe bağlı Tümü (İsteğe bağlı) Ayrıntılı çıkış üretir.
‑‑virtual-hosts İsteğe bağlı Yalnızca Edge Private Cloud (Dize) default,secure olan varsayılan sanal ana makineleri geçersiz kılar. Edge kuruluş ortamınız için bu varsayılanlar dışında sanal ana makineleriniz varsa bu seçeneği kullanın.

Örnek

Aşağıdaki örnekte gösterildiği gibi, provision komutunun çıkışını bir dosyaya aktarmak önemlidir. Bu dosya, diğer Apigee Adapter for Envoy işlemleri için giriş olarak kullanılır.

Örnek: 

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

Örnekler komutu

Örnek yapılandırma dosyaları oluşturur ve listeler.

Örnek yapılandırma dosyaları oluşturma

Yerel Envoy ve Istio dağıtımları için örnek yapılandırma dosyaları oluşturur.

Kullanım

apigee-remote-service-cli samples create [flags]

Açıklama

Bu komut için giriş olarak geçerli bir config.yaml dosyası gerekir. Bu giriş dosyası, sağlama yoluyla oluşturulan dosyadır. Varsayılan olarak, örnek dosyalar ./samples adlı bir dizine çıkarılır. Komut, bu dizini sizin için oluşturur.

Yerel Envoy kullanıyorsanız komut, hedef hizmet ana makinesini ve kümesi için istenen adı alır. Ayrıca, --tls üzerinden tls.key ve tls.crt içeren bir klasör sağlanırsa Envoy proxy'den uzak hizmet kümesine özel SSL bağlantısı ayarlar.

Envoy proxy'nin sidecar olarak çalıştığı Istio kullanıyorsanız hedef belirtilmediğinde httpbin örneği oluşturulur. Aksi takdirde, hedef hizmetlerinizin dağıtımıyla ilgili yapılandırma dosyalarını hazırlamak sizin sorumluluğunuzdadır.

Parametreler

Parametreler Varlık Ürünlerle birlikte kullanılır Açıklama
‑‑adapter‑host Yalnızca Envoy şablonları için gereklidir. Tümü (Dize) Bağdaştırıcının ana makine adı (varsayılan: localhost)
-c, ‑‑config Zorunlu Tümü (Dize) Apigee Remote Service yapılandırma dosyasının yolu.
İpucu: Bu işaret, CLI bunları doğrudan yapılandırma dosyasından çekebildiğinden diğer komut parametrelerinin çoğunu atlamanıza olanak tanır. ‑‑config seçeneğini kullanma başlıklı makaleyi inceleyin.
-f, ‑‑force İsteğe bağlı Tümü Mevcut dizinin üzerine yazılmasını zorlayın.
-h, ‑‑help İsteğe bağlı Tümü Komut parametreleriyle ilgili yardımı gösterir.
‑‑host Yalnızca Envoy şablonları için gereklidir. Tümü (Dize) Hedef hizmet ana makinesi (varsayılan httpbin.org)
-n, ‑‑name Zorunlu Tümü (Dize) Hedef hizmet adı (varsayılan httpbin.org)
‑‑out İsteğe bağlı Tümü (Dize) Örnek yapılandırma dosyalarının oluşturulacağı dizin.
Varsayılan: ./samples
‑‑tag Yalnızca Istio şablonları için gereklidir. Tümü (Dize) Envoy bağdaştırıcısı görüntüsünün sürüm etiketi. Varsayılan: v2.0.0
-t, ‑‑template Zorunlu Tümü (Dize) Envoy veya Istio şablon adı. Kullanılabilir şablonların listesini görmek için apigee-remote-service samples templates komutunu yürütün.
‑‑tls İsteğe bağlıdır ve yalnızca Envoy şablonları için geçerlidir. Tümü (Dize) Adaptör hizmeti için kullanılan tls.key ve tls.crt dosyalarını içeren dizin.

Örnek 

apigee-remote-service-cli samples create -c ./config.yaml

Kullanılabilir şablon seçeneklerini listeleme

samples komutu için --templates parametresiyle kullanılabilecek şablonları listeler.

Kullanım

apigee-remote-service-cli samples templates

Parametreler

Yok.

Örnek 

apigee-remote-service-cli samples templates
 
Supported templates (native is deprecated):
  envoy-1.15
  envoy-1.16
  envoy-1.17
  istio-1.7
  istio-1.8
  istio-1.9

Jeton komutları

Kimliği doğrulanmış API proxy'si çağrıları yapmak için API anahtarı yerine JWT jetonu kullanabilirsiniz. Jeton komutları, bu amaçla JWT jetonları oluşturmanıza, incelemenize ve döndürmenize olanak tanır.

JWT jetonu oluşturma

Uzak hizmet hedefine kimliği doğrulanmış API proxy'si çağrıları yapmak için JWT jetonu kullanabilirsiniz. Ayrıca JWT tabanlı kimlik doğrulamayı kullanma başlıklı makaleye bakın.

Kullanım

apigee-remote-service-cli token create [flags]

Parametreler

Parametreler Varlık Ürünlerle birlikte kullanılır Açıklama
-c,
‑‑config 		Zorunlu Tümü (Dize) Apigee Uzak Hizmet yapılandırma dosyasının yolu.
İpucu: Bu işaret, CLI bunları doğrudan yapılandırma dosyasından çekebildiğinden diğer komut parametrelerinin çoğunu atlamanıza olanak tanır. ‑‑config seçeneğini kullanma başlıklı makaleyi inceleyin.
-e,
‑‑environment 		Zorunlu Tümü (Dize) Kuruluşunuzdaki bir ortam.
-h,
‑‑help 		İsteğe bağlı Tümü Komut parametreleriyle ilgili yardımı gösterir.
--i, --id Zorunlu Tümü (Dize) API anahtarı nasıl alınır? başlıklı makalede açıklandığı gibi, Apigee geliştirici uygulamasında bulunan Anahtar kimlik bilgisi.
‑‑insecure İsteğe bağlı Tümü SSL kullanırken güvenli olmayan sunucu bağlantılarına izin verilir.
‑‑legacy Zorunlu Yalnızca Edge Public Cloud Apigee Edge for Public Cloud kullanıyorsanız bu işareti ayarlamanız gerekir. Apigee Edge Public Cloud için yönetim ve çalışma zamanı URL'lerini ayarlar.
‑‑opdk Zorunlu Yalnızca Edge Private Cloud Apigee Edge for Private Cloud kullanıyorsanız bu işareti ayarlamanız gerekir.
-o,
‑‑organization 		Zorunlu Tümü (Dize) Bir Apigee kuruluşu. Kuruluş yöneticisi olmanız gerekir.
-r,
‑‑runtime 		Zorunlu Yalnızca Edge Private Cloud ve Apigee Hybrid (Dize) Özel bulutunuzun veya Apigee hibrit örneğinizin çalışma zamanı URL'sini belirtir. URL, https:// ile başlamalıdır. Örneğin: https://apitest.apigee-hybrid-docs.net
--s, ‑‑secret Zorunlu Tümü (Dize) Secret kimlik bilgisi, API anahtarı nasıl alınır? başlıklı makalede açıklandığı gibi Apigee geliştirici uygulamasında bulunur.
‑‑tls‑cert
‑‑tls‑key
‑‑tls‑ca 		İsteğe bağlı Yalnızca Edge Private Cloud (Dize) mTLS bağlantısı için istemci tarafı TLS sertifikasını, özel anahtarı ve kök CA'yı belirtir.
-v,
‑‑verbose 		İsteğe bağlı Tümü (İsteğe bağlı) Ayrıntılı çıkış üretir.

Örnek

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

Çıkış

İşlem başarılı olduğunda aşağıdakine benzer bir JST jetonu çıkışı görürsünüz: 
eyJraWQiOiIxIiwidHlwIjoiSldUIiwiYWxnIjoiUlMyNTYifQ.eyJhY2Nlc3NfdG9rZW4iOiJ0a2tlVzVKQTY2a0pZYTB4bFV1cVBsUW1BMU43IiwiYXVkIjoiaXN0aW8iLCJuYmYiOjE1MzAxMzg1OTEsImFwaV9wcm9kdWN0X2xpc3QiOlsiaXN0aW8tcHJvZHVjdCJdLCJhcHBsaWNhdGlvbl9uYW1lIjoiaXN0aW8tYXBwIiwiZGV2ZWxvcGVyX2VtYWlsIjoicFluZ2Zsb3lkQGdvb2dsZS5jb20iLCJpc3MiOiJodHRwczovL2FwaWdlZXNlYXJjaC10ZXN0LmFwaWdlZS5uZXQvaXN0aW8tYXV0aC90b2tlbiIsImV4cCI6MTUzMDEzOTQ5MSwiaWF0IjoxNTMwMTM4NTkxLCJqdGkiOiIxODgzMzViZi0wMmE4LTRjZGUsOGFkOS0yMWJmNDZjNmRjZDkiLCJjbGllbnRfaWQiOiJZVW1sWkFjQktOc1RBZWxKcVBZRmwzc2g1OE9iQVRYOSJ9.AL7pKSTmond-NSPRNNHVbIzTdAnZjOXcjQ-BbOJ_8lsQvF7PuiOUrGIhY5XTcJusisKgbCdtIxBl8Wq1EiQ_fKnUc3JYYOqzpTB5bGoFy0Yqbfu96dneuWyzgZnoQBkqwZkbQTIg7WNTGx1TJX-UTePvBPxAefiAbaEUcigX9tTsXPoRJZOTrm7IOeKpxpB_gQYkxQtV1_NbERxjTPyMbHdMWal9_xRVzSt7mpTGudMN9OR-VtQ1uXA67GOqhZWcOzq57qImOiCMbaoKnKUADevyWjX_VscN5ZZUtzQUQhTrmv8aR69-uVhMIPKp9juMyYKaYn2IsYZEeCWfhfV45Q

JWT jetonunu inceleme

Bu komutla JWT jetonunu inceleyebilirsiniz. Jetonu inceleme başlıklı makaleyi de inceleyin.

Kullanım

apigee-remote-service-cli token inspect [flags]

Parametreler

Parametreler

Parametreler Varlık Ürünlerle birlikte kullanılır Açıklama
-c,
‑‑config 		Zorunlu Tümü (Dize) Apigee Uzak Hizmet yapılandırma dosyasının yolu.
İpucu: Bu işaret, CLI bunları doğrudan yapılandırma dosyasından çekebildiğinden diğer komut parametrelerinin çoğunu atlamanıza olanak tanır. ‑‑config seçeneğini kullanma başlıklı makaleyi inceleyin.
-e,
‑‑environment 		Zorunlu Tümü (Dize) Kuruluşunuzdaki bir ortam.
-f,
‑‑file 		Zorunlu Tümü (Dize) Jeton dosyası (varsayılan: stdin kullanın)
-h,
‑‑help 		İsteğe bağlı Tümü Komut parametreleriyle ilgili yardımı gösterir.
‑‑insecure İsteğe bağlı Tümü SSL kullanırken güvenli olmayan sunucu bağlantılarına izin verilir.
‑‑legacy Zorunlu Yalnızca Edge Public Cloud Apigee Edge for Public Cloud kullanıyorsanız bu işareti ayarlamanız gerekir. Apigee Edge Public Cloud için yönetim ve çalışma zamanı URL'lerini ayarlar.
‑‑opdk Zorunlu Yalnızca Edge Private Cloud Apigee Edge for Private Cloud kullanıyorsanız bu işareti ayarlamanız gerekir.
-o,
‑‑organization 		Zorunlu Tümü (Dize) Bir Apigee kuruluşu. Kuruluş yöneticisi olmanız gerekir.
-r,
‑‑runtime 		Zorunlu Yalnızca Edge Private Cloud ve Apigee Hybrid (Dize) Özel bulutunuzun veya Apigee hibrit örneğinizin çalışma zamanı URL'sini belirtir. URL, https:// ile başlamalıdır. Örneğin: https://apitest.apigee-hybrid-docs.net
‑‑tls‑cert
‑‑tls‑key
‑‑tls‑ca 		İsteğe bağlı Yalnızca Edge Private Cloud (Dize) mTLS bağlantısı için istemci tarafı TLS sertifikasını, özel anahtarı ve kök CA'yı belirtir.
-v,
‑‑verbose 		İsteğe bağlı Tümü (İsteğe bağlı) Ayrıntılı çıkış üretir.

Örnek

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

Çıkış

İşlem başarılı olduğunda aşağıdakine benzer bir çıkış görürsünüz: 
{
	"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 jetonunu döndürme

Bir JWT'yi ilk oluşturduktan bir süre sonra, Apigee'nin şifrelenmiş anahtar/değer eşlemesinde (KVM) depolanan ortak/gizli anahtar çiftini değiştirmeniz gerekebilir. Yeni bir anahtar çifti oluşturma işlemine anahtar rotasyonu adı verilir. Anahtarları döndürdüğünüzde yeni bir özel/ortak anahtar çifti oluşturulur ve Apigee kuruluşunuzdaki/ortamınızdaki "istio" KVM'de depolanır. Ayrıca, eski ortak anahtar orijinal anahtar kimliği değeriyle birlikte saklanır.

Kullanım

apigee-remote-service-cli token rotate-cert [flags]

Parametreler

Parametreler Varlık Ürünlerle birlikte kullanılır Açıklama
-c,
‑‑config 		Zorunlu Tümü (Dize) Apigee Uzak Hizmet yapılandırma dosyasının yolu.
İpucu: Bu işaret, CLI bunları doğrudan yapılandırma dosyasından çekebildiğinden diğer komut parametrelerinin çoğunu atlamanıza olanak tanır. ‑‑config seçeneğini kullanma başlıklı makaleyi inceleyin.
-e,
‑‑environment 		Zorunlu Tümü (Dize) Kuruluşunuzdaki bir ortam.
-h,
‑‑help 		İsteğe bağlı Yalnızca Edge Public ve Private Cloud Komut parametreleriyle ilgili yardımı gösterir.
--k, --key Zorunlu Yalnızca Edge Public ve Private Cloud (Dize) Sağlama anahtarı.
‑‑insecure İsteğe bağlı Yalnızca Edge Public ve Private Cloud SSL kullanırken güvenli olmayan sunucu bağlantılarına izin verilir.
‑‑legacy Zorunlu Yalnızca Edge Public Cloud Apigee Edge for Public Cloud kullanıyorsanız bu işareti ayarlamanız gerekir. Apigee Edge Public Cloud için yönetim ve çalışma zamanı URL'lerini ayarlar.
‑‑opdk Zorunlu Yalnızca Edge Private Cloud Apigee Edge for Private Cloud kullanıyorsanız bu işareti ayarlamanız gerekir.
-o,
‑‑organization 		Zorunlu Yalnızca Edge Public ve Private Cloud (Dize) Bir Apigee kuruluşu. Kuruluş yöneticisi olmanız gerekir.
-r,
‑‑runtime 		Zorunlu Yalnızca Edge Private Cloud (Dize) Özel bulutunuzun veya Apigee hibrit örneğinizin çalışma zamanı URL'sini belirtir. URL, https:// ile başlamalıdır. Örneğin: https://apitest.apigee-hybrid-docs.net
--s, ‑‑secret Zorunlu Tümü (Dize) Sağlama gizli anahtarı.
‑‑tls‑cert
‑‑tls‑key
‑‑tls‑ca 		İsteğe bağlı Yalnızca Edge Private Cloud (Dize) mTLS bağlantısı için istemci tarafı TLS sertifikasını, özel anahtarı ve kök CA'yı belirtir.
--t, ‑‑truncate Zorunlu Tümü (Tamsayı) JWKS'de tutulacak sertifika sayısı (varsayılan değer 2).
-v,
‑‑verbose 		İsteğe bağlı Tümü (İsteğe bağlı) Ayrıntılı çıkış üretir.

Örnek

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

Çıkış

certificate successfully rotated

Dahili jeton oluşturma

Uzak hizmet API çağrılarını yetkilendirmek için bir JWT jetonu oluşturun.

Kullanım

apigee-remote-service-cli token internal [flags]

Parametreler

Parametreler

Parametreler Varlık Ürünlerle birlikte kullanılır Açıklama
-c,
‑‑config 		Zorunlu Yalnızca Apigee Hybrid (Dize) Apigee Uzak Hizmet yapılandırma dosyasının yolu.
İpucu: Bu işaret, CLI bunları doğrudan yapılandırma dosyasından çekebildiğinden diğer komut parametrelerinin çoğunu atlamanıza olanak tanır. ‑‑config seçeneğini kullanma başlıklı makaleyi inceleyin.
-d,
‑‑duration 		Zorunlu Yalnızca Apigee Hybrid (Dize) Oluşturulma tarihinden itibaren dahili JWT'nin geçerli süresi (varsayılan: 10m0s (10 dakika)).
-e,
‑‑environment 		Zorunlu Yalnızca Apigee Hybrid (Dize) Kuruluşunuzdaki bir ortam.
-h,
‑‑help 		İsteğe bağlı Yalnızca Apigee Hybrid Komut parametreleriyle ilgili yardımı gösterir.
‑‑insecure İsteğe bağlı Yalnızca Apigee Hybrid SSL kullanırken güvenli olmayan sunucu bağlantılarına izin verilir.
-o,
‑‑organization 		Zorunlu Yalnızca Apigee Hybrid (Dize) Bir Apigee kuruluşu. Kuruluş yöneticisi olmanız gerekir.
-r,
‑‑runtime 		Zorunlu Yalnızca Apigee Hybrid (Dize) Apigee Hybrid örneğinizin çalışma zamanı URL'sini belirtir. URL, https:// ile başlamalıdır. Örneğin: https://apitest.apigee-hybrid-docs.net
-v,
‑‑verbose 		İsteğe bağlı Yalnızca Apigee Hybrid (İsteğe bağlı) Ayrıntılı çıkış üretir.

Sürüm komutu

CLI sürümünü yazdırın.

apigee-remote-service-cli version

Kimlik bilgileri için .netrc kullanma

Edge Public Cloud kullanıyorsanız ve makine api.enterprise.apigee.com için bir girişiniz varsa apigee-remote-service-cli, ana dizininizdeki .netrc dosyasından username ve password (gerektiğinde temel kimlik doğrulama için) bilgilerini otomatik olarak alır. Apigee Private Cloud kullanıyorsanız makine değeri, management URL'nizle aynıdır (örneğin, http://192.162.55.100). Örneğin, Edge Public Cloud'da: 
machine api.enterprise.apigee.com
login jdoe@google.com
password abc123
Örneğin, Edge Private Cloud'da: 
machine http://192.162.55.100
login jdoe@google.com
password abc123

‑‑config komut seçeneğini kullanma

‑‑config seçeneği, provision komutu tarafından oluşturulan yapılandırma dosyasının konumunu belirtir. Bu seçeneğin faydalı bir avantajı, KSA'nın yapılandırma dosyasından çektiği diğer komut parametrelerinin çoğunu atlamanıza olanak tanımasıdır. Bu seçenekler şunlardır:
  • kuruluş
  • ortam
  • çalışma zamanı
  • yönetim
  • güvensiz
  • ad alanı
  • eski
  • opdk

Örneğin, provision komutunu aşağıdaki gibi yürütebilirsiniz: 

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

Yapılandırma dosyası

Bu bölümde, mevcut tüm seçenekleri içeren örnek bir yapılandırma dosyası gösterilmektedir. 

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
  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
products:
  refresh_rate: 2m
analytics:
  legacy_endpoint: false
  file_limit: 1024
  send_channel_size: 10
  collection_interval: 10s
auth:
  api_key_claim: claim
  api_key_cache_duration: 30m
  api_key_header: x-api-key
  api_header: :authority
  allow_unauthorized: false
  jwt_provider_key: https://org-test.apigee.net/remote-token/token
  append_metadata_headers: true