

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á.

# Migrar para o namespace de voz do SDK do Amazon Chime
<a name="voice-namespace-migration"></a>

O namespace [Amazon Chime SDK Voice](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Voice.html) é um local dedicado para quem cria e gerencia recursos de voz do APIs Amazon Chime SDK. 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 da AWS disponíveis para o SDK do Amazon Chime](sdk-available-regions.md) neste guia.

Os aplicativos existentes que usam o namespace [Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) devem planejar a migração para o namespace dedicado a fim de usar recursos novos e atualizados. APIs 

**Topics**
+ [Motivos para migrar](#first-concept-chapter)
+ [Antes de migrar](#voice-before-migrate)
+ [Diferenças entre os namespaces](#voice-namespace-diffs)

## Motivos para migrar
<a name="first-concept-chapter"></a>

Recomendamos migrar para o namespace [SDK Voice do Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Voice.html) 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](https://docs.aws.amazon.com/chime-sdk/latest/dg/sdk-available-regions.html). 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](migrate-from-chm-namespace.md#name-end-map) neste guia.

**Voz atualizada e nova APIs**  
Só adicionamos ou atualizamos a voz APIs no namespace Amazon Chime SDK Voice.

## Antes de migrar
<a name="voice-before-migrate"></a>

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 | Disponível | Indisponível | 
| Domínios de perfil de voz | 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 ter mais informações sobre as regiões disponíveis, consulte [Regiões de voz](sdk-available-regions.md#voice-regions).

## Diferenças entre os namespaces
<a name="voice-namespace-diffs"></a>

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](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) só pode referenciar endpoints de API na região `us-east-1`. O namespace de [voz SDK do Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) 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 da AWS disponíveis para o SDK do Amazon Chime](sdk-available-regions.md) neste guia.

**Endpoints**  
O namespace de [voz SDK do Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Voice.html) usa endpoints de API diferentes do namespace [Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html).

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](migrate-from-chm-namespace.md#name-end-map) 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 [Amazon Chime SDK Voice](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Voice.html) contém apenas ações de voz APIs para criar e gerenciar. O namespace [Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) inclui APIs voz e outras partes do serviço Amazon Chime, como reuniões.

**Tags**  
Somente o namespace de [voz SDK do Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Voice.html) suporta tags. Para obter mais informações sobre tags, consulte [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_TagResource.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_TagResource.html) e [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_UntagResource.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_UntagResource.html).

**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 da AWS disponíveis para o SDK do Amazon Chime](sdk-available-regions.md).