Migrazione allo spazio dei nomi Amazon Chime SDK Messaging

Lo spazio dei nomi Amazon Chime SDK Messaging è un luogo dedicato per le API che creano e gestiscono le risorse di messaggistica Amazon Chime SDK. Puoi utilizzare lo spazio dei nomi per indirizzare gli endpoint delle API di messaggistica SDK Amazon Chime in qualsiasi regione AWS in cui sono disponibili. Usa questo namespace se stai appena iniziando a utilizzare l'SDK Amazon Chime. Per ulteriori informazioni sulle regioni, consulta questa guida. Regioni disponibili

Le applicazioni esistenti che utilizzano lo spazio dei nomi Amazon Chime devono pianificare la migrazione verso lo spazio dei nomi dedicato.

Motivi per migrare

Ti consigliamo di migrare allo spazio dei nomi di Amazon Chime SDK Messaging per questi motivi:

Scelta dell'API Endpoint

Lo spazio dei nomi Amazon Chime SDK Messaging è l'unico spazio dei nomi API che può utilizzare gli endpoint API in qualsiasi regione che li renda disponibili. Se desideri utilizzare endpoint API diversi da Stati Uniti orientali (Virginia settentrionale), devi utilizzare lo spazio dei nomi Amazon Chime SDK Messaging.

Per ulteriori informazioni su come la messaggistica di Amazon Chime SDK utilizza AWS le regioni, consulta la sezione Regioni disponibili in questa guida.

API di messaggistica nuove e aggiornate

Aggiungiamo o aggiorniamo solo le API di messaggistica nello spazio dei nomi Amazon Chime SDK Messaging.

Prima di effettuare la migrazione

Prima di effettuare la migrazione, tenete presente le differenze tra i namespace. La tabella seguente li elenca e li descrive.

	Spazio dei nomi di messaggistica SDK Amazon Chime	Spazio dei nomi Amazon Chime
AWS Spazio dei nomi SDK	ChimeSDKMessaging	Chime
Regioni	Più di uno	Solo Stati Uniti orientali (Virginia settentrionale)
API	Solo API per la messaggistica	API per la messaggistica e altre parti di Amazon Chime
Flussi	Disponibilità	Non disponibile
Canali elastici	Disponibilità	Non disponibile

Differenze tra i namespace

Le sezioni seguenti spiegano le differenze tra i namespace e. Amazon Chime Amazon Chime SDK Messaging

AWS Spazio dei nomi SDK

Lo spazio dei nomi Amazon Chime SDK utilizza il nome formale. Chime Lo spazio dei nomi Amazon Chime SDK Messaging utilizza il nome formale. ChimeSDKMessaging Il formato preciso del nome varia in base alla piattaforma.

Ad esempio, se si utilizza l' AWS SDK in Node.js per creare messaggi, si utilizza una riga di codice per indirizzare lo spazio dei nomi.

const chimeMessaging = AWS.Chime();

Per migrare all'Amazon Chime Messaging SDK, aggiorna questa riga di codice con il nuovo spazio dei nomi e la regione degli endpoint.

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

Regioni

Lo spazio dei nomi Amazon Chime può indirizzare solo gli endpoint API nella regione. US East (N. Virginia) Lo spazio dei nomi Amazon Chime SDK Messaging può indirizzare gli endpoint dell'API di messaggistica Amazon Chime SDK in qualsiasi regione in cui siano disponibili. Per un elenco aggiornato delle regioni di messaggistica, consulta questa guida. Regioni disponibili

Endpoints

Lo spazio dei nomi Amazon Chime SDK Messaging utilizza endpoint API diversi rispetto allo spazio dei nomi Amazon Chime.

Solo l'endpoint utilizzato per creare una risorsa di messaggistica può essere utilizzato per modificarla. Ciò significa che una risorsa di messaggistica creata tramite un endpoint in Europe (Frankfurt) può essere modificata solo tramite. Europe (Frankfurt) Ciò significa che un canale creato tramite un endpoint in Europa (Francoforte) può essere modificato solo via Europa (Francoforte). Significa anche che non è possibile indirizzare un canale creato tramite lo Chime spazio dei nomi con lo spazio dei ChimeSDKMessaging nomi negli Stati Uniti orientali (Virginia settentrionale). Per ulteriori informazioni sugli endpoint attuali, consulta questa guida. Mappatura delle API

Principale del servizio

Lo spazio dei nomi Amazon Chime SDK Messaging utilizza un nuovo service principal:. messaging.chime.amazonaws.com Se disponi di SQS, SNS o altre policy di accesso IAM che garantiscono l'accesso al servizio, devi aggiornare tali policy per concedere l'accesso al nuovo service principal.

API

Lo spazio dei nomi Amazon Chime SDK Messaging contiene solo API per la creazione e la gestione di risorse di messaggistica e per l'invio e la ricezione di messaggi. Lo spazio dei nomi Amazon Chime include API per altre parti del servizio Amazon Chime e per la messaggistica.

Flussi di canale

I flussi di canale consentono agli sviluppatori di eseguire la logica aziendale sui messaggi in transito prima che vengano recapitati ai membri di un canale di messaggistica. Ad esempio, puoi creare flussi che rimuovano dati sensibili come numeri di documenti d'identità governativi, numeri di telefono o parolacce dai messaggi prima che vengano recapitati. Ciò può aiutare a implementare le politiche di comunicazione aziendali o altre linee guida di comunicazione.

È inoltre possibile utilizzare i flussi di canale per eseguire funzioni come l'aggregazione delle risposte a un sondaggio prima di inviare i risultati ai partecipanti o l'invio di messaggi tramite SMS.

I flussi di canale sono disponibili solo nel namespace. ChimeSDKMessaging Per ulteriori informazioni su di essi, consulta questa Utilizzo dei flussi di canale per elaborare i messaggi guida.

Canali elastici

I canali elastici supportano esperienze di chat su larga scala con un massimo di un milione di utenti di chat bilanciati automaticamente su un numero definito di sottocanali. I canali elastici sono disponibili solo nell'ChimeSDKMessagingendpoint. Per ulteriori informazioni sui canali elastici, Utilizzo di canali elastici per ospitare eventi dal vivo consulta questa guida.

API aggiuntive

Lo spazio dei nomi Messaging ha un elenco crescente di API che lo spazio dei Chime nomi non dispone. Se stai iniziando a usare l'SDK Amazon Chime, usa lo spazio dei nomi di messaggistica per accedere a tutte le funzionalità più recenti. Per ulteriori informazioni sulle API attuali, consulta Amazon Chime SDK Messaging nell'Amazon Chime SDK API Reference.