API Monitoring Management API'yi kullanma

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

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

Görev Daha Fazla Bilgi
API izleme için uyarıları yönetme
API izleme 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, Create collections API, dakikada altı çağrı ile sınırlıdır.

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

Curl'ü kullanma

Bu belgedeki API örneklerinde, API Monitoring'in API kullanılarak nasıl kullanılacağını göstermek için curl kullanılır. curl, URL söz dizimiyle veri aktarmak için kullanılan açık kaynaklı bir komut satırı aracıdır ve HTTP ile HTTPS gibi yaygın protokolleri destekler. curl'ü indirme ve kullanma hakkında bilgi edinmek için https://curl.haxx.se/ adresini ziyaret edin.

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

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

--data @filename

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

--header

İstek başlığını 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 üstbilgisi kullanılarak kullanıcı kimlik doğrulaması için OAuth 2.0 jetonu.
  • Accept üstbilgisini kullanarak istemci tarafından desteklenen içerik türleri.
  • Content-Type üstbilgisi kullanılarak kaynak (POST, PATCH, PUT) oluşturulurken veya güncellenirken gönderilen istek metninin içerik türü.
-i Yanıtın üstbilgileri gibi daha fazla bilgi gösterir.
-X İstek 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. Jeton aldıktan sonra, jetonun süresi dolana kadar kimlik bilgilerinizi tekrar değiştirmeniz gerekmez. Yenileme jetonu, kimlik bilgilerinizi sağlamadan sunucuyla olan "oturumunuzu" daha uzun süre etkin tutmanıza olanak tanır. Erişim jetonları hakkında daha fazla bilgi için Yönetim API'sine 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 aracını kullanma başlıklı makaleyi inceleyin.

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

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

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

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

Monitoring API'yi çağırdığınızda Authorization üstbilgisini kullanarak HTTP üstbilgisinde 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" 
   ...