Migración al espacio de nombres de mensajería de Amazon Chime SDK

El espacio de nombres de mensajería del SDK de Amazon Chime es un lugar dedicado a quienes crean y administran los recursos APIs de mensajería del SDK de Amazon Chime. El espacio de nombres se utiliza para dirigirse a los puntos de conexión de la API de mensajería de Amazon Chime SDK en cualquier región de AWS en la que estén disponibles. Utilice este espacio de nombres si acaba de empezar a utilizar Amazon Chime SDK. Para obtener más información sobre las regiones, consulte Regiones de AWS disponibles para Amazon Chime SDK en esta guía.

Las aplicaciones existentes que utilizan el espacio de nombres de Amazon Chime deberían planificar la migración al espacio de nombres dedicado.

Razones para migrar

Le recomendamos que migre al espacio de nombres de mensajería de Amazon Chime SDK por los siguientes motivos:

Elección de un punto de conexión de API

El espacio de nombres de mensajería de Amazon Chime SDK es el único espacio de nombres de API que puede usar puntos de conexión de API en cualquier región en la que estén disponibles. Si desea utilizar puntos de conexión de API distintos de Este de EE. UU. (Norte de Virginia), debe utilizar el espacio de nombres de mensajería de Amazon Chime SDK.

Para obtener más información sobre cómo la mensajería del SDK de Amazon Chime utiliza AWS las regiones, consulte las regiones disponibles en esta guía.

Mensajes nuevos y actualizados APIs

Solo añadimos o actualizamos los mensajes APIs en el espacio de nombres de mensajería del SDK de Amazon Chime.

Antes de realizar la migración

Antes de realizar la migración, tenga en cuenta las diferencias entre los espacios de nombres. En la siguiente tabla, se muestran y describen.

	Espacio de nombres de mensajería de Amazon Chime SDK	Espacio de nombres de Amazon Chime
AWS Espacio de nombres del SDK	ChimeSDKMessaging	Chime
Regiones	Múltiple	Únicamente Este de EE. UU. (Norte de Virginia)
APIs	Solo APIs para mensajería	APIs para mensajería y otras partes de Amazon Chime
Flujos	Disponible	No disponible
Canales elásticos	Disponible	No disponible

Diferencias entre los espacios de nombres

En las siguientes secciones se explican las diferencias entre los espacios de nombres Amazon Chime y Amazon Chime SDK Messaging.

AWS espacio de nombres del SDK

El espacio de nombres de Amazon Chime SDK usa el nombre formal Chime. El espacio de nombres de mensajería de Amazon Chime SDK usa el nombre formal ChimeSDKMessaging. El formato preciso del nombre varía según la plataforma.

Por ejemplo, si utilizas el AWS SDK de Node.js para crear mensajes, utilizas una línea de código para direccionar el espacio de nombres.

const chimeMessaging = AWS.Chime();

Para migrar al espacio de nombres del SDK de mensajería de Amazon Chime, actualice esta línea de código con el nuevo espacio de nombres y la región del punto de conexión.

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

Regiones

El espacio de nombres de Amazon Chime solo puede abordar puntos de conexión de la API de la región de US East (N. Virginia). El espacio de nombres de mensajería de Amazon Chime SDK puede dirigirse a los puntos de conexión de la API de identidad de Amazon Chime SDK en cualquier región en la que estén disponibles. Para obtener una lista actualizada de las regiones de mensajería, consulte Regiones de AWS disponibles para Amazon Chime SDK en esta guía.

puntos de conexión

El espacio de nombres de mensajería de Amazon Chime SDK utiliza puntos de conexión de API diferentes a los del espacio de nombres de Amazon Chime.

Solo el punto de conexión utilizado para crear un recurso de mensajería se puede utilizar para modificarlo. Esto significa que un recurso de mensajería creado a través de un punto de conexión en Europe (Frankfurt) solo se puede modificar mediante Europe (Frankfurt). Esto significa que un canal creado a través de un punto de conexión en Europa (Fráncfort) solo puede modificarse mediante Europa (Fráncfort). También significa que no puede dirigirse a un canal creado a través del Chime con el espacio de nombres ChimeSDKMessaging incluido en Este de EE. UU. (Norte de Virginia). Para obtener más información sobre los puntos de conexión actuales, consulte Mapeo de API en esta guía.

Entidad principal de servicio

El espacio de nombres de mensajería de Amazon Chime SDK utiliza una nueva entidad principal de servicio: messaging.chime.amazonaws.com. Si tiene políticas de acceso de SQS, SNS u otras políticas de IAM que otorgan acceso al servicio, debe actualizar esas políticas para conceder acceso a la nueva entidad principal del servicio.

APIs

El espacio de nombres de mensajería del SDK de Amazon Chime solo contiene información APIs para crear y administrar recursos de mensajería y para enviar y recibir mensajes. El espacio de nombres Amazon Chime incluye otras partes del APIs servicio Amazon Chime, así como la mensajería.

Flujos de canales

Los flujos de canales permiten a los desarrolladores ejecutar lógica empresarial en los mensajes en movimiento antes de que se entreguen a los miembros de un canal de mensajería. Por ejemplo, puede crear flujos que eliminen de los mensajes datos confidenciales, como números de identificación oficiales, números de teléfono o blasfemias, antes de entregarlos. Esto puede ayudar a implementar las políticas de comunicación corporativas u otras pautas de comunicación.

También puede usar los flujos de canales para realizar funciones como agregar las respuestas a una encuesta antes de enviar los resultados a los participantes, o enviar mensajes SMS.

Los flujos de canales solo están disponibles en el espacio de nombres ChimeSDKMessaging. Para más información, consulte Uso de los flujos de canales para procesar los mensajes de la mensajería de Amazon Chime SDK en esta guía.

Canales elásticos

Los canales elásticos admiten experiencias de chat a gran escala, con hasta un millón de usuarios de chat repartidos automáticamente en un número definido de subcanales. Los canales elásticos solo están disponibles en el punto de conexión ChimeSDKMessaging. Para más información sobre los canales elásticos, consulte Uso de canales elásticos para organizar eventos en directo en las reuniones de Amazon Chime SDK en esta guía.

Adicional APIs

El espacio de nombres de Messaging tiene una lista cada vez mayor de los APIs que no tiene el espacio de Chime nombres. Si está empezando a utilizar Amazon Chime SDK, utilice el espacio de nombres de mensajería para tener acceso a todas las características más recientes. Para obtener más información sobre la versión actual APIs, consulte la mensajería del SDK de Amazon Chime en la referencia de la API del SDK de Amazon Chime.