@aws-sdk/client-shield 3.40.0 → 3.44.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 (67) hide show
  1. package/CHANGELOG.md +38 -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 +8 -0
  8. package/dist-cjs/models/models_0.js +74 -9
  9. package/dist-cjs/protocols/Aws_json1_1.js +363 -2
  10. package/dist-es/Shield.js +45 -0
  11. package/dist-es/commands/DisableApplicationLayerAutomaticResponseCommand.js +39 -0
  12. package/dist-es/commands/EnableApplicationLayerAutomaticResponseCommand.js +39 -0
  13. package/dist-es/commands/UpdateApplicationLayerAutomaticResponseCommand.js +39 -0
  14. package/dist-es/commands/index.js +3 -0
  15. package/dist-es/endpoints.js +8 -0
  16. package/dist-es/models/models_0.js +49 -4
  17. package/dist-es/protocols/Aws_json1_1.js +430 -50
  18. package/dist-types/Shield.d.ts +50 -12
  19. package/dist-types/ShieldClient.d.ts +5 -2
  20. package/dist-types/commands/AssociateDRTLogBucketCommand.d.ts +2 -2
  21. package/dist-types/commands/AssociateDRTRoleCommand.d.ts +5 -4
  22. package/dist-types/commands/AssociateHealthCheckCommand.d.ts +3 -3
  23. package/dist-types/commands/AssociateProactiveEngagementDetailsCommand.d.ts +1 -1
  24. package/dist-types/commands/CreateProtectionCommand.d.ts +7 -3
  25. package/dist-types/commands/CreateProtectionGroupCommand.d.ts +1 -1
  26. package/dist-types/commands/CreateSubscriptionCommand.d.ts +1 -1
  27. package/dist-types/commands/DeleteProtectionCommand.d.ts +1 -1
  28. package/dist-types/commands/DeleteProtectionGroupCommand.d.ts +1 -1
  29. package/dist-types/commands/DeleteSubscriptionCommand.d.ts +1 -1
  30. package/dist-types/commands/DescribeAttackCommand.d.ts +1 -1
  31. package/dist-types/commands/DescribeAttackStatisticsCommand.d.ts +1 -1
  32. package/dist-types/commands/DescribeDRTAccessCommand.d.ts +1 -1
  33. package/dist-types/commands/DescribeEmergencyContactSettingsCommand.d.ts +1 -1
  34. package/dist-types/commands/DescribeProtectionCommand.d.ts +1 -1
  35. package/dist-types/commands/DescribeProtectionGroupCommand.d.ts +1 -1
  36. package/dist-types/commands/DescribeSubscriptionCommand.d.ts +1 -1
  37. package/dist-types/commands/DisableApplicationLayerAutomaticResponseCommand.d.ts +36 -0
  38. package/dist-types/commands/DisableProactiveEngagementCommand.d.ts +1 -1
  39. package/dist-types/commands/DisassociateDRTLogBucketCommand.d.ts +1 -2
  40. package/dist-types/commands/DisassociateDRTRoleCommand.d.ts +1 -2
  41. package/dist-types/commands/DisassociateHealthCheckCommand.d.ts +3 -3
  42. package/dist-types/commands/EnableApplicationLayerAutomaticResponseCommand.d.ts +48 -0
  43. package/dist-types/commands/EnableProactiveEngagementCommand.d.ts +1 -1
  44. package/dist-types/commands/GetSubscriptionStateCommand.d.ts +1 -1
  45. package/dist-types/commands/ListAttacksCommand.d.ts +1 -1
  46. package/dist-types/commands/ListProtectionGroupsCommand.d.ts +1 -1
  47. package/dist-types/commands/ListProtectionsCommand.d.ts +1 -1
  48. package/dist-types/commands/ListResourcesInProtectionGroupCommand.d.ts +1 -1
  49. package/dist-types/commands/ListTagsForResourceCommand.d.ts +1 -1
  50. package/dist-types/commands/TagResourceCommand.d.ts +1 -1
  51. package/dist-types/commands/UntagResourceCommand.d.ts +1 -1
  52. package/dist-types/commands/UpdateApplicationLayerAutomaticResponseCommand.d.ts +35 -0
  53. package/dist-types/commands/UpdateEmergencyContactSettingsCommand.d.ts +1 -1
  54. package/dist-types/commands/UpdateProtectionGroupCommand.d.ts +1 -1
  55. package/dist-types/commands/UpdateSubscriptionCommand.d.ts +1 -1
  56. package/dist-types/commands/index.d.ts +3 -0
  57. package/dist-types/models/models_0.d.ts +260 -60
  58. package/dist-types/protocols/Aws_json1_1.d.ts +9 -0
  59. package/dist-types/ts3.4/Shield.d.ts +15 -0
  60. package/dist-types/ts3.4/ShieldClient.d.ts +5 -2
  61. package/dist-types/ts3.4/commands/DisableApplicationLayerAutomaticResponseCommand.d.ts +17 -0
  62. package/dist-types/ts3.4/commands/EnableApplicationLayerAutomaticResponseCommand.d.ts +17 -0
  63. package/dist-types/ts3.4/commands/UpdateApplicationLayerAutomaticResponseCommand.d.ts +17 -0
  64. package/dist-types/ts3.4/commands/index.d.ts +3 -0
  65. package/dist-types/ts3.4/models/models_0.d.ts +98 -10
  66. package/dist-types/ts3.4/protocols/Aws_json1_1.d.ts +9 -0
  67. package/package.json +4 -4
