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;
}
...
```
Nosso objetivo é substituir todas as importações da v1 por importações da v2. Prosseguimos com uma classe por vez.
#### a. Substitua a declaração de importação ou o nome da classe
Vemos que o primeiro parâmetro do método `describeRunningInstances` uma instância `AmazonEC2Client` da v1. Execute um destes procedimentos:
+ Substitua a importação por `com.amazonaws.services.ec2.AmazonEC2Client` com `software.amazon.awssdk.services.ec2.Ec2Client` e altere `AmazonEC2Client` para `Ec2Client`.
+ Altere o tipo de parâmetro para `Ec2Client` e deixe que o IDE solicite a importação correta. Nosso IDE solicitará a importação da classe da v2 porque os nomes dos clientes são diferente: `AmazonEC2Client` e `Ec2Client`. Essa abordagem não funcionará se o nome da classe for o mesmo nas duas versões.
#### b. Substitua as classes do modelo da v1 por equivalentes da v2
Após a mudança para o `Ec2Client` da v2, se usarmos um IDE, veremos erros de compilação na declaração a seguir.
```
result = ec2.describeInstances(request);
```
O erro de compilação resulta do uso de uma instância de `DescribeInstancesRequest` da v1 como parâmetro para o método `Ec2Client` `describeInstances` da v2. Para corrigir, faça as seguintes declarações de substituição ou importação.
| subtituir | por |
| --- | --- |
| import com.amazonaws.services.ec2.model.DescribeInstancesRequest
| import software.amazon.awssdk.services.ec2.model.DescribeInstancesRequest
|
#### c. Altere os compiladores da v1 para compiladores da v2.
Ainda vemos erros de compilação porque [não há construtores nas classes da v2](migration-whats-different.md#immutable-classes). Para corrigir isso, faça a alteração a seguir.
| alteração | para |
| --- | --- |
| final DescribeInstancesRequest request = new DescribeInstancesRequest()
.withInstanceIds(instanceIdsCopy);
| final DescribeInstancesRequest request = DescribeInstancesRequest.builder()
.instanceIds(instanceIdsCopy)
.build();
|
#### d. Substitua objetos de resposta `*Result` da v1 por `*Response` equivalentes da v2
Uma diferença consistente entre a v1 e a v2 é que todos os [objetos de resposta na v2 terminam com `*Response` em vez de `*Result`](migration-whats-different.md#model-classname-changes). Substitua a importação `DescribeInstancesResult` da v1 pela importação `DescribeInstancesResponse` da v2.
#### d. Fazer alterações na API
A declaração a seguir precisa de algumas alterações.
```
request.setNextToken(result.getNextToken());
```
Na v2, os [métodos de setter](migration-whats-different.md#setter-getter-methods) não usam o `set` nem com `prefix`. Métodos getter com prefixo `get` também foram incluídos no SDK para Java 2.x
Classes de modelo, como a instância `request`, são imutáveis na v2, então precisamos criar uma `DescribeInstancesRequest` com um compilador.
Na v2, a declaração se torna a seguinte.
```
request = DescribeInstancesRequest.builder()
.nextToken(result.nextToken())
.build();
```
#### d. Repita até que o método seja compilado com classes da v2
Continue com o restante do código. Substitua as importações da v1 pelas importações da v2 e corrija os erros de compilação. Consulte a [Referência da API da v2](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/package-summary.html) e a [Referência O que mudou](migration-whats-different.md), conforme necessário.
Depois de migrarmos esse único método, temos o seguinte código da 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;
}
...
```
Como estamos migrando um único método em um arquivo Java com oito métodos, temos uma combinação de importações da v1 e da v2 à medida que trabalhamos no arquivo. Adicionamos as últimas seis declarações de importação à medida que executamos as etapas.
Depois de migrarmos todo o código, não haverá mais declarações de importação v1.
### 6. Remova as dependências da v1 do Maven das importações do POM e da v1 dos arquivos
Depois de migrarmos todo o código da v1 no arquivo, temos as seguintes declarações de importação do SDK da v2.
```
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;
```
Depois de migrarmos *todos* os arquivos na aplicação, não precisaremos mais das dependências da v1 no arquivo POM. Remova o BOM v1 da seção `dependencyManagement`, caso esteja usando, e todos os blocos de dependência da v1.
### 7. Refatorar o código para usar os aprimoramentos da API da v2
Para o trecho que estamos migrando, podemos usar um paginador da v2 e deixar o SDK gerenciar as solicitações baseadas em tokens para obter mais dados, caso desejarmos.
Podemos substituir toda a cláusula `do` pela seguinte.
```
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);
}
}));
```
## Nome do pacote para mapeamentos de artifactId do Maven.
Ao migrar o projeto Maven ou Gradle da v1 do SDK para Java para a v2, você precisa descobrir quais dependências adicionar ao arquivo de compilação. A abordagem descrita em [step-by-stepInstruções de migração com exemplo](#migration-steps) (etapa 3) usa os nomes dos pacotes nas declarações de importação como ponto de partida para determinar as dependências (como artifactIds) que devem ser adicionadas ao arquivo de compilação.
Você pode usar as informações deste tópico para mapear os nomes dos pacotes da v1 para os artifactIds da v2.
### Convenção de nomenclatura comum usada em nomes de pacotes e artifactIds do Maven
A tabela a seguir mostra a convenção de nomenclatura comum SDKs usada para um determinado SERVICE\$1ID. Um SERVICE\$1ID é um identificador exclusivo para um. AWS service (Serviço da AWS) Por exemplo, o SERVICE\$1ID do serviço Amazon S3 é `s3` e o SERVICE\$1ID do Amazon Cognito Identity é `cognitoidentity`.
| Nome do pacote da v1 (declaração de importação) | artifactId da v1 | artifactId da v2 | Nome do pacote da v2 (declaração de importação) |
| --- | --- | --- | --- |
| com.amazonaws.services.SERVICE\$1ID | aws-java-sdk-ID DO SERVIÇO | SERVICE\$1ID | software.amazon.awssdk.services.SERVICE\$1ID |
| |
| Exemplo do Amazon Cognito Identity (SERVICE\$1ID: cognitoidentity) |
| com.amazonaws.services.cognitoidentity | aws-java-sdk- identidade cognitiva | cognitoidentity | software.amazon.awssdk.services.cognitoidentity |
### Diferenças de SERVICE\$1ID
#### Na v1
Em alguns casos, o SERVICE\$1ID difere entre o nome do pacote e o artifactId do mesmo serviço. Por exemplo, a linha CloudWatch Métricas da tabela a seguir mostra que `metrics` é o SERVICE\$1ID no nome do pacote, mas `cloudwatchmetrics` é o SERVICE\$1ID do ArtifactID.
#### Na v2
Não há diferenças no SERVICE\$1ID usado em nomes de pacotes e artifactIds.
#### Entre a v1 e a v2
Para a maioria dos serviços, o SERVICE\$1ID na v2 é o mesmo que o SERVICE\$1ID na v1 nos nomes dos pacotes e nos artifactIds. Um exemplo disso é o SERVICE\$1ID `cognitoedentity`, conforme mostrado na tabela anterior. No entanto, alguns SERVICE\$1 IDs diferem entre os, SDKs conforme mostrado na tabela a seguir.
Um **SERVICE\$1ID em negrito** em qualquer uma das colunas da v1 indica que ele é diferente do SERVICE\$1ID usado na v2.
| Nome do serviço | Nome do pacote da v1 | artifactId da v1 | artifactId da v2 | Nome do pacote da v2 |
| --- | --- | --- | --- | --- |
| | Todos os nomes de pacotes começam com `com.amazonaws.services`, conforme mostrado na primeira linha. | Todos os artifactIds são colocados entre tags, conforme mostrado na primeira linha. | Todos os artifactIds são colocados entre tags, conforme mostrado na primeira linha. | Todos os nomes de pacotes começam com `software.amazon.awssdk`, conforme mostrado na primeira linha. |
| |
| API Gateway | com.amazonaws.services.apigateway | aws-java-sdk- gateway de API | apigateway | software.amazon.awssdk.services.apigateway |
| Registro de aplicação | appregistry | appregistry | servicecatalogappregistry | servicecatalogappregistry |
| Application Discovery | applicationdiscovery | discovery | applicationdiscovery | applicationdiscovery |
| Runtime do Augmented AI | augmentedairuntime | augmentedairuntime | sagemakera2iruntime | sagemakera2iruntime |
| Certificate Manager | certificatemanager | acm | acm | acm |
| CloudControl API | cloudcontrolapi | cloudcontrolapi | cloudcontrol | cloudcontrol |
| CloudSearch | cloudsearchv2 | cloudsearch | cloudsearch | cloudsearch |
| CloudSearch Domínio | cloudsearchdomain | pesquisa na nuvem | cloudsearchdomain | cloudsearchdomain |
| CloudWatch Eventos | cloudwatchevents | eventos | cloudwatchevents | cloudwatchevents |
| CloudWatch Evidentemente | cloudwatchevidently | cloudwatchevidently | evidently | evidently |
| CloudWatch Registros | logs | logs | cloudwatchlogs | cloudwatchlogs |
| CloudWatch Métricas | métricas | cloudwatchmetrics | cloudwatch | cloudwatch |
| CloudWatch Rum | cloudwatchrum | cloudwatchrum | rum | rum |
| Provedor de identidades do Cognito | cognitoidp | cognitoidp | cognitoidentityprovider | cognitoidentityprovider |
| Campanhas do Connect | connectcampaign | connectcampaign | connectcampaigns | connectcampaigns |
| Connect 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 | sistema de arquivos elástico | efs | efs | efs |
| Elastic Map Reduce | elasticmapreduce | emr | emr | emr |
| Glue DataBrew | gluedatabrew | gluedatabrew | databrew | databrew |
| IAM Roles Anywhere | iamrolesanywhere | iamrolesanywhere | rolesanywhere | rolesanywhere |
| Gerenciamento de identidades | identitymanagement | iam | iam | iam |
| Dados de IoT | iotdata | iot | iotdataplane | iotdataplane |
| Kinesis Analytics | kinesisanalytics | kinesis | kinesisanalytics | kinesisanalytics |
| Kinesis Firehose | kinesisfirehose | kinesis | firehose | firehose |
| Canais de sinalização do Kinesis Video | kinesisvideosignalingchannels | kinesisvideosignalingchannels | kinesisvideosignaling | kinesisvideosignaling |
| Lex | lexruntime | lex | lexruntime | lexruntime |
| Lookout for Vision | lookoutforvision | lookoutforvision | lookoutvision | lookoutvision |
| Mainframe Modernization | mainframemodernization | mainframemodernization | m2 | m2 |
| Marketplace Metering | marketplacemetering | marketplacemeteringservice | marketplacemetering | marketplacemetering |
| Managed 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 |
| 5G Privado | private5g | private5g | privatenetworks | privatenetworks |
| Prometheus | prometheus | prometheus | amp | amp |
| Lixeira | recyclebin | recyclebin | rbin | rbin |
| API de dados Redshift | redshiftdataapi | redshiftdataapi | redshiftdata | redshiftdata |
| Route 53 | route53domains | route53 | route53domains | route53domains |
| SageMaker Edge Manager | sagemakeredgemanager | sagemakeredgemanager | sagemakeredge | sagemakeredge |
| Security Token | securitytoken | sts | sts | sts |
| Server Migration | servermigration | servermigration | sms | sms |
| Simple Email | simpleemail | ses | ses | ses |
| Simple Email V2 | simpleemailv2 | sesv2 | sesv2 | sesv2 |
| Simple Systems Manager | simplesystemsmanagement | ssm | ssm | ssm |
| Simple Workflow | simpleworkflow | simpleworkflow | swf | swf |
| Step Functions | stepfunctions | stepfunctions | sfn | sfn |