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;
}
...
```
Il nostro obiettivo è sostituire tutte le importazioni v1 con le importazioni v2. Procediamo una lezione alla volta.
#### a. Sostituisci l'istruzione di importazione o il nome della classe
Vediamo che il primo parametro del `describeRunningInstances` metodo è un'`AmazonEC2Client`istanza v1. Esegui una delle seguenti operazioni:
+ Sostituisci l'importazione per `com.amazonaws.services.ec2.AmazonEC2Client` con `software.amazon.awssdk.services.ec2.Ec2Client` e passa `AmazonEC2Client` a`Ec2Client`.
+ Cambia il tipo di parametro in `Ec2Client` e lascia che l'IDE ci richieda l'importazione corretta. Il nostro IDE ci chiederà di importare la classe v2 perché i nomi dei client sono diversi: e. `AmazonEC2Client` `Ec2Client` Questo approccio non funziona se il nome della classe è lo stesso in entrambe le versioni.
#### b. Sostituisci le classi del modello v1 con gli equivalenti v2
Dopo la modifica alla v2`Ec2Client`, se utilizziamo un IDE, vediamo errori di compilazione nella seguente dichiarazione.
```
result = ec2.describeInstances(request);
```
L'errore di compilazione deriva dall'utilizzo di un'istanza di v1 `DescribeInstancesRequest` come parametro del metodo v2. `Ec2Client` `describeInstances` Per risolvere il problema, effettuate le seguenti istruzioni di sostituzione o importazione.
| replace | con |
| --- | --- |
| import com.amazonaws.services.ec2.model.DescribeInstancesRequest
| import software.amazon.awssdk.services.ec2.model.DescribeInstancesRequest
|
#### c. Cambia i costruttori v1 in v2 builder.
Vediamo ancora errori di compilazione perché [non ci](migration-whats-different.md#immutable-classes) sono costruttori nelle classi v2. Per risolvere il problema, apporta la seguente modifica.
| modifica | in |
| --- | --- |
| final DescribeInstancesRequest request = new DescribeInstancesRequest()
.withInstanceIds(instanceIdsCopy);
| final DescribeInstancesRequest request = DescribeInstancesRequest.builder()
.instanceIds(instanceIdsCopy)
.build();
|
#### d. Sostituisci gli oggetti di `*Result` risposta v1 con gli equivalenti `*Response` v2
Una differenza consistente tra v1 e v2 è che tutti [gli oggetti di risposta in v2](migration-whats-different.md#model-classname-changes) terminano con invece di. `*Response` `*Result` Sostituisci l'importazione v1 con `DescribeInstancesResult` l'importazione v2,. `DescribeInstancesResponse`
#### d. Apporta modifiche all'API
La seguente dichiarazione richiede alcune modifiche.
```
request.setNextToken(result.getNextToken());
```
Nella v2, [i metodi setter](migration-whats-different.md#setter-getter-methods) non utilizzano `set` o with. `prefix` I metodi Getter con prefisso `get` sono presenti anche nell'SDK for Java 2.x
Le classi del modello, come l'`request`istanza, sono immutabili nella v2, quindi dobbiamo crearne una nuova con un builder. `DescribeInstancesRequest`
Nella v2, l'istruzione diventa la seguente.
```
request = DescribeInstancesRequest.builder()
.nextToken(result.nextToken())
.build();
```
#### d. Ripetere l'operazione fino alla compilazione del metodo con le classi v2
Continua con il resto del codice. Sostituisci le importazioni v1 con le importazioni v2 e correggi gli errori di compilazione. Se necessario, consulta il riferimento all'[API v2 e il riferimento](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/package-summary.html) [What's different](migration-whats-different.md).
Dopo aver migrato questo singolo metodo, abbiamo il seguente codice 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;
}
...
```
Poiché stiamo migrando un singolo metodo in un file Java con otto metodi, abbiamo un mix di importazioni v1 e v2 mentre elaboriamo il file. Abbiamo aggiunto le ultime sei istruzioni di importazione man mano che eseguivamo i passaggi.
Dopo aver migrato tutto il codice, non ci saranno più istruzioni di importazione v1.
### 6. Rimuovi le dipendenze v1 Maven dalle importazioni POM e v1 dai file
Dopo aver migrato tutto il codice v1 nel file, abbiamo le seguenti istruzioni di importazione dell'SDK 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;
```
Dopo aver migrato *tutti* i file nella nostra applicazione, non abbiamo più bisogno delle dipendenze v1 nel nostro file POM. Rimuovi la BOM v1 dalla `dependencyManagement` sezione, se in uso, e tutti i blocchi di dipendenza v1.
### 7. Rifattorizza il codice per utilizzare i miglioramenti dell'API v2
Per lo snippet che stiamo migrando, possiamo opzionalmente utilizzare un impaginatore v2 e lasciare che l'SDK gestisca le richieste basate su token per ulteriori dati.
Possiamo sostituire l'intera clausola con la seguente. `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);
}
}));
```
## Nome del pacchetto per le mappature ArtifactID di Maven
Quando migri il tuo progetto Maven o Gradle dalla v1 dell'SDK for Java alla v2, devi capire quali dipendenze aggiungere al tuo file di build. L'approccio descritto nel [step-by-stepIstruzioni di migrazione con esempio](#migration-steps) (passaggio 3) utilizza i nomi dei pacchetti nelle istruzioni di importazione come punto di partenza per determinare le dipendenze (come ArtifactID) da aggiungere al file di build.
È possibile utilizzare le informazioni in questo argomento per mappare i nomi dei pacchetti v1 agli artifactID v2.
### Convenzione di denominazione comune utilizzata nei nomi dei pacchetti e nei Maven ArtifactID
La tabella seguente mostra la convenzione di denominazione comune SDKs utilizzata per un determinato SERVICE\$1ID. Un SERVICE\$1ID è un identificatore univoco per un. Servizio AWS Ad esempio, il SERVICE\$1ID per il servizio Amazon S3 è `s3` ed `cognitoidentity` è il SERVICE\$1ID per Amazon Cognito Identity.
| nome del pacchetto v1 (dichiarazione di importazione) | artifactID v1 | artifactID v2 | nome del pacchetto v2 (istruzione di importazione) |
| --- | --- | --- | --- |
| com.amazonaws.services.service\$1id | aws-java-sdk-ID\$1SERVIZIO | ID\$1SERVIZIO | software.amazon.awssdk.services.service\$1id |
| |
| Esempio di Amazon Cognito Identity (SERVICE\$1ID:) cognitoidentity |
| com.amazonaws.services. identità cognitiva | aws-java-sdk- identità cognitiva | identità cognitiva | software.amazon.awssdk.services. identità cognitiva |
### differenze SERVICE\$1ID
#### All'interno della v1
In alcuni casi il SERVICE\$1ID differisce tra il nome del pacchetto e l'artifactID per lo stesso servizio. Ad esempio, la riga CloudWatch Metrics della tabella seguente mostra che `metrics` è il SERVICE\$1ID nel nome del pacchetto ma è il SERVICE\$1ID dell'ArtifactID. `cloudwatchmetrics`
#### All'interno della v2
Non ci sono differenze nel SERVICE\$1ID utilizzato nei nomi dei pacchetti e negli ArtifactID.
#### Tra v1 e v2
Per la maggior parte dei servizi, il SERVICE\$1ID nella v2 è lo stesso del SERVICE\$1ID della v1 sia nei nomi dei pacchetti che negli ArtifactID. Un esempio di ciò è il SERVICE\$1ID, come mostrato nella tabella precedente. `cognitoedentity` Tuttavia, alcuni SERVICE\$1 IDs differiscono tra quelli mostrati nella SDKs tabella seguente.
Un **SERVICE\$1ID in grassetto** in una delle colonne v1 indica che è diverso dal SERVICE\$1ID utilizzato nella v2.
| Nome del servizio | nome del pacchetto v1 | artifactID v1 | artifactID v2 | nome del pacchetto v2 |
| --- | --- | --- | --- | --- |
| | Tutti i nomi dei pacchetti iniziano con `com.amazonaws.services` quello mostrato nella prima riga. | Tutti gli ArtifactID sono racchiusi tra tag, come mostrato nella prima riga. | Tutti gli ArtifactID sono racchiusi tra tag, come mostrato nella prima riga. | Tutti i nomi dei pacchetti iniziano con `software.amazon.awssdk` quello mostrato nella prima riga. |
| |
| Gateway API | com.amazonaws.services.apigateway | aws-java-sdk- gateway API | una porta d'accesso | software.amazon.awssdk.services.apigateway |
| Registro delle app | registro delle app | apprendistato | registro del catalogo dei servizi | registro del catalogo dei servizi |
| Application Discovery | scoperta delle applicazioni | scoperta | scoperta delle applicazioni | scoperta delle applicazioni |
| Runtime AI Augmented | autonomia aerea aumentata | durata dell'aria aumentata | runtime sagemaker a2i | runtime sagemakera2i |
| Certificate Manager | gestore dei certificati | acm | acm | acm |
| CloudControl API | API di controllo cloud | API di controllo cloud | controllo cloud | controllo del cloud |
| CloudSearch | cloudsearch v2 | cloudsearch | cloudsearch | cloudsearch |
| CloudSearch Dominio | dominio cloudsearch | ricerca nel cloud | dominio cloudsearch | dominio cloudsearch |
| CloudWatch Eventi | eventi cloudwatch | eventi | eventi cloudwatch | eventi cloudwatch |
| CloudWatch Evidentemente | Cloudwatch evidentemente | cloudwatch evidentemente | evidently | evidently |
| CloudWatch Registri | logs | logs | log di cloudwatch | cloudwatchlogs |
| CloudWatch Metriche | metriche | metriche cloudwatch | cloudwatch | cloudwatch |
| CloudWatch rum | cloudwatch rum | cloudwatchrum | rum | rum |
| Provider di identità Cognito | cognitoidp | cognitoidp | provider di cognitoidentity | provider di cognitoidentity |
| Campagna Connect | connetti la campagna | connetti la campagna | collegare le campagne | collegare le campagne |
| Connect Wisdom | connetti la saggezza | connettere la saggezza | wisdom | wisdom |
| Database Migration Service | servizio di migrazione del database | dms | migrazione del database | migrazione del database |
| DataZone | zona dati | zona dati esterna | zona dati | zona dati |
| DynamoDB | dinamo dbv2 | dynamodb | dynamodb | dynamodb |
| File system elastico | file system elastico | efs | efs | efs |
| Riduzione elastica della mappa | elasticmapreduce | emr | emr | emr |
| Glue DataBrew | incolla databrew | incollare databrew | databrew | databrew |
| IAM Roles Anywhere | I miei ruoli sono ovunque | sono ruoli ovunque | rolesanywhere | rolesanywhere |
| Gestione di identità | gestione dell'identità | iam | iam | iam |
| Dati IoT | dati IoT | iot | piano dati IoT | piano dati iot |
| Analisi Kinesis | kinesisanalytics | kinesis | kinesisanalytics | kinesisanalytics |
| Kinesis Firehose | manichetta antincendio kinesis | kinesis | firehose | firehose |
| Canali di segnalazione video Kinesis | canali di segnalazione video kinesis | canali di segnalazione video kinesis | segnalazione video kinesis | segnalazione video kinesis |
| Lex | runtime lex | lex | runtime lex | lexruntime |
| Attenzione a Vision | fai attenzione alla visione | attenzione alla visione | lookoutvision | lookoutvision |
| Modernizzazione del mainframe | modernizzazione del mainframe | modernizzazione del mainframe | m2 | m2 |
| Misurazione del Marketplace | misurazione del mercato | servizio di marketplacemetering | misurazione del marketplace | misurazione del marketplace |
| Grafana gestita | grafana gestito | grafana gestita | grafana | grafana |
| Mechanical Turk | mturk | richiedente turco meccanico | mturk | mturk |
| Suggerimenti di strategia dell'Hub di migrazione | raccomandazioni sulla strategia dell'hub di migrazione | raccomandazioni strategiche di migrationhub | strategia migrationhubs | strategia migrationhub |
| Nimble Studio | studio agile | studio agile | nimble | nimble |
| 5G privato | 5g privato | 5g privato | reti private | reti private |
| Prometheus | prometeo | prometeo | amp | amp |
| Cestino di riciclaggio | bidone per riciclare | pattumiera | rbin | rbin |
| API dati di Redshift | redshift data api | redshiftdataapi | dati redshift | dati redshift |
| Route 53 | domini route53 | route53 | domini route53 | domini route53 |
| Sage Maker Edge Manager | sagemaker edgemanager | sagemakedgemanager | sagemakeredge | sagemaker edge |
| Token di sicurezza | token di sicurezza | sts | sts | sts |
| Migrazione dei server | migrazione del server | migrazione del server | sms | sms |
| Email semplice | email semplice | ses | ses | ses |
| Email semplice V2 | email semplice v2 | ses v2 | sesv2 | sesv2 |
| Gestione semplice dei sistemi | gestione semplice dei sistemi | ssm | ssm | ssm |
| Flusso di lavoro semplice | flusso di lavoro semplice | flusso di lavoro semplice | swf | swf |
| Step Functions | funzioni step | funzioni step | sfn | sfn |