Migration zum Amazon Chime SDK Identity-Namespace

Der Amazon Chime SDK Identity-Namespace ist ein spezieller Ort für die APIs, die zur Erstellung und Verwaltung von Amazon Chime SDK-Identitätsressourcen verwendet werden, einschließlich und. AppInstances AppInstanceUsers Sie verwenden den Namespace, um Amazon Chime SDK-Identity-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 Identity-Namespace zu migrieren:

Wahl des API-Endpunkts

Der Amazon Chime SDK Identity-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 verwenden möchtenus-east-1, müssen Sie den Amazon Chime SDK Identity-Namespace verwenden. Weitere Informationen zu den aktuellen Endpunkten finden Sie in diesem Handbuch. API-Zuordnung

Aktualisierte und neue Messaging-APIs

Wir fügen nur Identitäts-APIs im Amazon Chime SDK Identity-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-Identitätsnamespace	Amazon Chime Chime-Namespace
AWS SDK-Namespace	ChimeSDKIdentity	Chime
Regionen	Mehrere	nur us-east-1
Direktor des Dienstes	https://identity.chime.amazonaws.com	https://chime.amazonaws.com
APIs	Nur APIs für Identität	APIs für Identität und andere Teile von Amazon Chime
Ablauf des Benutzers	Verfügbar	Nicht verfügbar
Bots	Verfügbar	Nicht verfügbar

Unterschiede zwischen den Namespaces

In den folgenden Abschnitten werden die Unterschiede zwischen den Namespaces und erklärt. Chime ChimeSDKIdentity

AWS SDK-Namespace

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

Wenn Sie beispielsweise das AWS SDK in Node.js verwenden, um Identitäten zu erstellen, verwenden Sie eine Codezeile, um den Namespace zu adressieren.

const chimeIdentity = AWS.Chime();

Um zum ChimeSDKIdentity Namespace zu migrieren, aktualisieren Sie diese Codezeile mit dem neuen Namespace und der Endpunktregion.

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

Regionen

Der Amazon Chime Chime-Namespace kann nur API-Endpunkte in der Region adressieren. us-east-1 Der Amazon Chime SDK Identity-Namespace kann Amazon Chime SDK Identity API-Endpunkte in jeder Region adressieren, in der sie verfügbar sind. Eine aktuelle Liste der Endpunktregionen finden Sie in diesem Handbuch. Verfügbare Regionen

Endpunkte

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

Nur der Endpunkt, der zur Erstellung von Identitätsressourcen verwendet wird, kann für deren Aktualisierung verwendet werden. Das bedeutet, dass ein über einen Endpunkt AppInstance erstellter in nur über geändert werden eu-central-1 kanneu-central-1. Das bedeutet auch, dass Sie kein über den Chime-Namespace AppInstance erstelltes Objekt mit dem ChimesDkIdentity-Namespace adressieren oder einen Kanal in einer anderen Region als der Region erstellen könnenus-east-1, in der die Mitglieder und erstellt wurden. AppInstance AppInstanceUser Weitere Informationen zu den aktuellen Endpunkten finden Sie in diesem Handbuch. API-Zuordnung

Dienstauftraggeber

Der Amazon Chime SDK Identity-Namespace verwendet einen neuen Dienstprinzipal:. Identity.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 Identity-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.

Ablauf des Benutzers

Mit den Ablaufeinstellungen bei der Erstellung von AppInstanceUsers können Sie temporäre Benutzer erstellen. Sie können beispielsweise Chat-Benutzer erstellen, die nur für die Dauer einer großen Übertragung existieren. Nur der Identity-Namespace unterstützt Ablaufeinstellungen für AppInstanceUsers.

Bots

Sie verwenden die AppInstanceBotAPI, um Chat-Bots, die von Amazon Lex V2 unterstützt werden, zu Ihren Anwendungen hinzuzufügen. Sie können sie nur AppInstanceBots im Identity-Namespace verwenden. Weitere Informationen zu Bots finden Sie Verwendung AppInstanceBots als intelligente Channel-Agenten in diesem Handbuch.

Zusätzliche APIs

Der Identity-Namespace enthält eine wachsende Liste zusätzlicher APIs, über die der Chime-Namespace nicht verfügt. Wenn Sie mit dem Amazon Chime SDK beginnen, verwenden Sie den Identity-Namespace, um Zugriff auf alle aktuellen Funktionen zu haben. Weitere Informationen zu den aktuellen APIs finden Sie unter Amazon Chime SDK Identity in der Amazon Chime SDK API-Referenz.