AWS Migration Hub-API - AWS Migration Hub
Melden von MigrationsstatusaktualisierungenAPI-EndpunktAPI-VersionAWS CloudTrailVerwandte Themen

AWS Migration Hub-API

Die AWS Migration Hub-API-Methoden helfen, den Server- und Anwendungsmigrationsstatus zu erhalten und Ihr ressourcenspezifisches Migrationstool zu integrieren, indem eine Programmschnittstelle für Migration Hub bereitgestellt wird.

Melden von Migrationsstatusaktualisierungen

Erstellen eines ProgressUpdateStream für Ihr Migrationstool

Um den Status an Migration Hub zu senden, müssen Sie zuerst einen Ihrem Migrationstool entsprechenden ProgressUpdateStream mit CreateProgressUpdateStream erstellen. ProgressUpdateStreamName ist der Namespace für Ihr Migrationstool. ProgressUpdateStreamName gilt für das aktuelle AWS-Konto, so dass es für alle Konten gleich sein kann. ProgressUpdateStreamName wird in der gesamten Migration Hub-Konsole als Name angezeigt, der für Ihr Migrationstool steht. Beispielsweise verwendet der Servermigrationsdienst ProgressUpdateStreamName "SMS" und wird auf der Anwendungsseite unter dem Abschnitt "Migrate (Migrieren)" als "Migration Tool (Migrationstool)" angezeigt.

Importieren einer Migrationsaufgabe

Nachdem Sie einen ProgressUpdateStream erstellt haben, können Sie mit dem Importieren von Migrationsaufgaben aus Ihrem Migrationstool beginnen, indem Sie ImportMigrationTask aufrufen. Es wird empfohlen, ImportMigrationTask so früh wie möglich aufzurufen, um den Migration Hub-Benutzer über die Existenz der Aufgabe zu informieren, auch wenn die Aufgabe noch gestartet werden muss.

Zuordnen einer Migrationsaufgabe zu einem zuvor erkannten Server

Um der Konsole Details zur Migrationsaufgabe hinzuzufügen, muss die Aufgabe einer Ressource zugeordnet sein. Die Ressource stellt den vorhandenen oder Quellserver für die Migration dar. Es gibt zwei Möglichkeiten, diese Zuordnung vorzunehmen:

  • Automatische Zuweisung (empfohlen): Ein Migrationstool kann ausreichende identifizierbare Informationen (z. B. IP-Adresse, MAC-Adresse und/oder vollqualifizierter Domänenname und in einer VMware-Umgebung vCenter ID, MoRef ID, VM-Name und/oder VM-Ordnerpfad) zuweisen, indem er PutResourceAttributes mit einer Migrationsaufgabe, aufruft. So kann AWS Migration Hub den Server, der migriert wird, korrekt einem Server im Serverrepository von AWS Application Discovery Service (ADS) zuweisen. Wenn Migration Hub keinen übereinstimmenden Server im Server-Repository von ADS findet, wird der Server automatisch zum ADS-Repository hinzugefügt.

  • Manuelle Zuweisung: Alternativ kann ein Migrationstool dem Benutzer erlauben, diese Zuweisung manuell zu erstellen, indem eine Zuweisungsumgebung innerhalb des Workflows des Migrationstools bereitgestellt wird, in der eine Liste der vorhandenen AWS Application Discovery Service (ADS)-Server angezeigt wird.

    Anmerkung

    Dieser Ansatz wird nicht empfohlen und ist selten notwendig, da bei der automatischen Zuweisung (oben) der Server von Ihrem Tool beim Aufrufen von PutResourceAttributes dem Application Discovery Service-Repository automatisch hinzugefügt und zugewiesen wird.

