View a markdown version of this page

DeleteAlert - Amazon CloudWatch Omni

DeleteAlert

Deletes an alert by its identifier.

Idempotent: deleting an alert that has already been removed succeeds without error.

Request Parameters

alertId

The alert to delete.

Type: String

Length Constraints: Fixed length of 32.

Pattern: [0-9a-f]{32}

Required: Yes

spaceId

The unique ID of the space.

Type: String

Pattern: [0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}

Required: Yes

Errors

For information about the errors that are common to all actions, see Common Error Types.

AccessDeniedException

The caller is not authorized to perform this action.

HTTP Status Code: 403

InternalServerException

An unexpected error occurred while processing the request.

errorCode

The error code associated with the internal error.

HTTP Status Code: 500

ThrottlingException

The request was throttled due to exceeding the allowed request rate.

retryAfterSeconds

The number of seconds to wait before retrying the request. Not always present.

HTTP Status Code: 429

ValidationException

A parameter is specified incorrectly.

errorCode

The error code associated with the validation failure.

HTTP Status Code: 400

Examples

Delete an alert

The following example removes an alert from a space. Deleting an alert that has already been removed succeeds without error. Payloads are shown as JSON; on the wire they are CBOR-encoded.

Sample Request

{ "alertId": "c3d4e5f67a8b4c9d8e0f1a2b3c4d5e6f", "spaceId": "a1b2c3d4-5e6f-4a3b-8c9d-0e1f2a3b4c5d" }

Sample Response

{}

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: