Listing Amazon S3 on Outposts buckets - Amazon S3 on Outposts
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).

Listing Amazon S3 on Outposts buckets

With Amazon S3 on Outposts, you can create S3 buckets on your Amazon Outposts and easily store and retrieve objects on premises for applications that require local data access, local data processing, and data residency. S3 on Outposts provides a new storage class, S3 Outposts (OUTPOSTS), which uses the Amazon S3 APIs, and is designed to store data durably and redundantly across multiple devices and servers on your Amazon Outposts. You communicate with your Outpost bucket by using an access point and endpoint connection over a virtual private cloud (VPC). You can use the same APIs and features on Outpost buckets as you do on Amazon S3 buckets, including access policies, encryption, and tagging. You can use S3 on Outposts through the Amazon Web Services Management Console, Amazon Command Line Interface (Amazon CLI), Amazon SDKs, or REST API. For more information, see What is Amazon S3 on Outposts?

For more information about working with buckets in S3 on Outposts, see Working with S3 on Outposts buckets.

The following examples show you how to return a list of your S3 on Outposts buckets by using the Amazon Web Services Management Console, Amazon CLI, and Amazon SDK for Java.

  1. Open the Amazon S3 console at https://console.amazonaws.cn/s3/.

  2. In the left navigation pane, choose Outposts buckets.

  3. Under Outposts buckets, review your list of S3 on Outposts buckets.

The following Amazon CLI example gets a list of buckets in an Outpost. To use this command, replace each user input placeholder with your own information. For more information about this command, see list-regional-buckets in the Amazon CLI Reference.

aws s3control list-regional-buckets --account-id 123456789012 --outpost-id op-01ac5d28a6a232904

The following SDK for Java example gets a list of buckets in an Outpost. For more information, see ListRegionalBuckets in the Amazon Simple Storage Service API Reference.

import com.amazonaws.services.s3control.model.*;

public void listRegionalBuckets() {

    ListRegionalBucketsRequest reqListBuckets = new ListRegionalBucketsRequest()
            .withAccountId(AccountId)
            .withOutpostId(OutpostId);

    ListRegionalBucketsResult respListBuckets = s3ControlClient.listRegionalBuckets(reqListBuckets);
    System.out.printf("ListRegionalBuckets Response: %s%n", respListBuckets.toString());

}