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

# Alterações na análise do Amazon URIs S3 da versão 1 para a versão 2
<a name="migration-s3-uri-parser"></a>

Este tópico detalha as mudanças na análise do Amazon URIs S3 da versão 1 (v1) para a versão 2 (v2.).

## Alterações de alto nível
<a name="migration-3-uri-parser-api-changes"></a>

Para começar a analisar um URI do S3 na v1, você instancia um `AmazonS3URI` usando um construtor. Na v2, você chama `parseUri()` em uma instância de `S3Utilities`, para retornar um `S3URI`.


****  

| Alteração | v1 |  v2 da  | 
| --- | --- | --- | 
|    Dependências do 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>  | 
| Nome do pacote | com.amazonaws.services.s3 | software.amazon.awssdk.services.s3 | 
| Nomes da classe | [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 [Versão mais recente](https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom). 2 [Versão mais recente](https://central.sonatype.com/artifact/software.amazon.awssdk/bom).

## Alterações de API
<a name="migration-3-uri-parser-api-changes"></a>


| Comportamento | v1 |  v2 da  | 
| --- | --- | --- | 
| Analise um URI do 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>  | 
| Recupere o nome do bucket de um URI do S3. |  <pre>String bucket = s3Uri.getBucket();</pre>  |  <pre>Optional<String> bucket = s3Uri.bucket();</pre>  | 
| Recupere a chave. |  <pre>String key = s3Uri.getKey();</pre>  |  <pre>Optional<String> key = s3Uri.key();</pre>  | 
| Recupere a região. |  <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>  | 
|  Recupere se o URI do S3 está no estilo de caminho.  |  <pre>boolean isPathStyle = s3Uri.isPathStyle();</pre>  |  <pre>boolean isPathStyle = s3Uri.isPathStyle();</pre>  | 
| Recupere o ID da versão. |  <pre>String versionId = s3Uri.getVersionId();</pre>  |  <pre>Optional<String> versionId = <br />    s3Uri.firstMatchingRawQueryParameter("versionId");</pre>  | 
| Recupere os parâmetros de consulta. | N/D |  <pre>Map<String, List<String>> queryParams =<br />    s3Uri.rawQueryParameters();</pre>  | 

### Mudanças de comportamento
<a name="migration-s3-uri-parser-behavior-changes"></a>

#### Codificação de URL
<a name="migration-s3-uri-parser-behavior-changes-URLencoding"></a>

A v1 fornece a opção de passar um sinalizador para especificar se o URI deve ser codificado em URL. O valor padrão é `true`. 

Na v2, a codificação de URL não é compatível. Se você trabalha com chaves de objeto ou parâmetros de consulta que tenham caracteres reservados ou inseguros, codifique-os em URL. Por exemplo, você precisa substituir um espaço em branco `" "` por `%20`.