本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 遷移step-by-step說明與範例
<a name="migration-steps"></a>

本節提供step-by-step指南，將目前使用適用於 Java 的 SDK v1.x 的應用程式遷移至適用於 Java 的 SDK 2.x。第一部分提供步驟的概觀，後面接著詳細的遷移範例。

此處涵蓋的步驟說明正常使用案例的遷移，其中應用程式 AWS 服務 使用模型驅動的服務用戶端呼叫 。如果您需要遷移使用更高層級 APIs的程式碼，例如 [S3 Transfer Manager](migration-s3-transfer-manager.md) 或 [CloudFront 預先簽章](migration-cloudfront-presigning.md)，請參閱 目錄下的 [適用於 Java 的 AWS SDK 1.x 和 2.x 之間的差異](migration-whats-different.md) 一節。



此處所述的方法是建議。您可以使用其他技術，並利用 IDE 的程式碼編輯功能來達到相同的結果。

## 步驟概觀
<a name="migration-steps-overview"></a>

### 1. 首先新增適用於 Java 的 SDK 2.x BOM
<a name="migration-steps-overview-step1"></a>

透過將適用於 Java 的 SDK 2.x 的 Maven BOM （物料清單） 元素新增至您的 POM 檔案，您可以確保所需的所有 v2 相依性都來自相同的版本。POM 可以同時包含 v1 和 v2 相依性。這可讓您逐步遷移程式碼，而不是一次全部變更。

