s3-outposts:ListBucket

List

s3-outposts:ListBucket is a List access-level action in the s3-outposts service. Grants permission to list some or all of the objects in an Amazon S3 bucket (up to 1000)

Resource types

ARNs that s3-outposts:ListBucket can be scoped to in an IAM policy.

arn:${Partition}:s3-outposts:${Region}:${Account}:outpost/${OutpostId}/accesspoint/${AccessPointName} required
accesspoint
arn:${Partition}:s3-outposts:${Region}:${Account}:outpost/${OutpostId}/bucket/${BucketName} required
bucket

Condition keys

Keys you can use in the Condition block of a policy that grants s3-outposts:ListBucket.

s3-outposts:AccessPointNetworkOrigin String

Filters access by the network origin (Internet or VPC)

s3-outposts:DataAccessPointAccount String

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

s3-outposts:DataAccessPointArn ARN

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

s3-outposts:authType String

Filters access by restricting incoming requests to a specific authentication method

s3-outposts:delimiter String

Filters access by requiring the delimiter parameter

s3-outposts:max-keys Numeric

Filters access by limiting the maximum number of keys returned in a ListBucket request

s3-outposts:prefix String

Filters access by key name prefix

s3-outposts:signatureAge Numeric

Filters access by identifying the length of time, in milliseconds, that a signature is valid in an authenticated request

s3-outposts:signatureversion String

Filters access by identifying the version of AWS Signature that is supported for authenticated requests

s3-outposts:x-amz-content-sha256 String

Filters access by disallowing unsigned content in your bucket

Example IAM policy

A minimal policy that allows s3-outposts:ListBucket. Replace "Resource": "*" with a specific ARN to follow least privilege.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowS3outpostsListBucket",
      "Effect": "Allow",
      "Action": "s3-outposts:ListBucket",
      "Resource": "*"
    }
  ]
}

Related actions in s3-outposts

View all s3-outposts actions →