Bu sayfa, Cloud Translation API ile çevrilmiştir.

Hesap kullanma

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

acurl⁽¹⁾ yardımcı programı, standart curl çevresinde bir kolaylık sarmalayıcı sağlar. komutunu kullanın. acurl:

Apigee kimlik bilgilerinizi OAuth2 erişim jetonuyla değiştirir.
Erişim jetonunun süresinin dolduğunu algılar ve yeni bir erişim jetonu almak için yenileme jetonunu kullanır.
Bu jetonu API isteğinin Authorization başlığına iletir.

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

Edge API'ye erişmek için OAuth2'yi kullanıyorsanız ancak acurl kullanmıyorsanız bir erişim jetonu alıp API isteğinin üstbilgisini kendiniz eklemeniz gerekir. Hedef kitlenizin alabileceği erişim jetonu get_token yardımcı programıdır.

Acurl'u yükle

acurl uygulamasını kullanabilmek için yükleyin.

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:

Option	Zorunlu mu?	Açıklama
`API_URL`	Zorunlu	Apigee Edge API uç noktası. Uç noktaların tam listesi için Apigee Edge API Referansı'na bakın.
`USERNAME`	İsteğe bağlı. Kullanıcı adı ve şifre kombinasyonu veya şifre kodu gereklidir.	Apigee kullanıcı adınız (genellikle Apigee hesabınızla ilişkili e-posta adresidir). `get_token`'ü ilk kez aradığınızda kullanıcı adınızı veya şifre kodunuzu iletmeniz gerekir. E-postanızı iletmeniz gerekmez adresini tekrar kontrol etmelisiniz. Jetonları önbelleğe alıyorsanız birden fazla kullanıcı varsa her çağrıda kullanıcı adınızı belirtmeniz gerekir.
`PASSWORD`	İsteğe bağlı. Kullanıcı adı ve şifre kombinasyonu veya şifre kodu gereklidir.	Apigee hesabınızın şifresi. Şifreyi atlarsanız şunları girmeniz istenir: `acurl` kodunu ilk kullanışınızda ve geçerli bir yenileme jetonuna dokunun. Şifrenizi doğrudan komutta kullanmak istemiyorsanız bu komutta şifreniz yerine tek kullanımlık şifre kodunu kullanın.
`MFACODE`	İsteğe bağlı	Geçici olarak kullanılan altı basamaklı çok öğeli kimlik doğrulama (MFA) kodudur. `-u` kullanıyorsanız ve MFA'yı etkinleştirdiyseniz bu kod gereklidir. Şifre kodu modu kullanılmıyorsa bunu yapmanız istenir. MFA'nızı etkinleştirmediyseniz veya komut dosyası akışı kullanıyorsanız istemlerden kaçınmak için `-m ""` değerini belirtebilirsiniz.
`PASSCODE`	İsteğe bağlı. Kullanıcı adı ve şifre kombinasyonu veya şifre kodu gereklidir.	şifre. SAML IdP ile kimlik doğrulama yaparken geçiş kodu gerekir ve LDAP IdP ile kimlik doğrulama yapmak için kullanılabilir.

Ö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

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

Option	`acurl meaning`	`curl meaning`
-u	`username`	`username`
-dk.	`MFA code`	`max time` (`--max-time` uzun biçimi kullanılmalıdır)
-p	`passcode`	`proxy tunnel` (`--proxytunnel` uzun biçimi kullanılmalıdır)
-v	`verbose`	`verbose`
-h	`help`	`help` (`--help` uzun biçimi kullanılmalıdır)

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ına bağlı olarak sonuçlar döndürür çağrıldı. Ayrıca acurl, hem erişim hem de yenileme jetonlarını ~/.sso-cli içinde depolar.

Kimlik bilgilerini (şifre ve isteğe bağlı MFA veya şifre kodu) girmeden arama yapmaya devam edebilirsiniz. hem erişim jetonu hem de yenileme jetonunun süresinin dolacağından, bunu Jeton geçerlilik süresi bölümünde bulabilirsiniz.

curl'den taşıma

curl kullanıyorsanız acurl yardımcı programına geçiş yapmak oldukça kolaydır ve Kimlik bilgilerini manuel olarak kodlama ihtiyacını ortadan kaldırır. Yardımcı programı indirip yükledikten sonra değiştir:

curl -u username

şununla:

acurl -u username

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

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

acurl'i ilk kez çağırma

acurl ile API'yi ilk kez çağırdığınızda, Apigee kimlik bilgilerinizi ( kullanıcı adınızı ve şifrenizi veya bir şifre kodu) içerdiğinden, acurl, bu e-postaları erişim jetonu ve yenileme jetonuyla değiştirebilir.

Aşağıdaki örnekte, Get acurl uç noktasını kullanarak bir kuruluşla ilgili ayrıntıları almak için acurl ile yapılan ilk çağrı 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 aramalar 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, sizden onay ister gerekebilir.

Bu talep, "ahamilton-eval" ile ilgili ayrıntıları alıyor kurum içinde tutmaktır. Projenin tam listesi için Edge API uç noktaları için Apigee Edge API Referansı'na bakın.

⁽¹⁾ Telif Hakkı 2023 Google LLC
acurl aracı "Yazılım" olarak kullanıma sunulmuştur altında Hizmet de dahil olmak üzere Google Cloud Platform kullanımınızı düzenleyen sözleşme Özel Şartlar'a https://cloud.google.com/terms/service-terms adresinden ulaşabilirsiniz.