#### 適用於 Java 的 SDK 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>
```

您可以在 Maven Central Repository 上找到[最新版本](https://central.sonatype.com/artifact/software.amazon.awssdk/bom)。

### 2. 搜尋 v1 類別匯入陳述式的檔案
<a name="migration-steps-overview-step2"></a>

透過掃描應用程式中用於 v1 匯入的 SERVICE\$1IDs的檔案，您會找到使用的唯一 SERVICE\$1IDs。SERVICE\$1ID 是 的簡短唯一名稱 AWS 服務。例如`cognitoidentity`，Amazon Cognito Identity 的 SERVICE\$1ID。

### 3. 從 v1 匯入陳述式判斷 v2 Maven 相依性
<a name="migration-steps-overview-step3"></a>

找到所有唯一的 v1 SERVICE\$1IDs之後，您可以參考 來判斷 v2 相依性的對應 Maven 成品[Maven artifactId 映射的套件名稱](#migration-serviceid-artifactid-mapping)。

### 4. 將 v2 相依性元素新增至 POM 檔案
<a name="migration-steps-overview-step4"></a>

使用步驟 3 中確定的相依性元素更新 Maven POM 檔案。

### 5. 在 Java 檔案中，在 v1 類別上逐漸變更為 v2 類別
<a name="migration-steps-overview-step5"></a>

當您將 v1 類別取代為 v2 類別時，請進行必要的變更以支援 v2 API，例如使用建置器而非建構器，以及使用流暢的 getter 和 setter。

### 6. 從 POM 移除 v1 Maven 相依性，並從檔案移除 v1 匯入
<a name="migration-steps-overview-step6"></a>

遷移程式碼以使用 v2 類別後，請從檔案移除任何剩餘的 v1 匯入，並從建置檔案移除所有相依性。

### 7. 重構程式碼以使用 v2 API 增強功能
<a name="migration-steps-overview-step7"></a>

程式碼成功編譯並通過測試後，您可以利用 v2 增強功能，例如使用不同的 HTTP 用戶端或分頁程式來簡化程式碼。此為選用步驟。

## 遷移範例
<a name="migration-steps-example"></a>

在此範例中，我們會遷移使用適用於 Java v1 的 SDK 並存取數個 的應用程式 AWS 服務。我們在步驟 5 中詳細說明下列 v1 方法。這是類別中的一種方法，其中包含八個方法，應用程式中有 32 個類別。

### 要遷移的 v1 方法
<a name="v1-snippet-collapsed"></a>

只有 v1 SDK 匯入會從 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. 新增 v2 Maven BOM
<a name="migration-steps-example-step1"></a>

將適用於 Java 的 SDK 2.x 的 Maven BOM 與 `dependencyManagement`區段中的任何其他相依性一起新增至 POM。如果您的 POM 檔案具有開發套件 v1 的 BOM，請暫時保留它。稍後的步驟會將其移除。

#### 開始時的 POM 相依性管理
<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. 搜尋 v1 類別匯入陳述式的檔案
<a name="migration-steps-example-step2"></a>

搜尋應用程式的程式碼，找出唯一出現的 `import com.amazonaws.services`。這有助於我們判斷專案使用的 v1 相依性。如果您的應用程式有列出 v1 相依性的 Maven POM 檔案，您可以改為使用此資訊。

在此範例中，我們使用 [`ripgrep`(rg)](https://github.com/BurntSushi/ripgrep) 命令來搜尋程式碼庫。

從程式碼基礎的根目錄，執行下列`ripgrep`命令。`ripgrep` 找到匯入陳述式後，這些陳述式會輸送至 `cut`、 `sort`和 `uniq`命令，以隔離 SERVICE\$1IDs。

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

對於此應用程式，下列 SERVICE\$1IDs會記錄到 主控台。

```
autoscaling
cloudformation
ec2
identitymanagement
```

這表示`import`陳述式中所使用的下列每個套件名稱至少都會出現一次。基於我們的目的，個別類別名稱並不重要。我們只需要尋找使用的 SERVICE\$1IDs。

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

### 3. 從 v1 匯入陳述式判斷 v2 Maven 相依性
<a name="migration-steps-example-step3"></a>

我們從步驟 2 隔離的 v1 的 SERVICE\$1IDs，例如 `autoscaling`和 `cloudformation`，可以映射到大部分的相同 v2 SERVICE\$1ID。由於 v2 Maven artifactId 在大多數情況下都符合 SERVICE\$1ID，因此您擁有將相依性區塊新增至 POM 檔案所需的資訊。

下表顯示如何判斷 v2 相依性。


| v1 SERVICE\$1ID 映射至 ...套件名稱 | v2 SERVICE\$1ID 映射至 ...套件名稱 | v2 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>  | 
|  **自動擴展** `com.amazonaws.services.autoscaling.*`  |  **自動擴展** `software.amazon.awssdk.services.autoscaling.*`  |  <pre><dependency><br />  <groupId>software.amazon.awssdk</groupId><br />  <artifactId>autoscaling</artifactId><br /></dependency></pre>  | 
| cloudformation`com.amazonaws.services.cloudformation.*` | cloudformation`software.amazon.awssdk.cloudformation.*` |  <pre><dependency><br />  <groupId>software.amazon.awssdk</groupId><br />  <artifactId>cloudformation</artifactId><br /></dependency></pre>  | 
| 身分管理\$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 `identitymanagement``iam`映射的 是例外狀況，其中 SERVICE\$1ID 在版本之間不同。如果 Maven 或 Gradle 無法解析 v2 相依性，請參閱 [Maven artifactId 映射的套件名稱](#migration-serviceid-artifactid-mapping) 以取得例外狀況。

### 4. 將 v2 相依性元素新增至 POM 檔案
<a name="migration-steps-example-step4"></a>

在步驟 3 中，我們決定了需要新增到 POM 檔案的四個相依性區塊。我們不需要新增版本，因為我們已在步驟 1 中指定 BOM。新增匯入後，我們的 POM 檔案具有下列相依性元素。

```
    ...
  <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. 在 Java 檔案中，在 v1 類別上逐漸變更為 v2 類別
<a name="migration-steps-example-step5"></a>

在我們遷移的方法中，我們會看到
+ 來自 的 EC2 服務用戶端`com.amazonaws.services.ec2.AmazonEC2Client`。
+ 使用的數個 EC2 模型類別。例如 `DescribeInstancesRequest`和 `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;
}
...
```

我們的目標是將所有 v1 匯入取代為 v2 匯入。我們會一次繼續一個類別。

#### a. 取代匯入陳述式或類別名稱
<a name="migration-example-step5-substep1"></a>