Erläuterung der automatischen Zuweisung

  • Ein Migrationstool verwendet die PutResourceAttributes-API, um Informationen über die zu migrierende Ressource bereitzustellen. Dies geschieht durch eine asynchrone Zuordnung mit der Ressource, nachdem der PutResourceAttributes Aufruf zurückgegeben wurde. Wenn kein übereinstimmender Server gefunden wurde, fügt PutResourceAttributes dem ADS-Repository automatisch einen Server hinzu und ordnet die Migrationsaufgabe dem neuen Server zu. Diese Zuordnung kann dann durch Aufrufen von ListDiscoveredResource. verifiziert werden.

  • Der Aufruf erfolgt mit MigrationTaskName und ResourceAttributes. Der MigrationTaskName ist ein Bezeichner, der vom Migrationstool bereitgestellt wird. Mit diesem Namen wird eine Migrationsaufgabe innerhalb Ihres ProgressUpdateStream eindeutig identifiziert.

  • ResourceAttributes sind beschreibende Informationen über die zu migrierende Ressource, wie MAC-Adresse, IP-Adresse, vollqualifizierter Domänenname usw. für Server bzw. in einer VMware-Umgebung VM-Name, vCenter ID oder MoRef ID. Diese können verwendet werden, um die Migrationsaufgabe einem Server in der Application Discovery Service (ADS) zuzuordnen.

Senden von Migrationsstatusaktualisierungen

Nachdem nun eine Migrationsaufgabe vorhanden ist, können Sie Migrationsstatusaktualisierungen senden, damit diese in Migration Hub angezeigt werden. Rufen Sie die NotifyMigrationTaskState-API von AWS Migration Hub auf, um den aktuellen Aufgabenstatus freizugeben. Die von diesem Aufruf zurückgegebenen Informationen enthalten den Fortschritt und Status der Migrationsaufgabe. Dies sind die Informationen, die Kunden in Migration Hub angezeigt werden.

Der Eingabeparameter MigrationTaskName enthält Argumente, die für die Adressierung von Aktualisierungen für die korrekte Zielaufgabe verwendet werden. Der Parameter ProgressUpdateStream wird für die Zugriffskontrolle und zur Bereitstellung eines eindeutigen Namespaces für das AWS-Konto verwendet. API-Parameter werden weiter unten in diesem Abschnitt ausführlich beschrieben.

Erwartetes Verhalten des Migrationstools

Die folgenden Punkte sind wichtige Informationen zur Interaktion zwischen dem verwendeten Migrationstool und AWS Migration Hub.

  • Es wird erwartet, dass das Migrationstool bei Migration Hub-API-Fehlern eine erneuten Versuch ausführt.

  • Vom Migrationstool wird erwartet, dass Aktualisierungen so oft wie möglich veröffentlicht werden. Ein Migrationstool muss bei jedem Aufruf der NotifyMigrationTaskState-API eigene Aktualisierungserwartungen angeben. Es wird empfohlen, Updates zu senden, sobald sie verfügbar sind.

  • Das Migrationstool sollte PutResourceAttributes aufrufen. Wenn das Migrationstool während der Migration Änderungen an der Ressource erkennt oder zusätzliche Informationen findet, kann es PutResourceAttributes-Daten erneut senden. Migration Hub verwendet die neuen Werte und überschreibt alte Werte und versucht, eine erneute Zuweisung zu einer Ressource in Application Discovery Service vorzunehmen.

API-Endpunkt

Der API-Endpunkt ist der DNS-Name, der in dem HTTP-URI für die API-Aufrufe als Host verwendet wird. Diese API-Endpunkte sind regionsspezifisch und haben das folgende Format:

https://mgh.us-west-2.amazonaws.com/

API-Version

Die für den Aufruf verwendete API-Version wird vom ersten Pfadsegment des Anforderungs-URIs bestimmt und hat das Datumsformat nach ISO 8601.

Die Beschreibung in der Dokumentation bezieht sich auf die API-Version 2017-05-31.

AWS CloudTrail

Migration Hub ist in CloudTrail integriert. Dieser Service erfasst API-Aufrufe von der Migration Hub-Konsole oder von Ihrem Code zu den Migration Hub-API-Operationen. Anhand der von CloudTrail erfassten Informationen können Sie unter anderem die Anforderung an Migration Hub, die Quell-IP-Adresse, von der die Anforderung ausging, den Ersteller sowie den Erstellungszeitpunkt der Anforderung ermitteln. Siehe Protokollieren von Migration Hub-API-Aufrufen mit AWS CloudTrail.

In den folgenden Abschnitten erhalten Sie Beschreibungen der API-Operationen. Sie erfahren, wie Sie Signaturen zur Authentifizierung von Anforderungen erstellen und wie Sie mithilfe der IAM-Richtlinien Berechtigungen für die API-Operationen erteilen.