Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Trabajo con Amazon S3
<a name="examples-s3"></a>

En esta sección se proporciona información básica para trabajar con Amazon S3 mediante AWS SDK for Java 2.x. Esta sección complementa los [ejemplos de Java v2 de Amazon S3](java_s3_code_examples.md) presentados en la sección *Ejemplos de código* de esta guía.

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

 AWS SDK for Java 2.x Proporciona diferentes tipos de clientes S3. La siguiente tabla muestra las diferencias y puede ayudarle a decidir qué es lo mejor para sus casos de uso.


**Diferentes tipos de clientes de Amazon S3**  

| Cliente de S3 | Descripción breve | Cuándo se debe usar | Limitación o inconveniente | 
| --- | --- | --- | --- | 
| **AWS Cliente S3 basado en CRT**<br />[Interfaz: S3 AsyncClient](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/s3/S3AsyncClient.html)<br />Constructor: [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/es_es/sdk-for-java/latest/developer-guide/examples-s3.html)Consulte [Utilice un cliente S3 de alto rendimiento: cliente S3 basado en AWS CRT](crt-based-s3-client.md). |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/sdk-for-java/latest/developer-guide/examples-s3.html)  |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/sdk-for-java/latest/developer-guide/examples-s3.html)  | 
| **Cliente asincrónico S3 basado en Java *con* multiparte habilitada**<br />Interfaz: [S3 AsyncClient](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/s3/S3AsyncClient.html)<br />Constructor: [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/es_es/sdk-for-java/latest/developer-guide/examples-s3.html)Consulte [Configuración del cliente asincrónico S3 basado en Java para usar transferencias paralelas](s3-async-client-multipart.md). |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/sdk-for-java/latest/developer-guide/examples-s3.html)  | Tiene menos rendimiento que el cliente S3 basado en AWS CRT. | 
| **Cliente asincrónico de S3 basado en Java *sin* multiparte habilitada**<br />[Interfaz: S3 AsyncClient](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/s3/S3AsyncClient.html)<br />Constructor: [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/es_es/sdk-for-java/latest/developer-guide/examples-s3.html)  |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/sdk-for-java/latest/developer-guide/examples-s3.html)  | Sin optimización del rendimiento | 
| **Cliente asincrónico de S3 basado en Java**<br />Interfaz: [S3Client](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/s3/S3Client.html)<br />Constructor: [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/es_es/sdk-for-java/latest/developer-guide/examples-s3.html)  |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/sdk-for-java/latest/developer-guide/examples-s3.html)  | Sin optimización del rendimiento | 

**nota**  
A partir de la versión 2.18.x, AWS SDK for Java 2.x utiliza un [direccionamiento de tipo alojamiento virtual al incluir una anulación de punto final](https://docs.aws.amazon.com/AmazonS3/latest/userguide/VirtualHosting.html#virtual-hosted-style-access). Esto se aplica siempre que el nombre del bucket sea una etiqueta DNS válida.   
Llame al 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) con `true` en su constructor de clientes para forzar al cliente a utilizar el direccionamiento estilo ruta para los buckets.  
En el siguiente ejemplo se muestra un cliente de servicio configurado con una anulación de punto de conexión y utilizando direccionamiento estilo ruta.  

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

**Topics**
+ [Clientes de S3 en el SDK](#s3-clients)
+ [Carga de flujos en S3](best-practices-s3-uploads.md)
+ [Prefirmado URLs](examples-s3-presign.md)
+ [Acceso entre regiones](s3-cross-region.md)
+ [Protección de la integridad de los datos con sumas de comprobación](s3-checksums.md)
+ [Utilizar un cliente S3 de alto rendimiento](crt-based-s3-client.md)
+ [Configuración de la compatibilidad con la transferencia paralela](s3-async-client-multipart.md)
+ [Transferir archivos y directorios](transfer-manager.md)
+ [Notificaciones de eventos de S3](examples-s3-event-notifications.md)