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 Monitoring Management API'yi kullanın.

Görev Daha Fazla Bilgi
API Monitoring uyarılarını yönetin
API Monitoring için koleksiyonları yönetin
API Monitoring günlüklerini farklı düzeylerde görüntüleme
API Monitoring metriklerini göster

API çağrısı kotaları

Tüm API Monitoring API'leri, API'yi dakika başına kaç kez çağırabileceğinizi sınırlayan bir kota uygular. Örneğin, Create collections API, sizi dakika başına altı çağrıyla sınırlandırır.

Her API'nin kota sınırları aynı değildir. Sınırını belirlemek için her API'de API referans belgelerine bakın.

Curl kullan

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

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

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

--data @filename

İstek gövdesini tanımlar (doğrudan veya bir dosya adı belirtilerek iletilir).
-H

--header

İstek başlığı tanımlar. İstek başlığında aşağıdaki bilgileri iletmeniz gerekir:
  • OAuth 2.0 erişim jetonu alma bölümünde açıklandığı şekilde, Authorization üstbilgisi kullanılarak kullanıcı kimlik doğrulaması için OAuth 2.0 jetonu.
  • Accept üstbilgisini kullanan istemci tarafından desteklenen içerik türleri.
  • Content-Type başlığı kullanılarak bir kaynak (POST, PATCH, PUT) oluşturulurken veya güncellenirken gönderilen istek gövdesinin içerik türü.
-i Yanıtta üstbilgiler gibi daha fazla bilgi görüntüler.
-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 bir erişim jetonu ve yenileme jetonuyla değiştirirsiniz. Bu jetonları daha sonra Apigee Edge API'ye güvenli çağrılar yapmak için kullanabilirsiniz. Jeton aldıktan sonra, jetonun süresi dolana kadar kimlik bilgilerinizi tekrar değiştirmeniz gerekmez. Yenileme jetonu, kimlik bilgilerinizi sağlamadan sunucudaki "oturumunuzu" daha uzun bir süre etkin tutmanıza olanak tanır. Erişim jetonları hakkında daha fazla bilgi edinmek için Yönetim API'sine erişmek için OAuth2'yi kullanma başlıklı makaleye bakın.

Apigee Edge kimlik bilgilerinizi kullanarak OAuth 2.0 erişimi ve yenileme jetonları alarak Apigee'nin get_token yardımcı programını kullanarak Apigee Edge kaynaklarına erişebilirsiniz.

OAuth 2.0 erişim jetonu almak için:

  1. get_token yardımcı programını yükleyin. get_token yardımcı programını yüklemeyle ilgili bilgi edinmek için get_token'ı kullanma başlıklı makaleye bakın.

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

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

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

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

API Monitoring API'yi çağırırken Authorization başlığını kullanarak HTTP üstbilgisindeki 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" 
   ...