AWS Identity and Access Management
User Guide

Actions, Resources, and Condition Keys for AWS Shield

AWS Shield (service prefix: shield) provides the following service-specific resources, actions, and condition context keys for use in IAM permission policies.

References:

Actions Defined by AWS Shield

You can specify the following actions in the Action element of an IAM policy statement. By using policies, you define the permissions for anyone performing an operation in AWS. When you use an action in a policy, you usually allow or deny access to the API operation or CLI command with the same name. However, in some cases, a single action controls access to more than one operation. Alternatively, some operations require several different actions. For details about the columns in the following table, see The Actions Table.

Actions Description Access Level Resource Types (*required) Condition Keys Dependent Actions
AssociateDRTLogBucket Authorizes the DDoS Response team to access the specified Amazon S3 bucket containing your flow logs Write

s3:GetBucketPolicy

s3:PutBucketPolicy

AssociateDRTRole Authorizes the DDoS Response team using the specified role, to access your AWS account to assist with DDoS attack mitigation during potential attacks Write

iam:GetRole

iam:ListAttachedRolePolicies

iam:PassRole

CreateProtection Activate DDoS protection service for a given resource ARN Write

protection*

CreateSubscription Activate subscription Write
DeleteProtection Delete an existing protection Write

protection*

DeleteSubscription Deactivate subscription Write
DescribeAttack Get attack details Read

attack*

DescribeDRTAccess Returns the current role and list of Amazon S3 log buckets used by the DDoS Response team to access your AWS account while assisting with attack mitigation Read
DescribeEmergencyContactSettings Lists the email addresses that the DRT can use to contact you during a suspected attack Read
DescribeProtection Get protection details Read

protection*

DescribeSubscription Get subscription details, such as start time Read
DisassociateDRTLogBucket Removes the DDoS Response team's access to the specified Amazon S3 bucket containing your flow logs Write

s3:DeleteBucketPolicy

s3:GetBucketPolicy

s3:PutBucketPolicy

DisassociateDRTRole Removes the DDoS Response team's access to your AWS account Write
GetSubscriptionState Get subscription state Read
ListAttacks List all existing attacks List
ListProtections List all existing protections List
UpdateEmergencyContactSettings Updates the details of the list of email addresses that the DRT can use to contact you during a suspected attack Write

Resources Defined by Shield

The following resource types are defined by this service and can be used in the Resource element of IAM permission policy statements. Each action in the Actions table identifies the resource types that can be specified with that action. A resource type can also define which condition keys you can include in a policy. These keys are displayed in the last column of the table. For details about the columns in the following table, see The Resource Types Table.

Resource Types ARN Condition Keys
attack arn:${Partition}:shield::${Account}:attack/${Id}
protection arn:${Partition}:shield::${Account}:protection/${Id}

Condition Keys for AWS Shield

Shield has no service-specific context keys that can be used in the Condition element of policy statements. For the list of the global context keys that are available to all services, see Available Keys for Conditions in the IAM Policy Reference.