@aws-sdk/client-shield 3.43.0 → 3.47.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (51) hide show
  1. package/CHANGELOG.md +50 -0
  2. package/dist-cjs/Shield.js +45 -0
  3. package/dist-cjs/commands/DisableApplicationLayerAutomaticResponseCommand.js +36 -0
  4. package/dist-cjs/commands/EnableApplicationLayerAutomaticResponseCommand.js +36 -0
  5. package/dist-cjs/commands/UpdateApplicationLayerAutomaticResponseCommand.js +36 -0
  6. package/dist-cjs/commands/index.js +3 -0
  7. package/dist-cjs/endpoints.js +1 -0
  8. package/dist-cjs/models/models_0.js +64 -77
  9. package/dist-cjs/protocols/Aws_json1_1.js +363 -2
  10. package/dist-cjs/runtimeConfig.browser.js +7 -2
  11. package/dist-cjs/runtimeConfig.js +9 -3
  12. package/dist-es/Shield.js +45 -0
  13. package/dist-es/commands/DisableApplicationLayerAutomaticResponseCommand.js +39 -0
  14. package/dist-es/commands/EnableApplicationLayerAutomaticResponseCommand.js +39 -0
  15. package/dist-es/commands/UpdateApplicationLayerAutomaticResponseCommand.js +39 -0
  16. package/dist-es/commands/index.js +3 -0
  17. package/dist-es/endpoints.js +1 -0
  18. package/dist-es/models/models_0.js +45 -52
  19. package/dist-es/protocols/Aws_json1_1.js +430 -50
  20. package/dist-es/runtimeConfig.browser.js +12 -3
  21. package/dist-es/runtimeConfig.js +13 -6
  22. package/dist-types/Shield.d.ts +50 -12
  23. package/dist-types/ShieldClient.d.ts +10 -3
  24. package/dist-types/commands/AssociateDRTLogBucketCommand.d.ts +1 -1
  25. package/dist-types/commands/AssociateDRTRoleCommand.d.ts +4 -3
  26. package/dist-types/commands/AssociateHealthCheckCommand.d.ts +2 -2
  27. package/dist-types/commands/CreateProtectionCommand.d.ts +6 -2
  28. package/dist-types/commands/DisableApplicationLayerAutomaticResponseCommand.d.ts +36 -0
  29. package/dist-types/commands/DisassociateDRTLogBucketCommand.d.ts +0 -1
  30. package/dist-types/commands/DisassociateDRTRoleCommand.d.ts +0 -1
  31. package/dist-types/commands/DisassociateHealthCheckCommand.d.ts +2 -2
  32. package/dist-types/commands/EnableApplicationLayerAutomaticResponseCommand.d.ts +48 -0
  33. package/dist-types/commands/UpdateApplicationLayerAutomaticResponseCommand.d.ts +35 -0
  34. package/dist-types/commands/index.d.ts +3 -0
  35. package/dist-types/models/models_0.d.ts +250 -128
  36. package/dist-types/protocols/Aws_json1_1.d.ts +9 -0
  37. package/dist-types/runtimeConfig.browser.d.ts +3 -2
  38. package/dist-types/runtimeConfig.d.ts +4 -3
  39. package/dist-types/runtimeConfig.native.d.ts +1 -0
  40. package/dist-types/ts3.4/Shield.d.ts +15 -0
  41. package/dist-types/ts3.4/ShieldClient.d.ts +8 -3
  42. package/dist-types/ts3.4/commands/DisableApplicationLayerAutomaticResponseCommand.d.ts +17 -0
  43. package/dist-types/ts3.4/commands/EnableApplicationLayerAutomaticResponseCommand.d.ts +17 -0
  44. package/dist-types/ts3.4/commands/UpdateApplicationLayerAutomaticResponseCommand.d.ts +17 -0
  45. package/dist-types/ts3.4/commands/index.d.ts +3 -0
  46. package/dist-types/ts3.4/models/models_0.d.ts +92 -56
  47. package/dist-types/ts3.4/protocols/Aws_json1_1.d.ts +9 -0
  48. package/dist-types/ts3.4/runtimeConfig.browser.d.ts +3 -2
  49. package/dist-types/ts3.4/runtimeConfig.d.ts +4 -3
  50. package/dist-types/ts3.4/runtimeConfig.native.d.ts +1 -0
  51. package/package.json +38 -45
@@ -7,12 +7,6 @@ export interface AccessDeniedException extends __SmithyException, $MetadataBeare
7
7
  $fault: "client";
8
8
  message?: string;
9
9
  }
10
- export declare namespace AccessDeniedException {
11
- /**
12
- * @internal
13
- */
14
- const filterSensitiveLog: (obj: AccessDeniedException) => any;
15
- }
16
10
  /**
17
11
  * <p>In order to grant the necessary access to the Shield Response Team (SRT) the user submitting the request must have the <code>iam:PassRole</code> permission. This error indicates the user did not have the appropriate permissions. For more information, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_passrole.html">Granting a User Permissions to Pass a Role to an Amazon Web Services Service</a>. </p>
18
12
  */
@@ -21,11 +15,83 @@ export interface AccessDeniedForDependencyException extends __SmithyException, $
21
15
  $fault: "client";
22
16
  message?: string;
23
17
  }
