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

Hesap kullanma

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

acurl⁽¹⁾ yardımcı programı, standart bir curl komutu için sarmalayıcı sunar. acurl:

Apigee kimlik bilgilerinizi OAuth2 erişim jetonu için değiştirir.
Bir 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 başlığına iletir.

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

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

Acurl'u yükle

acurl uygulamasını kullanabilmek için önce bu uygulamayı 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:

Option	Zorunlu mu?	Açıklama
`API_URL`	Zorunlu	Apigee Edge API uç noktası. Uç noktaların tam listesi için Apigee Edge API Referansı'nı inceleyin.
`USERNAME`	İsteğe bağlı. Kullanıcı adı ve şifre kombinasyonu veya şifre kodu gereklidir.	Apigee kullanıcı adınız. Bu, genellikle Apigee hesabınızla ilişkilendirilmiş e-posta adresidir. `get_token` numaralı telefonu ilk kez aradığınızda kullanıcı adınızı veya bir şifre kodunu girmeniz gerekir. Erişim ve yenileme jetonlarının süresi dolana kadar e-posta adresinizi tekrar aktarmanız gerekmez. Birden fazla kullanıcının jetonlarını önbelleğe alıyorsanız 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 çıkarırsanız `acurl` hizmetini ilk kez kullandığınızda ve sonraki çağrılarda geçerli bir yenileme jetonu olmadan şifreyi girmeniz istenir. Şifrenizi doğrudan komutta kullanmak istemiyorsanız şifreniz yerine tek kullanımlık bir kod şifresi kullanabilirsiniz.
`MFACODE`	İsteğe bağlı	Altı basamaklı geçici bir çok öğeli kimlik doğrulaması (MFA) kodu. `-u` kullanıyorsanız ve MFA'yı etkinleştirdiyseniz bu kod gereklidir. Atlanırsa sorulur (şifre kodu modunda değilseniz). MFA'yı etkinleştirmediyseniz veya komut dosyalı bir akışınız varsa istemleri önlemek için `-m ""` değerini belirtebilirsiniz.
`PASSCODE`	İsteğe bağlı. Kullanıcı adı ve şifre kombinasyonu veya şifre kodu gereklidir.	Şifre yerine kullanabileceğiniz tek kullanımlık şifre kodu. SAML IDP ile kimlik doğrularken şifre kodu gerekir ve bir LDAP IdP ile kimlik doğrulamak 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çeneklerin yanı sıra tüm curl seçeneklerini de kabul eder. Örneğin, standart curl seçeneklerini kullanarak üst bilgileri iletebilir, HTTP fiilini belirtebilir, gövde ekleyebilir ve ayrıntı düzeyini etkinleştirebilirsiniz:

Option	`acurl meaning`	`curl meaning`
-u	`username`	`username`
-dk	`MFA code`	`max time` (uzun `--max-time` kullanılmalıdır)
-p	`passcode`	`proxy tunnel` (uzun `--proxytunnel` kullanılmalıdır)
-v	`verbose`	`verbose`
-sa	`help`	`help` (uzun `--help` 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ı, çağrı yaptığınız Edge API uç noktasına göre sonuçlar döndürür. Ayrıca acurl, hem erişim hem de yenileme jetonlarını ~/.sso-cli içinde depolar.

Jeton geçerlilik süresi bölümünde açıklandığı gibi, hem erişim jetonunun hem de yenileme jetonunun süresi dolana kadar kimlik bilgileri (şifre ve isteğe bağlı MFA veya şifre kodu) girmeden çağrı yapmaya devam edebilirsiniz.

curl'den taşı

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

curl -u username

şununla değiştirin:

acurl -u username

acurl yardımcı programı kimlik bilgilerinizi kodlar ve ara sıra yeni jeton çiftlerini almak için gereken ek kimlik bilgilerini girmenizi ister.

acurl yardımcı programı, makine kullanıcıları için curl yerine kullanmak üzere de kullanılabilir. Daha fazla bilgi edinmek üzere Makine kullanıcıları için OAuth2 ve SAML alt bölgelerindeki makine kullanıcıları bölümlerine bakın.

acurl'u ilk kez ara

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

Aşağıdaki örnekte, Kuruluşu alma uç noktasını kullanan bir kuruluş hakkında 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 çağrılar için kullanılır.

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

Bu talep "ahamilton-eval" kuruluşuyla ilgili ayrıntıları alıyor. Edge API uç noktalarının tam listesi için Apigee Edge API Referansı'nı inceleyin.

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