Utilizzare l'API API Monitoring Management

Stai visualizzando la documentazione di Apigee Edge.
Vai alla documentazione di Apigee X. informazioni

Utilizza l'API di gestione di API Monitoring per eseguire le attività seguenti.

Attività Ulteriori informazioni
Gestisci gli avvisi per API Monitoring
Gestisci le raccolte per il monitoraggio delle API
Visualizzazione dei log di API Monitoring a diversi livelli
Visualizza le metriche di API Monitoring

Quote per le chiamate API

Tutte le API API Monitoring applicano una quota che limita il numero di chiamate all'API al minuto. Ad esempio, l'API Create collections limita a sei chiamate al minuto.

Non tutte le API hanno gli stessi limiti di quota. Consulta la documentazione di riferimento API su ogni API per determinarne il limite.

Usa curl

Gli esempi di API in questo documento utilizzano curl per dimostrare come utilizzare API Monitoring mediante l'API. curl è uno strumento a riga di comando open source per il trasferimento di dati con sintassi dell'URL, che supporta protocolli comuni come HTTP e HTTPS. Per informazioni sul download e sull'utilizzo di curl, visita https://curl.haxx.se/.

La tabella seguente riassume le opzioni della riga di comando curl utilizzate negli esempi.

Opzione Descrizione
-d '{}'

--data @filename

Definisce il corpo della richiesta, passato direttamente o specificando un nome file.
-H

--header

Definisce un'intestazione della richiesta. Devi passare le seguenti informazioni nell'intestazione della richiesta:
  • Token OAuth 2.0 per l'autenticazione degli utenti mediante l'intestazione Authorization, come descritto in Ottenere un token di accesso per OAuth 2.0.
  • Tipi di contenuto supportati dal client tramite l'intestazione Accept.
  • Tipo di contenuti del corpo della richiesta inviato durante la creazione o l'aggiornamento di una risorsa (POST, PATCH, PUT) utilizzando l'intestazione Content-Type.
-i Visualizza nella risposta ulteriori informazioni, ad esempio le intestazioni.
-X Specifica il tipo di richiesta (GET, POST e così via).

Ottenere un token di accesso OAuth 2.0

Apigee Edge supporta OAuth 2.0 per l'autenticazione degli utenti. Con OAuth 2.0, scambi le tue credenziali Apigee Edge con un token di accesso e un token di aggiornamento che potrai utilizzare per effettuare chiamate sicure all'API Apigee Edge. Una volta ottenuto un token, non è necessario scambiare nuovamente le credenziali fino alla sua scadenza. Il token di aggiornamento consente di mantenere attiva la "sessione" con il server per un periodo più lungo senza fornire le credenziali. Per ulteriori informazioni sui token di accesso, consulta l'articolo su come utilizzare OAuth2 per accedere all'API di gestione.

Utilizzando le tue credenziali Apigee Edge, puoi ottenere i token di accesso e di aggiornamento OAuth 2.0 per accedere alle risorse Apigee Edge utilizzando l'utilità get_token di Apigee.

Per ottenere un token di accesso OAuth 2.0:

  1. Installa l'utilità get_token. Per informazioni su come installare l'utilità get_token, consulta Utilizzare get_token.

  2. Esegui get_token per ottenere un token di accesso OAuth 2.0.

    La prima volta che inserisci il comando o se il token di aggiornamento è scaduto, get_token ti chiede di inserire nome utente, password e codice di autenticazione a due fattori di sei cifre. Inserisci ciascun valore quando richiesto. Se l'autenticazione a due fattori non è abilitata, premi Invio quando viene richiesto.

  3. Copia il token OAuth 2.0 e memorizzalo in una variabile, ad esempio ACCESS_TOKEN: 

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

Quando chiami l'API Monitoring API, passa il token di accesso OAuth 2.0 nell'intestazione HTTP utilizzando l'intestazione Authorization. Ad esempio:


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