@@ -0,0 +1,48 @@
1
+ import { Command as $Command } from "@aws-sdk/smithy-client";
2
+ import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@aws-sdk/types";
3
+ import { EnableApplicationLayerAutomaticResponseRequest, EnableApplicationLayerAutomaticResponseResponse } from "../models/models_0";
4
+ import { ServiceInputTypes, ServiceOutputTypes, ShieldClientResolvedConfig } from "../ShieldClient";
5
+ export interface EnableApplicationLayerAutomaticResponseCommandInput extends EnableApplicationLayerAutomaticResponseRequest {
6
+ }
7
+ export interface EnableApplicationLayerAutomaticResponseCommandOutput extends EnableApplicationLayerAutomaticResponseResponse, __MetadataBearer {
8
+ }
9
+ /**
10
+ * <p>Enable the Shield Advanced automatic application layer DDoS mitigation for the resource. </p>
11
+ * <note>
12
+ * <p>This feature is available for Amazon CloudFront distributions only.</p>
13
+ * </note>
14
+ * <p>This causes Shield Advanced to create, verify, and apply WAF rules for DDoS attacks that it detects for the
15
+ * resource. Shield Advanced applies the rules in a Shield rule group inside the web ACL that you've associated
16
+ * with the resource. For information about how automatic mitigation works and the requirements for using it, see
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>
19
+ * <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
+ * 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
+ * <a href="https://docs.aws.amazon.com/waf/latest/developerguide/">WAF Developer Guide</a>.</p>
24
+ * @example
25
+ * Use a bare-bones client and the command you need to make an API call.
26
+ * ```javascript
27
+ * import { ShieldClient, EnableApplicationLayerAutomaticResponseCommand } from "@aws-sdk/client-shield"; // ES Modules import
28
+ * // const { ShieldClient, EnableApplicationLayerAutomaticResponseCommand } = require("@aws-sdk/client-shield"); // CommonJS import
29
+ * const client = new ShieldClient(config);
30
+ * const command = new EnableApplicationLayerAutomaticResponseCommand(input);
31
+ * const response = await client.send(command);
32
+ * ```
33
+ *
34
+ * @see {@link EnableApplicationLayerAutomaticResponseCommandInput} for command's `input` shape.
35
+ * @see {@link EnableApplicationLayerAutomaticResponseCommandOutput} for command's `response` shape.
36
+ * @see {@link ShieldClientResolvedConfig | config} for ShieldClient's `config` shape.
37
+ *
38
+ */
39
+ export declare class EnableApplicationLayerAutomaticResponseCommand extends $Command<EnableApplicationLayerAutomaticResponseCommandInput, EnableApplicationLayerAutomaticResponseCommandOutput, ShieldClientResolvedConfig> {
40
+ readonly input: EnableApplicationLayerAutomaticResponseCommandInput;
41
+ constructor(input: EnableApplicationLayerAutomaticResponseCommandInput);
42
+ /**
43
+ * @internal
44
+ */
45
+ resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: ShieldClientResolvedConfig, options?: __HttpHandlerOptions): Handler<EnableApplicationLayerAutomaticResponseCommandInput, EnableApplicationLayerAutomaticResponseCommandOutput>;
46
+ private serialize;
47
+ private deserialize;
48
+ }
@@ -20,7 +20,7 @@ export interface EnableProactiveEngagementCommandOutput extends EnableProactiveE
20
20
  *
