NetworkFlowMonitor / Client / get_monitor

get_monitor#

NetworkFlowMonitor.Client.get_monitor(**kwargs)#

Gets information about a monitor in Network Flow Monitor based on a monitor name. The information returned includes the Amazon Resource Name (ARN), create time, modified time, resources included in the monitor, and status information.

See also: AWS API Documentation

Request Syntax

response = client.get_monitor(
    monitorName='string'
)
Parameters:

monitorName (string) –

[REQUIRED]

The name of the monitor.

Return type:

dict

Returns:

Response Syntax

{
    'monitorArn': 'string',
    'monitorName': 'string',
    'monitorStatus': 'PENDING'|'ACTIVE'|'INACTIVE'|'ERROR'|'DELETING',
    'localResources': [
        {
            'type': 'AWS::EC2::VPC'|'AWS::AvailabilityZone'|'AWS::EC2::Subnet',
            'identifier': 'string'
        },
    ],
    'remoteResources': [
        {
            'type': 'AWS::EC2::VPC'|'AWS::AvailabilityZone'|'AWS::EC2::Subnet'|'AWS::AWSService',
            'identifier': 'string'
        },
    ],
    'createdAt': datetime(2015, 1, 1),
    'modifiedAt': datetime(2015, 1, 1),
    'tags': {
        'string': 'string'
    }
}

Response Structure

  • (dict) –

    • monitorArn (string) –

      The Amazon Resource Name (ARN) of the monitor.

    • monitorName (string) –

      The name of the monitor.

    • monitorStatus (string) –

      The status of a monitor. The status can be one of the following

      • PENDING: The monitor is in the process of being created.

      • ACTIVE: The monitor is active.

      • INACTIVE: The monitor is inactive.

      • ERROR: Monitor creation failed due to an error.

      • DELETING: The monitor is in the process of being deleted.

    • localResources (list) –

      The local resources for this monitor.

      • (dict) –

        A local resource is the host where the agent is installed. Local resources can be a a subnet, a VPC, or an Availability Zone.

        • type (string) –

          The type of the local resource. Valid values are AWS::EC2::VPC AWS::AvailabilityZone or AWS::EC2::Subnet.

        • identifier (string) –

          The identifier of the local resource, such as an ARN.

    • remoteResources (list) –

      The remote resources for this monitor.

      • (dict) –

        A remote resource is the other endpoint in a network flow. That is, one endpoint is the local resource and the other is the remote resource. Remote resources can be a a subnet, a VPC, an Availability Zone, or an Amazon Web Services service.

        • type (string) –

          The type of the remote resource. Valid values are AWS::EC2::VPC AWS::AvailabilityZone, AWS::EC2::Subnet, or AWS::AWSService.

        • identifier (string) –

          The identifier of the remote resource, such as an ARN.

    • createdAt (datetime) –

      The date and time when the monitor was created.

    • modifiedAt (datetime) –

      The date and time when the monitor was last modified.

    • tags (dict) –

      The tags for a monitor.

      • (string) –

        • (string) –

Exceptions