IBM Cloud Docs
Utilisation de cURL

Utilisation de cURL

Vous pouvez utiliser cURL, un outil de ligne de commande, à partir d'un terminal pour gérer le service IBM Cloud Monitoring à l'aide d'une syntaxe d'URL.

Syntaxe de cURL

Utilisez la syntaxe suivante à partir d'un terminal pour exécuter une commande cURL :

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

Où

  • <METHOD> indique le type d'appel à l'API REST que vous souhaitez effectuer.
  • <MONITORING-ENDPOINT> indique le point d'extrémité où l'instance de surveillance est disponible. Pour plus d'informations, voir MonitoringNoeuds finaux. Par exemple, le noeud final d'une instance disponible dans la région us-south est le suivant : https://us-south.monitoring.cloud.ibm.com
  • <API_URL> Pour plus d'informations sur les URL d'API, voir les points de terminaison de l'API REST.
  • HEADERS ajoute des informations supplémentaires telles que des informations permettant de s'authentifier auprès du service IBM Cloud Monitoring.
  • DATA permet de transmettre des informations supplémentaires qui peuvent être requises.

En-têtes des jetons IAM

Utilisez les jetons IAM pour vous authentifier auprès du service IBM Cloud Monitoring lorsque vous vous servez de l'API REST Monitoring pour automatiser les tâches de routine et surveiller les notifications.

Dans une commande cURL, ajoutez les options suivantes pour vous authentifier auprès du service IBM Cloud Monitoring à l'aide d'un jeton IAM :

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

Où

  • IBMInstanceID indique l'identificateur global unique de l'instance IBM Cloud Monitoring à cibler avec la commande cURL.

    Pour obtenir le GUID de l'instance de surveillance, exécutez la commande suivante : ibmcloud resource service-instance <NAME> --output json | jq -r '.[].guid'

  • Authorization indique le jeton IAM utilisé pour s'authentifier avec l'instance de service IBM Cloud Monitoring.

    Pour obtenir le jeton AUTH_TOKEN d'IAM, exécutez la commande suivante : ibmcloud iam oauth-tokens | awk '{print $4}'

    Pour plus d'informations, voir Obtention du jeton d'API IAM.

  • SysdigTeamID indique l'identificateur global unique d'une équipe.

    Pour obtenir cet identificateur, voir Obtention de l'ID d'une équipe Monitoring.

En-têtes du jeton Monitoring

Vous pouvez également utiliser des jetons d'API Monitoring pour vous authentifier auprès du service IBM Cloud Monitoring lorsque vous vous servez de l'API REST Monitoring pour automatiser les tâches de routine et surveiller les notifications.

Dans une commande cURL, ajoutez l'option de commande suivante pour vous authentifier auprès du service IBM Cloud Monitoring à l'aide d'un jeton Monitoring :

-H "Authorization: Bearer $SYSDIG_TOKEN"

Pour obtenir le jeton Monitoring, voir Obtention du jeton d'API Monitoring.

Exécution d'une requête d'API cURL

Pour exécuter une requête d'API cURL et vous authentifier à l'aide du jeton IAM, procédez comme suit :

  1. Définissez le jeton IAM.

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

  2. Définissez l'identificateur global unique de l'instance IBM Cloud Monitoring.

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

  3. Exécutez la requête d'API cURL.

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

Par exemple, pour créer une alerte dans laquelle la définition d'alerte et le canal de notification sont définis via un fichier JSON, vous pouvez exécuter la commande suivante :

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