cURL verwenden

Sie können cURL, ein Befehlszeilentool, über ein Terminal verwenden, um den IBM Cloud Monitoring-Service mittels URL-Syntax zu verwalten.

cURL-Syntax

Verwenden Sie die folgende Syntax über ein Terminal, um einen cURL-Befehl auszuführen:

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

Wo

  • <METHOD> gibt die Art des REST-API-Aufrufs an, den Sie tätigen möchten.
  • <MONITORING-ENDPOINT> gibt den Endpunkt an, an dem die Überwachungsinstanz verfügbar ist. Weitere Informationen finden Sie unter Monitoring-Endpunkte. Der Endpunkt für eine Instanz, die in der Region "us-south" verfügbar ist, ist beispielsweise folgender: https://us-south.monitoring.cloud.ibm.com
  • <API_URL> Weitere Informationen zu API-URLs finden Sie unter REST-API-Endpunkte.
  • HEADERS fügt weitere Informationen hinzu, wie Informationen zur Authentifizierung beim IBM Cloud Monitoring-Service.
  • DATA ermöglicht Ihnen die Übergabe zusätzlicher Informationen, die erforderlich sein könnten.

Header für IAM-Tokens

Verwendenn Sie IAM-Tokens für die Authentifizierung beim IBM Cloud Monitoring-Service, wenn Sie die Monitoring-REST-API verwenden, um Routineaufgaben und Überwachungsbenachrichtigungen zu automatisieren.

Fügen Sie in einem cURL-Befehl die folgenden Optionen hinzu, um eine Authentifizierung beim IBM Cloud Monitoring-Service mithilfe eines IAM-Tokens durchzuführen:

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

Wo

  • IBMInstanceID gibt die GUID der IBM Cloud Monitoring-Instanz an, die das Ziel des cURL-Befehls sein soll.

    Um die GUID der Überwachungsinstanz zu erhalten, führen Sie folgenden Befehl aus: ibmcloud resource service-instance <NAME> --output json | jq -r '.[].guid'

  • Authorization gibt das IAM-Token an, das für die Authentifizierung bei der IBM Cloud Monitoring-Serviceinstanz verwendet wird.

    Um das IAM-Token AUTH_TOKEN abzurufen, führen Sie den folgenden Befehl aus: ibmcloud iam oauth-tokens | awk '{print $4}'

    Weitere Informationen finden Sie unter IAM-API-Token abrufen.

  • SysdigTeamID gibt die GUID eines Teams an.

    Informationen zum Abrufen der GUID finden Sie unter Monitoring-Team-ID abrufen.

Header für Monitoring-Token

Sie können auch Monitoring-API-Tokens für die Authentifizierung beim IBM Cloud Monitoring-Service verwenden, wenn Sie die Monitoring-REST-API verwenden, um Routineaufgaben und Überwachungsbenachrichtigungen zu automatisieren.

Fügen Sie in einem cURL-Befehl die folgende Befehlsoption hinzu, um eine Authentifizierung IBM Cloud Monitoring-Service mithilfe eines Monitoring-Tokens durchzuführen:

-H "Authorization: Bearer $SYSDIG_TOKEN"

Informationen zum Abrufen des Monitoring-Tokens finden Sie unter Monitoring-API-Token abrufen.

cURL-API-Abfrage ausführen

Führen Sie die folgenden Schritte aus, um eine cURL-API-Abfrage auszuführen und sich unter Verwendung des IAM-Tokens zu authentifizieren:

  1. Legen Sie das IAM-Token fest.

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

  2. Legen Sie die GUID der IBM Cloud Monitoring-Instanz fest.

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

  3. Führen Sie die cURL-API-Abfrage aus.

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

Zum Erstellen eines Alerts, bei dem die Alertdefinition und der Benachrichtigungskanal über eine JSON-Datei definiert werden, können Sie beispielsweise den folgenden Befehl ausführen:

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