

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 identidade do SDK do Amazon Chime
<a name="identity-namespace-migration"></a>

O namespace [Amazon Chime SDK Identity](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Identity.html) é um local dedicado para o usuário criar e gerenciar recursos APIs de identidade do Amazon Chime SDK, incluindo e. AppInstances AppInstanceUsers Você usa o namespace para endereçar os endpoints da API de identidade do Amazon Chime SDK em AWS qualquer região na qual eles estejam disponíveis. 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.

**Topics**
+ [Motivos para migrar](#identity-migration-reasons)
+ [Antes de migrar](#id-before-migrating)
+ [Diferenças entre os namespaces](#id-namespace-differences)

## Motivos para migrar
<a name="identity-migration-reasons"></a>

Recomendamos que você migre para o namespace da [identidade do SDK do Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Identity.html) pelos seguintes motivos:

**Escolha do endpoint de API**  
O namespace da identidade do SDK do Amazon Chime é o único namespace de API que pode usar endpoints de API em qualquer [região que os disponibilize](https://docs.aws.amazon.com/chime-sdk/latest/dg/sdk-available-regions.html). Se quiser usar outros endpoints de API diferentes da `us-east-1`, você deve usar o namespace da identidade do 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.

**Mensagens atualizadas e novas APIs**  
Somente adicionamos ou atualizamos a identidade APIs no namespace Amazon Chime SDK Identity.

## Antes de migrar
<a name="id-before-migrating"></a>

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


|  | Namespace da identidade do SDK do Amazon Chime | Namespace Amazon Chime | 
| --- | --- | --- | 
| AWS Namespace do SDK | ChimeSDKIdentity | Chime | 
| Regiões | Vários | Somente us-east-1 | 
| Entidade principal do serviço | https://identity.chime.amazonaws.com | https://chime.amazonaws.com | 
| APIs | Somente APIs para identidade | APIs para identidade e outras partes do Amazon Chime | 
| Expiração de usuário | Disponível | Indisponível | 
| Bots | Disponível | Indisponível | 

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

As seções a seguir explicam as diferenças entre os namespaces `Chime` e `ChimeSDKIdentity`.

**AWS Namespace do SDK**  
O namespace SDK do Amazon Chime usa o nome formal `Chime`. O namespace da identidade do SDK do Amazon Chime usa o nome formal `ChimeSDKIdentity`. O formato preciso do nome varia de acordo com a plataforma.

Por exemplo, se você usa o AWS SDK no Node.js para criar identidades, você usa uma linha de código para endereçar o namespace.

```
const chimeIdentity = AWS.Chime();
```

Para migrar para o namespace `ChimeSDKIdentity`, atualize essa linha de código com o novo namespace e a região do endpoint.

```
const chimeIdentity = AWS.ChimeSDKIdentity({ 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 da [identidade do SDK do Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Identity.html) pode referenciar endpoints da API de identidade do SDK do Amazon Chime em qualquer região em que estejam disponíveis. Para obter uma lista atual das regiões de endpoints, consulte [Regiões da AWS disponíveis para o SDK do Amazon Chime](sdk-available-regions.md) neste guia.

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

Somente o endpoint usado para criar recursos de identidade pode ser usado para atualizá-los. Isso significa que um AppInstance criado por meio de um endpoint em só `eu-central-1` pode ser modificado via`eu-central-1`. Isso também significa que você não pode endereçar um AppInstance criado por meio do namespace Chime com o SDKIdentity namespace Chime em`us-east-1`, nem criar um canal em uma região diferente da região em que os membros e foram criados. AppInstance AppInstanceUser 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**  
O namespace da [identidade do SDK do Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Messaging.html) usa uma nova entidade principal de serviço: `Identity.chime.amazonaws.com`. Se você tiver SQS, SNS ou outras políticas de acesso do IAM que concedem acesso ao serviço, precisará atualizá-las para conceder acesso à nova entidade principal de serviço.

**APIs**  
O namespace [Amazon Chime SDK Identity](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Identity.html) contém apenas APIs para criar e gerenciar recursos de mensagens e para enviar e receber mensagens. O namespace [Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) inclui APIs outras partes do serviço Amazon Chime, bem como mensagens.

**Expiração de usuário**  
As configurações de expiração na criação do AppInstanceUsers permitem que você crie usuários temporários. Por exemplo, você pode criar usuários de chat que só existem durante uma grande transmissão. Somente o namespace Identity oferece suporte às configurações de expiração para. AppInstanceUsers

**Bots**  
Você usa o [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_identity-chime_AppInstanceBot.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_identity-chime_AppInstanceBot.html)API para adicionar bots de bate-papo desenvolvidos pelo Amazon Lex V2 em seus aplicativos. Você só pode usar AppInstanceBots no namespace Identity. Para obter mais informações sobre bots, consulte [Usando AppInstanceBots como agentes de canal inteligentes para mensagens do Amazon Chime SDK](appinstance-bots.md) neste guia.

**Adicional APIs**  
O namespace Identity tem uma lista crescente de itens adicionais APIs que o namespace Chime não tem. Se você está começando a usar o SDK do Amazon Chime, use o namespace de Identidade para ter acesso a todos os atributos mais recentes. Para obter mais informações sobre o atual APIs, consulte [Identidade do SDK do Amazon Chime na Referência da API do SDK](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Identity.html) do *Amazon Chime*.