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

# Criar uma AppInstance para o sistema de mensagens do SDK do Amazon Chime
<a name="create-app-instance"></a>

Para usar o sistema de mensagens do Amazon Chime SDK, você deve primeiro criar um SDK do Amazon Chime em sua conta. `AppInstance` AWS 

**Topics**
+ [Criar uma AppInstance](#app-instance-steps)
+ [Criando um AppInstanceUser](#create-app-instance-user)

## Criar uma AppInstance
<a name="app-instance-steps"></a>

**Para criar um `AppInstance` para usar mensagens**

1. Na CLI, execute `aws chime-sdk-identity create-app-instance --name NameOfAppInstance.`

1. Na resposta de criação, anote o `AppInstanceArn`. `arn:aws:chime:region: aws_account_id:app-instance/app_instance_id`.

## Criando um AppInstanceUser
<a name="create-app-instance-user"></a>

Depois de criar uma `AppInstance`, você cria um `AppInstanceUser` nessa `AppInstance`. Normalmente, você faz isso quando um usuário se registra ou faz login no seu aplicativo pela primeira vez. Você também pode criar um `AppInstanceUser` que atue em nome dos seus serviços de back-end.

O exemplo a seguir mostra como criar um `AppInstanceUser` de back-end:

```
aws chime-sdk-identity create-app-instance-user \
    --app-instance-arn "app_instance_arn" \
    --app-instance-user-id "back-end-worker" \
    --name "back-end-worker"
```

Em criar resposta, observe o `AppInstanceUserArn`. Leva este formulário: `arn:aws:chime:region: aws_account_id:app-instance/app_instance_id/user/app_instance_user_id`. Neste exemplo, `app_instance_user_id` é "back-end-worker.”

**nota**  
Como prática recomendada, ao criar um `AppInstanceUser` para um aplicativo cliente, faça com que o `AppInstanceUserId` corresponda a um ID exclusivo existente para esse usuário, como o `sub` de um provedor de identidade. O nome é um espaço reservado opcional que é anexado a algumas entidades da API, como um remetente de mensagem. Ele permite que você controle o nome de exibição de um usuário em um só lugar, em vez de precisar procurá-lo no ARN do `AppInstanceUser`, que também é anexado como remetente de uma mensagem.