我們看到 `describeRunningInstances`方法的第一個參數是 v1 `AmazonEC2Client`執行個體。執行以下任意一項：
+ 將 的匯入取代`com.amazonaws.services.ec2.AmazonEC2Client`為 `software.amazon.awssdk.services.ec2.Ec2Client`，並`AmazonEC2Client`變更為 `Ec2Client`。
+ 將參數類型變更為 ，`Ec2Client`並讓 IDE 提示我們正確匯入。我們的 IDE 會提示我們匯入 v2 類別，因為用戶端名稱不同 -`AmazonEC2Client` 和 `Ec2Client`。如果兩個版本中的類別名稱相同，則此方法無法運作。

#### b. 將 v1 模型類別取代為 v2 對等項目
<a name="migration-example-step5-substep2"></a>

變更 v2 之後`Ec2Client`，如果我們使用 IDE，我們會在下列陳述式中看到編譯錯誤。

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

編譯錯誤是因為使用 v1 的 執行個體`DescribeInstancesRequest`做為 v2 `Ec2Client``describeInstances`方法的參數。若要修正，請進行下列取代或匯入陳述式。


| 取代 | 取代為 | 
| --- | --- | 
|  <pre>import com.amazonaws.services.ec2.model.DescribeInstancesRequest</pre>  |  <pre>import software.amazon.awssdk.services.ec2.model.DescribeInstancesRequest</pre>  | 

#### c. 將 v1 建構器變更為 v2 建置器。
<a name="migration-example-step5-substep3"></a>

