@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.
- package/CHANGELOG.md +33 -0
- package/README.md +1 -1
- package/dist-cjs/commands/AssociateDRTLogBucketCommand.js +2 -2
- package/dist-cjs/commands/AssociateDRTRoleCommand.js +2 -2
- package/dist-cjs/commands/AssociateHealthCheckCommand.js +2 -2
- package/dist-cjs/commands/AssociateProactiveEngagementDetailsCommand.js +2 -2
- package/dist-cjs/commands/CreateProtectionCommand.js +2 -2
- package/dist-cjs/commands/CreateProtectionGroupCommand.js +2 -2
- package/dist-cjs/commands/CreateSubscriptionCommand.js +2 -2
- package/dist-cjs/commands/DeleteProtectionCommand.js +2 -2
- package/dist-cjs/commands/DeleteProtectionGroupCommand.js +2 -2
- package/dist-cjs/commands/DeleteSubscriptionCommand.js +2 -2
- package/dist-cjs/commands/DescribeAttackCommand.js +2 -2
- package/dist-cjs/commands/DescribeAttackStatisticsCommand.js +2 -2
- package/dist-cjs/commands/DescribeDRTAccessCommand.js +2 -2
- package/dist-cjs/commands/DescribeEmergencyContactSettingsCommand.js +2 -2
- package/dist-cjs/commands/DescribeProtectionCommand.js +2 -2
- package/dist-cjs/commands/DescribeProtectionGroupCommand.js +2 -2
- package/dist-cjs/commands/DescribeSubscriptionCommand.js +2 -2
- package/dist-cjs/commands/DisableApplicationLayerAutomaticResponseCommand.js +2 -2
- package/dist-cjs/commands/DisableProactiveEngagementCommand.js +2 -2
- package/dist-cjs/commands/DisassociateDRTLogBucketCommand.js +2 -2
- package/dist-cjs/commands/DisassociateDRTRoleCommand.js +2 -2
- package/dist-cjs/commands/DisassociateHealthCheckCommand.js +2 -2
- package/dist-cjs/commands/EnableApplicationLayerAutomaticResponseCommand.js +2 -2
- package/dist-cjs/commands/EnableProactiveEngagementCommand.js +2 -2
- package/dist-cjs/commands/GetSubscriptionStateCommand.js +2 -2
- package/dist-cjs/commands/ListAttacksCommand.js +2 -2
- package/dist-cjs/commands/ListProtectionGroupsCommand.js +2 -2
- package/dist-cjs/commands/ListProtectionsCommand.js +2 -2
- package/dist-cjs/commands/ListResourcesInProtectionGroupCommand.js +2 -2
- package/dist-cjs/commands/ListTagsForResourceCommand.js +2 -2
- package/dist-cjs/commands/TagResourceCommand.js +2 -2
- package/dist-cjs/commands/UntagResourceCommand.js +2 -2
- package/dist-cjs/commands/UpdateApplicationLayerAutomaticResponseCommand.js +2 -2
- package/dist-cjs/commands/UpdateEmergencyContactSettingsCommand.js +2 -2
- package/dist-cjs/commands/UpdateProtectionGroupCommand.js +2 -2
- package/dist-cjs/commands/UpdateSubscriptionCommand.js +2 -2
- package/dist-cjs/models/models_0.js +415 -609
- package/dist-cjs/protocols/Aws_json1_1.js +95 -0
- package/dist-es/commands/AssociateDRTLogBucketCommand.js +3 -3
- package/dist-es/commands/AssociateDRTRoleCommand.js +3 -3
- package/dist-es/commands/AssociateHealthCheckCommand.js +3 -3
- package/dist-es/commands/AssociateProactiveEngagementDetailsCommand.js +3 -3
- package/dist-es/commands/CreateProtectionCommand.js +3 -3
- package/dist-es/commands/CreateProtectionGroupCommand.js +3 -3
- package/dist-es/commands/CreateSubscriptionCommand.js +3 -3
- package/dist-es/commands/DeleteProtectionCommand.js +3 -3
- package/dist-es/commands/DeleteProtectionGroupCommand.js +3 -3
- package/dist-es/commands/DeleteSubscriptionCommand.js +3 -3
- package/dist-es/commands/DescribeAttackCommand.js +3 -3
- package/dist-es/commands/DescribeAttackStatisticsCommand.js +3 -3
- package/dist-es/commands/DescribeDRTAccessCommand.js +3 -3
- package/dist-es/commands/DescribeEmergencyContactSettingsCommand.js +3 -3
- package/dist-es/commands/DescribeProtectionCommand.js +3 -3
- package/dist-es/commands/DescribeProtectionGroupCommand.js +3 -3
- package/dist-es/commands/DescribeSubscriptionCommand.js +3 -3
- package/dist-es/commands/DisableApplicationLayerAutomaticResponseCommand.js +3 -3
- package/dist-es/commands/DisableProactiveEngagementCommand.js +3 -3
- package/dist-es/commands/DisassociateDRTLogBucketCommand.js +3 -3
- package/dist-es/commands/DisassociateDRTRoleCommand.js +3 -3
- package/dist-es/commands/DisassociateHealthCheckCommand.js +3 -3
- package/dist-es/commands/EnableApplicationLayerAutomaticResponseCommand.js +3 -3
- package/dist-es/commands/EnableProactiveEngagementCommand.js +3 -3
- package/dist-es/commands/GetSubscriptionStateCommand.js +3 -3
- package/dist-es/commands/ListAttacksCommand.js +3 -3
- package/dist-es/commands/ListProtectionGroupsCommand.js +3 -3
- package/dist-es/commands/ListProtectionsCommand.js +3 -3
- package/dist-es/commands/ListResourcesInProtectionGroupCommand.js +3 -3
- package/dist-es/commands/ListTagsForResourceCommand.js +3 -3
- package/dist-es/commands/TagResourceCommand.js +3 -3
- package/dist-es/commands/UntagResourceCommand.js +3 -3
- package/dist-es/commands/UpdateApplicationLayerAutomaticResponseCommand.js +3 -3
- package/dist-es/commands/UpdateEmergencyContactSettingsCommand.js +3 -3
- package/dist-es/commands/UpdateProtectionGroupCommand.js +3 -3
- package/dist-es/commands/UpdateSubscriptionCommand.js +3 -3
- package/dist-es/models/models_0.js +103 -404
- package/dist-es/protocols/Aws_json1_1.js +86 -2
- package/dist-types/Shield.d.ts +23 -13
- package/dist-types/commands/AssociateDRTLogBucketCommand.d.ts +1 -1
- package/dist-types/commands/AssociateDRTRoleCommand.d.ts +1 -1
- package/dist-types/commands/CreateProtectionCommand.d.ts +1 -1
- package/dist-types/commands/CreateSubscriptionCommand.d.ts +5 -2
- package/dist-types/commands/DisableApplicationLayerAutomaticResponseCommand.d.ts +1 -1
- package/dist-types/commands/EnableApplicationLayerAutomaticResponseCommand.d.ts +6 -5
- package/dist-types/commands/ListProtectionGroupsCommand.d.ts +2 -1
- package/dist-types/commands/ListProtectionsCommand.d.ts +2 -1
- package/dist-types/commands/UpdateSubscriptionCommand.d.ts +4 -0
- package/dist-types/models/models_0.d.ts +464 -612
- package/dist-types/ts3.4/models/models_0.d.ts +226 -400
- 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(
|
|
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(
|
|
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
|
};
|
package/dist-types/Shield.d.ts
CHANGED
|
@@ -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="
|
|
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="
|
|
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,
|
|
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
|
-
*
|
|
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
|
-
* <
|
|
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
|
|
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
|
|
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>
|
|
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="
|
|
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="
|
|
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,
|
|
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
|
-
*
|
|
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
|
-
* <
|
|
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
|
|
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
|
|
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>
|
|
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
|