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).
Use GetBucketLocation
with an Amazon SDK or CLI
The following code examples show how to use GetBucketLocation
.
- CLI
-
- Amazon CLI
-
The following command retrieves the location constraint for a bucket named amzn-s3-demo-bucket
, if a constraint exists:
aws s3api get-bucket-location --bucket amzn-s3-demo-bucket
Output:
{
"LocationConstraint": "us-west-2"
}
- PowerShell
-
- Tools for PowerShell V4
-
Example 1: This command returns the location constraint for the bucket 's3testbucket', if a constraint exists.
Get-S3BucketLocation -BucketName 'amzn-s3-demo-bucket'
Output:
Value
-----
ap-south-1
- Rust
-
- SDK for Rust
-
async fn show_buckets(
strict: bool,
client: &Client,
region: BucketLocationConstraint,
) -> Result<(), S3ExampleError> {
let mut buckets = client.list_buckets().into_paginator().send();
let mut num_buckets = 0;
let mut in_region = 0;
while let Some(Ok(output)) = buckets.next().await {
for bucket in output.buckets() {
num_buckets += 1;
if strict {
let r = client
.get_bucket_location()
.bucket(bucket.name().unwrap_or_default())
.send()
.await?;
if r.location_constraint() == Some(®ion) {
println!("{}", bucket.name().unwrap_or_default());
in_region += 1;
}
} else {
println!("{}", bucket.name().unwrap_or_default());
}
}
}
println!();
if strict {
println!(
"Found {} buckets in the {} region out of a total of {} buckets.",
in_region, region, num_buckets
);
} else {
println!("Found {} buckets in all regions.", num_buckets);
}
Ok(())
}
For a complete list of Amazon SDK developer guides and code examples, see
Developing with Amazon S3 using the Amazon SDKs.
This topic also includes information about getting started and details about previous SDK versions.