24
- export declare namespace AccessDeniedForDependencyException {
18
+ /**
19
+ * <p>Specifies that Shield Advanced should configure its WAF rules with the WAF <code>Block</code> action. </p>
20
+ * <p>This is only used in the context of the <code>ResponseAction</code> setting. </p>
21
+ * <p>JSON specification: <code>"Block": {}</code>
22
+ * </p>
23
+ */
24
+ export interface BlockAction {
25
+ }
26
+ export declare namespace BlockAction {
27
+ /**
28
+ * @internal
29
+ */
30
+ const filterSensitiveLog: (obj: BlockAction) => any;
31
+ }
32
+ /**
33
+ * <p>Specifies that Shield Advanced should configure its WAF rules with the WAF <code>Count</code> action. </p>
34
+ * <p>This is only used in the context of the <code>ResponseAction</code> setting. </p>
35
+ * <p>JSON specification: <code>"Count": {}</code>
36
+ * </p>
37
+ */
38
+ export interface CountAction {
39
+ }
40
+ export declare namespace CountAction {
41
+ /**
42
+ * @internal
43
+ */
44
+ const filterSensitiveLog: (obj: CountAction) => any;
45
+ }
46
+ /**
47
+ * <p>Specifies the action setting that Shield Advanced should use in the WAF rules that it creates on behalf of the
48
+ * protected resource in response to DDoS attacks. You specify this as part of the configuration for the automatic application layer DDoS mitigation feature,
49
+ * when you enable or update automatic mitigation. Shield Advanced creates the WAF rules in a Shield Advanced-managed rule group, inside the web ACL that you have associated with the resource. </p>
50
+ */
51
+ export interface ResponseAction {
52
+ /**
53
+ * <p>Specifies that Shield Advanced should configure its WAF rules with the WAF <code>Block</code> action. </p>
54
+ * <p>You must specify exactly one action, either <code>Block</code> or <code>Count</code>.</p>
55
+ */
56
+ Block?: BlockAction;
57
+ /**
58
+ * <p>Specifies that Shield Advanced should configure its WAF rules with the WAF <code>Count</code> action. </p>
59
+ * <p>You must specify exactly one action, either <code>Block</code> or <code>Count</code>.</p>
60
+ */
61
+ Count?: CountAction;
62
+ }
63
+ export declare namespace ResponseAction {
64
+ /**
65
+ * @internal
66
+ */
67
+ const filterSensitiveLog: (obj: ResponseAction) => any;
68
+ }
69
+ export declare enum ApplicationLayerAutomaticResponseStatus {
70
+ DISABLED = "DISABLED",
71
+ ENABLED = "ENABLED"
72
+ }
73
+ /**
74
+ * <p>The automatic application layer DDoS mitigation settings for a <a>Protection</a>.
75
+ * This configuration determines whether Shield Advanced automatically
76
+ * manages rules in the web ACL in order to respond to application layer events that Shield Advanced determines to be DDoS attacks. </p>
77
+ */
78
+ export interface ApplicationLayerAutomaticResponseConfiguration {
79
+ /**
80
+ * <p>Indicates whether automatic application layer DDoS mitigation is enabled for the protection. </p>
81
+ */
82
+ Status: ApplicationLayerAutomaticResponseStatus | string | undefined;
83
+ /**
84
+ * <p>Specifies the action setting that Shield Advanced should use in the WAF rules that it creates on behalf of the
85
+ * protected resource in response to DDoS attacks. You specify this as part of the configuration for the automatic application layer DDoS mitigation feature,
86
+ * when you enable or update automatic mitigation. Shield Advanced creates the WAF rules in a Shield Advanced-managed rule group, inside the web ACL that you have associated with the resource. </p>
87
+ */
88
+ Action: ResponseAction | undefined;
89
+ }
90
+ export declare namespace ApplicationLayerAutomaticResponseConfiguration {
25
91
  /**
26
92
  * @internal
27
93
  */
28
- const filterSensitiveLog: (obj: AccessDeniedForDependencyException) => any;
94
+ const filterSensitiveLog: (obj: ApplicationLayerAutomaticResponseConfiguration) => any;
29
95
  }
30
96
  export interface AssociateDRTLogBucketRequest {
31
97
  /**
@@ -48,20 +114,13 @@ export declare namespace AssociateDRTLogBucketResponse {
48
114
  const filterSensitiveLog: (obj: AssociateDRTLogBucketResponse) => any;
49
115
  }
50
116
  /**
51
- * <p>Exception that indicates that a problem occurred with the service infrastructure. You
52
- * can retry the request.</p>
117
+ * <p>Exception that indicates that a problem occurred with the service infrastructure. You can retry the request.</p>
53
118
  */
54
119
  export interface InternalErrorException extends __SmithyException, $MetadataBearer {
55
120
  name: "InternalErrorException";
56
121
  $fault: "server";
57
122
  message?: string;
58
123
  }
59
- export declare namespace InternalErrorException {
60
- /**
61
- * @internal
62
- */
63
- const filterSensitiveLog: (obj: InternalErrorException) => any;
64
- }
65
124
  /**
66
125
  * <p>Exception that indicates that the operation would not cause any change to occur.</p>
67
126
  */
@@ -70,12 +129,6 @@ export interface InvalidOperationException extends __SmithyException, $MetadataB
70
129
  $fault: "client";
71
130
  message?: string;
72
131
  }
73
- export declare namespace InvalidOperationException {
74
- /**
75
- * @internal
76
- */
77
- const filterSensitiveLog: (obj: InvalidOperationException) => any;
78
- }
79
132
  /**
80
133
  * <p>Provides information about a particular parameter passed inside a request that resulted in an exception.</p>
81
134
  */
@@ -115,12 +168,6 @@ export interface InvalidParameterException extends __SmithyException, $MetadataB
115
168
  */
116
169
  fields?: ValidationExceptionField[];
117
170
  }
118
- export declare namespace InvalidParameterException {
119
- /**
120
- * @internal
121
- */
122
- const filterSensitiveLog: (obj: InvalidParameterException) => any;
123
- }
124
171
  /**
125
172
  * <p>Exception that indicates that the operation would exceed a limit.</p>
126
173
  */
@@ -137,12 +184,6 @@ export interface LimitsExceededException extends __SmithyException, $MetadataBea
137
184
  */
