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;
}
...
```
Unser Ziel ist es, alle v1-Importe durch v2-Importe zu ersetzen. Wir fahren mit einer Klasse nach der anderen fort.
#### a. Ersetzt die Importanweisung oder den Klassennamen
Wir sehen, dass der erste Parameter der `describeRunningInstances` Methode eine `AmazonEC2Client` v1-Instanz ist. Führen Sie eine der folgenden Aktionen aus:
+ Ersetzen Sie den Import für `com.amazonaws.services.ec2.AmazonEC2Client` durch `software.amazon.awssdk.services.ec2.Ec2Client` und wechseln Sie `AmazonEC2Client` zu`Ec2Client`.
+ Ändern Sie den Parametertyp in `Ec2Client` und lassen Sie uns von der IDE nach dem richtigen Import fragen. Unsere IDE fordert uns auf, die v2-Klasse zu importieren, da sich die Client-Namen unterscheiden — `AmazonEC2Client` und`Ec2Client`. Dieser Ansatz funktioniert nicht, wenn der Klassenname in beiden Versionen derselbe ist.
#### b. Ersetzen Sie v1-Modellklassen durch v2-Äquivalente
Wenn wir nach der Umstellung auf Version 2 `Ec2Client` eine IDE verwenden, werden in der folgenden Anweisung Kompilierungsfehler angezeigt.
```
result = ec2.describeInstances(request);
```
Der Kompilierungsfehler resultiert aus der Verwendung einer Instanz von v1 `DescribeInstancesRequest` als Parameter für die `Ec2Client` `describeInstances` v2-Methode. Um das Problem zu beheben, geben Sie die folgenden Ersatz- oder Importanweisungen ein.
| replace | mit |
| --- | --- |
| import com.amazonaws.services.ec2.model.DescribeInstancesRequest
| import software.amazon.awssdk.services.ec2.model.DescribeInstancesRequest
|
#### c. Ändern Sie v1-Konstruktoren in v2-Builder.
Wir sehen immer noch Kompilierungsfehler, da es [keine Konstruktoren für v2-Klassen](migration-whats-different.md#immutable-classes) gibt. Um das Problem zu beheben, nehmen Sie die folgende Änderung vor.
| ändern | to |
| --- | --- |
| final DescribeInstancesRequest request = new DescribeInstancesRequest()
.withInstanceIds(instanceIdsCopy);
| final DescribeInstancesRequest request = DescribeInstancesRequest.builder()
.instanceIds(instanceIdsCopy)
.build();
|
#### d. Ersetzen Sie `*Result` v1-Antwortobjekte durch `*Response` v2-Äquivalente
Ein konsistenter Unterschied zwischen v1 und v2 besteht darin, dass alle [Antwortobjekte in v2 mit `*Response` statt mit enden](migration-whats-different.md#model-classname-changes). `*Result` Ersetzen Sie den `DescribeInstancesResult` v1-Import durch den v2-Import,`DescribeInstancesResponse`.
#### d. Nehmen Sie API-Änderungen vor
Die folgende Aussage benötigt einige Änderungen.
```
request.setNextToken(result.getNextToken());
```
In Version 2 verwenden [Setter-Methoden](migration-whats-different.md#setter-getter-methods) das `set` oder mit `prefix` nicht. Getter-Methoden mit dem Präfix `get` sind auch im SDK for Java 2.x weg
Modellklassen, wie die `request` Instanz, sind in Version 2 unveränderlich, daher müssen wir mit einem Builder eine neue `DescribeInstancesRequest` Klasse erstellen.
In Version 2 lautet die Anweisung wie folgt.
```
request = DescribeInstancesRequest.builder()
.nextToken(result.nextToken())
.build();
```
#### d. Wiederholen Sie den Vorgang, bis die Methode mit v2-Klassen kompiliert wurde
Fahren Sie mit dem Rest des Codes fort. Ersetzen Sie v1-Importe durch v2-Importe und beheben Sie die Kompilierungsfehler. Weitere Informationen finden Sie je nach Bedarf in der [v2-API-Referenz](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/package-summary.html) und der [Referenz Was ist anders](migration-whats-different.md).
Nachdem wir diese einzelne Methode migriert haben, haben wir den folgenden v2-Code.
```
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;
}
...
```
Da wir eine einzelne Methode in einer Java-Datei mit acht Methoden migrieren, haben wir beim Durcharbeiten der Datei eine Mischung aus v1- und v2-Importen. Bei der Ausführung der Schritte haben wir die letzten sechs Importanweisungen hinzugefügt.
Nachdem wir den gesamten Code migriert haben, wird es keine v1-Importanweisungen mehr geben.
### 6. Entfernen Sie v1-Maven-Abhängigkeiten aus dem POM und v1-Importe aus Dateien
Nachdem wir den gesamten v1-Code in der Datei migriert haben, haben wir die folgenden v2-SDK-Importanweisungen.
```
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;
```
Nachdem wir *alle* Dateien in unserer Anwendung migriert haben, benötigen wir die v1-Abhängigkeiten in unserer POM-Datei nicht mehr. Entfernen Sie die v1-BOM aus dem `dependencyManagement` Abschnitt, falls Sie sie verwenden, und alle v1-Abhängigkeitsblöcke.
### 7. Refaktorieren Sie den Code, um v2-API-Verbesserungen zu verwenden
Für das Snippet, das wir migriert haben, können wir optional einen v2-Paginator verwenden und das SDK die tokenbasierten Anfragen nach weiteren Daten verwalten lassen.
Wir können die gesamte Klausel durch die folgende ersetzen. `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);
}
}));
```
## Zuordnungen von Paketnamen zu Maven-ArtifactID-Zuordnungen
Wenn Sie Ihr Maven- oder Gradle-Projekt von Version 1 des SDK for Java auf Version 2 migrieren, müssen Sie herausfinden, welche Abhängigkeiten Sie Ihrer Build-Datei hinzufügen müssen. Der in [step-by-stepMigrationsanweisungen mit Beispiel](#migration-steps) (Schritt 3) beschriebene Ansatz verwendet die Paketnamen in Importanweisungen als Ausgangspunkt, um die Abhängigkeiten (als ArtifactIDs) zu bestimmen, die zu Ihrer Build-Datei hinzugefügt werden sollen.
Sie können die Informationen in diesem Thema verwenden, um die v1-Paketnamen den v2-ArtifactIDs zuzuordnen.
### Allgemeine Namenskonvention, die in Paketnamen und Maven-ArtifactIDs verwendet wird
Die folgende Tabelle zeigt die allgemeine Benennungskonvention, die für eine bestimmte SERVICE\$1ID SDKs verwendet wird. Eine SERVICE\$1ID ist ein eindeutiger Bezeichner für eine. AWS-Service Beispielsweise ist `s3` und `cognitoidentity` ist die SERVICE\$1ID für den Amazon S3 S3-Service die SERVICE\$1ID für Amazon Cognito Identity.
| v1-Paketname (Import-Anweisung) | v1-Artefakt-ID | v2-Artefakt-ID | v2-Paketname (Importanweisung) |
| --- | --- | --- | --- |
| com.amazonaws.services.service\$1ID | aws-java-sdk-SERVICE\$1ID | SERVICE\$1ID | software.amazon.awssdk.services.service\$1id |
| |
| Beispiel für Amazon Cognito Identity (SERVICE\$1ID:) cognitoidentity |
| com.amazonaws.services. kognitive Identität | aws-java-sdk- kognitive Identität | kognitive Identität | software.amazon.awssdk.services. kognitive Identität |
### SERVICE\$1ID-Unterschiede
#### Innerhalb von Version 1
In einigen Fällen unterscheidet sich die SERVICE\$1ID zwischen dem Paketnamen und der artifactId für denselben Dienst. Beispielsweise zeigt die Zeile CloudWatch Metrics der folgenden Tabelle, dass es sich um die SERVICE\$1ID im Paketnamen `metrics` handelt, aber `cloudwatchmetrics` um die SERVICE\$1ID der ArtifactID.
#### Innerhalb von Version 2
Es gibt keine Unterschiede in der SERVICE\$1ID, die in Paketnamen und ArtifactIDs verwendet wird.
#### Zwischen v1 und v2
Für die meisten Dienste entspricht die SERVICE\$1ID in Version 2 der SERVICE\$1ID von Version 1, sowohl in den Paketnamen als auch in den ArtifactIDs. Ein Beispiel hierfür ist die `cognitoedentity` SERVICE\$1ID, wie in der vorherigen Tabelle dargestellt. Einige SERVICE\$1 IDs unterscheiden sich jedoch zwischen den in der SDKs folgenden Tabelle aufgeführten.
Eine **fett gedruckte SERVICE\$1ID** in einer der v1-Spalten weist darauf hin, dass sie sich von der in Version 2 verwendeten SERVICE\$1ID unterscheidet.
| Service-Name | v1-Paketname | v1-Artefakt-ID | v2-Artefakt-ID | v2-Paketname |
| --- | --- | --- | --- | --- |
| | Alle Paketnamen beginnen mit dem`com.amazonaws.services`, was in der ersten Zeile angegeben ist. | Alle ArtifactIDs sind in Tags eingeschlossen, wie in der ersten Zeile gezeigt. | Alle ArtifactIDs sind in Tags eingeschlossen, wie in der ersten Zeile gezeigt. | Alle Paketnamen beginnen mit dem, was in `software.amazon.awssdk` der ersten Zeile angezeigt wird. |
| |
| API Gateway | com.amazonaws.services.apigateway | aws-java-sdk- API-Gateway | API-Gateway | software.amazon.awssdk.services.apigateway |
| App-Registrierung | App-Registrierung | appregistrierung | ServicekatalogAppRegistry | Registrierung der ServicekatalogApp |
| Application Discovery | Anwendungserkennung | Entdeckung | Entdeckung von Anwendungen | Anwendungserkennung |
| Augmented AI KI-Laufzeit | erweiterte Air-Laufzeit | erhöhte Luftlaufzeit | Laufzeit von Sagemaker A2I | Sagemakera2i Laufzeit |
| Certificate Manager | Zertifikatsmanager | acm | acm | acm |
| CloudControl API | API für Cloud-Steuerung | Cloud-Control-API | Cloud-Steuerung | Cloud-Kontrolle |
| CloudSearch | Cloudsearch v2 | clousearch | clousearch | clousearch |
| CloudSearch Domäne | Cloudsearch-Domäne | Cloud-Suche | Cloudsearch-Domäne | Cloudsearch-Domäne |
| CloudWatch Events | Cloudwatch-Ereignisse | Ereignisse | Cloudwatch-Ereignisse | Cloudwatch-Ereignisse |
| CloudWatch Offensichtlich | Offensichtlich Cloudwatch | Cloudwatch offenbar | evidently | evidently |
| CloudWatch Logs | logs | logs | CloudWatch-Protokolle | CloudWatch-Protokolle |
| CloudWatch Metriken | Metriken | Cloudwatch-Metriken | cloudwatch | cloudwatch |
| CloudWatch Rum | Cloudwatch Rum | cloudwatchrum | rum | rum |
| Cognito-Identitätsanbieter | Cognitoidp | Kognitoidp | Anbieter von kognitiver Identität | Anbieter von Cognito Identity |
| Kampagne Connect | Kampagne verbinden | Kampagne verbinden | Kampagnen verbinden | Kampagnen verbinden |
| Connect Wisdom | verbinde Weisheit | Weisheit verbinden | wisdom | wisdom |
| Database Migration Service | Datenbankmigrationsdienst | dms | Datenbank-Migration | Datenbankmigration |
| DataZone | Datazone | Datenzone extern | Datenzone | Datenzone |
| DynamoDB | Dynamo DBV 2 | dynamodb | dynamodb | dynamodb |
| Elastisches Dateisystem | elastisches Dateisystem | efs | efs | efs |
| Elastic Map Reduce | elasticmapreduce | emr | emr | emr |
| Glue DataBrew | Klebe ein Gebräu | Gluedata Brew | databrew | databrew |
| IAM Roles Anywhere | Ich bin überall Rollen | Ich bin überall Roles | rolesanywhere | rolesanywhere |
| Identitätsverwaltung | Identitätsmanagement | iam | iam | iam |
| IoT-Daten | IoT-Daten | iot | IoT-Datenebene | iotDatenebene |
| Kinesis-Analytik | kinesisanalytics | kinesis | kinesisanalytics | kinesisanalytics |
| Kinesis Firehose | Kinesis-Feuerwehrschlauch | kinesis | firehose | firehose |
| Kinesis-Videosignalkanäle | Kinesis-Videosignalkanäle | Kinesis-Videosignalkanäle | Kinesis-Videosignalisierung | Kinesis-Videosignalisierung |
| Lex | LEX Runtime | Lex | Lex Laufzeit | lexruntime |
| Halten Sie Ausschau nach Visionen | Halte Ausschau nach Visionen | Halte Ausschau nach Visionen | lookoutvision | lookoutvision |
| Mainframe-Modernisierung | Modernisierung von Mainframes | Modernisierung des Mainframes | m2 | m2 |
| Marktmessung | Messung von Marktplätzen | Marketplace-Metering-Service | Marktplatzmessung | Marktplatzmessung |
| Verwaltetes Grafana | verwaltete Grafana | verwaltete Grafana | grafana | grafana |
| Mechanical Turk | Mturk | mechanischer Türkenquester | mturk | mturk |
| Migration-Hub-Strategieempfehlungen | Strategieempfehlungen für den Migrationshub | Strategieempfehlungen für MigrationHubs | Strategie für einen Migrationshub | Strategie für einen Migrationshub |
| Nimble Studio | flinkes Studio | flinkes Studio | nimble | nimble |
| Privates 5G | privat 5g | privat 5g | private Netzwerke | private Netzwerke |
| Prometheus | Prometheus | Prometheus | Verstärker | Verstärker |
| Papierkorb | Papierkorb | Papierkorb | rbin | rbin |
| Redshift-Daten-API | RedshiftData-API | RedshiftData-API | Redshiftdaten | Redshiftdaten |
| Route 53 | 53 Domains weiterleiten | route53 | 53 Domänen weiterleiten | 53 Domänen weiterleiten |
| Sage Maker Edge-Manager | Sagemaker Edge Manager | SagemakerEdgemanager | SagemakerEdge | SagemakerEdge |
| Sicherheitstoken | Sicherheitstoken | sts | sts | sts |
| Server-Migration | Servermigration | Servermigration | sms | sms |
| Einfache E-Mail | einfache E-Mail | ses | ses | ses |
| Einfache E-Mail V2 | einfache E-Mail v2 | sesv2 | sesv2 | sesv2 |
| Einfaches Systemmanagement | einfache Systemverwaltung | ssm | ssm | ssm |
| Einfacher Arbeitsablauf | einfacher Arbeitsablauf | einfacher Arbeitsablauf | swf | swf |
| Step Functions | Schrittfunktionen | Schrittfunktionen | sfn | sfn |