API Monitoring Management API'yi kullanma

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

Aşağıdaki görevleri gerçekleştirmek için API İzleme yönetim API'sini kullanın.

Görev Daha Fazla Bilgi
API İzleme ile ilgili uyarıları yönetme
API İzleme için koleksiyonları yönetme
API Monitoring günlüklerini farklı düzeylerde görüntüleme
API Monitoring metriklerini görüntüleme

API çağrısı kotaları

Tüm API Monitoring API'leri, API'yi dakikada kaç kez çağırabileceğinizi sınırlayan bir kota uygular. Örneğin, Koleksiyon oluşturma API'si sizi dakikada altı çağrıyla sınırlandırır.

Tüm API'lerin kota sınırları aynı değildir. Sınırını belirlemek için her API'nin API referans dokümanlarına bakın.

curl'i kullanma

Bu belgedeki API örnekleri, API İzleme'nin API'yi kullanarak nasıl kullanılacağını göstermek için curl'i kullanır. curl, URL söz dizimini kullanarak veri aktarmak için kullanılan, HTTP ve HTTPS gibi yaygın protokolleri destekleyen açık kaynak bir komut satırı aracıdır. curl'i indirme ve kullanma hakkında bilgi edinmek için https://curl.haxx.se/ adresine bakın.

Aşağıdaki tabloda, örneklerde kullanılan curl komut satırı seçenekleri özetlenmiştir.

Seçenek Açıklama
-d '{}'

--data @filename

Doğrudan veya bir dosya adı belirterek iletilen istek gövdesini tanımlar.
-H

--header

Bir istek üst bilgisini tanımlar. İstek başlığında aşağıdaki bilgileri iletmeniz gerekir:
  • OAuth 2.0 erişim jetonu edinme bölümünde açıklandığı gibi, Authorization üstbilgisini kullanarak kullanıcı kimlik doğrulaması için OAuth 2.0 jetonu.
  • Accept başlığını kullanan istemci tarafından desteklenen içerik türleri.
  • Content-Type üstbilgisi kullanılarak bir kaynak (POST, PATCH, PUT) oluşturulurken veya güncellenirken gönderilen istek gövdesinin içerik türü.
-i Yanıtta üstbilgi gibi daha fazla bilgi görüntülenir.
-X İsteğin türünü (GET, POST vb.) belirtir.

OAuth 2.0 erişim jetonu alma

Apigee Edge, kullanıcı kimlik doğrulaması için OAuth 2.0'ı destekler. OAuth 2.0 ile Apigee Edge kimlik bilgilerinizi, Apigee Edge API'ye güvenli çağrılar yapmak için kullanabileceğiniz bir erişim jetonu ve yenileme jetonuyla değiştirirsiniz. Bir jeton aldıktan sonra, jetonun süresi dolana kadar kimlik bilgilerinizi tekrar değiştirmeniz gerekmez. Yenileme jetonu, kimlik bilgilerinizi sağlamadan sunucuyla "oturumunuzu" daha uzun süre açık tutmanıza olanak tanır. Erişim jetonları hakkında daha fazla bilgi için Management API'ye erişmek için OAuth2'yi kullanma başlıklı makaleyi inceleyin.

Apigee Edge kimlik bilgilerinizi kullanarak Apigee'nin get_token yardımcı programını kullanarak Apigee Edge kaynaklarına erişmek için OAuth 2.0 erişim ve yenileme jetonları alabilirsiniz.

OAuth 2.0 erişim jetonu almak için:

  1. get_token yardımcı programını yükleyin. get_token yardımcı programının nasıl yükleneceği hakkında bilgi için get_token'ı kullanma başlıklı makaleyi inceleyin.

  2. OAuth 2.0 erişim jetonu almak için get_token komutunu yürütün.

    Komutu ilk kez girdiğinizde veya yenileme jetonunun süresi dolduğunda get_token, kullanıcı adınızı, şifrenizi ve altı haneli iki faktörlü kimlik doğrulama kodunu ister. İstendiğinde her bir değeri girin. İki faktörlü kimlik doğrulamayı etkinleştirmediyseniz istemde Enter tuşuna basmanız yeterlidir.

  3. OAuth 2.0 jetonunu kopyalayıp ACCESS_TOKEN gibi bir değişkende saklayın: 

    export ACCESS_TOKEN=eyJhbGciOiJSUzI1NiJ9.eyJqdGkiOiI2NmQ4MTRiMC01YzZkLTQyZWUtYjlmYi05ZGVhODk5MGRiODIiLCJzdWIiOiJlZjc3YmRhMS05ZWIxLTQyZDgtODg5MC0zODQ3ODg0MzM1OWIiLCJzY29wZSI6WyJzY2ltLmVtYWlscy5yZWFkIiwicGFzc3dvcmQud3JpdGUiLCJhcHByb3ZhbHMubWUiLCJzY2ltLm1lIiwic2NpbS5pZHMucmVhZCIsIm9wZW5pZCIsIm9hdXRoLmFwcHJvdmFscyJdLCJjbGllbnRfaWQiOiJlZGdlY2xpIiwiY2lkIjoiZWRnZWNsaSIsImF6cCI6ImVkZ2VjbGkiLCJncmFudF90eXBlIjoicGFzc3dvcmQiLCJ1c2VyX2lkIjoiZWY3N2JkYTEtOWViMS00MmQ4LTg4OTAtMzg0Nzg4NDMzNTliIiwib3JpZ2luIjoidXNlcmdyaWQiLCJ1c2VyX25hbWUiOiJsbHluY2hAYXBpZ2VlLmNvbSIsImVtYWlsIjoibGx5bmNoQGFwaWdlZS5jb20iLCJyZXZfc2lnIjoiZTViZDc3NjIiLCJpYXQiOjE0NzA3NTMyMDksImV4cCI6MTQ3MDc5NjQwOSwiaXNzIjoiaHR0cHM6Ly9sb2dpbi5lMmUuYXBpZ2VlLm5ldC9vYXV0aC90b2tlbiIsInppZCI6InVhYSIsImF1ZCI6WyJzY2ltIiwicGFzc3dvcmQiLCJvcGVuaWQiLCJlZGdlY2xpIiwiYXBwcm92YWxzIiwic2NpbS5lbWFpbHMiLCJzY2ltLmlkcyIsIm9hdXRoIl19.FF3f1i9eHbBqYjnvBmt9nTtTcyNQBQRDDq2tQ3aRUAzUesLAet7qfBB9QVCvE-zVBn4BiPgRU-iturxPxRMAQ2a34-8oLvgff3x-aALBWkSwbc8PJdWTiPP9VYykoFSJtu9UIN5x0FQEQN_hyurO8D2SrS3uQKNwIyjoJPy4Bps7nb3WqJyKRfXAzf8UptdN7XE0TVqTyBcZGT3OQ2Was0VPfe_dr-wIrywvjNf6FczjdktB1lpKJ2oRXx1n8PuK5FhOQ4wE9VeSsNsMHVcGvJ5W6Tvi61fo2h1w1d4AKvGdERzuVf_XWN00mtcgwsUAuXV0r5H_i3vxcMuUym1XOg

API İzleme API'sini çağırırken Authorization üst bilgisini kullanarak HTTP üst bilgisinde OAuth 2.0 erişim jetonunu iletin. Örneğin:


curl -X GET "https://apimonitoring.enterprise.apigee.com/alerts?org=myorg"
   -H "Authorization: Bearer $ACCESS_TOKEN" 
   ...