MediaLive / Client / list_cluster_alerts

list_cluster_alerts

MediaLive.Client.list_cluster_alerts(**kwargs)

List the alerts for a cluster with optional filtering based on alert state.

See also: AWS API Documentation

Request Syntax

response = client.list_cluster_alerts(
    ClusterId='string',
    MaxResults=123,
    NextToken='string',
    StateFilter='string'
)
Parameters:

  • ClusterId (string) – [REQUIRED] The unique ID of the cluster

  • MaxResults (integer) – The maximum number of items to return

  • NextToken (string) – The next pagination token

  • StateFilter (string) – Specifies the set of alerts to return based on their state. SET - Return only alerts with SET state. CLEARED - Return only alerts with CLEARED state. ALL - Return all alerts.

Return type:

dict

Returns:

Response Syntax

{
    'Alerts': [
        {
            'AlertType': 'string',
            'ChannelId': 'string',
            'ClearedTimestamp': datetime(2015, 1, 1),
            'Id': 'string',
            'Message': 'string',
            'NodeId': 'string',
            'SetTimestamp': datetime(2015, 1, 1),
            'State': 'SET'|'CLEARED'
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) – List of alerts

    • Alerts (list) – The alerts found for this cluster

      • (dict) – An alert on a cluster

        • AlertType (string) – The type of the alert

        • ChannelId (string) – The ID of the channel this alert is associated with

        • ClearedTimestamp (datetime) – The time when the alert was cleared

        • Id (string) – The further subtype of this alert

        • Message (string) – The user facing alert message which can have more context

        • NodeId (string) – The ID of the node this alert is associated with

        • SetTimestamp (datetime) – The time when the alert was set

        • State (string) – The state of the alert

    • NextToken (string) – The token to use to retrieve the next page of results

Exceptions

  • MediaLive.Client.exceptions.BadRequestException

  • MediaLive.Client.exceptions.InternalServerErrorException

  • MediaLive.Client.exceptions.ForbiddenException

  • MediaLive.Client.exceptions.BadGatewayException

  • MediaLive.Client.exceptions.NotFoundException

  • MediaLive.Client.exceptions.GatewayTimeoutException

  • MediaLive.Client.exceptions.TooManyRequestsException