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

# step-by-stepInstruksi migrasi dengan contoh
<a name="migration-steps"></a>

Bagian ini menyediakan step-by-step panduan untuk memigrasikan aplikasi Anda yang saat ini menggunakan SDK for Java v1.x ke SDK for Java 2.x. Bagian pertama menyajikan ikhtisar langkah-langkah yang diikuti dengan contoh rinci migrasi.

Langkah-langkah yang dibahas di sini menjelaskan migrasi kasus penggunaan normal, di mana aplikasi memanggil Layanan AWS menggunakan klien layanan berbasis model. Jika Anda perlu memigrasikan kode yang menggunakan level yang lebih tinggi APIs seperti [S3 Transfer Manager](migration-s3-transfer-manager.md) atau [CloudFrontpresigning](migration-cloudfront-presigning.md), lihat bagian di bawah [Apa yang berbeda antara AWS SDK untuk Java 1.x dan 2.x](migration-whats-different.md) daftar isi.



Pendekatan yang dijelaskan di sini adalah saran. Anda dapat menggunakan teknik lain dan memanfaatkan fitur pengeditan kode IDE Anda untuk mencapai hasil yang sama. 

## Ikhtisar langkah-langkah
<a name="migration-steps-overview"></a>

### 1. Mulailah dengan menambahkan SDK for Java 2.x BOM
<a name="migration-steps-overview-step1"></a>

Dengan menambahkan elemen Maven BOM (Bill of Materials) untuk SDK for Java 2.x ke file POM Anda, Anda memastikan bahwa semua ketergantungan v2 yang Anda butuhkan berasal dari versi yang sama. POM Anda dapat berisi dependensi v1 dan v2. Ini memungkinkan Anda untuk memigrasikan kode secara bertahap daripada mengubah semuanya sekaligus.

#### SDK for Java 2.x BOM
<a name="drt_b5n_q1c"></a>

```
<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>software.amazon.awssdk</groupId>
      <artifactId>bom</artifactId>
      <version>2.27.21</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>
```

