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가 올바른 가져오기를 표시하도록 합니다. 클라이언트 이름이 `AmazonEC2Client` 및 `Ec2Client`와 다르기 때문에 IDE는 v2 클래스를 가져오라는 메시지를 표시합니다. 클래스 이름이 두 버전에서 동일한 경우에는 이 접근 방식이 작동하지 않습니다.
#### b. v1 모델 클래스를 v2와 동등한 클레스로 교체
v2 `Ec2Client`를 변경한 후 IDE를 사용하면 다음 문에 컴파일 오류가 표시됩니다.
```
result = ec2.describeInstances(request);
```
컴파일 오류는 v1의 `DescribeInstancesRequest` 인스턴스를 v2 `Ec2Client` `describeInstances` 메서드의 파라미터로 사용하여 발생합니다. 수정하려면 다음의 대체 또는 가져오기 문을 만듭니다.
| 대체 | with |
| --- | --- |
| 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) 때문에 컴파일 오류가 계속 표시됩니다. 수정하려면 다음 변경 사항을 적용합니다.
| 변경 | to |
| --- | --- |
| final DescribeInstancesRequest request = new DescribeInstancesRequest()
.withInstanceIds(instanceIdsCopy);
| final DescribeInstancesRequest request = DescribeInstancesRequest.builder()
.instanceIds(instanceIdsCopy)
.build();
|
#### d. v1 `*Result` 응답 객체를 v2 `*Response`에 상응하는 객체로 교체
v1과 v2의 일관된 차이점은 [v2의 모든 응답 객체가 `*Result` 대신 `*Response`로 끝나는 것](migration-whats-different.md#model-classname-changes)입니다. v1 `DescribeInstancesResult` 가져오기를 v2 가져오기인 `DescribeInstancesResponse`로 교체합니다.
#### d. API 변경 사항 적용
다음 문은 몇 가지 변경 사항이 필요합니다.
```
request.setNextToken(result.getNextToken());
```
v2에서 [setter 메서드](migration-whats-different.md#setter-getter-methods)는 `set`를 사용하거나 `prefix`와 함께 사용하지 않습니다. 또한 접두사가 `get`인 getter 메서드는 SDK for Java 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;
}
...
```
8가지 메서드로 Java 파일의 단일 메서드를 마이그레이션하기 때문에 파일을 작업할 때 v1과 v2 가져오기가 혼합되어 있습니다. 단계를 수행할 때 마지막 6개의 가져오기 문을 추가했습니다.
모든 코드를 마이그레이션하면 더 이상 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 프로젝트를 SDK for Java의 v1에서 v2로 마이그레이션할 때 빌드 파일에 추가할 종속성을 파악해야 합니다. [마이그레이션에 대한 단계별 설명(예제 포함)](#migration-steps)(3단계)에 설명된 접근 방식은 가져오기 문의 패키지 이름을 시작점으로 사용하여 빌드 파일에 추가할 종속성(artifactId)을 결정합니다.
이 주제의 정보를 사용하여 v1 패키지 이름을 v2 artifactId로 매핑합니다.
### 패키지 이름 및 Maven artifactId에 사용되는 일반적인 이름 지정 규칙
다음 테이블에는 SDK가 주어진 SERVICE\$1ID에 사용하는 일반적인 이름 지정 규칙이 나와 있습니다. SERVICE\$1ID는의 고유 식별자입니다 AWS 서비스. 예를 들어 Amazon S3 서비스의 SERVICE\$1ID는 `s3`이고 `cognitoidentity`는 Amazon Cognito 자격 증명의 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 자격 증명의 예(SERVICE\$1ID: cognitoidentity) |
| com.amazonaws.services.cognitoidentity | aws-java-sdk-cognitoidentity | cognitoidentity | software.amazon.awssdk.services.cognitoidentity |
### SERVICE\$1ID 차이점
#### v1 내
경우에 따라 SERVICE\$1ID는 패키지 이름과 동일한 서비스의 artifactId 간에 다릅니다. 예를 들어 다음 테이블의 CloudWatch Metrics 행은 `metrics`이 패키지 이름의 SERVICE\$1ID이지만 `cloudwatchmetrics`은 artifactId의 SERVICE\$1ID임을 보여줍니다.
#### v2 내
패키지 이름 및 artifactId에 사용되는 SERVICE\$1ID에는 차이가 없습니다.
#### v1 및 v2 차이
대부분의 서비스에서 v2의 SERVICE\$1ID는 패키지 이름과 artifactId 모두에서 v1의 SERVICE\$1ID와 동일합니다. 이전 테이블과 같이 `cognitoedentity` SERVICE\$1ID를 예로 들 수 있습니다. 그러나 다음 테이블과 같이 일부 SERVICE\$1ID는 SDK 간에 다릅니다.
v1 열 중 하나에 있는 **boldface SERVICE\$1ID**는 v2에 사용된 SERVICE\$1ID와 다르다는 것을 나타냅니다.
| 서비스 이름 | v1 패키지 이름 | v1 artifactId | v2 artifactId | v2 패키지 이름 |
| --- | --- | --- | --- | --- |
| | 모든 패키지 이름은 첫 번째 행에 표시된 대로 `com.amazonaws.services`로 시작합니다. | 모든 artifactId는 첫 번째 행과 같이 태그로 묶입니다. | 모든 artifactId는 첫 번째 행과 같이 태그로 묶입니다. | 모든 패키지 이름은 첫 번째 행에 표시된 대로 `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 | discovery | 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 | cloudwatchevidently | cloudwatchevidently | evidently | evidently |
| CloudWatch Logs | 로그 | 로그 | cloudwatchlogs | cloudwatchlogs |
| CloudWatch 지표 | 지표 | cloudwatchmetrics | cloudwatch | cloudwatch |
| CloudWatch Rum | cloudwatchrum | cloudwatchrum | rum | rum |
| Cognito 자격 증명 공급자 | cognitoidp | cognitoidp | cognitoidentityprovider | cognitoidentityprovider |
| 캠페인 연결 | connectcampaign | connectcampaign | connectcampaigns | connectcampaigns |
| Wisdom 연결 | connectwisdom | connectwisdom | wisdom | wisdom |
| Database Migration Service | databasemigrationservice | dms | databasemigration | databasemigration |
| DataZone | datazone | datazoneexternal | datazone | datazone |
| DynamoDB | dynamodbv2 | dynamodb | dynamodb | dynamodb |
| Elastic File System | elasticfilesystem | efs | efs | efs |
| Elastic Map Reduce | elasticmapreduce | emr | emr | emr |
| Glue DataBrew | gluedatabrew | gluedatabrew | databrew | databrew |
| IAM Roles Anywhere | iamrolesanywhere | iamrolesanywhere | rolesanywhere | rolesanywhere |
| 자격 증명 관리 | identitymanagement | iam | iam | iam |
| IoT 데이터 | iotdata | iot | iotdataplane | iotdataplane |
| Kinesis Analytics | kinesisanalytics | kinesis | kinesisanalytics | kinesisanalytics |
| Kinesis Firehose | kinesisfirehose | kinesis | firehose | firehose |
| Kinesis 비디오 신호 채널 | kinesisvideosignalingchannels | kinesisvideosignalingchannels | kinesisvideosignaling | kinesisvideosignaling |
| Lex | lexruntime | 어휘 | lexruntime | lexruntime |
| Lookout For Vision | lookoutforvision | lookoutforvision | lookoutvision | lookoutvision |
| Mainframe Modernization | mainframemodernization | mainframemodernization | m2 | m2 |
| Marketplace Metering | marketplacemetering | marketplacemeteringservice | marketplacemetering | marketplacemetering |
| 관리형 Grafana | managedgrafana | managedgrafana | grafana | grafana |
| Mechanical Turk | mturk | mechanicalturkrequester | mturk | mturk |
| Migration Hub Strategy Recommendations | migrationhubstrategyrecommendations | migrationhubstrategyrecommendations | migrationhubstrategy | migrationhubstrategy |
| Nimble Studio | nimblestudio | nimblestudio | nimble | nimble |
| Private 5G | private5g | private5g | privatenetworks | privatenetworks |
| Prometheus | prometheus | prometheus | amp | amp |
| 휴지통 | recyclebin | recyclebin | rbin | rbin |
| Redshift 데이터 API | redshiftdataapi | redshiftdataapi | redshiftdata | redshiftdata |
| Route 53 | route53domains | route53 | route53domains | route53domains |
| Sage Maker Edge Manager | sagemakeredgemanager | sagemakeredgemanager | sagemakeredge | sagemakeredge |
| 보안 토큰 | securitytoken | sts | sts | sts |
| 서버 마이그레이션 | servermigration | servermigration | sms | sms |
| 간단한 이메일 | simpleemail | ses | ses | ses |
| 간단한 이메일 V2 | simpleemailv2 | sesv2 | sesv2 | sesv2 |
| Simple Systems Management | simplesystemsmanagement | ssm | ssm | ssm |
| 단순 워크플로 | simpleworkflow | simpleworkflow | swf | swf |
| 단계 함수 | stepfunctions | stepfunctions | sfn | sfn |