Há mais exemplos de AWS SDK disponíveis no repositório [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Use `GetBucketLocation` com um AWS SDK ou CLI
<a name="s3_example_s3_GetBucketLocation_section"></a>

Os exemplos de código a seguir mostram como usar o `GetBucketLocation`.

------
#### [ CLI ]

**AWS CLI**  
O seguinte comando recupera a restrição de localização do bucket `amzn-s3-demo-bucket`, se houver uma restrição:  

```
aws s3api get-bucket-location --bucket amzn-s3-demo-bucket
```
Saída:  

```
{
    "LocationConstraint": "us-west-2"
}
```
+  Para obter detalhes da API, consulte [GetBucketLocation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/get-bucket-location.html)em *Referência de AWS CLI Comandos*. 

------
#### [ PowerShell ]

**Ferramentas para PowerShell V4**  
**Exemplo 1: se houver uma restrição, este comando retornará a restrição de localização do bucket “amzn-s3-demo-bucket”.**  

```
Get-S3BucketLocation -BucketName 'amzn-s3-demo-bucket'
```
**Saída**:  

```
Value
-----
ap-south-1
```
+  Para obter detalhes da API, consulte [GetBucketLocation](https://docs.aws.amazon.com/powershell/v4/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V4)*. 

**Ferramentas para PowerShell V5**  
**Exemplo 1: se houver uma restrição, este comando retornará a restrição de localização do bucket “amzn-s3-demo-bucket”.**  

```
Get-S3BucketLocation -BucketName 'amzn-s3-demo-bucket'
```
**Saída**:  

```
Value
-----
ap-south-1
```
+  Para obter detalhes da API, consulte [GetBucketLocation](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

------
#### [ Rust ]

**SDK para Rust**  
 Tem mais sobre GitHub. Encontre o exemplo completo e saiba como configurar e executar no [AWS Code Examples Repository](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/rustv1/examples/s3#code-examples). 

```
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(&region) {
                    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(())
}
```
+  Para obter detalhes da API, consulte a [GetBucketLocation](https://docs.rs/aws-sdk-s3/latest/aws_sdk_s3/client/struct.Client.html#method.get_bucket_location)referência da *API AWS SDK for Rust*. 

------