Shield / Paginator / ListAttacks

ListAttacks

class Shield.Paginator.ListAttacks

paginator = client.get_paginator('list_attacks')

paginate(**kwargs)

Creates an iterator that will paginate through responses from Shield.Client.list_attacks().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    ResourceArns=[
        'string',
    ],
    StartTime={
        'FromInclusive': datetime(2015, 1, 1),
        'ToExclusive': datetime(2015, 1, 1)
    },
    EndTime={
        'FromInclusive': datetime(2015, 1, 1),
        'ToExclusive': datetime(2015, 1, 1)
    },
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)

Parameters:

• ResourceArns (list) –

  The ARNs (Amazon Resource Names) of the resources that were attacked. If you leave this blank, all applicable resources for this account will be included.

  • (string) –

• StartTime (dict) –

  The start of the time period for the attacks. This is a timestamp type. The request syntax listing for this call indicates a number type, but you can provide the time in any valid timestamp format setting.

  • FromInclusive (datetime) –

    The start time, in Unix time in seconds.

  • ToExclusive (datetime) –

    The end time, in Unix time in seconds.

• EndTime (dict) –

  The end of the time period for the attacks. This is a timestamp type. The request syntax listing for this call indicates a number type, but you can provide the time in any valid timestamp format setting.

  • FromInclusive (datetime) –

    The start time, in Unix time in seconds.

  • ToExclusive (datetime) –

    The end time, in Unix time in seconds.

• PaginationConfig (dict) –

  A dictionary that provides parameters to control pagination.

  • MaxItems (integer) –

    The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.

  • PageSize (integer) –

    The size of each page.

  • StartingToken (string) –

    A token to specify where to start paginating. This is the NextToken from a previous response.

Return type:

dict

Returns:

Response Syntax

{
    'AttackSummaries': [
        {
            'AttackId': 'string',
            'ResourceArn': 'string',
            'StartTime': datetime(2015, 1, 1),
            'EndTime': datetime(2015, 1, 1),
            'AttackVectors': [
                {
                    'VectorType': 'string'
                },
            ]
        },
    ],

}

Response Structure

• (dict) –

  • AttackSummaries (list) –

    The attack information for the specified time range.

    • (dict) –

      Summarizes all DDoS attacks for a specified time period.

      • AttackId (string) –

        The unique identifier (ID) of the attack.

      • ResourceArn (string) –

        The ARN (Amazon Resource Name) of the resource that was attacked.

      • StartTime (datetime) –

        The start time of the attack, in Unix time in seconds.

      • EndTime (datetime) –

        The end time of the attack, in Unix time in seconds.

      • AttackVectors (list) –

        The list of attacks for a specified time period.

        • (dict) –

          Describes the attack.

          • VectorType (string) –

            The attack type. Valid values:

            • UDP_TRAFFIC

            • UDP_FRAGMENT

            • GENERIC_UDP_REFLECTION

            • DNS_REFLECTION

            • NTP_REFLECTION

            • CHARGEN_REFLECTION

            • SSDP_REFLECTION

            • PORT_MAPPER

            • RIP_REFLECTION

            • SNMP_REFLECTION

            • MSSQL_REFLECTION

            • NET_BIOS_REFLECTION

            • SYN_FLOOD

            • ACK_FLOOD

            • REQUEST_FLOOD

            • HTTP_REFLECTION

            • UDS_REFLECTION

            • MEMCACHED_REFLECTION