# Obter um bucket do S3 on Outposts usando a AWS CLI e o SDK para Java
<a name="S3OutpostsGetBucket"></a>

Com o Amazon S3 on Outposts, é possível criar buckets do S3 no AWS Outposts, além de armazenar e recuperar facilmente objetos no local para aplicações que exigem acesso a dados locais, processamento de dados local e residência de dados. O S3 on Outposts fornece uma nova classe de armazenamento, o S3 Outposts (`OUTPOSTS`), que usa as APIs do Amazon S3 e é projetado para armazenar dados de forma duradoura e redundante em vários dispositivos e servidores em seu AWS Outposts. Você se comunica com o bucket do Outposts usando um ponto de acesso e uma conexão de endpoint em uma nuvem privada virtual (VPC). É possível usar os mesmos recursos e APIs nos buckets do Outposts da mesma maneira que em buckets do Amazon S3, incluindo políticas de acesso, criptografia e marcação. Só é possível usar o S3 on Outposts por meio do Console de gerenciamento da AWS, da AWS Command Line Interface (AWS CLI), de AWS SDKs ou da API REST. Para obter mais informações, consulte [O que é o Amazon S3 on Outposts?](S3onOutposts.md)

Os exemplos a seguir mostram como obter um bucket do S3 on Outposts usando a AWS CLI e o AWS SDK para Java.

**nota**  
Ao trabalhar com o Amazon S3 on Outposts por meio da AWS CLI ou de AWSSDKs, forneça o ARN do ponto de acesso do Outpost no lugar do nome do bucket. O ARN do ponto de acesso assume a forma a seguir, em que `region` é o código da Região da AWS em que se encontra o Outpost:   
`arn:aws:s3-outposts:region:123456789012:outpost/op-01ac5d28a6a232904/accesspoint/example-outposts-access-point`   
Para obter mais informações sobre o S3 on Outposts, consulte [ARNs de recurso para S3 no Outposts](S3OutpostsIAM.md#S3OutpostsARN).

## Como usar o AWS CLI
<a name="S3OutpostsGetBucketCLI"></a>

O exemplo do S3 on Outposts a seguir obtém um bucket usando a AWS CLI. Para usar esse comando, substitua cada `user input placeholder` por suas próprias informações. Para obter mais informações sobre esse comando, consulte [get-bucket](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3control/get-bucket.html) na *Referência da AWS CLI*.

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

## Usar o AWS SDK para Java
<a name="S3OutpostsGetBucketJava"></a>

O exemplo do S3 no Outposts a seguir obtém um bucket usando o SDK para Java. Para obter mais informações, consulte [GetBucket](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetBucket.html) na *Referência da API do 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());

}
```