@aws-sdk/client-shield 3.131.0 → 3.141.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 (91) hide show
  1. package/CHANGELOG.md +33 -0
  2. package/README.md +1 -1
  3. package/dist-cjs/commands/AssociateDRTLogBucketCommand.js +2 -2
  4. package/dist-cjs/commands/AssociateDRTRoleCommand.js +2 -2
  5. package/dist-cjs/commands/AssociateHealthCheckCommand.js +2 -2
  6. package/dist-cjs/commands/AssociateProactiveEngagementDetailsCommand.js +2 -2
  7. package/dist-cjs/commands/CreateProtectionCommand.js +2 -2
  8. package/dist-cjs/commands/CreateProtectionGroupCommand.js +2 -2
  9. package/dist-cjs/commands/CreateSubscriptionCommand.js +2 -2
  10. package/dist-cjs/commands/DeleteProtectionCommand.js +2 -2
  11. package/dist-cjs/commands/DeleteProtectionGroupCommand.js +2 -2
  12. package/dist-cjs/commands/DeleteSubscriptionCommand.js +2 -2
  13. package/dist-cjs/commands/DescribeAttackCommand.js +2 -2
  14. package/dist-cjs/commands/DescribeAttackStatisticsCommand.js +2 -2
  15. package/dist-cjs/commands/DescribeDRTAccessCommand.js +2 -2
  16. package/dist-cjs/commands/DescribeEmergencyContactSettingsCommand.js +2 -2
  17. package/dist-cjs/commands/DescribeProtectionCommand.js +2 -2
  18. package/dist-cjs/commands/DescribeProtectionGroupCommand.js +2 -2
  19. package/dist-cjs/commands/DescribeSubscriptionCommand.js +2 -2
  20. package/dist-cjs/commands/DisableApplicationLayerAutomaticResponseCommand.js +2 -2
  21. package/dist-cjs/commands/DisableProactiveEngagementCommand.js +2 -2
  22. package/dist-cjs/commands/DisassociateDRTLogBucketCommand.js +2 -2
  23. package/dist-cjs/commands/DisassociateDRTRoleCommand.js +2 -2
  24. package/dist-cjs/commands/DisassociateHealthCheckCommand.js +2 -2
  25. package/dist-cjs/commands/EnableApplicationLayerAutomaticResponseCommand.js +2 -2
  26. package/dist-cjs/commands/EnableProactiveEngagementCommand.js +2 -2
  27. package/dist-cjs/commands/GetSubscriptionStateCommand.js +2 -2
  28. package/dist-cjs/commands/ListAttacksCommand.js +2 -2
  29. package/dist-cjs/commands/ListProtectionGroupsCommand.js +2 -2
  30. package/dist-cjs/commands/ListProtectionsCommand.js +2 -2
  31. package/dist-cjs/commands/ListResourcesInProtectionGroupCommand.js +2 -2
  32. package/dist-cjs/commands/ListTagsForResourceCommand.js +2 -2
  33. package/dist-cjs/commands/TagResourceCommand.js +2 -2
  34. package/dist-cjs/commands/UntagResourceCommand.js +2 -2
  35. package/dist-cjs/commands/UpdateApplicationLayerAutomaticResponseCommand.js +2 -2
  36. package/dist-cjs/commands/UpdateEmergencyContactSettingsCommand.js +2 -2
  37. package/dist-cjs/commands/UpdateProtectionGroupCommand.js +2 -2
  38. package/dist-cjs/commands/UpdateSubscriptionCommand.js +2 -2
  39. package/dist-cjs/models/models_0.js +415 -609
  40. package/dist-cjs/protocols/Aws_json1_1.js +95 -0
  41. package/dist-es/commands/AssociateDRTLogBucketCommand.js +3 -3
  42. package/dist-es/commands/AssociateDRTRoleCommand.js +3 -3
  43. package/dist-es/commands/AssociateHealthCheckCommand.js +3 -3
  44. package/dist-es/commands/AssociateProactiveEngagementDetailsCommand.js +3 -3
  45. package/dist-es/commands/CreateProtectionCommand.js +3 -3
  46. package/dist-es/commands/CreateProtectionGroupCommand.js +3 -3
  47. package/dist-es/commands/CreateSubscriptionCommand.js +3 -3
  48. package/dist-es/commands/DeleteProtectionCommand.js +3 -3
  49. package/dist-es/commands/DeleteProtectionGroupCommand.js +3 -3
  50. package/dist-es/commands/DeleteSubscriptionCommand.js +3 -3
  51. package/dist-es/commands/DescribeAttackCommand.js +3 -3
  52. package/dist-es/commands/DescribeAttackStatisticsCommand.js +3 -3
  53. package/dist-es/commands/DescribeDRTAccessCommand.js +3 -3
  54. package/dist-es/commands/DescribeEmergencyContactSettingsCommand.js +3 -3
  55. package/dist-es/commands/DescribeProtectionCommand.js +3 -3
  56. package/dist-es/commands/DescribeProtectionGroupCommand.js +3 -3
  57. package/dist-es/commands/DescribeSubscriptionCommand.js +3 -3
  58. package/dist-es/commands/DisableApplicationLayerAutomaticResponseCommand.js +3 -3
  59. package/dist-es/commands/DisableProactiveEngagementCommand.js +3 -3
  60. package/dist-es/commands/DisassociateDRTLogBucketCommand.js +3 -3
  61. package/dist-es/commands/DisassociateDRTRoleCommand.js +3 -3
  62. package/dist-es/commands/DisassociateHealthCheckCommand.js +3 -3
  63. package/dist-es/commands/EnableApplicationLayerAutomaticResponseCommand.js +3 -3
  64. package/dist-es/commands/EnableProactiveEngagementCommand.js +3 -3
  65. package/dist-es/commands/GetSubscriptionStateCommand.js +3 -3
  66. package/dist-es/commands/ListAttacksCommand.js +3 -3
  67. package/dist-es/commands/ListProtectionGroupsCommand.js +3 -3
  68. package/dist-es/commands/ListProtectionsCommand.js +3 -3
  69. package/dist-es/commands/ListResourcesInProtectionGroupCommand.js +3 -3
  70. package/dist-es/commands/ListTagsForResourceCommand.js +3 -3
  71. package/dist-es/commands/TagResourceCommand.js +3 -3
  72. package/dist-es/commands/UntagResourceCommand.js +3 -3
  73. package/dist-es/commands/UpdateApplicationLayerAutomaticResponseCommand.js +3 -3
  74. package/dist-es/commands/UpdateEmergencyContactSettingsCommand.js +3 -3
  75. package/dist-es/commands/UpdateProtectionGroupCommand.js +3 -3
  76. package/dist-es/commands/UpdateSubscriptionCommand.js +3 -3
  77. package/dist-es/models/models_0.js +103 -404
  78. package/dist-es/protocols/Aws_json1_1.js +86 -2
  79. package/dist-types/Shield.d.ts +23 -13
  80. package/dist-types/commands/AssociateDRTLogBucketCommand.d.ts +1 -1
  81. package/dist-types/commands/AssociateDRTRoleCommand.d.ts +1 -1
  82. package/dist-types/commands/CreateProtectionCommand.d.ts +1 -1
  83. package/dist-types/commands/CreateSubscriptionCommand.d.ts +5 -2
  84. package/dist-types/commands/DisableApplicationLayerAutomaticResponseCommand.d.ts +1 -1
  85. package/dist-types/commands/EnableApplicationLayerAutomaticResponseCommand.d.ts +6 -5
  86. package/dist-types/commands/ListProtectionGroupsCommand.d.ts +2 -1
  87. package/dist-types/commands/ListProtectionsCommand.d.ts +2 -1
  88. package/dist-types/commands/UpdateSubscriptionCommand.d.ts +4 -0
  89. package/dist-types/models/models_0.d.ts +464 -612
  90. package/dist-types/ts3.4/models/models_0.d.ts +226 -400
  91. package/package.json +6 -6
