Select your cookie preferences

We use cookies and similar tools to enhance your experience, provide our services, deliver relevant advertising, and make improvements. Approved third parties also use these tools to help us deliver advertising and provide certain site features.

list_monitors

list_monitors(**kwargs)

Lists all of your monitors for Amazon CloudWatch Internet Monitor and their statuses, along with the Amazon Resource Name (ARN) and name of each monitor.

See also: AWS API Documentation

Request Syntax

response = client.list_monitors(
    NextToken='string',
    MaxResults=123,
    MonitorStatus='string'
)
Parameters
  • NextToken (string) -- The token for the next set of results. You receive this token from a previous call.
  • MaxResults (integer) -- The number of monitor objects that you want to return with this call.
  • MonitorStatus (string) --

    The status of a monitor. This includes the status of the data processing for the monitor and the status of the monitor itself.

    For information about the statuses for a monitor, see Monitor.

Return type

dict

Returns

Response Syntax

{
    'Monitors': [
        {
            'MonitorName': 'string',
            'MonitorArn': 'string',
            'Status': 'PENDING'|'ACTIVE'|'INACTIVE'|'ERROR',
            'ProcessingStatus': 'OK'|'INACTIVE'|'COLLECTING_DATA'|'INSUFFICIENT_DATA'|'FAULT_SERVICE'|'FAULT_ACCESS_CLOUDWATCH'
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • Monitors (list) --

      A list of monitors.

      • (dict) --

        The description of and information about a monitor in Amazon CloudWatch Internet Monitor.

        • MonitorName (string) --

          The name of the monitor.

        • MonitorArn (string) --

          The Amazon Resource Name (ARN) of the monitor.

        • Status (string) --

          The status of a monitor.

        • ProcessingStatus (string) --

          The health of data processing for the monitor.

    • NextToken (string) --

      The token for the next set of results. You receive this token from a previous call.

Exceptions

  • CloudWatchInternetMonitor.Client.exceptions.InternalServerException
  • CloudWatchInternetMonitor.Client.exceptions.AccessDeniedException
  • CloudWatchInternetMonitor.Client.exceptions.ThrottlingException
  • CloudWatchInternetMonitor.Client.exceptions.ValidationException