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.

get_network_telemetry

get_network_telemetry(**kwargs)

Gets the network telemetry of the specified global network.

See also: AWS API Documentation

Request Syntax

response = client.get_network_telemetry(
    GlobalNetworkId='string',
    CoreNetworkId='string',
    RegisteredGatewayArn='string',
    AwsRegion='string',
    AccountId='string',
    ResourceType='string',
    ResourceArn='string',
    MaxResults=123,
    NextToken='string'
)
Parameters
  • GlobalNetworkId (string) --

    [REQUIRED]

    The ID of the global network.

  • CoreNetworkId (string) -- The ID of a core network.
  • RegisteredGatewayArn (string) -- The ARN of the gateway.
  • AwsRegion (string) -- The Amazon Web Services Region.
  • AccountId (string) -- The Amazon Web Services account ID.
  • ResourceType (string) --

    The resource type.

    The following are the supported resource types for Direct Connect:

    • dxcon
    • dx-gateway
    • dx-vif

    The following are the supported resource types for Network Manager:

    • connection
    • device
    • link
    • site

    The following are the supported resource types for Amazon VPC:

    • customer-gateway
    • transit-gateway
    • transit-gateway-attachment
    • transit-gateway-connect-peer
    • transit-gateway-route-table
    • vpn-connection
  • ResourceArn (string) -- The ARN of the resource.
  • MaxResults (integer) -- The maximum number of results to return.
  • NextToken (string) -- The token for the next page of results.
Return type

dict

Returns

Response Syntax

{
    'NetworkTelemetry': [
        {
            'RegisteredGatewayArn': 'string',
            'CoreNetworkId': 'string',
            'AwsRegion': 'string',
            'AccountId': 'string',
            'ResourceType': 'string',
            'ResourceId': 'string',
            'ResourceArn': 'string',
            'Address': 'string',
            'Health': {
                'Type': 'BGP'|'IPSEC',
                'Status': 'UP'|'DOWN',
                'Timestamp': datetime(2015, 1, 1)
            }
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • NetworkTelemetry (list) --

      The network telemetry.

      • (dict) --

        Describes the telemetry information for a resource.

        • RegisteredGatewayArn (string) --

          The ARN of the gateway.

        • CoreNetworkId (string) --

          The ID of a core network.

        • AwsRegion (string) --

          The Amazon Web Services Region.

        • AccountId (string) --

          The Amazon Web Services account ID.

        • ResourceType (string) --

          The resource type.

        • ResourceId (string) --

          The ID of the resource.

        • ResourceArn (string) --

          The ARN of the resource.

        • Address (string) --

          The address.

        • Health (dict) --

          The connection health.

          • Type (string) --

            The connection type.

          • Status (string) --

            The connection status.

          • Timestamp (datetime) --

            The time the status was last updated.

    • NextToken (string) --

      The token for the next page of results.

Exceptions

  • NetworkManager.Client.exceptions.ValidationException
  • NetworkManager.Client.exceptions.AccessDeniedException
  • NetworkManager.Client.exceptions.ResourceNotFoundException
  • NetworkManager.Client.exceptions.ThrottlingException
  • NetworkManager.Client.exceptions.InternalServerException