DescribeAttackStatistics - AWS Shield Advanced

DescribeAttackStatistics

Provides information about the number and type of attacks AWS Shield has detected in the last year for all resources that belong to your account, regardless of whether you've defined Shield protections for them. This operation is available to Shield customers as well as to Shield Advanced customers.

The operation returns data for the time range of midnight UTC, one year ago, to midnight UTC, today. For example, if the current time is 2020-10-26 15:39:32 PDT, equal to 2020-10-26 22:39:32 UTC, then the time range for the attack data returned is from 2019-10-26 00:00:00 UTC to 2020-10-26 00:00:00 UTC.

The time range indicates the period covered by the attack statistics data items.

Response Syntax

{ "DataItems": [ { "AttackCount": number, "AttackVolume": { "BitsPerSecond": { "Max": number }, "PacketsPerSecond": { "Max": number }, "RequestsPerSecond": { "Max": number } } } ], "TimeRange": { "FromInclusive": number, "ToExclusive": number } }

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

DataItems

The data that describes the attacks detected during the time period.

Type: Array of AttackStatisticsDataItem objects

TimeRange

The time range of the attack.

Type: TimeRange object

Errors

For information about the errors that are common to all actions, see Common Errors.

InternalErrorException

Exception that indicates that a problem occurred with the service infrastructure. You can retry the request.

HTTP Status Code: 500

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: