Hesap kullanma

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

acurl⁽¹⁾ yardımcı programı, standart bir curl komutunun etrafında kolaylık sağlayan bir sarmalayıcı sunar. acurl:

• Apigee kimlik bilgilerinizi bir OAuth2 erişim jetonuyla değiştirir.
• Erişim jetonunun süresi dolduğunda bunu algılar ve yeni bir erişim jetonu almak için yenileme jetonunu kullanır.
• Bu jetonu API isteğinin Authorization üst bilgisinde iletir.

LDAP ve SAML iş akışları dahil olmak üzere OAuth2 ile Edge API uç noktalarını çağırmak için erişim jetonlarını kullanırsınız.

Edge API'ye erişmek için OAuth2 kullanıyorsanız ancak acurl kullanmıyorsanız erişim jetonu alıp API isteğinin üstbilgisine kendiniz eklemeniz gerekir. Erişim jetonu almanın bir yolu get_token yardımcı programını kullanmaktır.

acurl'ü yükleme

acurl kullanabilmek için yüklemeniz gerekir.

acurl söz dizimi

acurl yardımcı programı şu söz dizimini kullanır:

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

veya

acurl API_URL -p PASSCODE

Burada:

Örneğin:

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

Yukarıda gösterilen seçeneklere ek olarak acurl, tüm curl seçeneklerini kabul eder. Örneğin, standart curl seçeneklerini kullanarak üstbilgileri iletebilir, HTTP fiilini belirtebilir, gövde ekleyebilir ve ayrıntılı çıkışı etkinleştirebilirsiniz:

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}'

Başarılı bir acurl çağrısı, hangi Edge API uç noktasını çağırdığınıza bağlı olarak sonuçlar döndürür. Ayrıca acurl, hem erişim hem de yenileme jetonlarını ~/.sso-cli içinde saklar.

Erişim jetonu ve yenileme jetonu geçerlilik süresi dolana kadar kimlik bilgilerinizi (şifre ve isteğe bağlı iki faktörlü kimlik doğrulama veya geçiş kodu) girmeden aramaya devam edebilirsiniz. Bu durum, Jetonun geçerlilik süresi bölümünde açıklanmıştır.

curl'den taşıma

curl kullanıyorsanız acurl yardımcı programına geçiş kolaydır ve kimlik bilgilerinin manuel olarak kodlanması gerekmez. Yardımcı programı indirip yükledikten sonra aşağıdakileri değiştirebilirsiniz:

curl -u username

acurl -u username

acurl yardımcı programı, kimlik bilgilerinizi kodlar ve zaman zaman yeni jeton çiftleri almak için gereken ek kimlik bilgilerini girmenizi ister.

acurl yardımcı programı, makine kullanıcıları için curl yerine de kullanılabilir. Daha fazla bilgi için Makine kullanıcıları için OAuth2 ve SAML bölgelerindeki makine kullanıcıları başlıklı makaleleri inceleyin.

İlk kez bir acurl'u çağırma

API'yi acurl ile ilk kez çağırdığınızda, acurl'nın bunları erişim jetonu ve yenileme jetonuyla değiştirebilmesi için Apigee kimlik bilgilerinizi (Apigee hesabınızın kullanıcı adı ve şifresi veya bir geçiş kodu) sağlarsınız.

Aşağıdaki örnekte, Get organization uç noktasını kullanarak bir kuruluş hakkında ayrıntılı bilgi edinmek için acurl ile yapılan ilk görüşme gösterilmektedir:

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 yardımcı programı, bir erişim jetonu alır ve bunu Edge API uç noktasına yapılan çağrıya ekler:

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

Erişim jetonu ~/.sso-cli içinde yerel olarak depolanır ve sonraki çağrılar için kullanılır.

Erişim jetonunun süresi dolduktan sonra acurl, yeni bir erişim jetonu almak için yenileme jetonunu otomatik olarak kullanır. Yenileme jetonunun süresi dolduğunda acurl, Apigee kimlik bilgilerinizi ister.

Bu istek, "ahamilton-eval" kuruluşuyla ilgili ayrıntıları alır. Edge API uç noktalarının tam listesi için Apigee Edge API Referansı'na bakın.

⁽¹⁾ Telif Hakkı 2023 Google LLC
acurl aracı, https://cloud.google.com/terms/service-terms adresinde bulunan Hizmete Özel Şartlar da dahil olmak üzere Google Cloud Platform kullanımınızı yöneten sözleşme kapsamında "Yazılım" olarak sunulmaktadır.