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. 取代匯入陳述式或類別名稱
我們看到 `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 對等項目
變更 v2 之後`Ec2Client`，如果我們使用 IDE，我們會在下列陳述式中看到編譯錯誤。
```
result = ec2.describeInstances(request);
```
編譯錯誤是因為使用 v1 的 執行個體`DescribeInstancesRequest`做為 v2 `Ec2Client``describeInstances`方法的參數。若要修正，請進行下列取代或匯入陳述式。
| 取代 | 取代為 |
| --- | --- |
| import com.amazonaws.services.ec2.model.DescribeInstancesRequest
| import software.amazon.awssdk.services.ec2.model.DescribeInstancesRequest
|
#### c. 將 v1 建構器變更為 v2 建置器。
我們仍然看到編譯錯誤，因為 [v2 類別上沒有建構函數](migration-whats-different.md#immutable-classes)。若要修正，請進行下列變更。
| 變更 | 至 |
| --- | --- |
| final DescribeInstancesRequest request = new DescribeInstancesRequest()
.withInstanceIds(instanceIdsCopy);
| final DescribeInstancesRequest request = DescribeInstancesRequest.builder()
.instanceIds(instanceIdsCopy)
.build();
|
#### d. 將 v1 `*Result`回應物件取代為 v2 對`*Response`等項目
v1 和 v2 之間的一致差異是 [v2 中的所有回應物件都以 結尾，`*Response`而不是 `*Result`](migration-whats-different.md#model-classname-changes)。將 v1 `DescribeInstancesResult`匯入取代為 v2 匯入，`DescribeInstancesResponse`。
#### d. 進行 API 變更
下列陳述式需要一些變更。
```
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 類別
繼續執行其餘的程式碼。將 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 getRunningInstances(Ec2Client ec2, List instanceIds) {
List 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 匯入
遷移 檔案中的所有 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 增強功能
對於我們遷移的程式碼片段，我們可以選擇性地使用 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 映射的套件名稱
當您將 Maven 或 Gradle 專案從適用於 Java 的 SDK v1 遷移至 v2 時，您需要找出要新增至建置檔案的相依性。[遷移step-by-step說明與範例](#migration-steps) （步驟 3) 中所述的方法使用匯入陳述式中的套件名稱做為起點，以決定要新增至建置檔案的相依性 （做為 artifactIds)。
您可以使用本主題中的資訊，將 v1 套件名稱對應至 v2 artifactIds。
### 套件名稱和 Maven artifactIds 中使用的常見命名慣例
下表顯示 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 差異
#### 在 v1 內
在某些情況下，相同服務的套件名稱和 artifactId 中的 SERVICE\$1ID 會有所不同。例如，下表的 CloudWatch Metrics 資料列顯示 `metrics`是套件名稱中的 SERVICE\$1ID，但 `cloudwatchmetrics`是 artifactId 的 SERVICE\$1ID。
#### 在 v2 內
套件名稱和 artifactIds 中使用的 SERVICE\$1ID 沒有差異。
#### 在 v1 和 v2 之間
對於大多數服務，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 | aws-java-sdk-api-gateway | apigateway | 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 |