View a markdown version of this page

Actions, resources, and condition keys for Amazon S3 Express - Service Authorization Reference
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Actions, resources, and condition keys for Amazon S3 Express

Amazon S3 Express (service prefix: s3express) provides the following service-specific operations, resources, actions, and condition keys for use in IAM permission policies.

References:

Actions defined by Amazon S3 Express

You can specify the following actions in the Action element of an IAM policy statement. Use policies to grant permissions to perform an operation in Amazon. 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.

Actions Description Resource types (*required) Condition keys Access level

CreateAccessPoint

Grants permission to create a new access point

accesspoint*

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

aws:TagKeys

s3express:AccessPointNetworkOrigin

s3express:AccessPointTag/${TagKey}

s3express:authType

s3express:DataAccessPointAccount

s3express:DataAccessPointArn

s3express:LocationName

s3express:ResourceAccount

s3express:signatureversion

s3express:TlsVersion

s3express:x-amz-content-sha256

Write

CreateBucket

Grants permission to create a new bucket

bucket*

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

aws:TagKeys

s3express:authType

s3express:BucketTag/${TagKey}

s3express:LocationName

s3express:ResourceAccount

s3express:signatureversion

s3express:TlsVersion

s3express:x-amz-content-sha256

Write

CreateSession

Grants permission to Create Session token which is used for object APIs such as PutObject, GetObject, etc

accesspoint

aws:ResourceTag/${TagKey}

s3express:AccessPointTag/${TagKey}

s3express:AllAccessRestrictedToLocalZoneGroup

s3express:authType

s3express:Permissions

s3express:ResourceAccount

s3express:SessionMode

s3express:signatureAge

s3express:signatureversion

s3express:TlsVersion

s3express:x-amz-content-sha256

s3express:x-amz-server-side-encryption

s3express:x-amz-server-side-encryption-aws-kms-key-id

Write

bucket*

aws:ResourceTag/${TagKey}

s3express:AllAccessRestrictedToLocalZoneGroup

s3express:authType

s3express:BucketTag/${TagKey}

s3express:Permissions

s3express:ResourceAccount

s3express:SessionMode

s3express:signatureAge

s3express:signatureversion

s3express:TlsVersion

s3express:x-amz-content-sha256

s3express:x-amz-server-side-encryption

s3express:x-amz-server-side-encryption-aws-kms-key-id

DeleteAccessPoint

Grants permission to delete the access point named in the URI

accesspoint*

aws:ResourceTag/${TagKey}

s3express:AccessPointNetworkOrigin

s3express:AccessPointTag/${TagKey}

s3express:authType

s3express:DataAccessPointAccount

s3express:DataAccessPointArn

s3express:ResourceAccount

s3express:signatureversion

s3express:TlsVersion

s3express:x-amz-content-sha256

Write

DeleteAccessPointPolicy

Grants permission to delete the policy on a specified access point

accesspoint*

aws:ResourceTag/${TagKey}

s3express:AccessPointNetworkOrigin

s3express:AccessPointTag/${TagKey}

s3express:authType

s3express:DataAccessPointAccount

s3express:DataAccessPointArn

s3express:ResourceAccount

s3express:signatureversion

s3express:TlsVersion

s3express:x-amz-content-sha256

Permissions management, Write

DeleteAccessPointScope

Grants permission to delete the scope configuration on a specified access point

accesspoint*

aws:ResourceTag/${TagKey}

s3express:AccessPointNetworkOrigin

s3express:AccessPointTag/${TagKey}

s3express:authType

s3express:DataAccessPointAccount

s3express:DataAccessPointArn

s3express:ResourceAccount

s3express:signatureversion

s3express:TlsVersion

s3express:x-amz-content-sha256

Permissions management, Write

DeleteBucket

Grants permission to delete the bucket named in the URI

bucket*

aws:ResourceTag/${TagKey}

s3express:authType

s3express:BucketTag/${TagKey}

s3express:ResourceAccount

s3express:signatureversion

s3express:TlsVersion

s3express:x-amz-content-sha256

Write

DeleteBucketPolicy

Grants permission to delete the policy on a specified bucket

bucket*

aws:ResourceTag/${TagKey}

s3express:authType

s3express:BucketTag/${TagKey}

s3express:ResourceAccount

s3express:signatureversion

s3express:TlsVersion

s3express:x-amz-content-sha256

Permissions management, Write

GetAccessPoint

Grants permission to return configuration information about the specified access point

accesspoint*

aws:ResourceTag/${TagKey}

s3express:AccessPointNetworkOrigin

s3express:AccessPointTag/${TagKey}

s3express:authType

s3express:DataAccessPointAccount

s3express:DataAccessPointArn

s3express:ResourceAccount

s3express:signatureversion

s3express:TlsVersion

s3express:x-amz-content-sha256

Read

GetAccessPointPolicy

Grants permission to return the access point policy associated with the specified access point

accesspoint*

aws:ResourceTag/${TagKey}

s3express:AccessPointNetworkOrigin

s3express:AccessPointTag/${TagKey}

