Como migrar para o namespace SDK Voice do Amazon Chime - SDK do Amazon Chime

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Como migrar para o namespace SDK Voice do Amazon Chime

O namespace de voz SDK do Amazon Chime é um local dedicado às APIs que criam e gerenciam recursos de voz do SDK do Amazon Chime. Você usa o namespace para endereçar os endpoints da API de voz do Amazon Chime SDK em AWS qualquer região que os disponibilize. Use esse namespace se você acabou de começar a usar o SDK do Amazon Chime. Para obter mais informações sobre as regiões, consulte Regiões disponíveis neste guia.

Os aplicativos existentes que usam o namespace Amazon Chime devem planejar a migração para o namespace dedicado para usar as APIs e atributos mais recentes.

Motivos para migrar

Recomendamos migrar para o namespace SDK Voice do Amazon Chime pelos seguintes motivos:

Escolha do endpoint de API

O SDK do Amazon Chime permite usar endpoints de API em qualquer região em que estejam disponíveis. Se quiser usar outros endpoints da API diferentes de us-east-1, você deve usar o namespace de voz SDK do Amazon Chime. Para obter mais informações sobre os endpoints atuais, consulte Mapeamento de API neste guia.

APIs de voz novas e atualizadas

Só adicionamos ou atualizamos as APIs de voz no namespace de voz SDK do Amazon Chime.

Antes de migrar

Antes de migrar, observe as diferenças entre os namespaces. A tabela a seguir lista e descreve-os.

Namespace de voz SDK do Amazon Chime

Namespace Amazon Chime

AWS namespace

ChimeSDKVoice

Chime

Regiões

Vários

Somente us-east-1

Endpoints

https://voice-chime.region.amazonaws.com

service.chime.aws.amazon.com

Entidade principal do serviço

chime.amazonaws.com

chime.amazonaws.com

APIs

Somente APIs para o serviço de áudio PSTN

APIs para áudio PSTN e outras partes do Amazon Chime

Gerenciamento de conectores de voz Várias regiões us-east-1
Gerenciamento de grupos de conectores de voz Várias regiões us-east-1
Aplicativo de mídia SIP e gerenciamento de regras SIP Várias regiões us-east-1
Gerenciamento de números de telefone Várias regiões us-east-1
Análise de chamadas Available (Disponível) Indisponível
Domínios de perfil de voz Available (Disponível) Indisponível
Gerenciamento de chamadas de emergência Várias regiões us-east-1
Gerenciamento de sessões de telefone proxy Várias regiões us-east-1
Gerenciamento de streaming Várias regiões us-east-1
Gerenciamento de registros de log e métricas Várias regiões us-east-1

Para obter mais informações sobre as regiões disponíveis, consulte Regiões PSTN anteriormente neste guia.

Diferenças entre os namespaces

As seções a seguir explicam as diferenças entre os namespaces Amazon Chime SDK Voice e Amazon Chime.

AWS namespace

O namespace SDK do Amazon Chime usa o nome formal Chime. O namespace de voz SDK do Amazon Chime usa o nome formal ChimeSDKVoice. O formato preciso do nome varia de acordo com a plataforma.

Por exemplo, se você usar o AWS SDK no Node.js para criar reuniões, use a seguinte linha de código para endereçar o namespace.

const chimeVoice = AWS.Chime();

Para migrar para o namespace de voz SDK do Amazon Chime, atualize essa linha de código com o novo namespace e a região do endpoint.

const chimeVoice = AWS.ChimeSDKVoice({ region: "eu-central-1" });
Regiões

O namespace Amazon Chime só pode referenciar endpoints de API na região us-east-1. O namespace de voz SDK do Amazon Chime pode endereçar os endpoints da API de voz do SDK do Amazon Chime em qualquer região em que estejam disponíveis. Para obter uma lista atual das regiões de voz, consulte Regiões disponíveis neste guia.

Endpoints

O namespace de voz SDK do Amazon Chime usa endpoints de API diferentes do namespace Amazon Chime.

Somente o endpoint usado para criar uma ação de voz pode ser usado para modificá-la. Isso significa que uma ação de voz criada por meio de um endpoint em eu-central-1 pode ser modificada via eu-central-1. Isso também significa que você não pode abordar uma ação de voz criada por meio do namespace Chime com o namespace ChimeSDKVoice em us-east-1. Para obter mais informações sobre os endpoints atuais, consulte Mapeamento de API neste guia.

Entidade principal do serviço

Ambos os namespaces usam a entidade principal de serviço chime.amazonaws.com. Se você tiver políticas de acesso que concedam acesso ao serviço, não precisará atualizar essas políticas.

APIs

O namespace de voz SDK do Amazon Chime contém somente APIs para criar e gerenciar ações de voz. O namespace Amazon Chime inclui APIs para voz e outras partes do serviço Amazon Chime, como reuniões.

Tags

Somente o namespace de voz SDK do Amazon Chime suporta tags. Para obter mais informações sobre tags, consulte TagResourceUntagResourcee.

Regiões de mídia

Se você usar o namespace Chime para criar recursos como conectores de voz e aplicativos de mídia SIP, só poderá fazer isso em us-east-1 e us-west-2, e deverá usar o endpoint us-east-1.

Por outro lado, o namespace ChimeSDKVoice permite a criação de recursos em todas as regiões suportadas, não apenas us-east-1 e us-west-2. Para obter mais informações sobre a cobertura regional, consulte Regiões disponíveis.