我們仍然看到編譯錯誤，因為 [v2 類別上沒有建構函數](migration-whats-different.md#immutable-classes)。若要修正，請進行下列變更。


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

#### d. 將 v1 `*Result`回應物件取代為 v2 對`*Response`等項目
<a name="migration-example-step5-substep4"></a>

v1 和 v2 之間的一致差異是 [v2 中的所有回應物件都以 結尾，`*Response`而不是 `*Result`](migration-whats-different.md#model-classname-changes)。將 v1 `DescribeInstancesResult`匯入取代為 v2 匯入，`DescribeInstancesResponse`。

#### d. 進行 API 變更
<a name="migration-example-step5-substep5"></a>

下列陳述式需要一些變更。

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

在 v2 中，[設定程式方法](migration-whats-different.md#setter-getter-methods)不使用 `set`或 搭配 `prefix`。字首`get`為 的 Getter 方法也會出現在適用於 Java 的 SDK 2.x 中

`request` 執行個體等模型類別在 v2 中是不可變的，因此我們需要使用`DescribeInstancesRequest`建置器建立新的 。

在 v2 中， 陳述式會變成以下內容。

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

#### d. 重複此動作，直到方法編譯為 v2 類別
<a name="migration-example-step5-substep6"></a>

繼續執行其餘的程式碼。將 v1 匯入取代為 v2 匯入並修正編譯錯誤。如有需要，請參閱 [v2 API 參考](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/package-summary.html)和[什麼是不同的參考](migration-whats-different.md)。

遷移此單一方法後，我們有下列 v2 程式碼。

```
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;
    }
...
```

由於我們正在以八種方法遷移 Java 檔案中的單一方法，因此在處理檔案時，我們會混合使用 v1 和 v2 匯入。我們在執行步驟時新增了最後六個匯入陳述式。

遷移所有程式碼後，將不再有 v1 匯入陳述式。

### 6. 從 POM 移除 v1 Maven 相依性，並從檔案移除 v1 匯入
<a name="migration-steps-example-step6"></a>

遷移 檔案中的所有 v1 程式碼後，我們會有下列 v2 SDK 匯入陳述式。

```
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;
```

遷移應用程式*中的所有*檔案後，我們不再需要 POM 檔案中的 v1 相依性。如果使用 和所有 v1 相依性區塊，請從 `dependencyManagement`區段移除 v1 BOM。

### 7. 重構程式碼以使用 v2 API 增強功能
<a name="migration-steps-example-step7"></a>

對於我們遷移的程式碼片段，我們可以選擇性地使用 v2 分頁程式，並讓 SDK 管理更多資料的字符型請求。

我們可以將整個 `do` 子句取代為以下內容。

```
                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);
                                    }
                                }));
```

## Maven artifactId 映射的套件名稱
<a name="migration-serviceid-artifactid-mapping"></a>

當您將 Maven 或 Gradle 專案從適用於 Java 的 SDK v1 遷移至 v2 時，您需要找出要新增至建置檔案的相依性。[遷移step-by-step說明與範例](#migration-steps) （步驟 3) 中所述的方法使用匯入陳述式中的套件名稱做為起點，以決定要新增至建置檔案的相依性 （做為 artifactIds)。

您可以使用本主題中的資訊，將 v1 套件名稱對應至 v2 artifactIds。

### 套件名稱和 Maven artifactIds 中使用的常見命名慣例
<a name="migration-naming-convention"></a>

下表顯示 SDKs用於指定 SERVICE\$1ID 的常見命名慣例。SERVICE\$1ID 是 的唯一識別符 AWS 服務。例如，Amazon S3 服務的 SERVICE\$1ID 是 `s3`，而 `cognitoidentity` 是 Amazon Cognito Identity 的 SERVICE\$1ID。


| v1 套件名稱 （匯入陳述式） | v1 artifactId | v2 artifactId | v2 套件名稱 （匯入陳述式） | 
| --- | --- | --- | --- | 
| com.amazonaws.services.SERVICE\$1ID | aws-java-sdk-SERVICE\$1ID | SERVICE\$1ID | software.amazon.awssdk.services.SERVICE\$1ID | 
|   | 
| Amazon Cognito Identity (SERVICE\$1ID：cognitoidentity) 的範例 | 
| com.amazonaws.services.cognitoidentity | aws-java-sdk-cognitoidentity | cognitoidentity | software.amazon.awssdk.services.cognitoidentity | 

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

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

在某些情況下，相同服務的套件名稱和 artifactId 中的 SERVICE\$1ID 會有所不同。例如，下表的 CloudWatch Metrics 資料列顯示 `metrics`是套件名稱中的 SERVICE\$1ID，但 `cloudwatchmetrics`是 artifactId 的 SERVICE\$1ID。

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

套件名稱和 artifactIds 中使用的 SERVICE\$1ID 沒有差異。

#### 在 v1 和 v2 之間
<a name="migration-serviceid-diffs-btwv1v2"></a>

對於大多數服務，v2 中的 SERVICE\$1ID 與套件名稱和 artifactIds 中的 v1 的 SERVICE\$1ID 相同。其中一個範例是 `cognitoedentity` SERVICE\$1ID，如上表所示。不過，某些 SERVICE\$1IDs會因 SDKs 而有所不同，如下表所示。

任一 v1 資料欄中的**粗體 SERVICE\$1ID** 表示它與 v2 中使用的 SERVICE\$1ID 不同。


| 服務名稱 | v1 套件名稱 | v1 artifactId | v2 artifactId | v2 套件名稱 | 
| --- | --- | --- | --- | --- | 
|  |  所有套件名稱都以 開頭`com.amazonaws.services`，如第一列所示。  |  所有 artifactIds都包含在標籤中，如第一列所示。  |  所有 artifactIds都包含在標籤中，如第一列所示。  |  所有套件名稱都以 開頭`software.amazon.awssdk`，如第一列所示。  | 
|  | 
| API Gateway | com.amazonaws.services.apigateway | <artifactId>aws-java-sdk-api-gateway</artifactId> | <artifactId>apigateway</artifactId> | software.amazon.awssdk.services.apigateway | 
| 應用程式登錄檔 | appregistry | appregistry | servicecatalogappregistry | servicecatalogappregistry | 
| Application Discovery | applicationdiscovery | 探索 | applicationdiscovery | applicationdiscovery | 
| 增強版 AI 執行期 | augmentedairuntime | augmentedairuntime | sagemakera2iruntime | sagemakera2iruntime | 
| Certificate Manager | certificatemanager | acm | acm | acm | 
| CloudControl API | cloudcontrolapi | cloudcontrolapi | cloudcontrol | cloudcontrol | 
| CloudSearch | cloudsearchv2 | cloudsearch | cloudsearch | cloudsearch | 
| CloudSearch 網域 | cloudsearchdomain | cloudsearch | cloudsearchdomain | cloudsearchdomain | 
| CloudWatch Events | cloudwatchevents | 事件 | cloudwatchevents | cloudwatchevents | 
| CloudWatch Evidently | cloudwatch 顯而易見 | cloudwatch 明顯地 | evidently | evidently | 
| CloudWatch Logs | logs | logs | cloudwatchlogs | cloudwatchlogs | 
| CloudWatch Metrics | 指標 | cloudwatchmetrics | cloudwatch | cloudwatch | 
| CloudWatch Rum | cloudwatchrum | cloudwatchrum | rum | rum | 
| Cognito 身分提供者 | cognitoidp | cognitoidp | cognitoidentityprovider | cognitoidentityprovider | 
| Connect 行銷活動 | connectcampaign | connectcampaign | 連線行銷活動 | 連線行銷活動 | 
| Connect Wisdom | connectwisdom | connectwisdom | wisdom | wisdom | 
| 資料庫遷移服務 | databasemigrationservice | dms | 資料庫遷移 | 資料庫遷移 | 
| DataZone | 資料區域 | datazoneexternal | 資料區域 | 資料區域 | 
| DynamoDB | dynamodbv2 | dynamodb | dynamodb | dynamodb | 
| 彈性檔案系統 | elasticfile 系統 | efs | efs | efs | 
| 彈性映射減少 | elasticmapreduce | emr | emr | emr | 
| Glue DataBrew | gluedatabrew | gluedatabrew | databrew | databrew | 
| IAM Roles Anywhere | iamrolesanywhere | iamrolesanywhere | rolesanywhere | rolesanywhere | 
| 身分管理 | 身分管理 | iam | iam | iam | 
| IoT 資料 | iotdata | iot | iotdataplane | iotdataplane | 
| Kinesis Analytics | kinesisanalytics | kinesis | kinesisanalytics | kinesisanalytics | 
| Kinesis Firehose | kinesisfirehose | kinesis | firehose | firehose | 
| Kinesis Video Signaling 頻道 | kinesisvideosignaling 頻道 | kinesisvideosignaling 頻道 | kinesisvideosignaling | kinesisvideosignaling | 
| Lex | lexruntime | lex | lexruntime | lexruntime | 
| 注視視覺 | lookoutforvision | lookoutforvision | lookoutvision | lookoutvision | 
| 大型主機現代化 | 大型主機模式 | 大型主機模式 | m2 | m2 | 
| Marketplace 計量 | 市場計量 | Marketplacemeteringservice | 市場計量 | 市場計量 | 
| 受管 Grafana | 受管格拉法納 | 受管格拉法納 | grafana | grafana | 
| 機械 Turk | 泥濘 | Mechanicalturkrequester | 泥濘 | 泥濘 | 
| Migration Hub 策略建議 | migrationhubstrategyrecommendations | migrationhubstrategyrecommendations | migrationhubstrategy | migrationhubstrategy | 
| Nimble Studio | nimblestudio | nimblestudio | nimble | nimble | 
| 私有 5G | private5g | private5g | 私有網路 | 私有網路 | 
| Prometheus | prometheus | prometheus | amp | amp | 
| 資源回收筒 | 資源回收筒 | 資源回收筒 | rbin | rbin | 
| Redshift 資料 API | redshiftdataapi | redshiftdataapi | redshiftdata | redshiftdata | 
| Route 53 | route53網域 | route53 | route53網域 | route53網域 | 
| Sage Maker Edge Manager | sagemakeredgemanager | sagemakeredgemanager | sagemakeredge | sagemakeredge | 
| 安全字符 | securitytoken | sts | sts | sts | 
| 伺服器遷移 | 伺服器遷移 | 伺服器遷移 | sms | sms | 
| 簡易電子郵件 | simpleemail | ses | ses | ses | 
| 簡易電子郵件 V2 | simpleemailv2 | sesv2 | sesv2 | sesv2 | 
| 簡易系統管理 | Simplesystems 管理 | ssm | ssm | ssm | 
| 簡單工作流程 | Simpleworkflow | Simpleworkflow | swf | swf | 
| 步驟函數 | 步驟函數 | 步驟函數 | sfn | sfn |