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;
}
...
```
Nuestro objetivo es sustituir todas las importaciones de la v1 por las de la v2. Procedemos clase por clase.
#### a. Reemplace la instrucción de importación o el nombre de clase
Vemos que el primer parámetro del método `describeRunningInstances` es una instancia de `AmazonEC2Client` v1. Realice una de las siguientes acciones:
+ Sustituya la importación de `com.amazonaws.services.ec2.AmazonEC2Client` con `software.amazon.awssdk.services.ec2.Ec2Client` y cambie `AmazonEC2Client` a `Ec2Client`.
+ Cambie el tipo de parámetro a `Ec2Client` y deje que el IDE nos pida la importación correcta. Nuestro IDE nos pedirá que importemos la clase v2 porque los nombres de cliente son diferentes: `AmazonEC2Client` y `Ec2Client`. Este método no funciona si el nombre de clase es el mismo en ambas versiones.
#### b. Reemplazo de las clases del modelo de v1 por equivalentes de v2
Tras el cambio a `Ec2Client` v2, si utilizamos un IDE, aparecen errores de compilación en la siguiente instrucción.
```
result = ec2.describeInstances(request);
```
El error de compilación se debe al uso de una instancia de `DescribeInstancesRequest` de la v1 como parámetro del método `Ec2Client` `describeInstances` de la v2. Para corregirlo, aplique las siguientes instrucciones de sustitución o importación.
| replace | por |
| --- | --- |
| import com.amazonaws.services.ec2.model.DescribeInstancesRequest
| import software.amazon.awssdk.services.ec2.model.DescribeInstancesRequest
|
#### c. Cambie los constructores de v1 por constructores de v2.
Siguen apareciendo errores de compilación porque [no hay constructores en clases de la v2](migration-whats-different.md#immutable-classes). Para corregirlo, realice el siguiente cambio.
| cambiar | a |
| --- | --- |
| final DescribeInstancesRequest request = new DescribeInstancesRequest()
.withInstanceIds(instanceIdsCopy);
| final DescribeInstancesRequest request = DescribeInstancesRequest.builder()
.instanceIds(instanceIdsCopy)
.build();
|
#### d. Reemplace los objetos de respuesta de `*Result` de v1 con los equivalentes de `*Response` de v2
Una diferencia constante entre v1 y v2 es que todos los [objetos de respuesta de v2 terminan en `*Response` en lugar de `*Result`](migration-whats-different.md#model-classname-changes). Reemplace la importación de `DescribeInstancesResult` de v1 por la importación de v2, `DescribeInstancesResponse`.
#### d. Realización de cambios en la API
La siguiente instrucción necesita algunos cambios.
```
request.setNextToken(result.getNextToken());
```
En la v2, [los métodos setter](migration-whats-different.md#setter-getter-methods) no utilizan `set` o `prefix`. Los métodos Getter con prefijo con `get` también han desaparecido del SDK para Java 2.x
Las clases de modelos, como la instancia de `request`, son inmutables en la v2, por lo que debemos crear una `DescribeInstancesRequest` nueva con un compilador.
En la v2, la instrucción pasa a ser la siguiente.
```
request = DescribeInstancesRequest.builder()
.nextToken(result.nextToken())
.build();
```
#### d. Repita hasta que el método se compile con clases de la v2
Continúe con el resto del código. Sustituya las importaciones de la v1 por las de la v2 y corrija los errores de compilación. Consulte la [Referencia de la API de la v2](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/package-summary.html) y la [Referencia de diferencias](migration-whats-different.md) si es necesario.
Después de migrar este método individual, tendremos el siguiente código de la 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;
}
...
```
Dado que estamos migrando un único método en un archivo Java con ocho métodos, tenemos una combinación de importaciones de la v1 y v2 a medida que avanzamos en el archivo. Hemos añadido las seis últimas instrucciones de importación a medida que dábamos los pasos.
Después de migrar todo el código, no habrá más instrucciones de importación de v1.
### 6. Eliminación las dependencias de Maven de v1 desde el POM y las importaciones de v1 desde los archivos
Tras migrar todo el código de la v1 del archivo, tenemos las siguientes instrucciones de importación del SDK de la 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;
```
Después de migrar *todos* los archivos de nuestra aplicación, ya no necesitamos las dependencias de la v1 en nuestro archivo POM. Elimine la BOM de la v1 de la sección `dependencyManagement`, si la está utilizando, y todos los bloques de dependencias de la v1.
### 7. Refactorización del código para usar mejoras de la API de la v2
Para el fragmento de código que hemos estado migrando, podemos usar opcionalmente un paginador de v2 y dejar que el SDK administre las solicitudes de datos adicionales basadas en tokens.
Podemos sustituir toda la cláusula `do` por lo siguiente.
```
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);
}
}));
```
## Asignaciones de nombre del paquete a artifactId de Maven
Al migrar el proyecto de Maven o Gradle de la v1 del SDK para Java a la v2, debe determinar qué dependencias desea añadir al archivo de compilación. El método descrito en los [step-by-stepInstrucciones de migración con ejemplo](#migration-steps) (paso 3) utiliza los nombres de paquetes de las instrucciones de importación como punto de partida para determinar las dependencias (como artifactId) que se van a añadir al archivo de compilación.
Puede usar la información de este tema para asignar los nombres de paquetes de la v1 a los artifactId de la v2.
### Convención de nomenclatura común utilizada en nombres de paquetes y artifactId de Maven
La siguiente tabla muestra la convención de nomenclatura común que se SDKs utiliza para un SERVICE\$1ID determinado. Un SERVICE\$1ID es un identificador único para un. Servicio de AWS Por ejemplo, el SERVICE\$1ID del servicio de Amazon S3 es `s3` y `cognitoidentity` es el SERVICE\$1ID de Amazon Cognito Identity.
| Nombre del paquete v1 (instrucción de importación) | artifactId v1 | artifactId v2 | nombre del paquete v2 (instrucción de importación) |
| --- | --- | --- | --- |
| com.amazonaws.services.SERVICE\$1ID | aws-java-sdk-SERVICE\$1ID | SERVICE\$1ID | software.amazon.awssdk.services.SERVICE\$1ID |
| |
| Ejemplo de Amazon Cognito Identity (SERVICE\$1ID: cognitoidentity) |
| com.amazonaws.services.cognitoidentity | aws-java-sdk- identidad cognitiva | cognitoidentity | software.amazon.awssdk.services.cognitoidentity |
### Diferencias de SERVICE\$1ID
#### En v1
En algunos casos, el SERVICE\$1ID presenta diferencias entre el nombre del paquete y el artifactId del mismo servicio. Por ejemplo, la fila de CloudWatch métricas de la siguiente tabla muestra que `metrics` es el SERVICE\$1ID del nombre del paquete, pero `cloudwatchmetrics` es el SERVICE\$1ID del ArtifactID.
#### En v2
No hay diferencias en el SERVICE\$1ID utilizado en los nombres de paquetes y artifactId.
#### Entre v1 y v2.
En la mayoría de los servicios, el SERVICE\$1ID de la v2 es el mismo que el SERVICE\$1ID de la v1, tanto en los nombres de paquetes como en los artifactId. Un ejemplo de esto es el SERVICE\$1ID `cognitoedentity` que se muestra en la tabla anterior. Sin embargo, algunos SERVICE\$1 IDs difieren entre sí, como se muestra en la siguiente tabla. SDKs
Un **SERVICE\$1ID en negrita** en las columnas de la v1 indica que es diferente del SERVICE\$1ID utilizado en la v2.
| Nombre del servicio | Nombre del paquete v1 | artifactId v1 | artifactId v2 | Nombre del paquete v2 |
| --- | --- | --- | --- | --- |
| | Todos los nombres de paquetes comienzan por `com.amazonaws.services`, como se muestra en la primera fila. | Todos los artifactId aparecen entre etiquetas, como se muestra en la primera fila. | Todos los artifactId aparecen entre etiquetas, como se muestra en la primera fila. | Todos los nombres de paquetes comienzan por `software.amazon.awssdk`, como se muestra en la primera fila. |
| |
| API Gateway | com.amazonaws.services.apigateway | aws-java-sdk- puerta de enlace api | apigateway | software.amazon.awssdk.services.apigateway |
| App Registry | appregistry | appregistry | servicecatalogappregistry | servicecatalogappregistry |
| Application Discovery | applicationdiscovery | discovery | applicationdiscovery | applicationdiscovery |
| Augmented AI Runtime | augmentedairuntime | augmentedairuntime | sagemakera2iruntime | sagemakera2iruntime |
| Certificate Manager | certificatemanager | acm | acm | acm |
| CloudControl API | cloudcontrolapi | cloudcontrolapi | cloudcontrol | cloudcontrol |
| CloudSearch | cloudsearchv2 | cloudsearch | cloudsearch | cloudsearch |
| CloudSearch Dominio | cloudsearchdomain | cloudsearch | 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 Ron | cloudwatchrum | cloudwatchrum | rum | rum |
| Amazon Cognito Identity Provider | cognitoide | cognitoide | cognitoidentityprovider | cognitoidentityprovider |
| Connect Campaign | 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 archivos 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 |
| Administración de identidades | identitymanagement | iam | iam | iam |
| IoT Data | iotdata | iot | iotdataplane | iotdataplane |
| Kinesis Analytics | kinesisanalytics | kinesis | kinesisanalytics | kinesisanalytics |
| Kinesis Firehose | kinesisfirehose | kinesis | firehose | firehose |
| Kinesis Video Signaling Channels | kinesisvideosignalingchannels | kinesisvideosignalingchannels | kinesisvideosignaling | kinesisvideosignaling |
| Lex | lexruntime | Álex | lexruntime | lexruntime |
| Lookout For Vision | lookoutforvision | lookoutforvision | lookoutvision | lookoutvision |
| Modernización de la unidad central | mainframemodernization | mainframemodernization | m2 | m2 |
| Marketplace Metering | marketplacemetering | marketplacemeteringservice | marketplacemetering | marketplacemetering |
| Managed Grafana | managedgrafana | managedgrafana | grafana | grafana |
| Mechanical Turk | mturk | mechanicalturkrequester | mturk | mturk |
| Recomendaciones de estrategias de Migration Hub | migrationhubstrategyrecommendations | migrationhubstrategyrecommendations | migrationhubstrategy | migrationhubstrategy |
| Nimble Studio | nimblestudio | nimblestudio | nimble | nimble |
| Private 5G | private5g | private5g | redes privadas | redes privadas |
| Prometheus | prometheus | prometheus | amp | amp |
| Papelera de reciclaje | recyclebin | recyclebin | rbin | rbin |
| API de datos de Redshift | redshiftdataapi | redshiftdataapi | redshiftdata | redshiftdata |
| Route 53 | route53domains | route53 | route53domains | route53domains |
| Sage Maker 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 Management | simplesystemsmanagement | ssm | ssm | ssm |
| Simple Workflow | simpleworkflow | simpleworkflow | swf | swf |
| Step Functions | stepfunctions | stepfunctions | sfn | sfn |