Anda dapat menemukan [versi terbaru](https://central.sonatype.com/artifact/software.amazon.awssdk/bom) di Maven Central Repository.

### 2. Cari file untuk pernyataan impor kelas v1
<a name="migration-steps-overview-step2"></a>

Dengan memindai file dalam aplikasi Anda untuk SERVICE\$1 yang IDs digunakan dalam impor v1, Anda akan menemukan SERVICE\$1 unik yang digunakan. IDs SERVICE\$1ID adalah nama pendek dan unik untuk sebuah. Layanan AWS Misalnya `cognitoidentity` adalah SERVICE\$1ID untuk Identitas Amazon Cognito.

### 3. Tentukan dependensi Maven v2 dari pernyataan impor v1
<a name="migration-steps-overview-step3"></a>

Setelah Anda menemukan semua v1 SERVICE\$1 yang unikIDs, Anda dapat menentukan artefak Maven yang sesuai untuk ketergantungan v2 dengan mengacu pada. [Nama Package untuk pemetaan ArtifactID Maven](#migration-serviceid-artifactid-mapping)

### 4. Tambahkan elemen ketergantungan v2 ke file POM
<a name="migration-steps-overview-step4"></a>

Perbarui file Maven POM dengan elemen ketergantungan ditentukan pada langkah 3.

### 5. Dalam file Java, secara bertahap ubah kelas v1 ke kelas v2
<a name="migration-steps-overview-step5"></a>

Saat Anda mengganti kelas v1 dengan kelas v2, buat perubahan yang diperlukan untuk mendukung API v2 seperti menggunakan pembangun alih-alih konstruktor dan menggunakan pengambil dan penyetel yang lancar.

### 6. Hapus dependensi v1 Maven dari impor POM dan v1 dari file
<a name="migration-steps-overview-step6"></a>

Setelah memigrasikan kode untuk menggunakan kelas v2, hapus semua impor v1 yang tersisa dari file dan semua dependensi dari file build Anda.

### 7. Memfaktorkan ulang kode untuk menggunakan penyempurnaan API v2
<a name="migration-steps-overview-step7"></a>

Setelah kode berhasil mengkompilasi dan lulus tes, Anda dapat memanfaatkan penyempurnaan v2 seperti menggunakan klien HTTP atau paginator yang berbeda untuk menyederhanakan kode. Ini adalah langkah opsional.

## Contoh migrasi
<a name="migration-steps-example"></a>

Dalam contoh ini, kami memigrasikan aplikasi yang menggunakan SDK for Java v1 dan mengakses beberapa. Layanan AWS Kami bekerja melalui metode v1 berikut secara rinci di langkah 5. Ini adalah salah satu metode dalam kelas yang berisi delapan metode dan ada 32 kelas dalam aplikasi.

### metode v1 untuk bermigrasi
<a name="v1-snippet-collapsed"></a>

Hanya impor SDK v1 yang tercantum di bawah ini dari file Java.

```
import com.amazonaws.ClientConfiguration;
import com.amazonaws.regions.Region;
import com.amazonaws.regions.RegionUtils;
import com.amazonaws.services.ec2.AmazonEC2Client;
import com.amazonaws.services.ec2.model.AmazonEC2Exception;
import com.amazonaws.services.ec2.model.CreateTagsRequest;
import com.amazonaws.services.ec2.model.DescribeInstancesRequest;
import com.amazonaws.services.ec2.model.DescribeInstancesResult;
import com.amazonaws.services.ec2.model.Instance;
import com.amazonaws.services.ec2.model.InstanceStateName;
import com.amazonaws.services.ec2.model.Reservation;
import com.amazonaws.services.ec2.model.Tag;
import com.amazonaws.services.ec2.model.TerminateInstancesRequest;
...
private static List<Instance> getRunningInstances(AmazonEC2Client ec2, List<String> instanceIds) {
    List<Instance> runningInstances = new ArrayList<>();
    try {
        DescribeInstancesRequest request = new DescribeInstancesRequest()
                .withInstanceIds(instanceIds);
        DescribeInstancesResult result;
        do {
            // DescribeInstancesResponse is a paginated response, so use tokens with multiple requests.
            result = ec2.describeInstances(request);
            request.setNextToken(result.getNextToken());   // Prepare request for next page.
            for (final Reservation r : result.getReservations()) {
                for (final Instance instance : r.getInstances()) {
                    LOGGER.info("Examining instanceId: "+ instance.getInstanceId());
                    // if instance is in a running state, add it to runningInstances list.
                    if (RUNNING_STATES.contains(instance.getState().getName())) {
                        runningInstances.add(instance);
                    }
                }
            }
        } while (result.getNextToken() != null);
    } catch (final AmazonEC2Exception exception) {
        // if instance isn't found, assume its terminated and continue.
        if (exception.getErrorCode().equals(NOT_FOUND_ERROR_CODE)) {
            LOGGER.info("Instance probably terminated; moving on.");
        } else {
            throw exception;
        }
    }
    return runningInstances;
}
```

### 1. Tambahkan v2 Maven BOM
<a name="migration-steps-example-step1"></a>

Tambahkan Maven BOM untuk SDK for Java 2.x ke POM di samping dependensi lain di bagian tersebut. `dependencyManagement` Jika file POM Anda memiliki BOM untuk v1 SDK, biarkan untuk saat ini. Ini akan dihapus pada langkah selanjutnya.

#### Manajemen Ketergantungan POM di awal
<a name="migration-example-boms"></a>

```
<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>org.example</groupId>             <!--Existing dependency in POM. -->
      <artifactId>bom</artifactId>
      <version>1.3.4</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
    ...
    <dependency>
      <groupId>com.amazonaws</groupId>
      <artifactId>aws-java-sdk-bom</artifactId>  <!--Existing v1 BOM dependency. -->
      <version>1.11.1000</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
    ...
    <dependency>
      <groupId>software.amazon.awssdk</groupId>  <!--Add v2 BOM dependency. -->
      <artifactId>bom</artifactId>
      <version>2.27.21</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>
```

### 2. Cari file untuk pernyataan impor kelas v1
<a name="migration-steps-example-step2"></a>

Cari kode aplikasi untuk kejadian unik. `import com.amazonaws.services` Ini membantu kami menentukan dependensi v1 yang digunakan oleh proyek. Jika aplikasi Anda memiliki file POM Maven dengan dependensi v1 terdaftar, Anda dapat menggunakan informasi ini sebagai gantinya. 

Untuk contoh ini kita menggunakan perintah [`ripgrep`(rg)](https://github.com/BurntSushi/ripgrep) untuk mencari basis kode.

Dari root basis kode Anda, jalankan `ripgrep` perintah berikut. Setelah `ripgrep` menemukan pernyataan impor, mereka disalurkan ke`cut`,`sort`, dan `uniq` perintah untuk mengisolasi SERVICE\$1. IDs 

```
rg --no-filename 'import\s+com\.amazonaws\.services' | cut -d '.' -f 4 | sort | uniq
```

Untuk aplikasi ini, SERVICE\$1 IDs berikut dicatat ke konsol.

```
autoscaling
cloudformation
ec2
identitymanagement
```

Ini menunjukkan bahwa setidaknya ada satu kemunculan dari masing-masing nama paket berikut yang digunakan dalam `import` pernyataan. Untuk tujuan kita, nama kelas individu tidak masalah. Kita hanya perlu menemukan SERVICE\$1 IDs yang digunakan.

```
com.amazonaws.services.autoscaling.*
com.amazonaws.services.cloudformation.*
com.amazonaws.services.ec2.*
com.amazonaws.services.identitymanagement.*
```

### 3. Tentukan dependensi Maven v2 dari pernyataan impor v1
<a name="migration-steps-example-step3"></a>

SERVICE\$1 IDs untuk v1 yang kami isolasi dari Langkah 2—misalnya `cloudformation` dan—dapat dipetakan ke `autoscaling` v2 SERVICE\$1ID yang sama untuk sebagian besar. Karena artifactID Maven v2 cocok dengan SERVICE\$1ID dalam banyak kasus, Anda memiliki informasi yang Anda perlukan untuk menambahkan blok ketergantungan ke file POM Anda.

Tabel berikut menunjukkan bagaimana kita dapat menentukan dependensi v2.


| v1 SERVICE\$1ID memetakan ke...nama paket | v2 SERVICE\$1ID memetakan ke...nama paket | v2 Ketergantungan Maven | 
| --- | --- | --- | 
|  **ec2** `com.amazonaws.services.ec2.*`  |  **ec2** `software.amazon.awssdk.services.ec2.*`  |  <pre><dependency><br />  <groupId>software.amazon.awssdk</groupId><br />  <artifactId>ec2</artifactId><br /></dependency></pre>  | 
|  **penskalaan otomatis** `com.amazonaws.services.autoscaling.*`  |  **penskalaan otomatis** `software.amazon.awssdk.services.autoscaling.*`  |  <pre><dependency><br />  <groupId>software.amazon.awssdk</groupId><br />  <artifactId>autoscaling</artifactId><br /></dependency></pre>  | 
| pembentukan awan`com.amazonaws.services.cloudformation.*` | pembentukan awan`software.amazon.awssdk.cloudformation.*` |  <pre><dependency><br />  <groupId>software.amazon.awssdk</groupId><br />  <artifactId>cloudformation</artifactId><br /></dependency></pre>  | 
| manajemen identitas\$1`com.amazonaws.services.identitymanagement.*` | iam\$1`software.amazon.awssdk.iam.*` |  <pre><dependency><br />  <groupId>software.amazon.awssdk</groupId><br />  <artifactId>iam</artifactId><br /></dependency></pre>  | 

\$1 The `identitymanagement` to `iam` mapping adalah pengecualian di mana SERVICE\$1ID berbeda antar versi. Lihat pengecualian [Nama Package untuk pemetaan ArtifactID Maven](#migration-serviceid-artifactid-mapping) untuk jika Maven atau Gradle tidak dapat menyelesaikan ketergantungan v2.

### 4. Tambahkan elemen ketergantungan v2 ke file POM
<a name="migration-steps-example-step4"></a>

Pada langkah 3, kami menentukan empat blok ketergantungan yang perlu ditambahkan ke file POM. Kami tidak perlu menambahkan versi karena kami telah menentukan BOM di langkah 1. Setelah impor ditambahkan, file POM kami memiliki elemen ketergantungan berikut.

```
    ...
  <dependencies>
    ...
    <dependency>
      <groupId>software.amazon.awssdk</groupId>
      <artifactId>autoscaling</artifactId>
    </dependency>
    <dependency>
      <groupId>software.amazon.awssdk</groupId>
      <artifactId>iam</artifactId>
    </dependency>
    <dependency>
      <groupId>software.amazon.awssdk</groupId>
      <artifactId>cloudformation</artifactId>
    </dependency>
    <dependency>
      <groupId>software.amazon.awssdk</groupId>
      <artifactId>ec2</artifactId>
    </dependency>
    ...
  </dependencies>
    ...
```

### 5. Dalam file Java, secara bertahap ubah kelas v1 ke kelas v2
<a name="migration-steps-example-step5"></a>

Dalam metode yang kita migrasi, kita lihat
+ Klien layanan EC2 dari`com.amazonaws.services.ec2.AmazonEC2Client`.
+ Beberapa kelas model EC2 digunakan. Misalnya `DescribeInstancesRequest` dan`DescribeInstancesResult`.

```
import com.amazonaws.ClientConfiguration;
import com.amazonaws.regions.Region;
import com.amazonaws.regions.RegionUtils;
import com.amazonaws.services.ec2.AmazonEC2Client;
import com.amazonaws.services.ec2.model.AmazonEC2Exception;
import com.amazonaws.services.ec2.model.CreateTagsRequest;
import com.amazonaws.services.ec2.model.DescribeInstancesRequest;
import com.amazonaws.services.ec2.model.DescribeInstancesResult;
import com.amazonaws.services.ec2.model.Instance;
import com.amazonaws.services.ec2.model.InstanceStateName;
import com.amazonaws.services.ec2.model.Reservation;
import com.amazonaws.services.ec2.model.Tag;
import com.amazonaws.services.ec2.model.TerminateInstancesRequest;
...
private static List<Instance> getRunningInstances(AmazonEC2Client ec2, List<String> instanceIds)
    List<Instance> runningInstances = new ArrayList<>();
    try {
        DescribeInstancesRequest request = new DescribeInstancesRequest()
                .withInstanceIds(instanceIds);
        DescribeInstancesResult result;
        do {
            // DescribeInstancesResponse is a paginated response, so use tokens with multiple re
            result = ec2.describeInstances(request);
            request.setNextToken(result.getNextToken());   // Prepare request for next page.
            for (final Reservation r : result.getReservations()) {
                for (final Instance instance : r.getInstances()) {
                    LOGGER.info("Examining instanceId: "+ instance.getInstanceId());
                    // if instance is in a running state, add it to runningInstances list.
                    if (RUNNING_STATES.contains(instance.getState().getName())) {
                        runningInstances.add(instance);
                    }
                }
            }
        } while (result.getNextToken() != null);
    } catch (final AmazonEC2Exception exception) {
        // if instance isn't found, assume its terminated and continue.
        if (exception.getErrorCode().equals(NOT_FOUND_ERROR_CODE)) {
            LOGGER.info("Instance probably terminated; moving on.");
        } else {
            throw exception;
        }
    }
    return runningInstances;
}
...
```

Tujuan kami adalah mengganti semua impor v1 dengan impor v2. Kami melanjutkan satu kelas pada satu waktu.

#### a. Ganti pernyataan impor atau nama kelas
<a name="migration-example-step5-substep1"></a>

Kita melihat bahwa parameter pertama untuk `describeRunningInstances` metode ini adalah `AmazonEC2Client` instance v1. Lakukan salah satu tindakan berikut:
+ Ganti impor untuk `com.amazonaws.services.ec2.AmazonEC2Client` dengan `software.amazon.awssdk.services.ec2.Ec2Client` dan ubah `AmazonEC2Client` ke`Ec2Client`.
+ Ubah tipe parameter menjadi `Ec2Client` dan biarkan IDE meminta kami untuk impor yang benar. IDE kami akan meminta kami untuk mengimpor kelas v2 karena nama klien berbeda— `AmazonEC2Client` dan`Ec2Client`. Pendekatan ini tidak berfungsi jika nama kelas sama di kedua versi.

#### b. Ganti kelas model v1 dengan setara v2
<a name="migration-example-step5-substep2"></a>

Setelah perubahan ke v2`Ec2Client`, jika kita menggunakan IDE, kita melihat kesalahan kompilasi dalam pernyataan berikut.

```
                    result = ec2.describeInstances(request);
```

Kesalahan kompilasi dihasilkan dari penggunaan instance v1 `DescribeInstancesRequest` sebagai parameter ke `Ec2Client` `describeInstances` metode v2. Untuk memperbaikinya, buat pernyataan penggantian atau impor berikut.


| menggantikan | dengan | 
| --- | --- | 
|  <pre>import com.amazonaws.services.ec2.model.DescribeInstancesRequest</pre>  |  <pre>import software.amazon.awssdk.services.ec2.model.DescribeInstancesRequest</pre>  | 

#### c. Ubah konstruktor v1 menjadi pembangun v2.
<a name="migration-example-step5-substep3"></a>

Kami masih melihat kesalahan kompilasi karena [tidak ada konstruktor di kelas v2](migration-whats-different.md#immutable-classes). Untuk memperbaikinya, buat perubahan berikut.


| perubahan | kepada | 
| --- | --- | 
|  <pre>final DescribeInstancesRequest request = new DescribeInstancesRequest()<br />        .withInstanceIds(instanceIdsCopy);</pre>  |  <pre>final DescribeInstancesRequest request = DescribeInstancesRequest.builder()<br />        .instanceIds(instanceIdsCopy)<br />        .build();</pre>  | 

#### d. Ganti objek `*Result` respons v1 dengan ekuivalen v2 `*Response`
<a name="migration-example-step5-substep4"></a>

Perbedaan yang konsisten antara v1 dan v2 adalah bahwa semua [objek respons di v2 diakhiri dengan `*Response` alih-alih. `*Result`](migration-whats-different.md#model-classname-changes) Ganti impor v1 ke `DescribeInstancesResult` impor v2,`DescribeInstancesResponse`.

#### d. Buat perubahan API
<a name="migration-example-step5-substep5"></a>

Pernyataan berikut membutuhkan beberapa perubahan.

```
request.setNextToken(result.getNextToken());
```

Dalam v2, [metode setter](migration-whats-different.md#setter-getter-methods) tidak menggunakan `set` atau dengan`prefix`. Metode getter yang diawali dengan `get` juga hilang di SDK for Java 2.x

Kelas model, seperti `request` instance, tidak dapat diubah di v2, jadi kita perlu membuat yang baru `DescribeInstancesRequest` dengan pembangun.

Dalam v2, pernyataan menjadi sebagai berikut.

```
request = DescribeInstancesRequest.builder()
        .nextToken(result.nextToken())
        .build();
```

#### d. Ulangi sampai metode dikompilasi dengan kelas v2
<a name="migration-example-step5-substep6"></a>

Lanjutkan dengan sisa kode. Ganti impor v1 dengan impor v2 dan perbaiki kesalahan kompilasi. Lihat [Referensi API v2 dan Referensi](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/package-summary.html) [apa yang berbeda](migration-whats-different.md) sesuai kebutuhan.

Setelah kami memigrasikan metode tunggal ini, kami memiliki kode v2 berikut.

```
import com.amazonaws.ClientConfiguration;
import com.amazonaws.regions.Region;
import com.amazonaws.regions.RegionUtils;
import com.amazonaws.services.ec2.AmazonEC2Client;
import com.amazonaws.services.ec2.model.AmazonEC2Exception;
import com.amazonaws.services.ec2.model.CreateTagsRequest;
import com.amazonaws.services.ec2.model.InstanceStateName;
import com.amazonaws.services.ec2.model.Tag;
import com.amazonaws.services.ec2.model.TerminateInstancesRequest;

import software.amazon.awssdk.services.ec2.Ec2Client;
import software.amazon.awssdk.services.ec2.model.DescribeInstancesRequest;
import software.amazon.awssdk.services.ec2.model.DescribeInstancesResponse;
import software.amazon.awssdk.services.ec2.model.Ec2Exception;
import software.amazon.awssdk.services.ec2.model.Instance;
import software.amazon.awssdk.services.ec2.model.Reservation;
...
private static List<Instance> getRunningInstances(Ec2Client ec2, List<String> instanceIds) {
    List<Instance> runningInstances = new ArrayList<>();
        try {
            DescribeInstancesRequest request = DescribeInstancesRequest.builder()
                    .instanceIds(instanceIds)
                    .build();
            DescribeInstancesResponse result;
            do {
                // DescribeInstancesResponse is a paginated response, so use tokens with multiple re
                result = ec2.describeInstances(request);
                request = DescribeInstancesRequest.builder()   // Prepare request for next page.
                        .nextToken(result.nextToken())
                        .build();
                for (final Reservation r : result.reservations()) {
                    for (final Instance instance : r.instances()) {
                        // if instance is in a running state, add it to runningInstances list.
                        if (RUNNING_STATES.contains(instance.state().nameAsString())) {
                            runningInstances.add(instance);
                        }
                    }
                }
            } while (result.nextToken() != null);
        } catch (final Ec2Exception exception) {
            // if instance isn't found, assume its terminated and continue.
            if (exception.awsErrorDetails().errorCode().equals(NOT_FOUND_ERROR_CODE)) {
                    LOGGER.info("Instance probably terminated; moving on.");
            } else {
                throw exception;
            }
        }
        return runningInstances;
    }
...
```

Karena kami memigrasikan satu metode dalam file Java dengan delapan metode, kami memiliki campuran impor v1 dan v2 saat kami mengerjakan file. Kami menambahkan enam pernyataan impor terakhir saat kami melakukan langkah-langkahnya. 

Setelah kami memigrasikan semua kode, tidak akan ada lagi pernyataan impor v1.

### 6. Hapus dependensi v1 Maven dari impor POM dan v1 dari file
<a name="migration-steps-example-step6"></a>

Setelah kami memigrasikan semua kode v1 dalam file, kami memiliki pernyataan impor SDK v2 berikut.

```
import software.amazon.awssdk.core.client.config.ClientOverrideConfiguration;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.regions.ServiceMetadata;
import software.amazon.awssdk.services.ec2.Ec2Client;
import software.amazon.awssdk.services.ec2.model.CreateTagsRequest;
import software.amazon.awssdk.services.ec2.model.DescribeInstancesRequest;
import software.amazon.awssdk.services.ec2.model.DescribeInstancesResponse;
import software.amazon.awssdk.services.ec2.model.Ec2Exception;
import software.amazon.awssdk.services.ec2.model.Instance;
import software.amazon.awssdk.services.ec2.model.InstanceStateName;
import software.amazon.awssdk.services.ec2.model.Reservation;
import software.amazon.awssdk.services.ec2.model.Tag;
import software.amazon.awssdk.services.ec2.model.TerminateInstancesRequest;
```

Setelah kita memigrasikan *semua* file dalam aplikasi kita, kita tidak lagi membutuhkan dependensi v1 dalam file POM kita. Hapus v1 BOM dari `dependencyManagement` bagian, jika menggunakan, dan semua blok ketergantungan v1.

### 7. Memfaktorkan ulang kode untuk menggunakan penyempurnaan API v2
<a name="migration-steps-example-step7"></a>

Untuk cuplikan yang telah kami migrasi, kami dapat menggunakan paginator v2 secara opsional dan membiarkan SDK mengelola permintaan berbasis token untuk lebih banyak data.

Kita dapat mengganti seluruh `do` klausa dengan yang berikut ini.

```
                DescribeInstancesIterable responses = ec2.describeInstancesPaginator(request);

                responses.reservations().stream()
                        .forEach(reservation -> reservation.instances()
                                .forEach(instance -> {
                                    if (RUNNING_STATES.contains(instance.state().nameAsString())) {
                                        runningInstances.put(instance.instanceId(), instance);
                                    }
                                }));
```

## Nama Package untuk pemetaan ArtifactID Maven
<a name="migration-serviceid-artifactid-mapping"></a>

Saat memigrasikan project Maven atau Gradle dari v1 SDK for Java ke v2, Anda perlu mencari tahu dependensi mana yang akan ditambahkan ke file build Anda. Pendekatan yang dijelaskan dalam [step-by-stepInstruksi migrasi dengan contoh](#migration-steps) (langkah 3) menggunakan nama paket dalam pernyataan import sebagai titik awal untuk menentukan dependensi (sebagai ArtifactIds) untuk ditambahkan ke file build Anda. 

Anda dapat menggunakan informasi dalam topik ini untuk memetakan nama paket v1 ke v2 Artifactids.

### Konvensi penamaan umum yang digunakan dalam nama paket dan Maven Artifactids
<a name="migration-naming-convention"></a>

Tabel berikut menunjukkan konvensi penamaan umum yang SDKs digunakan untuk SERVICE\$1ID tertentu. SERVICE\$1ID adalah pengidentifikasi unik untuk file. Layanan AWS Misalnya, SERVICE\$1ID untuk layanan Amazon S3 adalah `s3` dan merupakan SERVICE\$1ID untuk Identitas Amazon `cognitoidentity` Cognito.


| nama paket v1 (pernyataan impor) | v1 Artifactid | v2 Artifactid | v2 nama paket (pernyataan impor) | 
| --- | --- | --- | --- | 
| com.amazonaws.services.service\$1id | aws-java-sdk-SERVICE\$1ID | SERVICE\$1ID | Software.amazon.awssdk.services.service\$1id | 
|   | 
| Contoh untuk Identitas Amazon Cognito (SERVICE\$1ID:) cognitoidentity | 
| com.amazonaws.services. kognitoidentitas | aws-java-sdk- kognitoidentitas | kognitoidentitas | software.amazon.awssdk.services. kognitoidentitas | 

### Perbedaan SERVICE\$1ID
<a name="migration-serviceid-diffs"></a>

#### Dalam v1
<a name="migration-serviceid-diffs-withinv1"></a>

Dalam beberapa kasus, SERVICE\$1ID berbeda antara nama paket dan di ArtifactID untuk layanan yang sama. Misalnya, baris CloudWatch Metrik dari tabel berikut menunjukkan bahwa itu `metrics` adalah SERVICE\$1ID dalam nama paket tetapi `cloudwatchmetrics` merupakan SERVICE\$1ID ArtifactID.

#### Dalam v2
<a name="migration-serviceid-diffs-withinv2"></a>

Tidak ada perbedaan dalam SERVICE\$1ID yang digunakan dalam nama paket dan Artifactids.

#### Antara v1 dan v2
<a name="migration-serviceid-diffs-btwv1v2"></a>

Untuk sebagian besar layanan, SERVICE\$1ID di v2 sama dengan SERVICE\$1ID v1 di kedua nama paket dan Artifactids. Contoh dari ini adalah `cognitoedentity` SERVICE\$1ID seperti yang ditunjukkan pada tabel sebelumnya. Namun, beberapa SERVICE\$1 IDs berbeda antara SDKs seperti yang ditunjukkan pada tabel berikut.

**SERVICE\$1ID huruf tebal** di salah satu kolom v1 menunjukkan bahwa itu berbeda dari SERVICE\$1ID yang digunakan di v2.


| Nama layanan | nama paket v1 | v1 Artifactid | v2 Artifactid | v2 nama paket | 
| --- | --- | --- | --- | --- | 
|  |  Semua nama paket dimulai dengan `com.amazonaws.services` seperti yang ditunjukkan pada baris pertama.  |  Semua ArtifactID disertakan dalam tag seperti yang ditunjukkan pada baris pertama.  |  Semua ArtifactID disertakan dalam tag seperti yang ditunjukkan pada baris pertama.  |  Semua nama paket dimulai dengan `software.amazon.awssdk` seperti yang ditunjukkan pada baris pertama.  | 
|  | 
| API Gateway | com.amazonaws.services.apigateway | <artifactId>aws-java-sdk- api-gateway</artifactId> | <artifactId>apigateway</artifactId> | software.amazon.awssdk.services.apigateway | 
| Registri Aplikasi | appregistry | appregistry | servicecatalogappregistry | servicecatalogappregistry | 
| Penemuan Aplikasi | aplikasipenemuan | penemuan | aplikasipenemuan | aplikasipenemuan | 
| Runtime AI yang Augmented | augmentedairuntime | augmentedairuntime | sagemakera2iruntime | sagemakera2iruntime | 
| Certificate Manager | Certificatemanager | acm | acm | acm | 
| CloudControl API | cloudcontrolapi | cloudcontrolapi | cloudcontrol | cloudcontrol | 
| CloudSearch | cloudsearchv2 | cloudsearch | cloudsearch | cloudsearch | 
| CloudSearch Domain | cloudsearchdomain | cloudsearch | cloudsearchdomain | cloudsearchdomain | 
| CloudWatch Acara | cloudwatchevents | acara | cloudwatchevents | cloudwatchevents | 
| CloudWatch Terbukti | cloudwatchevident | cloudwatchevident | ternyata | ternyata | 
| CloudWatch Log | log | log | cloudwatchlogs | cloudwatchlogs | 
| CloudWatch Metrik | metrik | cloudwatchmetrics | cloudwatch | cloudwatch | 
| CloudWatch Rum | cloudwatchrum | cloudwatchrum | rum | rum | 
| Penyedia Identitas Cognito | cognitoidp | cognitoidp | penyedia cognitoidentityprovider | penyedia cognitoidentityprovider | 
| Kampanye Connect | connectcampaign | connectcampaign | connectcampaign | connectcampaign | 
| Connect Wisdom | connectwisdom | connectwisdom | kebijaksanaan | kebijaksanaan | 
| Database Migration Service | databasemigrationservice | dms | migrasi basis data | migrasi basis data | 
| DataZone | datazone | datazoneeksternal | datazone | datazone | 
| DynamoDB | dynamodbv2 | dynamodb | dynamodb | dynamodb | 
| Sistem File Elastis | sistem file elastis | efs | efs | efs | 
| Kurangi Peta Elastis | elasticmapreduce | emr | emr | emr | 
| Glue DataBrew | gluedatabrew | gluedatabrew | databrew | databrew | 
| IAM Roles Anywhere | iamrolesdi mana saja | iamrolesdi mana saja | peranandi mana saja | peranandi mana saja | 
| Manajemen Identitas | manajemen identitas | iam | iam | iam | 
| Data IoT | iotdata | iot | iotdataplane | iotdataplane | 
| Analisis Kinesis | kinesisanalitik | kinesis | kinesisanalitik | kinesisanalitik | 
| Kinesis Firehose | kinesisfirehose | kinesis | firehose | firehose | 
| Saluran Sinyal Video Kinesis | kinesisvideosignalingchannels | kinesisvideosignalingchannels | kinesisvideosignaling | kinesisvideosignaling | 
| Lex | lexruntime | lex | lexruntime | lexruntime | 
| Lookout Untuk Visi | lookoutforvision | lookoutforvision | lookoutvision | lookoutvision | 
| Modernisasi Mainframe | mainframemodernisasi | mainframemodernisasi | m2 | m2 | 
| Pengukuran Marketplace | pemeteran pasar | layanan marketplacemeteringservice | pemeteran pasar | pemeteran pasar | 
| Grafana yang Dikelola | managedgrafana | managedgrafana | grafana | grafana | 
| Mechanical Turk | mturk | mechanicalturkrequester | mturk | mturk | 
| Rekomendasi Strategi Migrasi Hub | Migrationhubstrategyrecommendations | Migrationhubstrategyrecommendations | Migrationhubstrategy | Migrationhubstrategy | 
| Nimble Studio | lincah studio | lincah studio | gesit | gesit | 
| 5G pribadi | private5g | private5g | privatenetworks | privatenetworks | 
| Prometheus | prometheus | prometheus | amp | amp | 
| Tempat Sampah Daur Ulang | Recyclebin | Recyclebin | rbin | rbin | 
| API Data Pergeseran Merah | redshiftdataapi | redshiftdataapi | data pergeseran merah | data pergeseran merah | 
| Route 53 | route53domain | route53 | route53domain | route53domain | 
| Manajer Tepi Pembuat Sage | sagemakeredgemanager | sagemakeredgemanager | sagemakeredge | sagemakeredge | 
| Token Keamanan | securitytoken | sts | sts | sts | 
| Migrasi Server | migrasi server | migrasi server | sms | sms | 
| Email Sederhana | email sederhana | ses | ses | ses | 
| Email Sederhana V2 | simpleemailv2 | sesv2 | sesv2 | sesv2 | 
| Manajemen Sistem Sederhana | manajemen sistem sederhana | ssm | ssm | ssm | 
| Alur Kerja Sederhana | alur kerja sederhana | alur kerja sederhana | swf | swf | 
| Step Functions | stepfungsi | stepfungsi | sfn | sfn |