s3express:authType

s3express:DataAccessPointAccount

s3express:DataAccessPointArn

s3express:ResourceAccount

s3express:signatureversion

s3express:TlsVersion

s3express:x-amz-content-sha256

Read

GetAccessPointScope

Grants permission to return the scope configuration associated with the specified access point

accesspoint*

aws:ResourceTag/${TagKey}

s3express:AccessPointNetworkOrigin

s3express:AccessPointTag/${TagKey}

s3express:authType

s3express:DataAccessPointAccount

s3express:DataAccessPointArn

s3express:ResourceAccount

s3express:signatureversion

s3express:TlsVersion

s3express:x-amz-content-sha256

Read

GetBucketPolicy

Grants permission to return the policy of the specified bucket

bucket*

aws:ResourceTag/${TagKey}

s3express:authType

s3express:BucketTag/${TagKey}

s3express:ResourceAccount

s3express:signatureversion

s3express:TlsVersion

s3express:x-amz-content-sha256

Read

GetEncryptionConfiguration

Grants permission to return the default encryption configuration for a directory bucket

bucket*

aws:ResourceTag/${TagKey}

s3express:authType

s3express:BucketTag/${TagKey}

s3express:ResourceAccount

s3express:signatureversion

s3express:TlsVersion

s3express:x-amz-content-sha256

Read

GetInventoryConfiguration

Grants permission to return an inventory configuration identified by the inventory configuration ID for a S3 directory bucket

bucket*

aws:ResourceTag/${TagKey}

s3express:authType

s3express:BucketTag/${TagKey}

s3express:ResourceAccount

s3express:signatureversion

s3express:TlsVersion

s3express:x-amz-content-sha256

Read

GetLifecycleConfiguration

Grants permission to return the lifecycle configuration information set on a directory bucket

bucket*

aws:ResourceTag/${TagKey}

s3express:authType

s3express:BucketTag/${TagKey}

s3express:ResourceAccount

s3express:signatureversion

s3express:TlsVersion

s3express:x-amz-content-sha256

Read

GetMetricsConfiguration

Grants permission to get a metrics configuration of a directory bucket

bucket*

aws:ResourceTag/${TagKey}

s3express:authType

s3express:BucketTag/${TagKey}

s3express:ResourceAccount

s3express:signatureversion

s3express:TlsVersion

s3express:x-amz-content-sha256

Read

ListAccessPointsForDirectoryBuckets

Grants permission to list access points

s3express:authType

s3express:ResourceAccount

s3express:signatureversion

s3express:TlsVersion

s3express:x-amz-content-sha256

List

ListAllMyDirectoryBuckets

Grants permission to list all directory buckets owned by the authenticated sender of the request

s3express:authType

s3express:ResourceAccount

s3express:signatureversion

s3express:TlsVersion

s3express:x-amz-content-sha256

List

ListTagsForResource

Grants permission to lists all of the tags for a specified resource

accesspoint

aws:ResourceTag/${TagKey}

s3express:AccessPointTag/${TagKey}

s3express:authType

s3express:ResourceAccount

s3express:signatureversion

s3express:TlsVersion

s3express:x-amz-content-sha256

List

bucket

aws:ResourceTag/${TagKey}

s3express:authType

s3express:BucketTag/${TagKey}

s3express:ResourceAccount

s3express:signatureversion

s3express:TlsVersion

s3express:x-amz-content-sha256

PutAccessPointPolicy

Grants permission to associate an access policy with a specified access point

accesspoint*

aws:ResourceTag/${TagKey}

s3express:AccessPointNetworkOrigin

s3express:AccessPointTag/${TagKey}

s3express:authType

s3express:DataAccessPointAccount

s3express:DataAccessPointArn

s3express:ResourceAccount

s3express:signatureversion

s3express:TlsVersion

s3express:x-amz-content-sha256

Permissions management, Write

PutAccessPointScope

Grants permission to associate an access point with a specified access point scope configuration

accesspoint*

aws:ResourceTag/${TagKey}

s3express:AccessPointNetworkOrigin

s3express:AccessPointTag/${TagKey}

s3express:authType

s3express:DataAccessPointAccount

s3express:DataAccessPointArn

s3express:ResourceAccount

s3express:signatureversion

s3express:TlsVersion

s3express:x-amz-content-sha256

Permissions management, Write

PutBucketPolicy

Grants permission to add or replace a bucket policy on a bucket

bucket*

aws:ResourceTag/${TagKey}

s3express:authType

s3express:BucketTag/${TagKey}

s3express:ResourceAccount

s3express:signatureversion

s3express:TlsVersion

s3express:x-amz-content-sha256

Permissions management, Write

PutEncryptionConfiguration

Grants permission to set the encryption configuration for a directory bucket

bucket*

aws:ResourceTag/${TagKey}

s3express:authType

s3express:BucketTag/${TagKey}

s3express:ResourceAccount

s3express:signatureversion

s3express:TlsVersion

s3express:x-amz-content-sha256

Write

PutInventoryConfiguration

