

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Modifications apportées à l'analyse d'Amazon S3 URIs de la version 1 à la version 2
<a name="migration-s3-uri-parser"></a>

Cette rubrique détaille les modifications apportées à l'analyse d'Amazon S3 URIs entre la version 1 (v1) et la version 2 (v2.).

## Changements de haut niveau
<a name="migration-3-uri-parser-api-changes"></a>

Pour commencer à analyser un URI S3 dans la version 1, vous instanciez un URI à l'aide `AmazonS3URI` d'un constructeur. Dans la v2, vous `parseUri()` faites appel à une instance de`S3Utilities`, pour renvoyer un`S3URI`.


****  

| Modifier | v1 |   v2 | 
| --- | --- | --- | 
|    Dépendances de 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>  | 
| Nom du package | com.amazonaws.services.s3 | software.amazon.awssdk.services.s3 | 
| Noms des classes | [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 [Dernière version](https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom). 2 [Dernière version](https://central.sonatype.com/artifact/software.amazon.awssdk/bom).

## Modifications de l'API
<a name="migration-3-uri-parser-api-changes"></a>


| Comportement | v1 |   v2 | 
| --- | --- | --- | 
| Analyse un URI 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>  | 
| Récupérez le nom du compartiment à partir d'une URI S3. |  <pre>String bucket = s3Uri.getBucket();</pre>  |  <pre>Optional<String> bucket = s3Uri.bucket();</pre>  | 
| Récupérez la clé. |  <pre>String key = s3Uri.getKey();</pre>  |  <pre>Optional<String> key = s3Uri.key();</pre>  | 
| Récupérez la région. |  <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>  | 
|  Vérifiez si l'URI S3 est un style de chemin.  |  <pre>boolean isPathStyle = s3Uri.isPathStyle();</pre>  |  <pre>boolean isPathStyle = s3Uri.isPathStyle();</pre>  | 
| Récupérez l'ID de version. |  <pre>String versionId = s3Uri.getVersionId();</pre>  |  <pre>Optional<String> versionId = <br />    s3Uri.firstMatchingRawQueryParameter("versionId");</pre>  | 
| Récupérez les paramètres de requête. | N/A |  <pre>Map<String, List<String>> queryParams =<br />    s3Uri.rawQueryParameters();</pre>  | 

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

#### Codage d'URL
<a name="migration-s3-uri-parser-behavior-changes-URLencoding"></a>

v1 fournit la possibilité de transmettre un indicateur pour spécifier si l'URI doit être codé en URL. La valeur par défaut est `true`. 

Dans la version 2, le codage d'URL n'est pas pris en charge. Si vous travaillez avec des clés d'objet ou des paramètres de requête contenant des caractères réservés ou non sécurisés, vous devez les encoder par URL. Par exemple, vous devez remplacer un espace blanc `" "` par`%20`.