21
21
  * @see {@link EnableProactiveEngagementCommandInput} for command's `input` shape.
22
22
  * @see {@link EnableProactiveEngagementCommandOutput} for command's `response` shape.
23
- * @see {@link ShieldClientResolvedConfig | config} for command's `input` shape.
23
+ * @see {@link ShieldClientResolvedConfig | config} for ShieldClient's `config` shape.
24
24
  *
25
25
  */
26
26
  export declare class EnableProactiveEngagementCommand extends $Command<EnableProactiveEngagementCommandInput, EnableProactiveEngagementCommandOutput, ShieldClientResolvedConfig> {
@@ -20,7 +20,7 @@ export interface GetSubscriptionStateCommandOutput extends GetSubscriptionStateR
20
20
  *
21
21
  * @see {@link GetSubscriptionStateCommandInput} for command's `input` shape.
22
22
  * @see {@link GetSubscriptionStateCommandOutput} for command's `response` shape.
23
- * @see {@link ShieldClientResolvedConfig | config} for command's `input` shape.
23
+ * @see {@link ShieldClientResolvedConfig | config} for ShieldClient's `config` shape.
24
24
  *
25
25
  */
26
26
  export declare class GetSubscriptionStateCommand extends $Command<GetSubscriptionStateCommandInput, GetSubscriptionStateCommandOutput, ShieldClientResolvedConfig> {
@@ -21,7 +21,7 @@ export interface ListAttacksCommandOutput extends ListAttacksResponse, __Metadat
21
21
  *
22
22
  * @see {@link ListAttacksCommandInput} for command's `input` shape.
23
23
  * @see {@link ListAttacksCommandOutput} for command's `response` shape.
24
- * @see {@link ShieldClientResolvedConfig | config} for command's `input` shape.
24
+ * @see {@link ShieldClientResolvedConfig | config} for ShieldClient's `config` shape.
25
25
  *
26
26
  */
27
27
  export declare class ListAttacksCommand extends $Command<ListAttacksCommandInput, ListAttacksCommandOutput, ShieldClientResolvedConfig> {
@@ -20,7 +20,7 @@ export interface ListProtectionGroupsCommandOutput extends ListProtectionGroupsR
20
20
  *
21
21
  * @see {@link ListProtectionGroupsCommandInput} for command's `input` shape.
22
22
  * @see {@link ListProtectionGroupsCommandOutput} for command's `response` shape.
23
- * @see {@link ShieldClientResolvedConfig | config} for command's `input` shape.
23
+ * @see {@link ShieldClientResolvedConfig | config} for ShieldClient's `config` shape.
24
24
  *
25
25
  */
26
26
  export declare class ListProtectionGroupsCommand extends $Command<ListProtectionGroupsCommandInput, ListProtectionGroupsCommandOutput, ShieldClientResolvedConfig> {
@@ -20,7 +20,7 @@ export interface ListProtectionsCommandOutput extends ListProtectionsResponse, _
20
20
  *
21
21
  * @see {@link ListProtectionsCommandInput} for command's `input` shape.
22
22
  * @see {@link ListProtectionsCommandOutput} for command's `response` shape.
23
- * @see {@link ShieldClientResolvedConfig | config} for command's `input` shape.
23
+ * @see {@link ShieldClientResolvedConfig | config} for ShieldClient's `config` shape.
24
24
  *
25
25
  */
26
26
  export declare class ListProtectionsCommand extends $Command<ListProtectionsCommandInput, ListProtectionsCommandOutput, ShieldClientResolvedConfig> {
@@ -20,7 +20,7 @@ export interface ListResourcesInProtectionGroupCommandOutput extends ListResourc
20
20
  *
21
21
  * @see {@link ListResourcesInProtectionGroupCommandInput} for command's `input` shape.
22
22
  * @see {@link ListResourcesInProtectionGroupCommandOutput} for command's `response` shape.
23
- * @see {@link ShieldClientResolvedConfig | config} for command's `input` shape.
23
+ * @see {@link ShieldClientResolvedConfig | config} for ShieldClient's `config` shape.
24
24
  *
25
25
  */
26
26
  export declare class ListResourcesInProtectionGroupCommand extends $Command<ListResourcesInProtectionGroupCommandInput, ListResourcesInProtectionGroupCommandOutput, ShieldClientResolvedConfig> {
@@ -20,7 +20,7 @@ export interface ListTagsForResourceCommandOutput extends ListTagsForResourceRes
20
20
  *
21
21
  * @see {@link ListTagsForResourceCommandInput} for command's `input` shape.
22
22
  * @see {@link ListTagsForResourceCommandOutput} for command's `response` shape.
23
- * @see {@link ShieldClientResolvedConfig | config} for command's `input` shape.
23
+ * @see {@link ShieldClientResolvedConfig | config} for ShieldClient's `config` shape.
24
24
  *
25
25
  */
26
26
  export declare class ListTagsForResourceCommand extends $Command<ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, ShieldClientResolvedConfig> {
@@ -20,7 +20,7 @@ export interface TagResourceCommandOutput extends TagResourceResponse, __Metadat
20
20
  *
21
21
  * @see {@link TagResourceCommandInput} for command's `input` shape.
22
22
  * @see {@link TagResourceCommandOutput} for command's `response` shape.
23
- * @see {@link ShieldClientResolvedConfig | config} for command's `input` shape.
23
+ * @see {@link ShieldClientResolvedConfig | config} for ShieldClient's `config` shape.
24
24
  *
25
25
  */
26
26
  export declare class TagResourceCommand extends $Command<TagResourceCommandInput, TagResourceCommandOutput, ShieldClientResolvedConfig> {
@@ -20,7 +20,7 @@ export interface UntagResourceCommandOutput extends UntagResourceResponse, __Met
20
20
  *
21
21
  * @see {@link UntagResourceCommandInput} for command's `input` shape.
22
22
  * @see {@link UntagResourceCommandOutput} for command's `response` shape.
23
- * @see {@link ShieldClientResolvedConfig | config} for command's `input` shape.
23
+ * @see {@link ShieldClientResolvedConfig | config} for ShieldClient's `config` shape.
24
24
  *
25
25
  */
26
26
  export declare class UntagResourceCommand extends $Command<UntagResourceCommandInput, UntagResourceCommandOutput, ShieldClientResolvedConfig> {
@@ -0,0 +1,35 @@
1
+ import { Command as $Command } from "@aws-sdk/smithy-client";
2
+ import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@aws-sdk/types";
3
+ import { UpdateApplicationLayerAutomaticResponseRequest, UpdateApplicationLayerAutomaticResponseResponse } from "../models/models_0";
4
+ import { ServiceInputTypes, ServiceOutputTypes, ShieldClientResolvedConfig } from "../ShieldClient";
5
+ export interface UpdateApplicationLayerAutomaticResponseCommandInput extends UpdateApplicationLayerAutomaticResponseRequest {
6
+ }
7
+ export interface UpdateApplicationLayerAutomaticResponseCommandOutput extends UpdateApplicationLayerAutomaticResponseResponse, __MetadataBearer {
8
+ }
9
+ /**
10
+ * <p>Updates an existing Shield Advanced automatic application layer DDoS mitigation configuration for the specified resource.</p>
11
+ * @example
12
+ * Use a bare-bones client and the command you need to make an API call.
13
+ * ```javascript
14
+ * import { ShieldClient, UpdateApplicationLayerAutomaticResponseCommand } from "@aws-sdk/client-shield"; // ES Modules import
15
+ * // const { ShieldClient, UpdateApplicationLayerAutomaticResponseCommand } = require("@aws-sdk/client-shield"); // CommonJS import
16
+ * const client = new ShieldClient(config);
17
+ * const command = new UpdateApplicationLayerAutomaticResponseCommand(input);
18
+ * const response = await client.send(command);
19
+ * ```
20
+ *
21
+ * @see {@link UpdateApplicationLayerAutomaticResponseCommandInput} for command's `input` shape.
22
+ * @see {@link UpdateApplicationLayerAutomaticResponseCommandOutput} for command's `response` shape.
23
+ * @see {@link ShieldClientResolvedConfig | config} for ShieldClient's `config` shape.
24
+ *
25
+ */
26
+ export declare class UpdateApplicationLayerAutomaticResponseCommand extends $Command<UpdateApplicationLayerAutomaticResponseCommandInput, UpdateApplicationLayerAutomaticResponseCommandOutput, ShieldClientResolvedConfig> {
27
+ readonly input: UpdateApplicationLayerAutomaticResponseCommandInput;
28
+ constructor(input: UpdateApplicationLayerAutomaticResponseCommandInput);
29
+ /**
30
+ * @internal
31
+ */
32
+ resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: ShieldClientResolvedConfig, options?: __HttpHandlerOptions): Handler<UpdateApplicationLayerAutomaticResponseCommandInput, UpdateApplicationLayerAutomaticResponseCommandOutput>;
33
+ private serialize;
34
+ private deserialize;
35
+ }
@@ -20,7 +20,7 @@ export interface UpdateEmergencyContactSettingsCommandOutput extends UpdateEmerg
20
20
  *
21
21
  * @see {@link UpdateEmergencyContactSettingsCommandInput} for command's `input` shape.
22
22
  * @see {@link UpdateEmergencyContactSettingsCommandOutput} for command's `response` shape.
23
- * @see {@link ShieldClientResolvedConfig | config} for command's `input` shape.
23
+ * @see {@link ShieldClientResolvedConfig | config} for ShieldClient's `config` shape.
24
24
  *
25
25
  */
26
26
  export declare class UpdateEmergencyContactSettingsCommand extends $Command<UpdateEmergencyContactSettingsCommandInput, UpdateEmergencyContactSettingsCommandOutput, ShieldClientResolvedConfig> {
@@ -20,7 +20,7 @@ export interface UpdateProtectionGroupCommandOutput extends UpdateProtectionGrou
20
20
  *
21
21
  * @see {@link UpdateProtectionGroupCommandInput} for command's `input` shape.
22
22
  * @see {@link UpdateProtectionGroupCommandOutput} for command's `response` shape.
23
- * @see {@link ShieldClientResolvedConfig | config} for command's `input` shape.
23
+ * @see {@link ShieldClientResolvedConfig | config} for ShieldClient's `config` shape.
24
24
  *
25
25
  */
26
26
  export declare class UpdateProtectionGroupCommand extends $Command<UpdateProtectionGroupCommandInput, UpdateProtectionGroupCommandOutput, ShieldClientResolvedConfig> {
@@ -20,7 +20,7 @@ export interface UpdateSubscriptionCommandOutput extends UpdateSubscriptionRespo
20
20
  *
21
21
  * @see {@link UpdateSubscriptionCommandInput} for command's `input` shape.
22
22
  * @see {@link UpdateSubscriptionCommandOutput} for command's `response` shape.
23
- * @see {@link ShieldClientResolvedConfig | config} for command's `input` shape.
23
+ * @see {@link ShieldClientResolvedConfig | config} for ShieldClient's `config` shape.
24
24
  *
25
25
  */
26
26
  export declare class UpdateSubscriptionCommand extends $Command<UpdateSubscriptionCommandInput, UpdateSubscriptionCommandOutput, ShieldClientResolvedConfig> {
@@ -15,10 +15,12 @@ export * from "./DescribeEmergencyContactSettingsCommand";
15
15
  export * from "./DescribeProtectionCommand";
16
16
  export * from "./DescribeProtectionGroupCommand";
17
17
  export * from "./DescribeSubscriptionCommand";
18
+ export * from "./DisableApplicationLayerAutomaticResponseCommand";
18
19
  export * from "./DisableProactiveEngagementCommand";
19
20
  export * from "./DisassociateDRTLogBucketCommand";
20
21
  export * from "./DisassociateDRTRoleCommand";
21
22
  export * from "./DisassociateHealthCheckCommand";
23
+ export * from "./EnableApplicationLayerAutomaticResponseCommand";
22
24
  export * from "./EnableProactiveEngagementCommand";
23
25
  export * from "./GetSubscriptionStateCommand";
24
26
  export * from "./ListAttacksCommand";
@@ -28,6 +30,7 @@ export * from "./ListResourcesInProtectionGroupCommand";
28
30
  export * from "./ListTagsForResourceCommand";
29
31
  export * from "./TagResourceCommand";
30
32
  export * from "./UntagResourceCommand";
33
+ export * from "./UpdateApplicationLayerAutomaticResponseCommand";
31
34
  export * from "./UpdateEmergencyContactSettingsCommand";
32
35
  export * from "./UpdateProtectionGroupCommand";
33
36
  export * from "./UpdateSubscriptionCommand";