Migration zum Amazon Chime SDK:

DerAmazon Chime SDK-NachrichtenNamespace ist ein spezieller Ort für die APIs, die Amazon Chime SDK-Messaging-Ressourcen erstellen und verwalten. Sie verwenden den Namespace, um Amazon Chime SDK-Messaging-API-Endpunkte in einem beliebigenAWSRegion, in der sie verfügbar sind. Verwenden Sie diesen Namespace, wenn Sie gerade erst anfangen, das Amazon Chime SDK zu verwenden. Weitere Informationen zu den Regionen finden Sie unterVerfügbare Regionenin dieser Anleitung.

Bestehende Anwendungen, die das verwendenAmazon ChimeDer Namespace sollte die Migration zum dedizierten Namespace planen.

Gründe für die Migration

Wir empfehlen Ihnen, auf das zu migrierenAmazon Chime SDK-NachrichtenNamespace aus folgenden Gründen:

Wahl des API-Endpunkts

Der Amazon Chime SDK Messaging-Namespace ist der einzige API-Namespace, der API-Endpunkte in jedem verwenden kannRegion, die sie verfügbar macht. Wenn Sie andere API-Endpunkte verwenden möchten alsus-east-1, müssen Sie den Amazon Chime SDK Messaging-Namespace verwenden.

Für weitere Informationen zur Verwendung von Amazon Chime SDKAWSRegionen finden Sie unterVerfügbare Regionenin dieser Anleitung.

Aktualisierte und neue Messaging-APIs

Wir fügen nur Messaging-APIs im Amazon Chime SDK Messaging-Namespace hinzu oder aktualisieren sie.

Bevor Sie migrieren

Beachten Sie vor der Migration die Unterschiede zwischen den Namespaces. Sie werden in der folgenden Tabelle aufgeführt und beschrieben.

	Der Namespace für das Amazon Chime SDK	Amazon Chime Chime-Namespace
AWSSDK-Namespace	ChimesDK-Messaging	Glockenspiel
Regionen	Mehrere	nur us-east-1
APIs	Nur APIs für Messaging	APIs für Messaging und andere Teile von Amazon Chime
Flüsse	Verfügbar	Nicht verfügbar
Elastische Kanäle	Verfügbar	Nicht verfügbar

Unterschiede zwischen den Namespaces

In den folgenden Abschnitten werden die Unterschiede zwischenAmazon ChimeundAmazon Chime SDK MessagingNamespaces.

AWSSDK-Namespace

Der Amazon Chime SDK-Namespace verwendet denChimeformeller Name. Der Amazon Chime SDK:ChimeSDKMessagingformeller Name. Das genaue Format des Namens variiert je nach Plattform.

Verwenden Sie zum Beispiel dieAWSDas SDK in Node.js zum Erstellen von Nachrichten verwenden Sie eine Codezeile, um den Namespace zu adressieren.

const chimeMessaging = AWS.Chime();

Um zum Amazon Chime Messaging SDK zu migrieren, aktualisieren Sie diese Codezeile mit dem neuen Namespace und der Endpunktregion.

const chimeMessaging = AWS.ChimeSDKMessaging({ region: "eu-central-1" });

Regionen

DasAmazon ChimeDer Namespace kann nur API-Endpunkte in der adressierenus-east-1Region. DieAmazon Chime SDK-NachrichtenDer Namespace kann Amazon Chime SDK-Messaging-API-Endpunkte in jeder Region adressieren, in der sie verfügbar sind. Eine aktuelle Liste der Messaging-Regionen finden Sie unterVerfügbare Regionenin dieser Anleitung.

Endpunkte

DasAmazon Chime SDK-NachrichtenDer Namespace verwendet andere API-Endpunkte als derAmazon ChimeNamensraum.

Nur der Endpunkt, der zum Erstellen einer Messaging-Ressource verwendet wurde, kann verwendet werden, um sie zu ändern. Das bedeutet, dass eine Messaging-Ressource über einen Endpunkt in erstellt wurdeeu-central-1kann nur geändert werden übereu-central-1. Das bedeutet, dass ein Kanal, der über einen Endpunkt in eu-central-1 erstellt wurde, nur geändert werden kann übereu-central-1. Dies bedeutet auch, dass Sie einen Kanal, der über den erstellt wurde, nicht adressieren könnenChimeNamespace mitChimeSDKMessagingNamensraum inus-east-1. Weitere Informationen zu den aktuellen Endpoints finden Sie unterAPI-Zuordnungin dieser Anleitung.

Dienstauftraggeber

DasAmazon Chime SDK-NachrichtenDer Namespace verwendet einen neuen Dienstprinzipal:messaging.chime.amazonaws.com. Wenn Sie über SQS-, SNS- oder andere IAM-Zugriffsrichtlinien verfügen, die Zugriff auf den Dienst gewähren, müssen Sie diese Richtlinien aktualisieren, um Zugriff auf den neuen Dienstprinzipal zu gewähren.

APIs

DasAmazon Chime SDK-NachrichtenDer Namespace enthält nur APIs zum Erstellen und Verwalten von Messaging-Ressourcen sowie zum Senden und Empfangen von Nachrichten. DerAmazon ChimeDer Namespace umfasst APIs für andere Teile des Amazon Chime Chime-Dienstes sowie für Messaging.

Kanalflüsse

Kanalflüsse ermöglichen es Entwicklern, Geschäftslogik auf Nachrichten während der Übertragung anzuwenden, bevor sie an Mitglieder eines Messaging-Channels zugestellt werden. Sie können beispielsweise Flows erstellen, mit denen vertrauliche Daten wie behördliche Ausweisnummern, Telefonnummern oder Schimpfwörter aus Nachrichten entfernt werden, bevor sie zugestellt werden. Dies kann bei der Umsetzung von Unternehmenskommunikationsrichtlinien oder anderen Kommunikationsrichtlinien helfen.

Sie können Kanalflüsse auch verwenden, um Funktionen auszuführen, z. B. die Antworten auf eine Umfrage zu aggregieren, bevor die Ergebnisse an die Teilnehmer zurückgesendet werden, oder um Nachrichten per SMS zu versenden.

Die Kanalflüsse sind nur verfügbar inChimeSDKMessagingNamensraum. Weitere Informationen zu ihnen finden Sie unterKanalabläufe zur Verarbeitung von Nachrichten verwendenin dieser Anleitung.

Elastische Kanäle

Elastische Kanäle unterstützen groß angelegte Chat-Erlebnisse mit bis zu einer Million Chat-Nutzern, die automatisch auf eine definierte Anzahl von Unterkanälen verteilt werden. Die elastischen Kanäle sind nur in derChimeSDKMessagingEndpunkt. Weitere Informationen zu elastischen Kanälen finden Sie unterVerwendung elastischer Kanäle für die Ausrichtung von Live-Eventsin dieser Anleitung.

Zusätzliche APIs

Der Messaging-Namespace enthält eine wachsende Liste von APIs, dieChimeDer Namespace hat nicht. Wenn Sie mit dem Amazon Chime SDK beginnen, verwenden Sie den Messaging-Namespace für den Zugriff auf die neuesten Funktionen. Weitere Informationen zu den aktuellen APIs finden Sie unterAmazon Chime SDK-Nachrichtenin derReferenz zur Amazon Chime SDK-API.