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

Hesap kullanma

Apigee Edge belgelerini görüntülüyorsunuz.
. Git: Apigee X belgeleri. bilgi

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.
Bir erişim jetonunun süresinin ne zaman 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 kullanıyor ancak acurl kullanmıyorsanız bir erişim jetonu alıp bunu API isteğinin başlığına kendiniz ekleyin. 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ı aşağıdaki 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` numarasını ilk aradığınızda kullanıcı adınızı veya şifre kodunu girmeniz 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ılmadığı sürece bunu yapmanız istenir. MFA'yı etkinleştirmediyseniz veya komut dosyası tabanlı bir akışınız varsa istemleri önlemek için `-m ""` belirtebilirsiniz.
`PASSCODE`	İsteğe bağlı. Kullanıcı adı ve şifre kombinasyonu veya şifre kodu gereklidir.	şifre. SAML IdP ile kimlik doğrularken şifre kodu gerekir ve kullanılabilir LDAP IDP'si ile kimlik doğrulaması yapmak için kullanılır.

Ö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 curl şartlarının tümünü kabul eder seçenekleri vardır. Örneğin, üstbilgileri iletebilir, HTTP fiilini belirtebilir, gövde ekleyebilir ve standart curl seçeneklerini kullanarak ayrıntı düzeyini ayarlayın:

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

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şı

curl kullanıyorsanız acurl yardımcı programına geçiş yapmak oldukça basittir 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ı, verilerinizi kimlik bilgileri ve zaman zaman yeni jeton çiftlerini almak için gereken ek kimlik bilgilerini girmenizi 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 alt bölgelerindeki makine kullanıcıları başlıklı makaleleri inceleyin.

Acurl'yi ilk kez ara

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, acurl ile almak için kuruluş uç noktası:

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 bu jetonu Edge API uç noktası:

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

Erişim jetonu ~/.sso-cli uygulamasında yerel olarak depolanır ve jeton için kullanılır arama yapabilirsiniz.

Erişim jetonunun süresi dolduktan sonra acurl, yenileme jetonunu otomatik olarak kullanır: yeni bir erişim jetonu ekleyebilirsiniz. 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.