Utilizando cURL

Puede utilizar cURL, una herramienta de línea de mandatos, en un terminal para gestionar el servicio IBM Cloud Monitoring utilizando sintaxis de URL.

Sintaxis de cURL

Utilice la siguiente sintaxis en un terminal para ejecutar un mandato cURL:

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

Donde

  • <METHOD> indica el tipo de llamada a la API REST que desea realizar.
  • <MONITORING-ENDPOINT> indica el punto final en el que está disponible la instancia de supervisión. Para obtener más información, consulte Puntos finales de Monitoring. Por ejemplo, el punto final de una instancia que está disponible en us-south es el siguiente: https://us-south.monitoring.cloud.ibm.com
  • <API_URL> Para obtener más información sobre las URL de API, consulte Puntos finales de API REST.
  • HEADERS añade información adicional como, por ejemplo, información para la autenticación con el servicio IBM Cloud Monitoring.
  • DATA permite pasar información adicional que puede ser necesaria.

Cabeceras para señales IAM

Utilice señales IAM para autenticarse con el servicio IBM Cloud Monitoring cuando utilice la API REST de Monitoring para automatizar tareas rutinarias y supervisar notificaciones.

En un mandato cURL, añada las siguientes opciones para autenticarse con el servicio IBM Cloud Monitoring utilizando una señal IAM:

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

Donde

  • IBMInstanceID indica el GUID de la instancia de IBM Cloud Monitoring que desea que sea el destino del mandato cURL.

    Para obtener el GUID de la instancia de monitorización, ejecute el siguiente comando: ibmcloud resource service-instance <NAME> --output json | jq -r '.[].guid'

  • Authorization indica la señal de IAM que se utiliza para autenticarse con la instancia de servicio de IBM Cloud Monitoring.

    Para obtener la señal IAM AUTH_TOKEN, ejecute el siguiente mandato: ibmcloud iam oauth-tokens | awk '{print $4}'

    Para obtener más información, consulte Obtención de la señal de API de IAM.

  • SysdigTeamID indica el GUID de un equipo.

    Para obtener el GUID, consulte Obtención del ID de un equipo de Monitoring.

Cabeceras para la señal de Monitoring

También puede utilizar las señales de API de Monitoring para autenticarse con el servicio IBM Cloud Monitoring cuando utilice la API REST de Monitoring para automatizar tareas rutinarias y supervisar notificaciones.

En un mandato cURL, añada la siguiente opción de mandato para autenticarse con el servicio IBM Cloud Monitoring utilizando una señal de Monitoring:

-H "Authorization: Bearer $SYSDIG_TOKEN"

Para obtener la señal de Monitoring, consulte Obtención de la señal de API de Monitoring.

Ejecución de una consulta de API de cURL

Para ejecutar una consulta de API de cURL y autenticarse utilizando la señal IAM, siga estos pasos:

  1. Establezca la señal IAM.

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

  2. Establezca el GUID de la instancia de IBM Cloud Monitoring.

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

  3. Ejecute la consulta de API cURL.

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

Por ejemplo, para crear una alerta donde la definición de la alerta y el canal de notificación se definan mediante un archivo JSON, puede ejecutar el siguiente mandato:

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