List your access points for directory buckets - Amazon Simple Storage Service
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).

List your access points for directory buckets

This section explains how to list access points for a directory bucket using the Amazon Web Services Management Console, Amazon Command Line Interface (Amazon CLI), REST API, or Amazon SDKs.

To list access points in your Amazon Web Services account

  1. Sign in to the Amazon Web Services Management Console and open the Amazon S3 console at https://console.amazonaws.cn/s3/.

  2. In the navigation bar on the top of the page, choose the name of the currently displayed Amazon Web Services Region. Next, choose the Region that you want to list access points for.

  3. In the navigation pane on the left side of the console, choose Access points for directory buckets.

  4. (Optional) Search for access points by name. Only access points in your selected Amazon Web Services Region will appear here.

  5. Choose the name of the access point you want to manage.

The following list-access-points-for-directory-buckets example command shows how you can use the Amazon CLI to list the access points owned by an Amazon account and associated with a directory bucket.

The following command lists access points for Amazon Web Services account 111122223333 that are attached to bucket amzn-s3-demo-bucket--zone-id--x-s3.

aws s3control list-access-points-for-directory-buckets --account-id 111122223333 --directory-bucket amzn-s3-demo-bucket--zone-id--x-s3

For more information and examples, see list-access-points-for-directory-buckets in the Amazon CLI Command Reference.

The following example shows how you can use the REST API to list your access points.


GET /v20180820/directoryaccesspoint?directoryBucket=amzn-s3-demo-bucket--zone-id--x-s3
&maxResults=maxResults HTTP/1.1
Host: s3express-control.region.amazonaws.com 
x-amz-account-id: 111122223333
Example of ListAccessPointsForDirectoryBuckets response

HTTP/1.1 200
<?xml version="1.0" encoding="UTF-8"?>
<ListDirectoryAccessPointsResult>
    <AccessPointList>
        <AccessPoint>
            <AccessPointArn>arn:aws-cn:s3express:region:111122223333:accesspoint/example-access-point--zoneID--xa-s3</AccessPointArn>
            <Alias>example-access-point--zoneID--xa-s3</Alias>
            <Bucket>amzn-s3-demo-bucket--zone-id--x-s3</Bucket>
            <BucketAccountId>111122223333</BucketAccountId>
            <Name>example-access-point--zoneID--xa-s3</Name>
            <NetworkOrigin>VPC</NetworkOrigin>
            <VpcConfiguration>
                <VpcId>VPC-1</VpcId>
            </VpcConfiguration>
        </AccessPoint>    
    </AccessPointList>  
</ListDirectoryAccessPointsResult>

You can use the Amazon SDKs to list your access points. For more information, see list of supported SDKs in the Amazon Simple Storage Service API Reference.