# Obtención de un bucket de S3 en Outposts mediante la AWS CLI y el SDK para Java
<a name="S3OutpostsGetBucket"></a>

Con Amazon S3 en Outposts, puede crear buckets de S3 en Outposts de AWS y almacenar y recuperar fácilmente objetos en las instalaciones para las aplicaciones que requieren acceso local a los datos, procesamiento local de los datos y residencia de los datos. S3 en Outposts proporciona una nueva clase de almacenamiento, S3 Outposts (`OUTPOSTS`), que utiliza las API de Amazon S3 y está diseñada para almacenar datos de manera duradera y redundante en múltiples dispositivos y servidores de AWS Outposts. Usted se comunica con su bucket de Outpost mediante un punto de acceso y una conexión de punto de conexión a través de una nube privada virtual (VPC). Puede usar las mismas API y características en los buckets de Outposts que en buckets de Amazon S3, como políticas de acceso, cifrado y etiquetado. Puede utilizar S3 en Outposts a través de la Consola de administración de AWS, AWS Command Line Interface (AWS CLI), AWS SDK o la API de REST. Para obtener más información, consulte [¿Qué es Amazon S3 en Outposts?](S3onOutposts.md)

En los siguientes ejemplos, se muestra cómo obtener un bucket de S3 en Outposts con AWS CLI y AWS SDK para Java.

**nota**  
Al trabajar con Amazon S3 en Outposts a través de los SDK de AWS CLI o AWS, se proporciona el ARN del punto de acceso para Outpost en lugar del nombre del bucket. El ARN del punto de acceso adopta la siguiente forma, donde `region` es el código de Región de AWS de la región en la que está destinado el Outpost:   
`arn:aws:s3-outposts:region:123456789012:outpost/op-01ac5d28a6a232904/accesspoint/example-outposts-access-point`   
Para obtener más información acerca de S3 en Outposts, consulte [ARN de recursos para S3 en Outposts](S3OutpostsIAM.md#S3OutpostsARN).

## Uso de AWS CLI
<a name="S3OutpostsGetBucketCLI"></a>

El siguiente ejemplo de S3 en Outposts obtiene un bucket con la AWS CLI. Para usar este comando, sustituya `user input placeholder` por su propia información. Para obtener más información acerca de este comando, consulte [get-bucket](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3control/get-bucket.html) en la *Referencia de AWS CLI*.

```
aws s3control get-bucket --account-id 123456789012 --bucket "arn:aws:s3-outposts:region:123456789012:outpost/op-01ac5d28a6a232904/bucket/example-outposts-bucket"
```

## Uso de AWS SDK para Java
<a name="S3OutpostsGetBucketJava"></a>

El siguiente ejemplo de S3 en Outposts obtiene un bucket con el SDK para Java. Para obtener más información, consulte [GetBucket](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetBucket.html) en la *Referencia de la API de Amazon Simple Storage Service*.

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

public void getBucket(String bucketArn) {

    GetBucketRequest reqGetBucket = new GetBucketRequest()
            .withBucket(bucketArn)
            .withAccountId(AccountId);

    GetBucketResult respGetBucket = s3ControlClient.getBucket(reqGetBucket);
    System.out.printf("GetBucket Response: %s%n", respGetBucket.toString());

}
```