POST checks/tags?mode={mode}
Associates checks with tag values.
URL Parameters
Name | Description |
---|---|
mode | (Optional) Determines how to combine existing tag value associations with the new ones. Accepted values are "merge" and "replace". If the mode is "replace" then all existing check - tag value associations will be replaced by the ones sent in the request. If the mode is "merge" then new check - tag value associations will be added to the existing ones. If the mode parameter is not specified then the "merge" mode will be used. |
Request example and description
curl --request POST "https://api-asm1.apica.io/v3/checks/tags?mode=merge&auth_ticket=C471ADC4-19B4-4219-BBF4-671A97EC653E" --header "Content-Type: application/json" --data-raw "{ \"check_ids\": [ 12345, 6789, 34524 ], \"tags\": { \"Environment\": [ \"Prod\", \"Dev\" ], \"Region\": [ \"USA\", \"SWE\" ] } }"
Response body model example and description
{ "deleted_associations": [ { "check_id": 12345, "tag_key": "Environment", "tag_value": "Prod" }, { "check_id": 12345, "tag_key": "Region", "tag_value": "Prod" }, { "check_id": 6789, "tag_key": "Region", "tag_value": "Prod" } ], "added_associations": [ { "check_id": 6789, "tag_key": "Region", "tag_value": "Prod" }, { "check_id": 6789, "tag_key": "Region", "tag_value": "Prod" }, { "check_id": 12345, "tag_key": "Region", "tag_value": "Prod" } ] }
Name | Type | Description |
---|---|---|
deleted_associations | Array |
The list of deleted check - tag value associations. |
check_id | Integer |
The numeric identifier of the check. |
tag_key | String |
Tag key. |
tag_value | String |
Tag value. |
added_associations | Array |
The list of added check - tag value associations. |
check_id | Integer |
The numeric identifier of the check. |
tag_key | String |
Tag key. |
tag_value | String |
Tag value. |