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: