Utilizzo di cURL

È possibile utilizzare cURL, uno strumento a riga di comando, da un terminale, per gestire il servizio IBM Cloud Monitoring utilizzando la sintassi URL.

cURL sintassi

Utilizzate la seguente sintassi da un terminale per eseguire un comando cURL:

curl -X <METHOD> <MONITORING_ENDPOINT>/<API_URL> <-H HEADERS,> [-d DATA]

Dove

<METHOD> indica il tipo di chiamata API REST che si vuole effettuare.
<MONITORING-ENDPOINT> indica l'endpoint in cui è disponibile l'istanza di monitoraggio. Per ulteriori informazioni, vedere Monitoring endpoint. Ad esempio, l'endpoint per un'istanza disponibile in us-south è il seguente: https://us-south.monitoring.cloud.ibm.com
<API_URL> Per ulteriori informazioni sugli URL API, consultare gli endpoint API REST.
HEADERS aggiungere informazioni aggiuntive, come quelle per l'autenticazione con il servizio IBM Cloud Monitoring.
DATA consente di passare informazioni aggiuntive che potrebbero essere necessarie.

Intestazioni per i token IAM

Usare i token IAM per autenticarsi con il servizio IBM Cloud Monitoring quando si usa l'API REST di Monitoring per automatizzare le attività di routine e monitorare le notifiche.

In un comando cURL, aggiungere le seguenti opzioni per autenticarsi con il servizio IBM Cloud Monitoring utilizzando un token IAM:

-H "Authorization: $AUTH_TOKEN"
-H "IBMInstanceID: $GUID"
-H "SysdigTeamID: $TEAM_ID"

Dove

IBMInstanceID indica il GUID dell'istanza IBM Cloud Monitoring che si vuole indirizzare con il comando cURL.

Per ottenere il GUID dell'istanza di monitoraggio, eseguire il seguente comando: ibmcloud resource service-instance <NAME> --output json | jq -r '.[].guid'
Authorization indica il token IAM utilizzato per l'autenticazione con l'istanza del servizio IBM Cloud Monitoring.

Per ottenere il token IAM AUTH_TOKEN, eseguire il seguente comando: ibmcloud iam oauth-tokens | awk '{print $4}'

Per ulteriori informazioni, vedere Ottenere il token API IAM.
SysdigTeamID indica il GUID di una squadra.

Per ottenere il GUID, vedere Ottenere l'ID di un team Monitoring.

Intestazioni per il token Monitoring

È inoltre possibile utilizzare i token API Monitoring per autenticarsi con il servizio IBM Cloud Monitoring quando si utilizza l'API REST Monitoring per automatizzare le attività di routine e monitorare le notifiche.

In un comando cURL, aggiungere la seguente opzione di comando per autenticarsi con il servizio IBM Cloud Monitoring utilizzando un token Monitoring:

-H "Authorization: Bearer $SYSDIG_TOKEN"

Per ottenere il token Monitoring, vedere Ottenere il token API Monitoring.

Esecuzione di una query API cURL

Per eseguire una query API cURL e autenticarla utilizzando il token IAM, completare i passaggi seguenti:

Imposta il token IAM.

AUTH_TOKEN=$(ibmcloud iam oauth-tokens | awk '{print $4}')

Impostare il GUID dell'istanza di IBM Cloud Monitoring.

GUID=$(ibmcloud resource service-instance <NAME> --output json | jq -r '.[].guid')

Eseguire la query API cURL.

curl -X <METHOD> <MONITORING_ENDPOINT>/<API_URL> -H "Authorization: $AUTH_TOKEN" -H "IBMInstanceID: $GUID" -H "content-type: application/json"

Ad esempio, per creare un avviso in cui la definizione dell'avviso e il canale di notifica sono definiti tramite un file JSON, è possibile eseguire il seguente comando:

curl -X POST \
  https://us-south.monitoring.cloud.ibm.com/api/alerts \
  -H 'Authorization: Bearer eyJraW...' \
  -H 'IBMInstanceID: fc8ceb8a-...' \
  -H 'Content-Type: application/json' \
  -d @alert.json