An AWS tag is a key-value pair that holds metadata about resources, in this case Amazon S3 directory buckets. You can tag S3 directory buckets when you create them or manage tags on existing directory buckets. For general information about tags, see Tagging for cost allocation or attribute-based access control (ABAC).
NoteThere is no additional charge for using tags on directory buckets beyond the standard S3 API request rates. For more information, see Amazon S3 pricing.
Use tags on your S3 directory buckets for:
Cost allocation â Track storage costs by bucket tag in AWS Billing and Cost Management. For more information, see Using tags for ABAC.
Attribute-based access control (ABAC) â Scale access permissions and grant access to S3 directory buckets based on their tags. For more information, see Using tags for ABAC.
You can use the same tags for both cost allocation and access control.
ABAC for S3 directory bucketsAmazon S3 directory buckets support attribute-based access control (ABAC) using tags. Use tag-based condition keys in your AWS organizations, IAM, and S3 directory bucket policies. For enterprises, ABAC in Amazon S3 supports authorization across multiple AWS accounts.
In your IAM policies, you can control access to S3 directory buckets based on the bucket's tags by using the following global condition keys:
aws:ResourceTag/key-name
Use this key to compare the tag key-value pair that you specify in the policy with the key-value pair attached to the resource. For example, you could require that access to a resource is allowed only if the resource has the attached tag key Dept
with the value Marketing
. For more information, see Controlling access to AWS resources.
aws:RequestTag/key-name
Use this key to compare the tag key-value pair that was passed in the request with the tag pair that you specify in the policy. For example, you could check whether the request includes the tag key Dept
and that it has the value Accounting
. For more information, see Controlling access during AWS requests. You can use this condition key to restrict which tag key-value pairs can be passed during the TagResource
and CreateBucket
API operations.
aws:TagKeys
Use this key to compare the tag keys in a request with the keys that you specify in the policy. We recommend that when you use policies to control access using tags, use the aws:TagKeys
condition key to define what tag keys are allowed. For example policies and more information, see Controlling access based on tag keys. You can create an S3 directory bucket with tags. To allow tagging during the CreateBucket
API operation, you must create a policy that includes both the s3express:TagResource
and s3express:CreateBucket
actions. You can then use the aws:TagKeys
condition key to enforce using specific tags in the CreateBucket
request.
s3express:BucketTag/tag-key
Use this condition key to grant permissions to specific data in directory buckets using tags. When accessing a directory bucket by using an access point, this condition key references the tags on the directory bucket both when authorizing against the access point and the directory bucket, while the aws:ResourceTag/tag-key
will reference the tags only of the resource it is being authorized against.
See the following example ABAC policies for Amazon S3 directory buckets.
1.1 - IAM policy to create or modify buckets with specific tagsIn this IAM policy, users or roles with this policy can only create S3 directory buckets if they tag the bucket with the tag key project
and tag value Trinity
in the bucket creation request. They can also add or modify tags on existing S3 directory buckets as long as the TagResource
request includes the tag key-value pair project:Trinity
. This policy does not grant read, write, or delete permissions on the buckets or its objects.
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "CreateBucketWithTags",
"Effect": "Allow",
"Action": [
"s3express:CreateBucket",
"s3express:TagResource"
],
"Resource": "*",
"Condition": {
"StringEquals": {
"aws:RequestTag/project": [
"Trinity
"
]
}
}
}
]
}
1.2 - Bucket policy to restrict operations on the bucket using tags
In this bucket policy, IAM principals (users and roles) can perform operations using the CreateSession
action on the bucket only if the value of the bucket's project
tag matches the value of the principal's project
tag.
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "AllowObjectOperations",
"Effect": "Allow",
"Principal": {
"AWS": "111122223333
"
},
"Action": "s3express:CreateSession",
"Resource": "arn:aws::s3express:us-west-2
:111122223333
:bucket/amzn-s3-demo-bucket--usw2-az1--x-s3
",
"Condition": {
"StringEquals": {
"aws:ResourceTag/project": "${aws:PrincipalTag/project}"
}
}
}
]
}
1.3 - IAM policy to modify tags on existing resources maintaining tagging governence
In this IAM policy, IAM principals (users or roles) can modify tags on a bucket only if the value of the bucket's project
tag matches the value of the principal's project
tag. Only the four tags project
, environment
, owner
, and cost-center
specified in the aws:TagKeys
condition keys are permitted for these directory buckets. This helps enforce tag governance, prevents unauthorized tag modifications, and keeps the tagging schema consistent across your buckets.
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "EnforceTaggingRulesOnModification",
"Effect": "Allow",
"Action": [
"s3express:TagResource"
],
"Resource": "arn:aws::s3express:us-west-2
:111122223333
:bucket/*",
"Condition": {
"StringEquals": {
"aws:ResourceTag/project": "${aws:PrincipalTag/project}"
},
"ForAllValues:StringEquals": {
"aws:TagKeys": [
"project
",
"environment
",
"owner
",
"cost-center
"
]
}
}
}
]
}
1.4 - Using the s3express:BucketTag condition key
In this IAM policy, the condition statement allows access to the bucket's data only if the bucket has the tag key Environment
and tag value Production
.
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "AllowAccessToSpecificAccessPoint",
"Effect": "Allow",
"Action": "*",
"Resource": "arn:aws::s3express:us-west-2
:111122223333
:accesspoint/*",
"Condition": {
"StringEquals": {
"s3express:BucketTag/Environment": "Production"
}
}
}
]
}
You can add or manage tags for S3 directory buckets using the Amazon S3 Console, the AWS Command Line Interface (CLI), the AWS SDKs, or using the S3 APIs: TagResource, UntagResource, and ListTagsForResource. For more information, see:
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4