使用 cURL

您可以使用 cURL, 這個命令列工具，從終端機使用 URL 語法來管理 IBM Cloud Monitoring 服務。

cURL 句法

在終端機使用下列語法執行 cURL 指令：

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

其中

<METHOD> 表示您要進行的 REST API 呼叫類型。
<MONITORING-ENDPOINT> 表示監控實體可用的端點。如需詳細資訊，請參閱 Monitoring endpoints。例如，在 us-south 可用的實例的端點如下：https://us-south.monitoring.cloud.ibm.com
<API_URL> 有關 API URL 的詳細資訊，請參閱 REST API 端點。
HEADERS 新增其他資訊，例如與服務驗證的資訊。IBM Cloud Monitoring
DATA 允許您傳遞可能需要的其他資訊。

IAM 代號的標頭

當您使用 Monitoring REST API 自動執行例行任務和監控通知時，請使用 IAM 令牌驗證 IBM Cloud Monitoring 服務。

在 cURL 指令中，新增下列選項，以使用 IAM 令牌驗證 IBM Cloud Monitoring 服務：

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

其中

IBMInstanceID 表示您要使用命令定位的实例的 GUID。cURL IBM Cloud Monitoring

若要取得監控實體的 GUID，請執行下列指令：ibmcloud resource service-instance <NAME> --output json | jq -r '.[].guid'
Authorization 表示用於驗證服務實體的 IAM 令牌。IBM Cloud Monitoring

若要取得 IAM AUTH_TOKEN 令牌，請執行下列指令：ibmcloud iam oauth-tokens | awk '{print $4}'

如需詳細資訊，請參閱取得 IAM API 令牌。
SysdigTeamID 表示團隊的 GUID。

若要取得 GUID，請參閱取得 Monitoring 團隊的 ID。

Monitoring 令牌的標頭

當您使用 Monitoring REST API 自動執行例行任務和監控通知時，也可以使用 Monitoring API 令牌來驗證 IBM Cloud Monitoring 服務。

在 cURL 指令中，新增下列指令選項，以使用 Monitoring 令牌與 IBM Cloud Monitoring 服務驗證：

-H "Authorization: Bearer $SYSDIG_TOKEN"

若要取得 Monitoring 令牌，請參閱取得 Monitoring API 令牌。

執行 cURL API 查詢

若要使用 IAM 令牌執行 cURL API 查詢和 authrnticat，請完成下列步驟：

設定 IAM 記號。

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

設定 IBM Cloud Monitoring 範例 GUID。

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

執行 cURL API 查詢。

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

例如，要建立一個警報，其中警報定義和通知通道是透過 JSON 檔定義的，您可以執行下列指令：

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