Migration vers l'espace de noms Amazon Chime SDK Identity

L'espace de noms Amazon Chime SDK Identity est un espace dédié aux API utilisées pour créer et gérer les ressources d'identité du SDK Amazon Chime, notamment et. AppInstances AppInstanceUsers Vous utilisez l'espace de noms pour adresser les points de terminaison de l'API d'identité du SDK Amazon Chime dans AWS toutes les régions dans lesquelles ils sont disponibles. Utilisez cet espace de noms si vous commencez tout juste à utiliser le SDK Amazon Chime. Pour plus d'informations sur les régions, reportez-vous Régions disponibles à ce guide.

Les applications existantes qui utilisent l'espace de noms Amazon Chime doivent prévoir de migrer vers l'espace de noms dédié.

Les raisons de migrer

Nous vous encourageons à migrer vers l'espace de noms Amazon Chime SDK Identity pour les raisons suivantes :

Choix du point de terminaison de l'API

L'espace de noms Amazon Chime SDK Identity est le seul espace de noms d'API capable d'utiliser des points de terminaison d'API dans toutes les régions qui les rendent disponibles. Si vous souhaitez utiliser des points de terminaison d'API autres queus-east-1, vous devez utiliser l'espace de noms Amazon Chime SDK Identity. Pour plus d'informations sur les points de terminaison actuels, reportez-vous Cartographie des API à ce guide.

API de messagerie mises à jour et nouvelles

Nous ajoutons ou mettons à jour des API d'identité uniquement dans l'espace de noms Amazon Chime SDK Identity.

Avant de procéder à la migration

Avant de procéder à la migration, soyez conscient des différences entre les espaces de noms. Le tableau suivant les répertorie et les décrit.

	Espace de noms d'identité du SDK Amazon Chime	Espace de noms Amazon Chime
AWS Espace de noms du SDK	ChimeSDKIdentity	Chime
Régions	Plusieurs	us-east-1 uniquement
Service principal	https://identity.chime.amazonaws.com	https://chime.amazonaws.com
API	Uniquement des API pour l'identité	API pour l'identité et d'autres éléments d'Amazon Chime
Expiration des utilisateurs	Disponible	Non disponible
Bots	Disponible	Non disponible

Différences entre les espaces de noms

Les sections suivantes expliquent les différences entre les ChimeSDKIdentity espaces de noms Chime et.

AWS Espace de noms du SDK

L'espace de noms du SDK Amazon Chime utilise le nom officiel. Chime L'espace de noms Amazon Chime SDK Identity utilise le nom officiel. ChimeSDKIdentity Le format précis du nom varie en fonction de la plateforme.

Par exemple, si vous utilisez le AWS SDK dans Node.js pour créer des identités, vous utilisez une ligne de code pour adresser l'espace de noms.

const chimeIdentity = AWS.Chime();

Pour migrer vers l'espace de ChimeSDKIdentity noms, mettez à jour cette ligne de code avec le nouvel espace de noms et la région du point de terminaison.

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

Régions

L'espace de noms Amazon Chime ne peut adresser que les points de terminaison d'API de la région. us-east-1 L'espace de noms Amazon Chime SDK Identity peut adresser les points de terminaison de l'API Amazon Chime SDK Identity dans toutes les régions où ils sont disponibles. Pour obtenir la liste actuelle des régions de points de terminaison, reportez-vous Régions disponibles à ce guide.

Points de terminaison

L'espace de noms Amazon Chime SDK Identity utilise des points de terminaison d'API différents de ceux de l'espace de noms Amazon Chime.

Seul le point de terminaison utilisé pour créer les ressources d'identité peut être utilisé pour les mettre à jour. Cela signifie qu'une AppInstance annonce créée via un point de terminaison ne eu-central-1 peut être modifiée que viaeu-central-1. Cela signifie également que vous ne pouvez pas adresser une chaîne AppInstance créée via l'espace de noms Chime avec l'espace de noms ChimeSDKIdentity dansus-east-1, ou créer une chaîne dans une région autre que la région où les membres et ont été créés. AppInstance AppInstanceUser Pour plus d'informations sur les points de terminaison actuels, reportez-vous Cartographie des API à ce guide.

Principal du service

L'espace de noms Amazon Chime SDK Identity utilise un nouveau principal de service :. Identity.chime.amazonaws.com Si vous avez des politiques d'accès SQS, SNS ou IAM qui accordent l'accès au service, vous devez mettre à jour ces politiques pour accorder l'accès au nouveau principal de service.

API

L'espace de noms Amazon Chime SDK Identity contient uniquement des API permettant de créer et de gérer des ressources de messagerie, ainsi que d'envoyer et de recevoir des messages. L'espace de noms Amazon Chime inclut des API pour d'autres parties du service Amazon Chime, ainsi que pour la messagerie.

Expiration des utilisateurs

Les paramètres d'expiration lors de la création de vous AppInstanceUsers permettent de créer des utilisateurs temporaires. Par exemple, vous pouvez créer des utilisateurs de chat qui n'existent que pendant la durée d'une diffusion importante. Seul l'espace de noms Identity prend en charge les paramètres d'expiration pour AppInstanceUsers.

Bots

Vous utilisez l'AppInstanceBotAPI pour ajouter des robots de discussion optimisés par Amazon Lex V2 dans vos applications. Vous ne pouvez l'utiliser que AppInstanceBots dans l'espace de noms Identity. Pour plus d'informations sur les robots, reportez-vous Utilisation en AppInstanceBots tant qu'agents de distribution intelligents à ce guide.

API supplémentaires

L'espace de noms Identity contient une liste croissante d'API supplémentaires que l'espace de noms Chime ne possède pas. Si vous commencez à utiliser le SDK Amazon Chime, utilisez l'espace de noms Identity pour accéder à toutes les fonctionnalités les plus récentes. Pour plus d'informations sur les API actuelles, reportez-vous à la section Identité du SDK Amazon Chime dans le manuel Amazon Chime SDK API Reference.