138
185
  Limit?: number;
139
186
  }
140
- export declare namespace LimitsExceededException {
141
- /**
142
- * @internal
143
- */
144
- const filterSensitiveLog: (obj: LimitsExceededException) => any;
145
- }
146
187
  /**
147
188
  * <p>The ARN of the role that you specifed does not exist.</p>
148
189
  */
@@ -151,12 +192,6 @@ export interface NoAssociatedRoleException extends __SmithyException, $MetadataB
151
192
  $fault: "client";
152
193
  message?: string;
153
194
  }
154
- export declare namespace NoAssociatedRoleException {
155
- /**
156
- * @internal
157
- */
158
- const filterSensitiveLog: (obj: NoAssociatedRoleException) => any;
159
- }
160
195
  /**
161
196
  * <p>Exception that indicates that the resource state has been modified by another
162
197
  * client. Retrieve the resource and then retry your request.</p>
@@ -166,12 +201,6 @@ export interface OptimisticLockException extends __SmithyException, $MetadataBea
166
201
  $fault: "client";
167
202
  message?: string;
168
203
  }
169
- export declare namespace OptimisticLockException {
170
- /**
171
- * @internal
172
- */
173
- const filterSensitiveLog: (obj: OptimisticLockException) => any;
174
- }
175
204
  /**
176
205
  * <p>Exception indicating the specified resource does not exist. If available, this exception includes details in additional properties. </p>
177
206
  */
@@ -184,12 +213,6 @@ export interface ResourceNotFoundException extends __SmithyException, $MetadataB
184
213
  */
185
214
  resourceType?: string;
186
215
  }
187
- export declare namespace ResourceNotFoundException {
188
- /**
189
- * @internal
190
- */
191
- const filterSensitiveLog: (obj: ResourceNotFoundException) => any;
192
- }
193
216
  export interface AssociateDRTRoleRequest {
194
217
  /**
195
218
  * <p>The Amazon Resource Name (ARN) of the role the SRT will use to access your Amazon Web Services account.</p>
@@ -235,6 +258,14 @@ export declare namespace AssociateHealthCheckResponse {
235
258
  */
236
259
  const filterSensitiveLog: (obj: AssociateHealthCheckResponse) => any;
237
260
  }
261
+ /**
262
+ * <p>Exception that indicates that the resource is invalid. You might not have access to the resource, or the resource might not exist.</p>
263
+ */
264
+ export interface InvalidResourceException extends __SmithyException, $MetadataBearer {
265
+ name: "InvalidResourceException";
266
+ $fault: "client";
267
+ message?: string;
268
+ }
238
269
  /**
239
270
  * <p>Contact information that the SRT can use to contact you if you have proactive engagement enabled, for escalations to the SRT and to initiate proactive customer support.</p>
240
271
  */
@@ -332,11 +363,11 @@ export declare enum AttackPropertyIdentifier {
332
363
  WORDPRESS_PINGBACK_SOURCE = "WORDPRESS_PINGBACK_SOURCE"
333
364
  }
334
365
  /**
335
- * <p>A contributor to the attack and their contribution.</p>
366
+ * <p>A contributor to the attack and their contribution. </p>
336
367
  */
