Migration vers l'espace de noms de messagerie du SDK Amazon Chime

L'espace de noms de messagerie du SDK Amazon Chime est un espace dédié aux API qui créent et gèrent les ressources de messagerie du SDK Amazon Chime. Vous utilisez l'espace de noms pour adresser les points de terminaison de l'API de messagerie du SDK Amazon Chime dans toutes les régions AWS 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 de messagerie du SDK Amazon Chime pour les raisons suivantes :

Choix du point de terminaison de l'API

L'espace de noms de messagerie du SDK Amazon Chime 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 que l'est des États-Unis (Virginie du Nord), vous devez utiliser l'espace de noms de messagerie du SDK Amazon Chime.

Pour plus d'informations sur la façon dont la messagerie du SDK Amazon Chime utilise AWS les régions, reportez-vous à la section Régions disponibles de ce guide.

API de messagerie mises à jour et nouvelles

Nous ajoutons ou mettons à jour des API de messagerie uniquement dans l'espace de noms de messagerie du SDK Amazon Chime.

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 de messagerie du SDK Amazon Chime	Espace de noms Amazon Chime
AWS Espace de noms du SDK	ChimeSDKMessaging	Chime
Régions	Plusieurs	Est des États-Unis (Virginie du Nord) uniquement
API	Uniquement des API pour la messagerie	API pour la messagerie et d'autres éléments d'Amazon Chime
Flux	Disponible	Non disponible
Canaux élastiques	Disponible	Non disponible

Différences entre les espaces de noms

Les sections suivantes expliquent les différences entre les Amazon Chime SDK Messaging espaces de noms Amazon 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 de messagerie du SDK Amazon Chime utilise le nom officiel. ChimeSDKMessaging 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 messages, vous utilisez une ligne de code pour adresser l'espace de noms.

const chimeMessaging = AWS.Chime();

Pour migrer vers le SDK de messagerie Amazon Chime, mettez à jour cette ligne de code avec le nouvel espace de noms et la région du point de terminaison.

const chimeMessaging = AWS.ChimeSDKMessaging({ region: "Europe (Frankfurt)" });

Régions

L'espace de noms Amazon Chime ne peut adresser que les points de terminaison d'API de la région. US East (N. Virginia) L'espace de noms de messagerie du SDK Amazon Chime peut s'adresser aux points de terminaison de l'API de messagerie du SDK Amazon Chime dans toutes les régions où ils sont disponibles. Pour obtenir la liste actuelle des régions de messagerie, reportez-vous Régions disponibles à ce guide.

Points de terminaison

L'espace de noms de messagerie du SDK Amazon Chime 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 une ressource de messagerie peut être utilisé pour la modifier. Cela signifie qu'une ressource de messagerie créée via un point de terminaison dans ne Europe (Frankfurt) peut être modifiée que viaEurope (Frankfurt). Cela signifie qu'un canal créé via un point de terminaison en Europe (Francfort) ne peut être modifié que via l'Europe (Francfort). Cela signifie également que vous ne pouvez pas adresser un canal créé via l'espace de Chime noms avec l'espace de ChimeSDKMessaging noms situé dans l'est des États-Unis (Virginie du Nord). Pour plus d'informations sur les points de terminaison actuels, reportez-vous Cartographie des API à ce guide.

Principal du service

L'espace de noms de messagerie du SDK Amazon Chime utilise un nouveau principal de service :. messaging.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 de messagerie du SDK Amazon Chime 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.

Débits des canaux

Les flux de canaux permettent aux développeurs d'appliquer une logique métier aux messages en cours de vol avant qu'ils ne soient transmis aux membres d'un canal de messagerie. Par exemple, vous pouvez créer des flux qui suppriment les données sensibles telles que les numéros d'identification gouvernementaux, les numéros de téléphone ou les grossièretés des messages avant leur remise. Cela peut aider à mettre en œuvre les politiques de communication d'entreprise ou d'autres directives de communication.

Vous pouvez également utiliser les flux de canaux pour exécuter des fonctions telles que l'agrégation des réponses à un sondage avant de renvoyer les résultats aux participants ou l'envoi de messages par SMS.

Les flux de canaux ne sont disponibles que dans l'espace de ChimeSDKMessaging noms. Pour plus d'informations à leur sujet, reportez-vous Utilisation des flux de canaux pour traiter les messages à ce guide.

Canaux élastiques

Les canaux élastiques permettent des expériences de chat à grande échelle avec jusqu'à un million d'utilisateurs automatiquement répartis sur un nombre défini de sous-canaux. Les canaux élastiques ne sont disponibles que dans le ChimeSDKMessaging point de terminaison. Pour plus d'informations sur les canaux élastiques, reportez-vous Utilisation de canaux élastiques pour organiser des événements en direct à ce guide.

API supplémentaires

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