Utilizzare l'API API Monitoring Management

Stai visualizzando la documentazione di Apigee Edge.
Consulta la documentazione di Apigee X. info

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

Attività Ulteriori informazioni
Gestisci gli avvisi per API Monitoring
Gestisci le raccolte per API Monitoring
Visualizza i log di API Monitoring a diversi livelli
Visualizza le metriche di API Monitoring

Quote per le chiamate API

Tutte le API di 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 ti consente di effettuare sei chiamate al minuto.

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

Utilizzare curl

Gli esempi di API in questo documento utilizzano curl per mostrare come utilizzare API Monitoring tramite 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 sul download e sull'utilizzo di curl, consulta 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 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 Visualizza ulteriori 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 tue credenziali 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 devi scambiare di nuovo le credenziali finché il token non scade. Il token di aggiornamento ti consente di mantenere attiva la "sessione" con il server per un periodo di tempo più lungo senza fornire le tue credenziali. Per saperne di più sui token di accesso, consulta Utilizzare OAuth2 per accedere all'API di gestione.

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