@@ -2872,16 +2872,40 @@ var serializeAws_json1_1EnableProactiveEngagementRequest = function (input, cont
2872
2872
  var serializeAws_json1_1GetSubscriptionStateRequest = function (input, context) {
2873
2873
  return {};
2874
2874
  };
2875
+ var serializeAws_json1_1InclusionProtectionFilters = function (input, context) {
2876
+ return __assign(__assign(__assign({}, (input.ProtectionNames != null && {
2877
+ ProtectionNames: serializeAws_json1_1ProtectionNameFilters(input.ProtectionNames, context),
2878
+ })), (input.ResourceArns != null && {
2879
+ ResourceArns: serializeAws_json1_1ResourceArnFilters(input.ResourceArns, context),
2880
+ })), (input.ResourceTypes != null && {
2881
+ ResourceTypes: serializeAws_json1_1ProtectedResourceTypeFilters(input.ResourceTypes, context),
2882
+ }));
2883
+ };
2884
+ var serializeAws_json1_1InclusionProtectionGroupFilters = function (input, context) {
2885
+ return __assign(__assign(__assign(__assign({}, (input.Aggregations != null && {
2886
+ Aggregations: serializeAws_json1_1ProtectionGroupAggregationFilters(input.Aggregations, context),
2887
+ })), (input.Patterns != null && {
2888
+ Patterns: serializeAws_json1_1ProtectionGroupPatternFilters(input.Patterns, context),
2889
+ })), (input.ProtectionGroupIds != null && {
2890
+ ProtectionGroupIds: serializeAws_json1_1ProtectionGroupIdFilters(input.ProtectionGroupIds, context),
2891
+ })), (input.ResourceTypes != null && {
2892
+ ResourceTypes: serializeAws_json1_1ProtectedResourceTypeFilters(input.ResourceTypes, context),
2893
+ }));
2894
+ };
2875
2895
  var serializeAws_json1_1ListAttacksRequest = function (input, context) {
2876
2896
  return __assign(__assign(__assign(__assign(__assign({}, (input.EndTime != null && { EndTime: serializeAws_json1_1TimeRange(input.EndTime, context) })), (input.MaxResults != null && { MaxResults: input.MaxResults })), (input.NextToken != null && { NextToken: input.NextToken })), (input.ResourceArns != null && {
2877
2897
  ResourceArns: serializeAws_json1_1ResourceArnFilterList(input.ResourceArns, context),
2878
2898
  })), (input.StartTime != null && { StartTime: serializeAws_json1_1TimeRange(input.StartTime, context) }));
2879
2899
  };
2880
2900
  var serializeAws_json1_1ListProtectionGroupsRequest = function (input, context) {
2881
- return __assign(__assign({}, (input.MaxResults != null && { MaxResults: input.MaxResults })), (input.NextToken != null && { NextToken: input.NextToken }));
2901
+ return __assign(__assign(__assign({}, (input.InclusionFilters != null && {
2902
+ InclusionFilters: serializeAws_json1_1InclusionProtectionGroupFilters(input.InclusionFilters, context),
2903
+ })), (input.MaxResults != null && { MaxResults: input.MaxResults })), (input.NextToken != null && { NextToken: input.NextToken }));
2882
2904
  };
2883
2905
  var serializeAws_json1_1ListProtectionsRequest = function (input, context) {
2884
- return __assign(__assign({}, (input.MaxResults != null && { MaxResults: input.MaxResults })), (input.NextToken != null && { NextToken: input.NextToken }));
2906
+ return __assign(__assign(__assign({}, (input.InclusionFilters != null && {
2907
+ InclusionFilters: serializeAws_json1_1InclusionProtectionFilters(input.InclusionFilters, context),
2908
+ })), (input.MaxResults != null && { MaxResults: input.MaxResults })), (input.NextToken != null && { NextToken: input.NextToken }));
2885
2909
  };
2886
2910
  var serializeAws_json1_1ListResourcesInProtectionGroupRequest = function (input, context) {
2887
2911
  return __assign(__assign(__assign({}, (input.MaxResults != null && { MaxResults: input.MaxResults })), (input.NextToken != null && { NextToken: input.NextToken })), (input.ProtectionGroupId != null && { ProtectionGroupId: input.ProtectionGroupId }));
@@ -2889,6 +2913,36 @@ var serializeAws_json1_1ListResourcesInProtectionGroupRequest = function (input,
2889
2913
  var serializeAws_json1_1ListTagsForResourceRequest = function (input, context) {
2890
2914
  return __assign({}, (input.ResourceARN != null && { ResourceARN: input.ResourceARN }));
2891
2915
  };
2916
+ var serializeAws_json1_1ProtectedResourceTypeFilters = function (input, context) {
2917
+ return input
2918
+ .filter(function (e) { return e != null; })
2919
+ .map(function (entry) {
2920
+ if (entry === null) {
2921
+ return null;
2922
+ }
2923
+ return entry;
2924
+ });
2925
+ };
2926
+ var serializeAws_json1_1ProtectionGroupAggregationFilters = function (input, context) {
2927
+ return input
2928
+ .filter(function (e) { return e != null; })
2929
+ .map(function (entry) {
2930
+ if (entry === null) {
2931
+ return null;
2932
+ }
2933
+ return entry;
2934
+ });
2935
+ };
2936
+ var serializeAws_json1_1ProtectionGroupIdFilters = function (input, context) {
2937
+ return input
2938
+ .filter(function (e) { return e != null; })
2939
+ .map(function (entry) {
2940
+ if (entry === null) {
2941
+ return null;
2942
+ }
2943
+ return entry;
2944
+ });
2945
+ };
2892
2946
  var serializeAws_json1_1ProtectionGroupMembers = function (input, context) {
2893
2947
  return input
2894
2948
  .filter(function (e) { return e != null; })
@@ -2899,6 +2953,26 @@ var serializeAws_json1_1ProtectionGroupMembers = function (input, context) {
2899
2953
  return entry;
2900
2954
  });
2901
2955
  };
2956
+ var serializeAws_json1_1ProtectionGroupPatternFilters = function (input, context) {
2957
+ return input
2958
+ .filter(function (e) { return e != null; })
2959
+ .map(function (entry) {
2960
+ if (entry === null) {
2961
+ return null;
2962
+ }
2963
+ return entry;
2964
+ });
2965
+ };
2966
+ var serializeAws_json1_1ProtectionNameFilters = function (input, context) {
2967
+ return input
2968
+ .filter(function (e) { return e != null; })
2969
+ .map(function (entry) {
2970
+ if (entry === null) {
2971
+ return null;
2972
+ }
2973
+ return entry;
2974
+ });
2975
+ };
2902
2976
  var serializeAws_json1_1ResourceArnFilterList = function (input, context) {
2903
2977
  return input
2904
2978
  .filter(function (e) { return e != null; })
@@ -2909,6 +2983,16 @@ var serializeAws_json1_1ResourceArnFilterList = function (input, context) {
2909
2983
  return entry;
2910
2984
  });
2911
2985
  };
2986
+ var serializeAws_json1_1ResourceArnFilters = function (input, context) {
2987
+ return input
2988
+ .filter(function (e) { return e != null; })
2989
+ .map(function (entry) {
2990
+ if (entry === null) {
2991
+ return null;
2992
+ }
2993
+ return entry;
2994
+ });
2995
+ };
2912
2996
  var serializeAws_json1_1ResponseAction = function (input, context) {
2913
2997
  return __assign(__assign({}, (input.Block != null && { Block: serializeAws_json1_1BlockAction(input.Block, context) })), (input.Count != null && { Count: serializeAws_json1_1CountAction(input.Count, context) }));
2914
2998
  };
@@ -45,7 +45,7 @@ import { ShieldClient } from "./ShieldClient";
45
45
  export declare class Shield extends ShieldClient {
46
46
  /**
47
47
  * <p>Authorizes the Shield Response Team (SRT) to access the specified Amazon S3 bucket containing log data such as Application Load Balancer access logs, CloudFront logs, or logs from third party sources. You can associate up to 10 Amazon S3 buckets with your subscription.</p>
48
- * <p>To use the services of the SRT and make an <code>AssociateDRTLogBucket</code> request, you must be subscribed to the <a href="https://docs.aws.amazon.com/premiumsupport/business-support/">Business Support plan</a> or the <a href="https://docs.aws.amazon.com/premiumsupport/enterprise-support/">Enterprise Support plan</a>.</p>
48
+ * <p>To use the services of the SRT and make an <code>AssociateDRTLogBucket</code> request, you must be subscribed to the <a href="http://aws.amazon.com/premiumsupport/business-support/">Business Support plan</a> or the <a href="http://aws.amazon.com/premiumsupport/enterprise-support/">Enterprise Support plan</a>.</p>
49
49
  */
50
50
  associateDRTLogBucket(args: AssociateDRTLogBucketCommandInput, options?: __HttpHandlerOptions): Promise<AssociateDRTLogBucketCommandOutput>;
51
51
  associateDRTLogBucket(args: AssociateDRTLogBucketCommandInput, cb: (err: any, data?: AssociateDRTLogBucketCommandOutput) => void): void;
@@ -58,7 +58,7 @@ export declare class Shield extends ShieldClient {
58
58
  *
59
59
  * <p>The SRT will have access only to your WAF and Shield resources. By submitting this request, you authorize the SRT to inspect your WAF and Shield configuration and create and update WAF rules and web ACLs on your behalf. The SRT takes these actions only if explicitly authorized by you.</p>
60
60
  * <p>You must have the <code>iam:PassRole</code> permission to make an <code>AssociateDRTRole</code> request. 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>
61
- * <p>To use the services of the SRT and make an <code>AssociateDRTRole</code> request, you must be subscribed to the <a href="https://docs.aws.amazon.com/premiumsupport/business-support/">Business Support plan</a> or the <a href="https://docs.aws.amazon.com/premiumsupport/enterprise-support/">Enterprise Support plan</a>.</p>
61
+ * <p>To use the services of the SRT and make an <code>AssociateDRTRole</code> request, you must be subscribed to the <a href="http://aws.amazon.com/premiumsupport/business-support/">Business Support plan</a> or the <a href="http://aws.amazon.com/premiumsupport/enterprise-support/">Enterprise Support plan</a>.</p>
62
62
  */
63
63
  associateDRTRole(args: AssociateDRTRoleCommandInput, options?: __HttpHandlerOptions): Promise<AssociateDRTRoleCommandOutput>;
64
64
  associateDRTRole(args: AssociateDRTRoleCommandInput, cb: (err: any, data?: AssociateDRTRoleCommandOutput) => void): void;
@@ -82,7 +82,7 @@ export declare class Shield extends ShieldClient {
82
82
  associateProactiveEngagementDetails(args: AssociateProactiveEngagementDetailsCommandInput, cb: (err: any, data?: AssociateProactiveEngagementDetailsCommandOutput) => void): void;
83
83
  associateProactiveEngagementDetails(args: AssociateProactiveEngagementDetailsCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: AssociateProactiveEngagementDetailsCommandOutput) => void): void;
84
84
  /**
85
- * <p>Enables Shield Advanced for a specific Amazon Web Services resource. The resource can be an Amazon CloudFront distribution, Elastic Load Balancing load balancer, Global Accelerator accelerator, Elastic IP Address, or an Amazon Route 53 hosted zone.</p>
85
+ * <p>Enables Shield Advanced for a specific Amazon Web Services resource. The resource can be an Amazon CloudFront distribution, Amazon Route 53 hosted zone, Global Accelerator standard accelerator, Elastic IP Address, Application Load Balancer, or a Classic Load Balancer. You can protect Amazon EC2 instances and Network Load Balancers by association with protected Amazon EC2 Elastic IP addresses.</p>
86
86
  * <p>You can add protection to only a single resource with each <code>CreateProtection</code> request. You can add protection to multiple resources
87
87
  * at once through the Shield Advanced console at <a href="https://console.aws.amazon.com/wafv2/shieldv2#/">https://console.aws.amazon.com/wafv2/shieldv2#/</a>.
88
88
  * For more information see
@@ -100,8 +100,11 @@ export declare class Shield extends ShieldClient {
100
100
  createProtectionGroup(args: CreateProtectionGroupCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: CreateProtectionGroupCommandOutput) => void): void;
101
101
  /**
102
102
  * <p>Activates Shield Advanced for an account.</p>
103
- *
104
- * <p>When you initally create a subscription, your subscription is set to be automatically renewed at the end of the existing subscription period. You can change this by submitting an <code>UpdateSubscription</code> request. </p>
103
+ * <note>
104
+ * <p>For accounts that are members of an Organizations organization, Shield Advanced subscriptions are billed against the organization's payer account,
105
+ * regardless of whether the payer account itself is subscribed. </p>
106
+ * </note>
107
+ * <p>When you initially create a subscription, your subscription is set to be automatically renewed at the end of the existing subscription period. You can change this by submitting an <code>UpdateSubscription</code> request. </p>
105
108
  */
106
109
  createSubscription(args: CreateSubscriptionCommandInput, options?: __HttpHandlerOptions): Promise<CreateSubscriptionCommandOutput>;
107
110
  createSubscription(args: CreateSubscriptionCommandInput, cb: (err: any, data?: CreateSubscriptionCommandOutput) => void): void;
@@ -171,7 +174,7 @@ export declare class Shield extends ShieldClient {
171
174
  describeSubscription(args: DescribeSubscriptionCommandInput, cb: (err: any, data?: DescribeSubscriptionCommandOutput) => void): void;
172
175
  describeSubscription(args: DescribeSubscriptionCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DescribeSubscriptionCommandOutput) => void): void;
173
176
  /**
174
- * <p>Disable the Shield Advanced automatic application layer DDoS mitigation feature for the resource. This
177
+ * <p>Disable the Shield Advanced automatic application layer DDoS mitigation feature for the protected resource. This
175
178
  * stops Shield Advanced from creating, verifying, and applying WAF rules for attacks that it detects for the resource. </p>
176
179
  */
177
180
  disableApplicationLayerAutomaticResponse(args: DisableApplicationLayerAutomaticResponseCommandInput, options?: __HttpHandlerOptions): Promise<DisableApplicationLayerAutomaticResponseCommandOutput>;
@@ -203,19 +206,20 @@ export declare class Shield extends ShieldClient {
203
206
  disassociateHealthCheck(args: DisassociateHealthCheckCommandInput, cb: (err: any, data?: DisassociateHealthCheckCommandOutput) => void): void;
204
207
  disassociateHealthCheck(args: DisassociateHealthCheckCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DisassociateHealthCheckCommandOutput) => void): void;
205
208
  /**
206
- * <p>Enable the Shield Advanced automatic application layer DDoS mitigation for the resource. </p>
209
+ * <p>Enable the Shield Advanced automatic application layer DDoS mitigation for the protected resource. </p>
207
210
  * <note>
208
- * <p>This feature is available for Amazon CloudFront distributions only.</p>
211
+ * <p>This feature is available for Amazon CloudFront distributions and Application Load Balancers only.</p>
209
212
  * </note>
210
213
  * <p>This causes Shield Advanced to create, verify, and apply WAF rules for DDoS attacks that it detects for the
211
214
  * resource. Shield Advanced applies the rules in a Shield rule group inside the web ACL that you've associated
212
215
  * with the resource. For information about how automatic mitigation works and the requirements for using it, see
213
216
  * <a href="https://docs.aws.amazon.com/waf/latest/developerguide/ddos-advanced-automatic-app-layer-response.html">Shield Advanced automatic application layer DDoS mitigation</a>.</p>
214
- * <p>Don't use this action to make changes to automatic mitigation settings when it's already enabled for a resource. Instead, use <a>UpdateApplicationLayerAutomaticResponse</a>.</p>
217
+ * <note>
218
+ * <p>Don't use this action to make changes to automatic mitigation settings when it's already enabled for a resource. Instead, use <a>UpdateApplicationLayerAutomaticResponse</a>.</p>
219
+ * </note>
215
220
  * <p>To use this feature, you must associate a web ACL with the protected resource. The web ACL must be created using the latest version of WAF (v2). You can associate the web ACL through the Shield Advanced console
216
221
  * at <a href="https://console.aws.amazon.com/wafv2/shieldv2#/">https://console.aws.amazon.com/wafv2/shieldv2#/</a>. For more information,
217
- * see <a href="https://docs.aws.amazon.com/waf/latest/developerguide/getting-started-ddos.html">Getting Started with Shield Advanced</a>.</p>
218
- * <p>You can also do this through the WAF console or the WAF API, but you must manage Shield Advanced automatic mitigation through Shield Advanced. For information about WAF, see
222
+ * see <a href="https://docs.aws.amazon.com/waf/latest/developerguide/getting-started-ddos.html">Getting Started with Shield Advanced</a>. You can also associate the web ACL to the resource through the WAF console or the WAF API, but you must manage Shield Advanced automatic mitigation through Shield Advanced. For information about WAF, see
219
223
  * <a href="https://docs.aws.amazon.com/waf/latest/developerguide/">WAF Developer Guide</a>.</p>
220
224
  */
221
225
  enableApplicationLayerAutomaticResponse(args: EnableApplicationLayerAutomaticResponseCommandInput, options?: __HttpHandlerOptions): Promise<EnableApplicationLayerAutomaticResponseCommandOutput>;
@@ -241,13 +245,15 @@ export declare class Shield extends ShieldClient {
241
245
  listAttacks(args: ListAttacksCommandInput, cb: (err: any, data?: ListAttacksCommandOutput) => void): void;
242
246
  listAttacks(args: ListAttacksCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ListAttacksCommandOutput) => void): void;
243
247
  /**
244
- * <p>Retrieves the <a>ProtectionGroup</a> objects for the account.</p>
248
+ * <p>Retrieves <a>ProtectionGroup</a> objects for the account. You can retrieve all protection groups or you can provide
249
+ * filtering criteria and retrieve just the subset of protection groups that match the criteria. </p>
245
250
  */
246
251
  listProtectionGroups(args: ListProtectionGroupsCommandInput, options?: __HttpHandlerOptions): Promise<ListProtectionGroupsCommandOutput>;
247
252
  listProtectionGroups(args: ListProtectionGroupsCommandInput, cb: (err: any, data?: ListProtectionGroupsCommandOutput) => void): void;
248
253
  listProtectionGroups(args: ListProtectionGroupsCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ListProtectionGroupsCommandOutput) => void): void;
249
254
  /**
250
- * <p>Lists all <a>Protection</a> objects for the account.</p>
255
+ * <p>Retrieves <a>Protection</a> objects for the account. You can retrieve all protections or you can provide
256
+ * filtering criteria and retrieve just the subset of protections that match the criteria. </p>
251
257
  */
252
258
  listProtections(args: ListProtectionsCommandInput, options?: __HttpHandlerOptions): Promise<ListProtectionsCommandOutput>;
253
259
  listProtections(args: ListProtectionsCommandInput, cb: (err: any, data?: ListProtectionsCommandOutput) => void): void;
@@ -296,6 +302,10 @@ export declare class Shield extends ShieldClient {
296
302
  updateProtectionGroup(args: UpdateProtectionGroupCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: UpdateProtectionGroupCommandOutput) => void): void;
297
303
  /**
298
304
  * <p>Updates the details of an existing subscription. Only enter values for parameters you want to change. Empty parameters are not updated.</p>
305
+ * <note>
306
+ * <p>For accounts that are members of an Organizations organization, Shield Advanced subscriptions are billed against the organization's payer account,
307
+ * regardless of whether the payer account itself is subscribed. </p>
308
+ * </note>
299
309
  */
300
310
  updateSubscription(args: UpdateSubscriptionCommandInput, options?: __HttpHandlerOptions): Promise<UpdateSubscriptionCommandOutput>;
301
311
  updateSubscription(args: UpdateSubscriptionCommandInput, cb: (err: any, data?: UpdateSubscriptionCommandOutput) => void): void;
@@ -8,7 +8,7 @@ export interface AssociateDRTLogBucketCommandOutput extends AssociateDRTLogBucke
8
8
  }
9
9
  /**
10
10
  * <p>Authorizes the Shield Response Team (SRT) to access the specified Amazon S3 bucket containing log data such as Application Load Balancer access logs, CloudFront logs, or logs from third party sources. You can associate up to 10 Amazon S3 buckets with your subscription.</p>
11
- * <p>To use the services of the SRT and make an <code>AssociateDRTLogBucket</code> request, you must be subscribed to the <a href="https://docs.aws.amazon.com/premiumsupport/business-support/">Business Support plan</a> or the <a href="https://docs.aws.amazon.com/premiumsupport/enterprise-support/">Enterprise Support plan</a>.</p>
11
+ * <p>To use the services of the SRT and make an <code>AssociateDRTLogBucket</code> request, you must be subscribed to the <a href="http://aws.amazon.com/premiumsupport/business-support/">Business Support plan</a> or the <a href="http://aws.amazon.com/premiumsupport/enterprise-support/">Enterprise Support plan</a>.</p>
12
12
  * @example
13
13
  * Use a bare-bones client and the command you need to make an API call.
14
14
  * ```javascript
@@ -14,7 +14,7 @@ export interface AssociateDRTRoleCommandOutput extends AssociateDRTRoleResponse,
14
14
  *
15
15
  * <p>The SRT will have access only to your WAF and Shield resources. By submitting this request, you authorize the SRT to inspect your WAF and Shield configuration and create and update WAF rules and web ACLs on your behalf. The SRT takes these actions only if explicitly authorized by you.</p>
16
16
  * <p>You must have the <code>iam:PassRole</code> permission to make an <code>AssociateDRTRole</code> request. 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>
17
- * <p>To use the services of the SRT and make an <code>AssociateDRTRole</code> request, you must be subscribed to the <a href="https://docs.aws.amazon.com/premiumsupport/business-support/">Business Support plan</a> or the <a href="https://docs.aws.amazon.com/premiumsupport/enterprise-support/">Enterprise Support plan</a>.</p>
17
+ * <p>To use the services of the SRT and make an <code>AssociateDRTRole</code> request, you must be subscribed to the <a href="http://aws.amazon.com/premiumsupport/business-support/">Business Support plan</a> or the <a href="http://aws.amazon.com/premiumsupport/enterprise-support/">Enterprise Support plan</a>.</p>
18
18
  * @example
19
19
  * Use a bare-bones client and the command you need to make an API call.
20
20
  * ```javascript
@@ -7,7 +7,7 @@ export interface CreateProtectionCommandInput extends CreateProtectionRequest {
7
7
  export interface CreateProtectionCommandOutput extends CreateProtectionResponse, __MetadataBearer {
8
8
  }
9
9
  /**
10
- * <p>Enables Shield Advanced for a specific Amazon Web Services resource. The resource can be an Amazon CloudFront distribution, Elastic Load Balancing load balancer, Global Accelerator accelerator, Elastic IP Address, or an Amazon Route 53 hosted zone.</p>
10
+ * <p>Enables Shield Advanced for a specific Amazon Web Services resource. The resource can be an Amazon CloudFront distribution, Amazon Route 53 hosted zone, Global Accelerator standard accelerator, Elastic IP Address, Application Load Balancer, or a Classic Load Balancer. You can protect Amazon EC2 instances and Network Load Balancers by association with protected Amazon EC2 Elastic IP addresses.</p>
11
11
  * <p>You can add protection to only a single resource with each <code>CreateProtection</code> request. You can add protection to multiple resources
12
12
  * at once through the Shield Advanced console at <a href="https://console.aws.amazon.com/wafv2/shieldv2#/">https://console.aws.amazon.com/wafv2/shieldv2#/</a>.
13
13
  * For more information see
@@ -8,8 +8,11 @@ export interface CreateSubscriptionCommandOutput extends CreateSubscriptionRespo
8
8
  }
9
9
  /**
10
10
  * <p>Activates Shield Advanced for an account.</p>
11
- *
12
- * <p>When you initally create a subscription, your subscription is set to be automatically renewed at the end of the existing subscription period. You can change this by submitting an <code>UpdateSubscription</code> request. </p>
11
+ * <note>
12
+ * <p>For accounts that are members of an Organizations organization, Shield Advanced subscriptions are billed against the organization's payer account,
13
+ * regardless of whether the payer account itself is subscribed. </p>
14
+ * </note>
15
+ * <p>When you initially create a subscription, your subscription is set to be automatically renewed at the end of the existing subscription period. You can change this by submitting an <code>UpdateSubscription</code> request. </p>
13
16
  * @example
14
17
  * Use a bare-bones client and the command you need to make an API call.
15
18
  * ```javascript
@@ -7,7 +7,7 @@ export interface DisableApplicationLayerAutomaticResponseCommandInput extends Di
7
7
  export interface DisableApplicationLayerAutomaticResponseCommandOutput extends DisableApplicationLayerAutomaticResponseResponse, __MetadataBearer {
8
8
  }
9
9
  /**
10
- * <p>Disable the Shield Advanced automatic application layer DDoS mitigation feature for the resource. This
10
+ * <p>Disable the Shield Advanced automatic application layer DDoS mitigation feature for the protected resource. This
11
11
  * stops Shield Advanced from creating, verifying, and applying WAF rules for attacks that it detects for the resource. </p>
12
12
  * @example
13
13
  * Use a bare-bones client and the command you need to make an API call.
@@ -7,19 +7,20 @@ export interface EnableApplicationLayerAutomaticResponseCommandInput extends Ena
7
7
  export interface EnableApplicationLayerAutomaticResponseCommandOutput extends EnableApplicationLayerAutomaticResponseResponse, __MetadataBearer {
8
8
  }
9
9
  /**
10
- * <p>Enable the Shield Advanced automatic application layer DDoS mitigation for the resource. </p>
10
+ * <p>Enable the Shield Advanced automatic application layer DDoS mitigation for the protected resource. </p>
11
11
  * <note>
12
- * <p>This feature is available for Amazon CloudFront distributions only.</p>
12
+ * <p>This feature is available for Amazon CloudFront distributions and Application Load Balancers only.</p>
13
13
  * </note>
14
14
  * <p>This causes Shield Advanced to create, verify, and apply WAF rules for DDoS attacks that it detects for the
15
15
  * resource. Shield Advanced applies the rules in a Shield rule group inside the web ACL that you've associated
16
16
  * with the resource. For information about how automatic mitigation works and the requirements for using it, see
17
17
  * <a href="https://docs.aws.amazon.com/waf/latest/developerguide/ddos-advanced-automatic-app-layer-response.html">Shield Advanced automatic application layer DDoS mitigation</a>.</p>
18
- * <p>Don't use this action to make changes to automatic mitigation settings when it's already enabled for a resource. Instead, use <a>UpdateApplicationLayerAutomaticResponse</a>.</p>
18
+ * <note>
19
+ * <p>Don't use this action to make changes to automatic mitigation settings when it's already enabled for a resource. Instead, use <a>UpdateApplicationLayerAutomaticResponse</a>.</p>
20
+ * </note>
19
21
  * <p>To use this feature, you must associate a web ACL with the protected resource. The web ACL must be created using the latest version of WAF (v2). You can associate the web ACL through the Shield Advanced console
20
22
  * at <a href="https://console.aws.amazon.com/wafv2/shieldv2#/">https://console.aws.amazon.com/wafv2/shieldv2#/</a>. For more information,
21
- * see <a href="https://docs.aws.amazon.com/waf/latest/developerguide/getting-started-ddos.html">Getting Started with Shield Advanced</a>.</p>
22
- * <p>You can also do this through the WAF console or the WAF API, but you must manage Shield Advanced automatic mitigation through Shield Advanced. For information about WAF, see
23
+ * see <a href="https://docs.aws.amazon.com/waf/latest/developerguide/getting-started-ddos.html">Getting Started with Shield Advanced</a>. You can also associate the web ACL to the resource through the WAF console or the WAF API, but you must manage Shield Advanced automatic mitigation through Shield Advanced. For information about WAF, see
23
24
  * <a href="https://docs.aws.amazon.com/waf/latest/developerguide/">WAF Developer Guide</a>.</p>
24
25
  * @example
25
26
  * Use a bare-bones client and the command you need to make an API call.
@@ -7,7 +7,8 @@ export interface ListProtectionGroupsCommandInput extends ListProtectionGroupsRe
7
7
  export interface ListProtectionGroupsCommandOutput extends ListProtectionGroupsResponse, __MetadataBearer {
8
8
  }
9
9
  /**
10
- * <p>Retrieves the <a>ProtectionGroup</a> objects for the account.</p>
10
+ * <p>Retrieves <a>ProtectionGroup</a> objects for the account. You can retrieve all protection groups or you can provide
11
+ * filtering criteria and retrieve just the subset of protection groups that match the criteria. </p>
11
12
  * @example
12
13
  * Use a bare-bones client and the command you need to make an API call.
13
14
  * ```javascript
@@ -7,7 +7,8 @@ export interface ListProtectionsCommandInput extends ListProtectionsRequest {
7
7
  export interface ListProtectionsCommandOutput extends ListProtectionsResponse, __MetadataBearer {
8
8
  }
9
9
  /**
10
- * <p>Lists all <a>Protection</a> objects for the account.</p>
10
+ * <p>Retrieves <a>Protection</a> objects for the account. You can retrieve all protections or you can provide
11
+ * filtering criteria and retrieve just the subset of protections that match the criteria. </p>
11
12
  * @example
12
13
  * Use a bare-bones client and the command you need to make an API call.
13
14
  * ```javascript
@@ -8,6 +8,10 @@ export interface UpdateSubscriptionCommandOutput extends UpdateSubscriptionRespo
8
8
  }
9
9
  /**
10
10
  * <p>Updates the details of an existing subscription. Only enter values for parameters you want to change. Empty parameters are not updated.</p>
11
+ * <note>
12
+ * <p>For accounts that are members of an Organizations organization, Shield Advanced subscriptions are billed against the organization's payer account,
13
+ * regardless of whether the payer account itself is subscribed. </p>
14
+ * </note>
11
15
  * @example
12
16
  * Use a bare-bones client and the command you need to make an API call.
13
17
  * ```javascript