Grants permission to add an inventory configuration to the bucket, identified by the inventory ID

bucket*

aws:ResourceTag/${TagKey}

s3express:authType

s3express:BucketTag/${TagKey}

s3express:InventoryAccessibleOptionalFields

s3express:ResourceAccount

s3express:signatureversion

s3express:TlsVersion

s3express:x-amz-content-sha256

Write

PutLifecycleConfiguration

Grants permission to create a new lifecycle configuration for the directory bucket or replace an existing lifecycle configuration

bucket*

aws:ResourceTag/${TagKey}

s3express:authType

s3express:BucketTag/${TagKey}

s3express:ResourceAccount

s3express:signatureversion

s3express:TlsVersion

s3express:x-amz-content-sha256

Write

PutMetricsConfiguration

Grants permission to set or update a metrics configuration for the CloudWatch request metrics of a directory bucket

bucket*

aws:ResourceTag/${TagKey}

s3express:authType

s3express:BucketTag/${TagKey}

s3express:ResourceAccount

s3express:signatureversion

s3express:TlsVersion

s3express:x-amz-content-sha256

Write

TagResource

Grants permission to create a new user-defined tag or update an existing tag

accesspoint

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

aws:TagKeys

s3express:AccessPointTag/${TagKey}

s3express:authType

s3express:ResourceAccount

s3express:signatureversion

s3express:TlsVersion

s3express:x-amz-content-sha256

Tagging, Write

bucket

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

aws:TagKeys

s3express:authType

s3express:BucketTag/${TagKey}

s3express:ResourceAccount

s3express:signatureversion

s3express:TlsVersion

s3express:x-amz-content-sha256

UntagResource

Grants permission to remove the specified user-defined tags from an S3 resource

accesspoint

aws:ResourceTag/${TagKey}

aws:TagKeys

s3express:AccessPointTag/${TagKey}

s3express:authType

s3express:ResourceAccount

s3express:signatureversion

s3express:TlsVersion

s3express:x-amz-content-sha256

Tagging, Write

bucket

aws:ResourceTag/${TagKey}

aws:TagKeys

s3express:authType

s3express:BucketTag/${TagKey}

s3express:ResourceAccount

s3express:signatureversion

s3express:TlsVersion

s3express:x-amz-content-sha256

Resource types defined by Amazon S3 Express

The following resource types are defined by this service and can be used in the Resource element of IAM permission policy statements.

Resource types ARN Condition keys

accesspoint

arn:${Partition}:s3express:${Region}:${Account}:accesspoint/${AccessPointName}

aws:ResourceTag/${TagKey}

s3express:AccessPointTag/${TagKey}

bucket

arn:${Partition}:s3express:${Region}:${Account}:bucket/${BucketName}

aws:ResourceTag/${TagKey}

s3express:BucketTag/${TagKey}

Condition keys for Amazon S3 Express

Amazon S3 Express defines the following condition keys that can be used in the Condition element of an IAM policy.

Condition keys Description Type

aws:RequestTag/${TagKey}

Filters access by the tags that are passed in the request

String

aws:ResourceTag/${TagKey}

Filters access by the tags associated with the resource

String

aws:TagKeys

Filters access by the tag keys that are passed in the request

ArrayOfString

s3express:AccessPointNetworkOrigin

Filters access by the network origin (Internet or VPC)

String

s3express:AccessPointTag/${TagKey}

Filters access by tag key-value pairs attached to the access point

String

s3express:AllAccessRestrictedToLocalZoneGroup

Filters access by Amazon Local Zone network border group(s) provided in this condition key

String

s3express:BucketTag/${TagKey}

Filters access by tag key-value pairs attached to the bucket

String

s3express:DataAccessPointAccount

Filters access by the Amazon Account ID that owns the access point

String

s3express:DataAccessPointArn

Filters access by an access point Amazon Resource Name (ARN)

ARN

s3express:InventoryAccessibleOptionalFields

Filters access by restricting which optional metadata fields a user can add when configuring S3 Inventory reports

ArrayOfString

s3express:LocationName

Filters access by a specific Availability Zone or Local Zone ID

String

s3express:Permissions

Filters access by the permission requested by Access Point Scope configuration, such as GetObject, PutObject

ArrayOfString

s3express:ResourceAccount

Filters access by the resource owner Amazon Web Services account ID

String

s3express:SessionMode

Filters access by the permission requested by CreateSession API, such as ReadOnly and ReadWrite

String

s3express:TlsVersion

Filters access by the TLS version used by the client

Numeric

s3express:authType

Filters access by authentication method

String

s3express:signatureAge

Filters access by the age in milliseconds of the request signature

Numeric

s3express:signatureversion

Filters access by the Amazon Signature Version used on the request

String

s3express:x-amz-content-sha256

Filters access by unsigned content in your bucket

String

s3express:x-amz-server-side-encryption

Filters access by server-side encryption

String

s3express:x-amz-server-side-encryption-aws-kms-key-id

Filters access by Amazon KMS customer managed key for server-side encryption

ARN