337
368
  export interface Contributor {
338
369
  /**
339
- * <p>The name of the contributor. This is dependent on the <code>AttackPropertyIdentifier</code>. For example, if the <code>AttackPropertyIdentifier</code> is <code>SOURCE_COUNTRY</code>, the <code>Name</code> could be <code>United States</code>.</p>
370
+ * <p>The name of the contributor. The type of name that you'll find here depends on the <code>AttackPropertyIdentifier</code> setting in the <code>AttackProperty</code> where this contributor is defined. For example, if the <code>AttackPropertyIdentifier</code> is <code>SOURCE_COUNTRY</code>, the <code>Name</code> could be <code>United States</code>.</p>
340
371
  */
341
372
  Name?: string;
342
373
  /**
@@ -364,7 +395,7 @@ export interface AttackProperty {
364
395
  * <p>The type of Shield event that was observed. <code>NETWORK</code> indicates layer 3 and layer 4 events and <code>APPLICATION</code>
365
396
  * indicates layer 7 events.</p>
366
397
  * <p>For infrastructure
367
- * layer events (L3 and L4 events) after January 25, 2021, you can view metrics for top contributors in Amazon CloudWatch metrics.
398
+ * layer events (L3 and L4 events), you can view metrics for top contributors in Amazon CloudWatch metrics.
368
399
  * For more information, see <a href="https://docs.aws.amazon.com/waf/latest/developerguide/monitoring-cloudwatch.html#set-ddos-alarms">Shield metrics and alarms</a>
369
400
  * in the <i>WAF Developer Guide</i>. </p>
370
401
  */
@@ -376,7 +407,7 @@ export interface AttackProperty {
376
407
  */
377
408
  AttackPropertyIdentifier?: AttackPropertyIdentifier | string;
378
409
  /**
379
- * <p>Contributor objects for the top five contributors to a Shield event. </p>
410
+ * <p>Contributor objects for the top five contributors to a Shield event. A contributor is a source of traffic that Shield Advanced identifies as responsible for some or all of an event.</p>
380
411
  */
381
412
  TopContributors?: Contributor[];
382
413
  /**
@@ -477,11 +508,11 @@ export interface AttackDetail {
477
508
  */
478
509
  SubResources?: SubResourceSummary[];
479
510
  /**
480
- * <p>The time the attack started, in Unix time in seconds. For more information see <a href="http://docs.aws.amazon.com/cli/latest/userguide/cli-using-param.html#parameter-types">timestamp</a>.</p>
511
+ * <p>The time the attack started, in Unix time in seconds. </p>
481
512
  */
482
513
  StartTime?: Date;
483
514
  /**
484
- * <p>The time the attack ended, in Unix time in seconds. For more information see <a href="http://docs.aws.amazon.com/cli/latest/userguide/cli-using-param.html#parameter-types">timestamp</a>.</p>
515
+ * <p>The time the attack ended, in Unix time in seconds. </p>
485
516
  */
486
517
  EndTime?: Date;
487
518
  /**
@@ -491,7 +522,7 @@ export interface AttackDetail {
491
522
  /**
492
523
  * <p>The array of objects that provide details of the Shield event. </p>
493
524
  * <p>For infrastructure
494
- * layer events (L3 and L4 events) after January 25, 2021, you can view metrics for top contributors in Amazon CloudWatch metrics.
525
+ * layer events (L3 and L4 events), you can view metrics for top contributors in Amazon CloudWatch metrics.
495
526
  * For more information, see <a href="https://docs.aws.amazon.com/waf/latest/developerguide/monitoring-cloudwatch.html#set-ddos-alarms">Shield metrics and alarms</a>
496
527
  * in the <i>WAF Developer Guide</i>. </p>
497
528
  */
@@ -648,11 +679,11 @@ export interface AttackSummary {
648
679
  */
649
680
  ResourceArn?: string;
650
681
  /**
651
- * <p>The start time of the attack, in Unix time in seconds. For more information see <a href="http://docs.aws.amazon.com/cli/latest/userguide/cli-using-param.html#parameter-types">timestamp</a>.</p>
682
+ * <p>The start time of the attack, in Unix time in seconds. </p>
652
683
  */
653
684
  StartTime?: Date;
654
685
  /**
655
- * <p>The end time of the attack, in Unix time in seconds. For more information see <a href="http://docs.aws.amazon.com/cli/latest/userguide/cli-using-param.html#parameter-types">timestamp</a>.</p>
686
+ * <p>The end time of the attack, in Unix time in seconds. </p>
656
687
  */
657
688
  EndTime?: Date;
658
689
  /**
@@ -719,7 +750,7 @@ export interface CreateProtectionRequest {
719
750
  * </p>
720
751
  * </li>
721
752
  * <li>
722
- * <p>For Amazon Route 53: <code>arn:aws:route53:::hostedzone/<i>hosted-zone-id</i>
753
+ * <p>For Amazon Route 53: <code>arn:aws:route53:::hostedzone/<i>hosted-zone-id</i>
723
754
  * </code>
724
755
  * </p>
725
756
  * </li>
@@ -754,20 +785,6 @@ export declare namespace CreateProtectionResponse {
754
785
  */
755
786
  const filterSensitiveLog: (obj: CreateProtectionResponse) => any;
756
787
  }
757
- /**
758
- * <p>Exception that indicates that the resource is invalid. You might not have access to the resource, or the resource might not exist.</p>
759
- */
760
- export interface InvalidResourceException extends __SmithyException, $MetadataBearer {
761
- name: "InvalidResourceException";
762
- $fault: "client";
763
- message?: string;
764
- }
765
- export declare namespace InvalidResourceException {
766
- /**
767
- * @internal
768
- */
769
- const filterSensitiveLog: (obj: InvalidResourceException) => any;
770
- }
771
788
  /**
772
789
  * <p>Exception indicating the specified resource already exists. If available, this exception includes details in additional properties. </p>
773
790
  */
@@ -780,12 +797,6 @@ export interface ResourceAlreadyExistsException extends __SmithyException, $Meta
780
797
  */
781
798
  resourceType?: string;
782
799
  }
783
- export declare namespace ResourceAlreadyExistsException {
784
- /**
785
- * @internal
786
- */
787
- const filterSensitiveLog: (obj: ResourceAlreadyExistsException) => any;
788
- }
789
800
  export declare enum ProtectionGroupAggregation {
790
801
  MAX = "MAX",
791
802
  MEAN = "MEAN",
@@ -937,15 +948,9 @@ export interface LockedSubscriptionException extends __SmithyException, $Metadat
937
948
  $fault: "client";
938
949
  message?: string;
939
950
  }
940
- export declare namespace LockedSubscriptionException {
941
- /**
942
- * @internal
943
- */
944
- const filterSensitiveLog: (obj: LockedSubscriptionException) => any;
945
- }
946
951
  export interface DescribeAttackRequest {
947
952
  /**
948
- * <p>The unique identifier (ID) for the attack that to be described.</p>
953
+ * <p>The unique identifier (ID) for the attack.</p>
949
954
  */
950
955
  AttackId: string | undefined;
951
956
  }
@@ -980,11 +985,11 @@ export declare namespace DescribeAttackStatisticsRequest {
980
985
  */
981
986
  export interface TimeRange {
982
987
  /**
983
- * <p>The start time, in Unix time in seconds. For more information see <a href="http://docs.aws.amazon.com/cli/latest/userguide/cli-using-param.html#parameter-types">timestamp</a>.</p>
988
+ * <p>The start time, in Unix time in seconds. </p>
984
989
  */
985
990
  FromInclusive?: Date;
986
991
  /**
987
- * <p>The end time, in Unix time in seconds. For more information see <a href="http://docs.aws.amazon.com/cli/latest/userguide/cli-using-param.html#parameter-types">timestamp</a>.</p>
992
+ * <p>The end time, in Unix time in seconds. </p>
988
993
  */
989
994
  ToExclusive?: Date;
990
995
  }
@@ -1089,13 +1094,19 @@ export interface Protection {
1089
1094
  */
1090
1095
  ResourceArn?: string;
1091
1096
  /**
1092
- * <p>The unique identifier (ID) for the Route 53 health check that's associated with the protection. </p>
1097
+ * <p>The unique identifier (ID) for the Route 53 health check that's associated with the protection. </p>
1093
1098
  */
1094
1099
  HealthCheckIds?: string[];
1095
1100
  /**
1096
1101
  * <p>The ARN (Amazon Resource Name) of the protection.</p>
1097
1102
  */
1098
1103
  ProtectionArn?: string;
1104
+ /**
1105
+ * <p>The automatic application layer DDoS mitigation settings for the protection.
1106
+ * This configuration determines whether Shield Advanced automatically
1107
+ * manages rules in the web ACL in order to respond to application layer events that Shield Advanced determines to be DDoS attacks. </p>
1108
+ */
1109
+ ApplicationLayerAutomaticResponseConfiguration?: ApplicationLayerAutomaticResponseConfiguration;
1099
1110
  }
1100
1111
  export declare namespace Protection {
1101
1112
  /**
@@ -1306,7 +1317,7 @@ export declare namespace SubscriptionLimits {
1306
1317
  */
1307
1318
  export interface Subscription {
1308
1319
  /**
1309
- * <p>The start time of the subscription, in Unix time in seconds. For more information see <a href="http://docs.aws.amazon.com/cli/latest/userguide/cli-using-param.html#parameter-types">timestamp</a>.</p>
1320
+ * <p>The start time of the subscription, in Unix time in seconds. </p>
1310
1321
  */
1311
1322
  StartTime?: Date;
1312
1323
  /**
@@ -1359,6 +1370,26 @@ export declare namespace DescribeSubscriptionResponse {
1359
1370
  */
1360
1371
  const filterSensitiveLog: (obj: DescribeSubscriptionResponse) => any;
1361
1372
  }
1373
+ export interface DisableApplicationLayerAutomaticResponseRequest {
1374
+ /**
1375
+ * <p>The ARN (Amazon Resource Name) of the resource.</p>
1376
+ */
1377
+ ResourceArn: string | undefined;
1378
+ }
1379
+ export declare namespace DisableApplicationLayerAutomaticResponseRequest {
1380
+ /**
1381
+ * @internal
1382
+ */
1383
+ const filterSensitiveLog: (obj: DisableApplicationLayerAutomaticResponseRequest) => any;
1384
+ }
1385
+ export interface DisableApplicationLayerAutomaticResponseResponse {
1386
+ }
1387
+ export declare namespace DisableApplicationLayerAutomaticResponseResponse {
1388
+ /**
1389
+ * @internal
1390
+ */
1391
+ const filterSensitiveLog: (obj: DisableApplicationLayerAutomaticResponseResponse) => any;
1392
+ }
1362
1393
  export interface DisableProactiveEngagementRequest {
1363
1394
  }
1364
1395
  export declare namespace DisableProactiveEngagementRequest {
@@ -1435,6 +1466,32 @@ export declare namespace DisassociateHealthCheckResponse {
1435
1466
  */
1436
1467
  const filterSensitiveLog: (obj: DisassociateHealthCheckResponse) => any;
1437
1468
  }
1469
+ export interface EnableApplicationLayerAutomaticResponseRequest {
1470
+ /**
1471
+ * <p>The ARN (Amazon Resource Name) of the resource.</p>
1472
+ */
1473
+ ResourceArn: string | undefined;
1474
+ /**
1475
+ * <p>Specifies the action setting that Shield Advanced should use in the WAF rules that it creates on behalf of the
1476
+ * protected resource in response to DDoS attacks. You specify this as part of the configuration for the automatic application layer DDoS mitigation feature,
1477
+ * when you enable or update automatic mitigation. Shield Advanced creates the WAF rules in a Shield Advanced-managed rule group, inside the web ACL that you have associated with the resource. </p>
1478
+ */
1479
+ Action: ResponseAction | undefined;
1480
+ }
1481
+ export declare namespace EnableApplicationLayerAutomaticResponseRequest {
1482
+ /**
1483
+ * @internal
1484
+ */
1485
+ const filterSensitiveLog: (obj: EnableApplicationLayerAutomaticResponseRequest) => any;
1486
+ }
1487
+ export interface EnableApplicationLayerAutomaticResponseResponse {
1488
+ }
1489
+ export declare namespace EnableApplicationLayerAutomaticResponseResponse {
1490
+ /**
1491
+ * @internal
1492
+ */
1493
+ const filterSensitiveLog: (obj: EnableApplicationLayerAutomaticResponseResponse) => any;
1494
+ }
1438
1495
  export interface EnableProactiveEngagementRequest {
1439
1496
  }
1440
1497
  export declare namespace EnableProactiveEngagementRequest {
@@ -1477,26 +1534,35 @@ export declare namespace GetSubscriptionStateResponse {
1477
1534
  }
1478
1535
  export interface ListAttacksRequest {
1479
1536
  /**
1480
- * <p>The ARN (Amazon Resource Name) of the resource that was attacked. If this is left
1537
+ * <p>The ARNs (Amazon Resource Names) of the resources that were attacked. If you leave this
1481
1538
  * blank, all applicable resources for this account will be included.</p>
1482
1539
  */
1483
1540
  ResourceArns?: string[];
1484
1541
  /**
1485
- * <p>The start of the time period for the attacks. This is a <code>timestamp</code> type. The sample request above indicates a <code>number</code> type because the default used by WAF is Unix time in seconds. However any valid <a href="http://docs.aws.amazon.com/cli/latest/userguide/cli-using-param.html#parameter-types">timestamp format</a> is allowed. </p>
1542
+ * <p>The start of the time period for the attacks. This is a <code>timestamp</code> type. The request syntax listing for this call indicates a <code>number</code> type,
1543
+ * but you can provide the time in any valid <a href="https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-types.html#parameter-type-timestamp">timestamp format</a> setting. </p>
1486
1544
  */
1487
1545
  StartTime?: TimeRange;
1488
1546
  /**
1489
- * <p>The end of the time period for the attacks. This is a <code>timestamp</code> type. The sample request above indicates a <code>number</code> type because the default used by WAF is Unix time in seconds. However any valid <a href="http://docs.aws.amazon.com/cli/latest/userguide/cli-using-param.html#parameter-types">timestamp format</a> is allowed. </p>
1547
+ * <p>The end of the time period for the attacks. This is a <code>timestamp</code> type. The request syntax listing for this call indicates a <code>number</code> type,
1548
+ * but you can provide the time in any valid <a href="https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-types.html#parameter-type-timestamp">timestamp format</a> setting. </p>
1490
1549
  */
1491
1550
  EndTime?: TimeRange;
1492
1551
  /**
1493
- * <p>The <code>ListAttacksRequest.NextMarker</code> value from a previous call to <code>ListAttacksRequest</code>. Pass null if this is the first call.</p>
1552
+ * <p>When you request a list of objects from Shield Advanced, if the response does not include all of the remaining available objects,
1553
+ * Shield Advanced includes a <code>NextToken</code> value in the response. You can retrieve the next batch of objects by requesting the list again and
1554
+ * providing the token that was returned by the prior call in your request. </p>
1555
+ * <p>You can indicate the maximum number of objects that you want Shield Advanced to return for a single call with the <code>MaxResults</code>
1556
+ * setting. Shield Advanced will not return more than <code>MaxResults</code> objects, but may return fewer, even if more objects are still available.</p>
1557
+ * <p>Whenever more objects remain that Shield Advanced has not yet returned to you, the response will include a <code>NextToken</code> value.</p>
1558
+ * <p>On your first call to a list operation, leave this setting empty.</p>
1494
1559
  */
1495
1560
  NextToken?: string;
1496
1561
  /**
1497
- * <p>The maximum number of <a>AttackSummary</a> objects to return. If you leave this blank,
1498
- * Shield Advanced returns the first 20 results.</p>
1499
- * <p>This is a maximum value. Shield Advanced might return the results in smaller batches. That is, the number of objects returned could be less than <code>MaxResults</code>, even if there are still more objects yet to return. If there are more objects to return, Shield Advanced returns a value in <code>NextToken</code> that you can use in your next request, to get the next batch of objects.</p>
1562
+ * <p>The greatest number of objects that you want Shield Advanced to return to the list request. Shield Advanced might return fewer objects
1563
+ * than you indicate in this setting, even if more objects are available. If there are more objects remaining, Shield Advanced will always also return a <code>NextToken</code> value
1564
+ * in the response.</p>
1565
+ * <p>The default setting is 20.</p>
1500
1566
  */
1501
1567
  MaxResults?: number;
1502
1568
  }
@@ -1512,11 +1578,12 @@ export interface ListAttacksResponse {
1512
1578
  */
1513
1579
  AttackSummaries?: AttackSummary[];
1514
1580
  /**
1515
- * <p>The token returned by a previous call to indicate that there is more data available.
1516
- * If not null, more results are available. Pass this value for the <code>NextMarker</code>
1517
- * parameter in a subsequent call to <code>ListAttacks</code> to retrieve the next set of
1518
- * items.</p>
1519
- * <p>Shield Advanced might return the list of <a>AttackSummary</a> objects in batches smaller than the number specified by MaxResults. If there are more attack summary objects to return, Shield Advanced will always also return a <code>NextToken</code>.</p>
1581
+ * <p>When you request a list of objects from Shield Advanced, if the response does not include all of the remaining available objects,
1582
+ * Shield Advanced includes a <code>NextToken</code> value in the response. You can retrieve the next batch of objects by requesting the list again and
1583
+ * providing the token that was returned by the prior call in your request. </p>
1584
+ * <p>You can indicate the maximum number of objects that you want Shield Advanced to return for a single call with the <code>MaxResults</code>
1585
+ * setting. Shield Advanced will not return more than <code>MaxResults</code> objects, but may return fewer, even if more objects are still available.</p>
1586
+ * <p>Whenever more objects remain that Shield Advanced has not yet returned to you, the response will include a <code>NextToken</code> value.</p>
1520
1587
  */
1521
1588
  NextToken?: string;
1522
1589
  }
@@ -1527,28 +1594,29 @@ export declare namespace ListAttacksResponse {
1527
1594
  const filterSensitiveLog: (obj: ListAttacksResponse) => any;
1528
1595
  }
1529
1596
  /**
1530
- * <p>Exception that indicates that the NextToken specified in the request is invalid. Submit the request using the NextToken value that was returned in the response.</p>
1597
+ * <p>Exception that indicates that the <code>NextToken</code> specified in the request is invalid. Submit the request using the <code>NextToken</code> value that was returned in the prior response.</p>
1531
1598
  */
1532
1599
  export interface InvalidPaginationTokenException extends __SmithyException, $MetadataBearer {
1533
1600
  name: "InvalidPaginationTokenException";
1534
1601
  $fault: "client";
1535
1602
  message?: string;
1536
1603
  }
1537
- export declare namespace InvalidPaginationTokenException {
1538
- /**
1539
- * @internal
1540
- */
1541
- const filterSensitiveLog: (obj: InvalidPaginationTokenException) => any;
1542
- }
1543
1604
  export interface ListProtectionGroupsRequest {
1544
1605
  /**
1545
- * <p>The next token value from a previous call to <code>ListProtectionGroups</code>. Pass null if this is the first call.</p>
1606
+ * <p>When you request a list of objects from Shield Advanced, if the response does not include all of the remaining available objects,
1607
+ * Shield Advanced includes a <code>NextToken</code> value in the response. You can retrieve the next batch of objects by requesting the list again and
1608
+ * providing the token that was returned by the prior call in your request. </p>
1609
+ * <p>You can indicate the maximum number of objects that you want Shield Advanced to return for a single call with the <code>MaxResults</code>
1610
+ * setting. Shield Advanced will not return more than <code>MaxResults</code> objects, but may return fewer, even if more objects are still available.</p>
1611
+ * <p>Whenever more objects remain that Shield Advanced has not yet returned to you, the response will include a <code>NextToken</code> value.</p>
1612
+ * <p>On your first call to a list operation, leave this setting empty.</p>
1546
1613
  */
1547
1614
  NextToken?: string;
1548
1615
  /**
1549
- * <p>The maximum number of <a>ProtectionGroup</a> objects to return. If you leave this blank,
1550
- * Shield Advanced returns the first 20 results.</p>
1551
- * <p>This is a maximum value. Shield Advanced might return the results in smaller batches. That is, the number of objects returned could be less than <code>MaxResults</code>, even if there are still more objects yet to return. If there are more objects to return, Shield Advanced returns a value in <code>NextToken</code> that you can use in your next request, to get the next batch of objects.</p>
1616
+ * <p>The greatest number of objects that you want Shield Advanced to return to the list request. Shield Advanced might return fewer objects
1617
+ * than you indicate in this setting, even if more objects are available. If there are more objects remaining, Shield Advanced will always also return a <code>NextToken</code> value
1618
+ * in the response.</p>
1619
+ * <p>The default setting is 20.</p>
1552
1620
  */
1553
1621
  MaxResults?: number;
1554
1622
  }
@@ -1564,7 +1632,12 @@ export interface ListProtectionGroupsResponse {
1564
1632
  */
1565
1633
  ProtectionGroups: ProtectionGroup[] | undefined;
1566
1634
  /**
1567
- * <p>If you specify a value for <code>MaxResults</code> and you have more protection groups than the value of MaxResults, Shield Advanced returns this token that you can use in your next request, to get the next batch of objects. </p>
1635
+ * <p>When you request a list of objects from Shield Advanced, if the response does not include all of the remaining available objects,
1636
+ * Shield Advanced includes a <code>NextToken</code> value in the response. You can retrieve the next batch of objects by requesting the list again and
1637
+ * providing the token that was returned by the prior call in your request. </p>
1638
+ * <p>You can indicate the maximum number of objects that you want Shield Advanced to return for a single call with the <code>MaxResults</code>
1639
+ * setting. Shield Advanced will not return more than <code>MaxResults</code> objects, but may return fewer, even if more objects are still available.</p>
1640
+ * <p>Whenever more objects remain that Shield Advanced has not yet returned to you, the response will include a <code>NextToken</code> value.</p>
1568
1641
  */
1569
1642
  NextToken?: string;
1570
1643
  }
@@ -1576,13 +1649,20 @@ export declare namespace ListProtectionGroupsResponse {
1576
1649
  }
1577
1650
  export interface ListProtectionsRequest {
1578
1651
  /**
1579
- * <p>The <code>ListProtectionsRequest.NextToken</code> value from a previous call to <code>ListProtections</code>. Pass null if this is the first call.</p>
1652
+ * <p>When you request a list of objects from Shield Advanced, if the response does not include all of the remaining available objects,
1653
+ * Shield Advanced includes a <code>NextToken</code> value in the response. You can retrieve the next batch of objects by requesting the list again and
1654
+ * providing the token that was returned by the prior call in your request. </p>
1655
+ * <p>You can indicate the maximum number of objects that you want Shield Advanced to return for a single call with the <code>MaxResults</code>
1656
+ * setting. Shield Advanced will not return more than <code>MaxResults</code> objects, but may return fewer, even if more objects are still available.</p>
1657
+ * <p>Whenever more objects remain that Shield Advanced has not yet returned to you, the response will include a <code>NextToken</code> value.</p>
1658
+ * <p>On your first call to a list operation, leave this setting empty.</p>
1580
1659
  */
1581
1660
  NextToken?: string;
1582
1661
  /**
1583
- * <p>The maximum number of <a>Protection</a> objects to return. If you leave this blank,
1584
- * Shield Advanced returns the first 20 results.</p>
1585
- * <p>This is a maximum value. Shield Advanced might return the results in smaller batches. That is, the number of objects returned could be less than <code>MaxResults</code>, even if there are still more objects yet to return. If there are more objects to return, Shield Advanced returns a value in <code>NextToken</code> that you can use in your next request, to get the next batch of objects.</p>
1662
+ * <p>The greatest number of objects that you want Shield Advanced to return to the list request. Shield Advanced might return fewer objects
1663
+ * than you indicate in this setting, even if more objects are available. If there are more objects remaining, Shield Advanced will always also return a <code>NextToken</code> value
1664
+ * in the response.</p>
1665
+ * <p>The default setting is 20.</p>
1586
1666
  */
1587
1667
  MaxResults?: number;
1588
1668
  }
@@ -1598,8 +1678,12 @@ export interface ListProtectionsResponse {
1598
1678
  */
1599
1679
  Protections?: Protection[];
1600
1680
  /**
1601
- * <p>If you specify a value for <code>MaxResults</code> and you have more Protections than the value of MaxResults, Shield Advanced returns a NextToken value in the response that allows you to list another group of Protections. For the second and subsequent ListProtections requests, specify the value of NextToken from the previous response to get information about another batch of Protections.</p>
1602
- * <p>Shield Advanced might return the list of <a>Protection</a> objects in batches smaller than the number specified by MaxResults. If there are more <a>Protection</a> objects to return, Shield Advanced will always also return a <code>NextToken</code>.</p>
1681
+ * <p>When you request a list of objects from Shield Advanced, if the response does not include all of the remaining available objects,
1682
+ * Shield Advanced includes a <code>NextToken</code> value in the response. You can retrieve the next batch of objects by requesting the list again and
1683
+ * providing the token that was returned by the prior call in your request. </p>
1684
+ * <p>You can indicate the maximum number of objects that you want Shield Advanced to return for a single call with the <code>MaxResults</code>
1685
+ * setting. Shield Advanced will not return more than <code>MaxResults</code> objects, but may return fewer, even if more objects are still available.</p>
1686
+ * <p>Whenever more objects remain that Shield Advanced has not yet returned to you, the response will include a <code>NextToken</code> value.</p>
1603
1687
  */
1604
1688
  NextToken?: string;
1605
1689
  }
@@ -1615,13 +1699,20 @@ export interface ListResourcesInProtectionGroupRequest {
1615
1699
  */
1616
1700
  ProtectionGroupId: string | undefined;
1617
1701
  /**
1618
- * <p>The next token value from a previous call to <code>ListResourcesInProtectionGroup</code>. Pass null if this is the first call.</p>
1702
+ * <p>When you request a list of objects from Shield Advanced, if the response does not include all of the remaining available objects,
1703
+ * Shield Advanced includes a <code>NextToken</code> value in the response. You can retrieve the next batch of objects by requesting the list again and
1704
+ * providing the token that was returned by the prior call in your request. </p>
1705
+ * <p>You can indicate the maximum number of objects that you want Shield Advanced to return for a single call with the <code>MaxResults</code>
1706
+ * setting. Shield Advanced will not return more than <code>MaxResults</code> objects, but may return fewer, even if more objects are still available.</p>
1707
+ * <p>Whenever more objects remain that Shield Advanced has not yet returned to you, the response will include a <code>NextToken</code> value.</p>
1708
+ * <p>On your first call to a list operation, leave this setting empty.</p>
1619
1709
  */
1620
1710
  NextToken?: string;
1621
1711
  /**
1622
- * <p>The maximum number of resource ARN objects to return. If you leave this blank,
1623
- * Shield Advanced returns the first 20 results.</p>
1624
- * <p>This is a maximum value. Shield Advanced might return the results in smaller batches. That is, the number of objects returned could be less than <code>MaxResults</code>, even if there are still more objects yet to return. If there are more objects to return, Shield Advanced returns a value in <code>NextToken</code> that you can use in your next request, to get the next batch of objects.</p>
1712
+ * <p>The greatest number of objects that you want Shield Advanced to return to the list request. Shield Advanced might return fewer objects
1713
+ * than you indicate in this setting, even if more objects are available. If there are more objects remaining, Shield Advanced will always also return a <code>NextToken</code> value
1714
+ * in the response.</p>
1715
+ * <p>The default setting is 20.</p>
1625
1716
  */
1626
1717
  MaxResults?: number;
1627
1718
  }
@@ -1637,7 +1728,12 @@ export interface ListResourcesInProtectionGroupResponse {
1637
1728
  */
1638
1729
  ResourceArns: string[] | undefined;
1639
1730
  /**
1640
- * <p>If you specify a value for <code>MaxResults</code> and you have more resources in the protection group than the value of MaxResults, Shield Advanced returns this token that you can use in your next request, to get the next batch of objects. </p>
1731
+ * <p>When you request a list of objects from Shield Advanced, if the response does not include all of the remaining available objects,
1732
+ * Shield Advanced includes a <code>NextToken</code> value in the response. You can retrieve the next batch of objects by requesting the list again and
1733
+ * providing the token that was returned by the prior call in your request. </p>
1734
+ * <p>You can indicate the maximum number of objects that you want Shield Advanced to return for a single call with the <code>MaxResults</code>
1735
+ * setting. Shield Advanced will not return more than <code>MaxResults</code> objects, but may return fewer, even if more objects are still available.</p>
1736
+ * <p>Whenever more objects remain that Shield Advanced has not yet returned to you, the response will include a <code>NextToken</code> value.</p>
1641
1737
  */
1642
1738
  NextToken?: string;
1643
1739
  }
@@ -1719,6 +1815,32 @@ export declare namespace UntagResourceResponse {
1719
1815
  */
1720
1816
  const filterSensitiveLog: (obj: UntagResourceResponse) => any;
1721
1817
  }
1818
+ export interface UpdateApplicationLayerAutomaticResponseRequest {
1819
+ /**
1820
+ * <p>The ARN (Amazon Resource Name) of the resource.</p>
1821
+ */
1822
+ ResourceArn: string | undefined;
1823
+ /**
1824
+ * <p>Specifies the action setting that Shield Advanced should use in the WAF rules that it creates on behalf of the
1825
+ * protected resource in response to DDoS attacks. You specify this as part of the configuration for the automatic application layer DDoS mitigation feature,
1826
+ * when you enable or update automatic mitigation. Shield Advanced creates the WAF rules in a Shield Advanced-managed rule group, inside the web ACL that you have associated with the resource. </p>
1827
+ */
1828
+ Action: ResponseAction | undefined;
1829
+ }
1830
+ export declare namespace UpdateApplicationLayerAutomaticResponseRequest {
1831
+ /**
1832
+ * @internal
1833
+ */
1834
+ const filterSensitiveLog: (obj: UpdateApplicationLayerAutomaticResponseRequest) => any;
1835
+ }
1836
+ export interface UpdateApplicationLayerAutomaticResponseResponse {
1837
+ }
1838
+ export declare namespace UpdateApplicationLayerAutomaticResponseResponse {
1839
+ /**
1840
+ * @internal
1841
+ */
1842
+ const filterSensitiveLog: (obj: UpdateApplicationLayerAutomaticResponseResponse) => any;
1843
+ }
1722
1844
  export interface UpdateEmergencyContactSettingsRequest {
1723
1845
  /**
1724
1846
  * <p>A list of email addresses and phone numbers that the Shield Response Team (SRT) can use to contact you if you have proactive engagement enabled, for escalations to the SRT and to initiate proactive customer support.</p>