Datadog-Webhooks インテグレーションの構成は、Datadog API から直接行います。 Datadog-Webhooks インテグレーションの詳細については、インテグレーションページを参照してください。
POST https://api.datadoghq.eu/api/v1/integration/webhooks/configuration/custom-variableshttps://api.ddog-gov.com/api/v1/integration/webhooks/configuration/custom-variableshttps://api.datadoghq.com/api/v1/integration/webhooks/configuration/custom-variableshttps://api.us3.datadoghq.com/api/v1/integration/webhooks/configuration/custom-variables
<CUSTOM_VARIABLE_NAME>
という名のエンドポイントを作成します。
カスタム変数のリクエスト本文を定義します。
{
"is_secret": true,
"name": "CUSTOM_VARIABLE_NAME",
"value": "CUSTOM_VARIABLE_VALUE"
}
OK
Custom variable for Webhook integration.
{
"is_secret": true,
"name": "CUSTOM_VARIABLE_NAME",
"value": "CUSTOM_VARIABLE_VALUE"
}
Bad Request
Error response object.
{
"errors": [
"Bad Request"
]
}
Authentication error
Error response object.
{
"errors": [
"Bad Request"
]
}
# Curl command
curl -X POST "https://api.datadoghq.eu"https://api.ddog-gov.com"https://api.datadoghq.com"https://api.us3.datadoghq.com/api/v1/integration/webhooks/configuration/custom-variables" \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY}" \
-d @- << EOF
{
"is_secret": true,
"name": "CUSTOM_VARIABLE_NAME",
"value": "CUSTOM_VARIABLE_VALUE"
}
EOF
POST https://api.datadoghq.eu/api/v1/integration/webhooks/configuration/webhookshttps://api.ddog-gov.com/api/v1/integration/webhooks/configuration/webhookshttps://api.datadoghq.com/api/v1/integration/webhooks/configuration/webhookshttps://api.us3.datadoghq.com/api/v1/integration/webhooks/configuration/webhooks
<WEBHOOK_NAME>
という名のエンドポイントを作成します。
Webhooks インテグレーションのリクエスト本文を作成します。
フィールド
種類
説明
custom_headers
object
If null
, uses no header.
If given a JSON payload, these will be headers attached to your webhook.
<any-key>
string
Additional properties for custom headers.
encode_as
enum
Encoding type. Can be given either json
or form
.
Allowed enum values: json,form
name [required]
string
The name of the webhook. It corresponds with <WEBHOOK_NAME>
.
Learn more on how to use it in
monitor notifications.
payload
object
If null
, uses the default payload.
If given a JSON payload, the webhook returns the payload
specified by the given payload.
Webhooks variable usage.
url [required]
string
URL of the webhook.
{
"custom_headers": {
"<any-key>": "string"
},
"encode_as": "string",
"name": "WEBHOOK_NAME",
"payload": {},
"url": "https://example.com/webhook"
}
OK
Datadog-Webhooks integration.
フィールド
種類
説明
custom_headers
object
If null
, uses no header.
If given a JSON payload, these will be headers attached to your webhook.
<any-key>
string
Additional properties for custom headers.
encode_as
enum
Encoding type. Can be given either json
or form
.
Allowed enum values: json,form
name [required]
string
The name of the webhook. It corresponds with <WEBHOOK_NAME>
.
Learn more on how to use it in
monitor notifications.
payload
object
If null
, uses the default payload.
If given a JSON payload, the webhook returns the payload
specified by the given payload.
Webhooks variable usage.
url [required]
string
URL of the webhook.
{
"custom_headers": {
"<any-key>": "string"
},
"encode_as": "string",
"name": "WEBHOOK_NAME",
"payload": {},
"url": "https://example.com/webhook"
}
Bad Request
Error response object.
{
"errors": [
"Bad Request"
]
}
Authentication error
Error response object.
{
"errors": [
"Bad Request"
]
}
# Curl command
curl -X POST "https://api.datadoghq.eu"https://api.ddog-gov.com"https://api.datadoghq.com"https://api.us3.datadoghq.com/api/v1/integration/webhooks/configuration/webhooks" \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY}" \
-d @- << EOF
{
"name": "WEBHOOK_NAME",
"url": "https://example.com/webhook"
}
EOF
DELETE https://api.datadoghq.eu/api/v1/integration/webhooks/configuration/custom-variables/{custom_variable_name}https://api.ddog-gov.com/api/v1/integration/webhooks/configuration/custom-variables/{custom_variable_name}https://api.datadoghq.com/api/v1/integration/webhooks/configuration/custom-variables/{custom_variable_name}https://api.us3.datadoghq.com/api/v1/integration/webhooks/configuration/custom-variables/{custom_variable_name}
<CUSTOM_VARIABLE_NAME>
という名のエンドポイントを削除します。
名前
種類
説明
custom_variable_name [required]
string
The name of the custom variable.
OK
Authentication error
Error response object.
{
"errors": [
"Bad Request"
]
}
Item Not Found
Error response object.
{
"errors": [
"Bad Request"
]
}
# Path parameters
export custom_variable_name="CHANGE_ME"
# Curl command
curl -X DELETE "https://api.datadoghq.eu"https://api.ddog-gov.com"https://api.datadoghq.com"https://api.us3.datadoghq.com/api/v1/integration/webhooks/configuration/custom-variables/${custom_variable_name}" \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY}"
DELETE https://api.datadoghq.eu/api/v1/integration/webhooks/configuration/webhooks/{webhook_name}https://api.ddog-gov.com/api/v1/integration/webhooks/configuration/webhooks/{webhook_name}https://api.datadoghq.com/api/v1/integration/webhooks/configuration/webhooks/{webhook_name}https://api.us3.datadoghq.com/api/v1/integration/webhooks/configuration/webhooks/{webhook_name}
<WEBHOOK 名>
という名前のエンドポイントを削除します。
名前
種類
説明
webhook_name [required]
string
The name of the webhook.
OK
Authentication error
Error response object.
{
"errors": [
"Bad Request"
]
}
Item Not Found
Error response object.
{
"errors": [
"Bad Request"
]
}
# Path parameters
export webhook_name="CHANGE_ME"
# Curl command
curl -X DELETE "https://api.datadoghq.eu"https://api.ddog-gov.com"https://api.datadoghq.com"https://api.us3.datadoghq.com/api/v1/integration/webhooks/configuration/webhooks/${webhook_name}" \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY}"
GET https://api.datadoghq.eu/api/v1/integration/webhooks/configuration/custom-variables/{custom_variable_name}https://api.ddog-gov.com/api/v1/integration/webhooks/configuration/custom-variables/{custom_variable_name}https://api.datadoghq.com/api/v1/integration/webhooks/configuration/custom-variables/{custom_variable_name}https://api.us3.datadoghq.com/api/v1/integration/webhooks/configuration/custom-variables/{custom_variable_name}
<CUSTOM_VARIABLE_NAME>
という名のカスタム変数の内容を表示します。
カスタム変数がシークレットである場合は、応答ペイロードの<CUSTOM_VARIABLE_VALUE>
で
null
を返します。
名前
種類
説明
custom_variable_name [required]
string
The name of the custom variable.
OK
Custom variable for Webhook integration.
{
"is_secret": true,
"name": "CUSTOM_VARIABLE_NAME",
"value": "CUSTOM_VARIABLE_VALUE"
}
Bad Request
Error response object.
{
"errors": [
"Bad Request"
]
}
Authentication error
Error response object.
{
"errors": [
"Bad Request"
]
}
Item Not Found
Error response object.
{
"errors": [
"Bad Request"
]
}
# Path parameters
export custom_variable_name="CHANGE_ME"
# Curl command
curl -X GET "https://api.datadoghq.eu"https://api.ddog-gov.com"https://api.datadoghq.com"https://api.us3.datadoghq.com/api/v1/integration/webhooks/configuration/custom-variables/${custom_variable_name}" \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY}"
GET https://api.datadoghq.eu/api/v1/integration/webhooks/configuration/webhooks/{webhook_name}https://api.ddog-gov.com/api/v1/integration/webhooks/configuration/webhooks/{webhook_name}https://api.datadoghq.com/api/v1/integration/webhooks/configuration/webhooks/{webhook_name}https://api.us3.datadoghq.com/api/v1/integration/webhooks/configuration/webhooks/{webhook_name}
<WEBHOOK_名>
という名前の Webhook のコンテンツを取得します。
名前
種類
説明
webhook_name [required]
string
The name of the webhook.
OK
Datadog-Webhooks integration.
フィールド
種類
説明
custom_headers
object
If null
, uses no header.
If given a JSON payload, these will be headers attached to your webhook.
<any-key>
string
Additional properties for custom headers.
encode_as
enum
Encoding type. Can be given either json
or form
.
Allowed enum values: json,form
name [required]
string
The name of the webhook. It corresponds with <WEBHOOK_NAME>
.
Learn more on how to use it in
monitor notifications.
payload
object
If null
, uses the default payload.
If given a JSON payload, the webhook returns the payload
specified by the given payload.
Webhooks variable usage.
url [required]
string
URL of the webhook.
{
"custom_headers": {
"<any-key>": "string"
},
"encode_as": "string",
"name": "WEBHOOK_NAME",
"payload": {},
"url": "https://example.com/webhook"
}
Bad Request
Error response object.
{
"errors": [
"Bad Request"
]
}
Authentication error
Error response object.
{
"errors": [
"Bad Request"
]
}
Item Not Found
Error response object.
{
"errors": [
"Bad Request"
]
}
# Path parameters
export webhook_name="CHANGE_ME"
# Curl command
curl -X GET "https://api.datadoghq.eu"https://api.ddog-gov.com"https://api.datadoghq.com"https://api.us3.datadoghq.com/api/v1/integration/webhooks/configuration/webhooks/${webhook_name}" \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY}"
PUT https://api.datadoghq.eu/api/v1/integration/webhooks/configuration/custom-variables/{custom_variable_name}https://api.ddog-gov.com/api/v1/integration/webhooks/configuration/custom-variables/{custom_variable_name}https://api.datadoghq.com/api/v1/integration/webhooks/configuration/custom-variables/{custom_variable_name}https://api.us3.datadoghq.com/api/v1/integration/webhooks/configuration/custom-variables/{custom_variable_name}
<CUSTOM_VARIABLE_NAME>
という名のエンドポイントを更新します。
名前
種類
説明
custom_variable_name [required]
string
The name of the custom variable.
既存カスタム変数のリクエスト本文を更新します。
{
"is_secret": false,
"name": "CUSTOM_VARIABLE_NAME",
"value": "CUSTOM_VARIABLE_VALUE"
}
OK
Custom variable for Webhook integration.
{
"is_secret": true,
"name": "CUSTOM_VARIABLE_NAME",
"value": "CUSTOM_VARIABLE_VALUE"
}
Bad Request
Error response object.
{
"errors": [
"Bad Request"
]
}
Authentication error
Error response object.
{
"errors": [
"Bad Request"
]
}
Item Not Found
Error response object.
{
"errors": [
"Bad Request"
]
}
# Path parameters
export custom_variable_name="CHANGE_ME"
# Curl command
curl -X PUT "https://api.datadoghq.eu"https://api.ddog-gov.com"https://api.datadoghq.com"https://api.us3.datadoghq.com/api/v1/integration/webhooks/configuration/custom-variables/${custom_variable_name}" \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY}" \
-d @- << EOF
{}
EOF
PUT https://api.datadoghq.eu/api/v1/integration/webhooks/configuration/webhooks/{webhook_name}https://api.ddog-gov.com/api/v1/integration/webhooks/configuration/webhooks/{webhook_name}https://api.datadoghq.com/api/v1/integration/webhooks/configuration/webhooks/{webhook_name}https://api.us3.datadoghq.com/api/v1/integration/webhooks/configuration/webhooks/{webhook_name}
<WEBHOOK_NAME>
という名前のエンドポイントを更新します。
名前
種類
説明
webhook_name [required]
string
The name of the webhook.
既存の Datadog-Webhooks インテグレーションを更新します。
フィールド
種類
説明
custom_headers
object
If null
, uses no header.
If given a JSON payload, these will be headers attached to your webhook.
<any-key>
string
Additional properties for custom headers.
encode_as
enum
Encoding type. Can be given either json
or form
.
Allowed enum values: json,form
name
string
The name of the webhook. It corresponds with <WEBHOOK_NAME>
.
Learn more on how to use it in
monitor notifications.
payload
object
If null
, uses the default payload.
If given a JSON payload, the webhook returns the payload
specified by the given payload.
Webhooks variable usage.
url
string
URL of the webhook.
{
"custom_headers": {
"<any-key>": "string"
},
"encode_as": "string",
"name": "WEBHOOK_NAME",
"payload": {},
"url": "https://example.com/webhook"
}
OK
Datadog-Webhooks integration.
フィールド
種類
説明
custom_headers
object
If null
, uses no header.
If given a JSON payload, these will be headers attached to your webhook.
<any-key>
string
Additional properties for custom headers.
encode_as
enum
Encoding type. Can be given either json
or form
.
Allowed enum values: json,form
name [required]
string
The name of the webhook. It corresponds with <WEBHOOK_NAME>
.
Learn more on how to use it in
monitor notifications.
payload
object
If null
, uses the default payload.
If given a JSON payload, the webhook returns the payload
specified by the given payload.
Webhooks variable usage.
url [required]
string
URL of the webhook.
{
"custom_headers": {
"<any-key>": "string"
},
"encode_as": "string",
"name": "WEBHOOK_NAME",
"payload": {},
"url": "https://example.com/webhook"
}
Bad Request
Error response object.
{
"errors": [
"Bad Request"
]
}
Authentication error
Error response object.
{
"errors": [
"Bad Request"
]
}
Item Not Found
Error response object.
{
"errors": [
"Bad Request"
]
}
# Path parameters
export webhook_name="CHANGE_ME"
# Curl command
curl -X PUT "https://api.datadoghq.eu"https://api.ddog-gov.com"https://api.datadoghq.com"https://api.us3.datadoghq.com/api/v1/integration/webhooks/configuration/webhooks/${webhook_name}" \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY}" \
-d @- << EOF
{}
EOF