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 Identity do Amazon Chime
O namespace Amazon Chime SDK Identity é um local dedicado às APIs usadas para criar e gerenciar recursos 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 disponíveis neste guia.
Os aplicativos existentes que usam o namespace Amazon Chime devem planejar a migração para o namespace dedicado.
Motivos para migrar
Recomendamos que você migre para o namespace da identidade do SDK do Amazon Chime 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. 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 neste guia.- APIs de mensagens novas e atualizadas
Só adicionamos ou atualizamos APIs de identidade no namespace da identidade do 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 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 | Available (Disponível) | Indisponível |
Bots | Available (Disponível) | Indisponível |
Diferenças entre os namespaces
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 só pode referenciar endpoints de API na região us-east-1
. O namespace da identidade do SDK do Amazon Chime 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 disponíveis neste guia.
Endpoints
O namespace da identidade do SDK do Amazon Chime usa endpoints de API diferentes do namespace do Amazon Chime.
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 viaeu-central-1
. Isso também significa que você não pode endereçar um AppInstance criado por meio do namespace Chime com o namespace ChimeSdkIdentity ou criar um canal em us-east-1
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 neste guia.
Entidade principal do serviço
O namespace da identidade do SDK do Amazon Chime 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 da identidade do SDK do Amazon Chime contém somente APIs para criar e gerenciar recursos de mensagens e para enviar e receber mensagens. O namespace Amazon Chime inclui APIs para outras partes do serviço Amazon Chime, além de 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 suporta configurações de expiração para. AppInstanceUsers
Bots
Você usa a AppInstanceBotAPI para adicionar bots de bate-papo desenvolvidos pelo Amazon Lex V2 aos 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 neste guia.
APIs adicionais
O namespace de Identidade tem uma lista crescente de APIs adicionais que o namespace do 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 as APIs atuais, consulte Identidade do SDK do Amazon Chime na Referência da API do SDK do Amazon Chime.