Posted On: Oct 17, 2024

Amazon S3 now supports new Amazon Web Services Region and bucket name prefix filters for the ListBuckets API. In addition, paginated ListBuckets requests now return both your general purpose buckets and their corresponding Amazon Web Services Regions in the response, helping you simplify applications that need to determine bucket locations across multiple Regions.

To get started, you can specify an Amazon Web Services Region like “cn-north-1” using the new query parameter to list your buckets in a particular Region. When using the bucket name filtering query parameter, you can specify bucket name prefixes like "my-bucket" to return all of your bucket names that start with "my-bucket..." These new parameters let you limit your ListBuckets API response to your desired buckets.

The ListBuckets API support for Region and bucket name prefix query parameters is now available in all Amazon Web Services Regions, including the Amazon Web Services China (Beijing) Region, operated by Sinnet, and the Amazon Web Services China (Ningxia) Region, operated by NWCD. You can use the Amazon SDK, API, or CLI to list your buckets for a specific Amazon Web Services Region or prefix. To learn more about the ListBuckets API, visit the documentation.