Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Perubahan dalam mengurai Amazon URIs S3 dari versi 1 ke versi 2
<a name="migration-s3-uri-parser"></a>

Topik ini merinci perubahan dalam mengurai Amazon URIs S3 dari versi 1 (v1) ke versi 2 (v2.).

## Perubahan tingkat tinggi
<a name="migration-3-uri-parser-api-changes"></a>

Untuk mulai mengurai URI S3 di v1, Anda membuat instance `AmazonS3URI` dengan menggunakan konstruktor. Di v2 Anda memanggil `parseUri()` instance`S3Utilities`, untuk mengembalikan file`S3URI`.


****  

| Ubah | v1 | v2 | 
| --- | --- | --- | 
|    Ketergantungan 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>  | 
| Nama paket | com.amazonaws.services.s3 | software.amazon.awssdk.services.s3 | 
| Nama kelas | [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 [Versi terbaru](https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom). 2 [Versi terbaru](https://central.sonatype.com/artifact/software.amazon.awssdk/bom).

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


| Perilaku | v1 | v2 | 
| --- | --- | --- | 
| Mengurai 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>  | 
| Ambil nama bucket dari URI S3. |  <pre>String bucket = s3Uri.getBucket();</pre>  |  <pre>Optional<String> bucket = s3Uri.bucket();</pre>  | 
| Ambil kuncinya. |  <pre>String key = s3Uri.getKey();</pre>  |  <pre>Optional<String> key = s3Uri.key();</pre>  | 
| Ambil kembali wilayah tersebut. |  <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>  | 
|  Ambil kembali apakah URI S3 adalah gaya jalur.  |  <pre>boolean isPathStyle = s3Uri.isPathStyle();</pre>  |  <pre>boolean isPathStyle = s3Uri.isPathStyle();</pre>  | 
| Ambil ID versi. |  <pre>String versionId = s3Uri.getVersionId();</pre>  |  <pre>Optional<String> versionId = <br />    s3Uri.firstMatchingRawQueryParameter("versionId");</pre>  | 
| Ambil parameter kueri. | N/A |  <pre>Map<String, List<String>> queryParams =<br />    s3Uri.rawQueryParameters();</pre>  | 

### Perubahan perilaku
<a name="migration-s3-uri-parser-behavior-changes"></a>

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

v1 menyediakan opsi untuk meneruskan bendera untuk menentukan apakah URI harus dikodekan URL. Nilai default-nya adalah `true`. 

Di v2, pengkodean URL tidak didukung. Jika Anda bekerja dengan kunci objek atau parameter kueri yang memiliki karakter cadangan atau tidak aman, Anda harus menyandikannya dengan URL. Misalnya Anda perlu mengganti spasi putih `" "` dengan. `%20`