Migration zum Amazon Chime SDK Messaging-Namespace

Der Amazon Chime SDK Messaging-Namespace 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 jeder AWS-Region anzusprechen, in der sie verfügbar sind. Verwenden Sie diesen Namespace, wenn Sie gerade erst anfangen, das Amazon Chime SDK zu verwenden. Weitere Informationen zu Regionen finden Sie Verfügbare Regionen in diesem Handbuch.

Bestehende Anwendungen, die den Amazon Chime Chime-Namespace verwenden, sollten eine Migration zum dedizierten Namespace planen.

Gründe für eine Migration

Aus den folgenden Gründen empfehlen wir Ihnen, zum Amazon Chime SDK Messaging-Namespace zu migrieren:

Wahl des API-Endpunkts

Der Amazon Chime SDK Messaging-Namespace ist der einzige API-Namespace, der API-Endpunkte in jeder Region verwenden kann, in der sie verfügbar sind. Wenn Sie andere API-Endpunkte als US East (Nord-Virginia) verwenden möchten, müssen Sie den Amazon Chime SDK Messaging-Namespace verwenden.

Weitere Informationen darüber, wie Amazon Chime SDK Messaging AWS Regionen verwendet, finden Sie unter Verfügbare Regionen in diesem Handbuch.

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. In der folgenden Tabelle sind sie aufgeführt und beschrieben.

	Amazon Chime SDK Messaging-Namespace	Amazon Chime Chime-Namespace
AWS SDK-Namespace	ChimeSDKMessaging	Chime
Regionen	Mehrere	Nur USA Ost (Nord-Virginia)
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 zwischen den Namespaces und erklärt. Amazon Chime Amazon Chime SDK Messaging

AWS SDK-Namespace

Der Amazon Chime SDK-Namespace verwendet den Chime formalen Namen. Der Amazon Chime SDK Messaging-Namespace verwendet den ChimeSDKMessaging formalen Namen. Das genaue Format des Namens variiert je nach Plattform.

Wenn Sie beispielsweise das AWS SDK in Node.js verwenden, um Nachrichten zu erstellen, 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: "Europe (Frankfurt)" });

Regionen

Der Amazon Chime Chime-Namespace kann nur API-Endpunkte in der Region adressieren. US East (N. Virginia) Der Amazon Chime SDK Messaging-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 in diesem Handbuch. Verfügbare Regionen

Endpunkte

Der Amazon Chime SDK Messaging-Namespace verwendet andere API-Endpunkte als der Amazon Chime Chime-Namespace.

Nur der Endpunkt, der zur Erstellung einer Messaging-Ressource verwendet wurde, kann für deren Änderung verwendet werden. Das bedeutet, dass eine Messaging-Ressource, die über einen Endpunkt in erstellt wurde, nur über geändert werden Europe (Frankfurt) kannEurope (Frankfurt). Das bedeutet, dass ein Kanal, der über einen Endpunkt in Europa (Frankfurt) erstellt wurde, nur über Europa (Frankfurt) geändert werden kann. Das bedeutet auch, dass Sie einen Kanal, der über den Chime Namespace erstellt wurde, nicht mit dem ChimeSDKMessaging Namespace in US East (Nord-Virginia) adressieren können. Weitere Informationen zu den aktuellen Endpunkten finden Sie API-Zuordnung in diesem Handbuch.

Dienstauftraggeber

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

APIs

Der Amazon Chime SDK Messaging-Namespace enthält nur APIs zum Erstellen und Verwalten von Messaging-Ressourcen sowie zum Senden und Empfangen von Nachrichten. Der Amazon Chime Chime-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, die sensible Daten wie behördliche Ausweisnummern, Telefonnummern oder Schimpfwörter aus Nachrichten entfernen, 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.

Kanalflüsse sind nur im ChimeSDKMessaging Namespace verfügbar. Weitere Informationen zu ihnen finden Sie Kanalflüsse zur Verarbeitung von Nachrichten verwenden in diesem Handbuch.

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. Elastische Kanäle sind nur am ChimeSDKMessaging Endpunkt verfügbar. Weitere Informationen zu elastischen Kanälen finden Sie Nutzung elastischer Kanäle für die Ausrichtung von Live-Events in diesem Handbuch.

Zusätzliche APIs

Der Messaging-Namespace enthält eine wachsende Liste von APIs, über die der Chime Namespace nicht verfügt. 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 unter Amazon Chime SDK Messaging in der Amazon Chime SDK API-Referenz.