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.

# Cambios en el análisis de Amazon S3 URIs de la versión 1 a la versión 2
<a name="migration-s3-uri-parser"></a>

En este tema se detallan los cambios en el análisis de Amazon S3 URIs de la versión 1 (v1) a la versión 2 (v2.).

## Cambios de alto nivel
<a name="migration-3-uri-parser-api-changes"></a>

Para empezar a analizar un URI de S3 en la v1, cree una instancia de un `AmazonS3URI` utilizando un constructor. En la v2, llame a `parseUri()` en una instancia de `S3Utilities` para devolver un `S3URI`.


****  

| Cambio | v1 |   v2 | 
| --- | --- | --- | 
|    dependencias Maven  |  <pre><dependencyManagement><br />    <dependencies><br />        <dependency><br />            <groupId>com.amazonaws</groupId><br />            <artifactId>aws-java-sdk-bom</artifactId><br />            <version>1.12.5871</version><br />            <type>pom</type><br />            <scope>import</scope><br />        </dependency><br />    </dependencies><br /></dependencyManagement><br /><dependencies><br />    <dependency>  <br />        <groupId>com.amazonaws</groupId><br />        <artifactId>s3</artifactId><br />    </dependency><br /></dependencies></pre>  |  <pre><dependencyManagement><br />    <dependencies><br />        <dependency><br />            <groupId>software.amazon.awssdk</groupId><br />            <artifactId>bom</artifactId><br />            <version>2.27.212</version><br />            <type>pom</type><br />            <scope>import</scope><br />        </dependency><br />    </dependencies><br /></dependencyManagement><br /><dependencies><br />    <dependency><br />        <groupId>software.amazon.awssdk</groupId><br />        <artifactId>s3</artifactId><br />    </dependency><br /></dependencies></pre>  | 
| Nombre del paquete | com.amazonaws.services.s3 | software.amazon.awssdk.services.s3 | 
| Nombres de clase | [AmazonS3URI](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/AmazonS3URI.html) | [S3URI](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/s3/S3Uri.html) | 

1 [Última versión](https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom). 2 [Última versión](https://central.sonatype.com/artifact/software.amazon.awssdk/bom).

## Cambios en la API
<a name="migration-3-uri-parser-api-changes"></a>


| Comportamiento | v1 |   v2 | 
| --- | --- | --- | 
| Analizar un URI de S3. |  <pre>URI uri = URI.create( "https://s3.amazonaws.com");<br /><br />AmazonS3Uri s3Uri = <br />    new AmazonS3URI(uri, false);</pre>  |  <pre>S3Client s3Client = S3Client.create();<br />S3Utilities s3Utilities =<br />    s3Client.utilities();<br /><br />S3Uri s3Uri =<br />    s3Utilities.parseUri(uri);</pre>  | 
| Recuperar el nombre del bucket de un URI de S3. |  <pre>String bucket = s3Uri.getBucket();</pre>  |  <pre>Optional<String> bucket = s3Uri.bucket();</pre>  | 
| Recuperar la clave. |  <pre>String key = s3Uri.getKey();</pre>  |  <pre>Optional<String> key = s3Uri.key();</pre>  | 
| Recuperar la región. |  <pre>String region = s3Uri.getRegion();</pre>  |  <pre>Optional<Region> region = s3Uri.region();<br /><br />String region;<br />if (s3Uri.region().isPresent()) {<br />    region = s3Uri.region().get().id();<br />}</pre>  | 
|  Recuperar si el URI de S3 es de estilo de ruta.  |  <pre>boolean isPathStyle = s3Uri.isPathStyle();</pre>  |  <pre>boolean isPathStyle = s3Uri.isPathStyle();</pre>  | 
| Recuperar el ID de versión. |  <pre>String versionId = s3Uri.getVersionId();</pre>  |  <pre>Optional<String> versionId = <br />    s3Uri.firstMatchingRawQueryParameter("versionId");</pre>  | 
| Recuperar los parámetros de consulta. | N/A |  <pre>Map<String, List<String>> queryParams =<br />    s3Uri.rawQueryParameters();</pre>  | 

### Cambios de comportamiento
<a name="migration-s3-uri-parser-behavior-changes"></a>

#### Codificación de URL
<a name="migration-s3-uri-parser-behavior-changes-URLencoding"></a>

La v1 ofrece la opción de pasar una marca para especificar si el URI debe estar codificado como URL. El valor predeterminado es `true`. 

En la v2 no se admite codificación de URL. Si trabaja con claves de objeto o parámetros de consulta que tienen caracteres reservados o no seguros, debe codificarlos mediante URL. Por ejemplo, debe reemplazar un espacio en blanco `" "` por `%20`.