Utilizzare l'API API Monitoring Management

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

Utilizza l'API di gestione del monitoraggio delle API per eseguire le seguenti attività.

Attività Ulteriori informazioni
Gestire gli avvisi per il monitoraggio dell'API
Gestire le raccolte per il monitoraggio delle API
Visualizzare i log di API Monitoring a diversi livelli
Visualizzare le metriche di API Monitoring

Quote per le chiamate API

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

Non tutte le API hanno gli stessi limiti di quota. Consulta la documentazione di riferimento dell'API di ogni API per determinare il relativo limite.

Utilizzare curl

Gli esempi di API in questo documento utilizzano curl per dimostrare come utilizzare il monitoraggio dell'API utilizzando l'API. curl è uno strumento a riga di comando open source per il trasferimento di dati con sintassi URL, che supporta protocolli comuni come HTTP e HTTPS. Per informazioni su come scaricare e utilizzare curl, visita la pagina https://curl.haxx.se/.

La tabella seguente riassume le opzioni a riga di comando di 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 di richiesta. Devi passare le seguenti informazioni nell'intestazione della richiesta:
  • Token OAuth 2.0 per l'autenticazione dell'utente utilizzando l'intestazione Authorization, come descritto in Ottenere un token di accesso OAuth 2.0.
  • Tipi di contenuti supportati dal client utilizzando l'intestazione Accept.
  • Tipo di contenuto del corpo della richiesta inviato durante la creazione o l'aggiornamento di una risorsa (POST, PATCH, PUT) utilizzando l'intestazione Content-Type.
-i Mostra più informazioni, ad esempio le intestazioni, nella risposta.
-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 utente. Con OAuth 2.0, scambi le credenziali di Apigee Edge con un token di accesso e un token di aggiornamento che puoi utilizzare per effettuare chiamate sicure all'API Apigee Edge. Una volta ottenuto un token, non dovrai più scambiare le tue credenziali fino alla scadenza del token. Il token di aggiornamento ti consente di mantenere attiva la "sessione" con il server per un periodo più lungo senza fornire le tue credenziali. Per saperne di più sui token di accesso, consulta l'articolo Utilizzare OAuth2 per accedere all'API di gestione.

Utilizzando le tue credenziali Apigee Edge, puoi ottenere token di accesso e 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 il nome utente, la password e il codice di autenticazione a due fattori di sei cifre. Inserisci ogni valore quando richiesto. Se non hai attivato l'autenticazione a due fattori, premi semplicemente Invio quando 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 API Monitoring, 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" 
   ...