

# Uso de `GetBucketLocation` con un SDK de AWS o la CLI
<a name="s3_example_s3_GetBucketLocation_section"></a>

Los siguientes ejemplos de código muestran cómo utilizar `GetBucketLocation`.

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

**AWS CLI**  
El siguiente comando recupera la restricción de ubicación de un bucket denominado `amzn-s3-demo-bucket`, si existe una restricción:  

```
aws s3api get-bucket-location --bucket {{amzn-s3-demo-bucket}}
```
Salida:  

```
{
    "LocationConstraint": "us-west-2"
}
```
+  Para obtener información sobre la API, consulte [GetBucketLocation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/get-bucket-location.html) en la *Referencia de comandos de la AWS CLI*. 

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

**Herramientas para PowerShell V4**  
**Ejemplo 1: Este comando devuelve la restricción de ubicación del bucket “amzn-s3-demo-bucket”, si existe una restricción.**  

```
Get-S3BucketLocation -BucketName 'amzn-s3-demo-bucket'
```
**Salida:**  

```
Value
-----
ap-south-1
```
+  Para obtener información sobre la API, consulte [GetBucketLocation](https://docs.aws.amazon.com/powershell/v4/reference) en la *Referencia de cmdlets de Herramientas de AWS para PowerShell (V4)*. 

**Herramientas para PowerShell V5**  
**Ejemplo 1: Este comando devuelve la restricción de ubicación del bucket “amzn-s3-demo-bucket”, si existe una restricción.**  

```
Get-S3BucketLocation -BucketName 'amzn-s3-demo-bucket'
```
**Salida:**  

```
Value
-----
ap-south-1
```
+  Para obtener información sobre la API, consulte [GetBucketLocation](https://docs.aws.amazon.com/powershell/v5/reference) en la *Referencia de cmdlets de Herramientas de AWS para PowerShell (V5)*. 

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

**SDK para Rust**  
 Hay más en GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](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 obtener información sobre la API, consulte [GetBucketLocation](https://docs.rs/aws-sdk-s3/latest/aws_sdk_s3/client/struct.Client.html#method.get_bucket_location) en la *Referencia de la API de AWS SDK para Rust*. 

------

Para obtener una lista completa de las guías para desarrolladores de AWS SDK y ejemplos de código, consulte [Desarrollo con Amazon S3 mediante los SDK de AWS](sdk-general-information-section.md). En este tema también se incluye información sobre cómo empezar a utilizar el SDK y detalles sobre sus versiones anteriores.