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