# AWS::Shield Construct Library

---

![cfn-resources: Stable](https://img.shields.io/badge/cfn--resources-stable-success.svg?style=for-the-badge)

> All classes with the `Cfn` prefix in this module ([CFN Resources]) are always stable and safe to use.
>
> [CFN Resources]: https://docs.aws.amazon.com/cdk/latest/guide/constructs.html#constructs_lib

---

This module is part of the [AWS Cloud Development Kit](https://github.com/aws/aws-cdk) project.

```ts
import * as shield from 'aws-cdk-lib/aws-shield';
```

There are no official hand-written ([L2](https://docs.aws.amazon.com/cdk/latest/guide/constructs.html#constructs_lib)) constructs for this service yet. Here are some suggestions on how to proceed:

- Search [Construct Hub for Shield construct libraries](https://constructs.dev/search?q=shield)
- Use the automatically generated [L1](https://docs.aws.amazon.com/cdk/latest/guide/constructs.html#constructs_l1_using) constructs, in the same way you would use [the CloudFormation AWS::Shield resources](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/AWS_Shield.html) directly.

There are no hand-written ([L2](https://docs.aws.amazon.com/cdk/latest/guide/constructs.html#constructs_lib)) constructs for this service yet.
However, you can still use the automatically generated [L1](https://docs.aws.amazon.com/cdk/latest/guide/constructs.html#constructs_l1_using) constructs, and use this service exactly as you would using CloudFormation directly.

For more information on the resources and properties available for this service, see the [CloudFormation documentation for AWS::Shield](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/AWS_Shield.html).

(Read the [CDK Contributing Guide](https://github.com/aws/aws-cdk/blob/main/CONTRIBUTING.md) and submit an RFC if you are interested in contributing to this construct library.)

## Types

| Name | Kind | Summary |
| --- | --- | --- |
| [`CfnDRTAccess`](/v2/docs/aws-cdk-lib.aws_shield.CfnDRTAccess) | Construct (L1) | Provides permissions for the AWS Shield Advanced Shield response team (SRT) to access your account and your resource protections, to help you mitigate potential distributed denial of service (DDoS) attacks. |
| [`CfnProactiveEngagement`](/v2/docs/aws-cdk-lib.aws_shield.CfnProactiveEngagement) | Construct (L1) | Authorizes the Shield Response Team (SRT) to use email and phone to notify contacts about escalations to the SRT and to initiate proactive customer support. |
| [`CfnProtection`](/v2/docs/aws-cdk-lib.aws_shield.CfnProtection) | Construct (L1) | Enables AWS Shield Advanced for a specific AWS resource. |
| [`CfnProtectionGroup`](/v2/docs/aws-cdk-lib.aws_shield.CfnProtectionGroup) | Construct (L1) | Creates a grouping of protected resources so they can be handled as a collective. |
| [`CfnDRTAccessProps`](/v2/docs/aws-cdk-lib.aws_shield.CfnDRTAccessProps) | Struct | Properties for defining a `CfnDRTAccess`. |
| [`CfnProactiveEngagement.EmergencyContactProperty`](/v2/docs/aws-cdk-lib.aws_shield.CfnProactiveEngagement.EmergencyContactProperty) | Struct | Contact information that the SRT can use to contact you if you have proactive engagement enabled, for escalations to the SRT and to initiate proactive customer support. |
| [`CfnProactiveEngagementProps`](/v2/docs/aws-cdk-lib.aws_shield.CfnProactiveEngagementProps) | Struct | Properties for defining a `CfnProactiveEngagement`. |
| [`CfnProtection.ActionProperty`](/v2/docs/aws-cdk-lib.aws_shield.CfnProtection.ActionProperty) | Struct | Specifies the action setting that Shield Advanced should use in the AWS WAF rules that it creates on behalf of the protected resource in response to DDoS attacks. |
| [`CfnProtection.ApplicationLayerAutomaticResponseConfigurationProperty`](/v2/docs/aws-cdk-lib.aws_shield.CfnProtection.ApplicationLayerAutomaticResponseConfigurationProperty) | Struct | The automatic application layer DDoS mitigation settings for a `Protection` . |
| [`CfnProtectionGroupProps`](/v2/docs/aws-cdk-lib.aws_shield.CfnProtectionGroupProps) | Struct | Properties for defining a `CfnProtectionGroup`. |
| [`CfnProtectionProps`](/v2/docs/aws-cdk-lib.aws_shield.CfnProtectionProps) | Struct | Properties for defining a `CfnProtection`. |