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á.

# Trabalhar com o Amazon S3
<a name="examples-s3"></a>

Esta seção fornece informações básicas para trabalhar com o Amazon S3 usando o AWS SDK for Java 2.x. Esta seção complementa os [exemplos do Java v2 do Amazon S3](java_s3_code_examples.md) apresentados na seção *Exemplos de código* deste guia.

## Clientes S3 no AWS SDK for Java 2.x
<a name="s3-clients"></a>

 AWS SDK for Java 2.x Ele fornece diferentes tipos de clientes S3. A tabela a seguir mostra as diferenças e pode ajudar você a decidir o que é melhor para seus casos de uso.


**Diferentes tipos de clientes do Amazon S3**  

| Cliente do S3 | Descrição breve | Quando usar | Limitação/desvantagem | 
| --- | --- | --- | --- | 
| **AWS Cliente S3 baseado em CRT**<br />Interface: [S3 AsyncClient](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/s3/S3AsyncClient.html)<br />Construtor: [S3 CrtAsyncClientBuilder](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/s3/S3AsyncClient.html) | [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/sdk-for-java/latest/developer-guide/examples-s3.html)Consulte [Use um cliente S3 de alto desempenho: cliente S3 baseado em AWS CRT](crt-based-s3-client.md). |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/sdk-for-java/latest/developer-guide/examples-s3.html)  |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/sdk-for-java/latest/developer-guide/examples-s3.html)  | 
| **Cliente assíncrono do S3 baseado em Java *com* várias partes habilitadas**<br />Interface: [S3 AsyncClient](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/s3/S3AsyncClient.html)<br />Construtor: [S3 AsyncClientBuilder](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/s3/S3AsyncClientBuilder.html) | [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/sdk-for-java/latest/developer-guide/examples-s3.html)Consulte [Configurar o cliente assíncrono do S3 baseado em Java para usar transferências paralelas](s3-async-client-multipart.md). |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/sdk-for-java/latest/developer-guide/examples-s3.html)  | Menos desempenho do que o cliente S3 AWS baseado em CRT. | 
| **Cliente assíncrono do S3 baseado em Java *sem* várias partes habilitadas**<br />Interface: [S3 AsyncClient](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/s3/S3AsyncClient.html)<br />Construtor: [S3 AsyncClientBuilder](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/s3/S3AsyncClientBuilder.html) |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/sdk-for-java/latest/developer-guide/examples-s3.html)  |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/sdk-for-java/latest/developer-guide/examples-s3.html)  | Sem otimização do desempenho. | 
| **Cliente síncrono do S3 baseado em Java**<br />Interface: [S3Client](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/s3/S3Client.html)<br />Construtor: [S3 ClientBuilder](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/s3/S3ClientBuilder.html) |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/sdk-for-java/latest/developer-guide/examples-s3.html)  |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/sdk-for-java/latest/developer-guide/examples-s3.html)  | Sem otimização do desempenho. | 

**nota**  
A partir da versão 2.18.x, o AWS SDK for Java 2.x usa [endereçamento no estilo hospedado virtual ao incluir uma substituição de](https://docs.aws.amazon.com/AmazonS3/latest/userguide/VirtualHosting.html#virtual-hosted-style-access) endpoint. Isso se aplica desde que o nome do bucket seja um rótulo DNS válido.   
Chame o método [https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/s3/S3BaseClientBuilder.html#forcePathStyle(java.lang.Boolean](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/s3/S3BaseClientBuilder.html#forcePathStyle(java.lang.Boolean) com `true` no seu construtor de clientes para forçar o cliente a usar o endereçamento no estilo de caminho para os buckets.  
O exemplo a seguir mostra um cliente de serviço configurado com uma substituição de endpoint e usando o endereçamento no estilo de caminho.  

```
S3Client client = S3Client.builder()
                          .region(Region.US_WEST_2)
                          .endpointOverride(URI.create("https://s3.us-west-2.amazonaws.com"))
                          .forcePathStyle(true)
                          .build();
```

**Topics**
+ [Clientes do S3 no SDK](#s3-clients)
+ [Fazer upload de fluxos para o S3](best-practices-s3-uploads.md)
+ [Pré-assinado URLs](examples-s3-presign.md)
+ [Acesso entre regiões](s3-cross-region.md)
+ [Proteção da integridade de dados com somas de verificação](s3-checksums.md)
+ [Usar um cliente do S3 de alta performance](crt-based-s3-client.md)
+ [Configuração de suporte de transferência paralela](s3-async-client-multipart.md)
+ [Transferir arquivos e diretórios](transfer-manager.md)
+ [Notificações de eventos do S3](examples-s3-event-notifications.md)