本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 创建用于 Amazon Chime SDK 消息传递的 AppInstance
<a name="create-app-instance"></a>

要使用 Amazon Chime 软件开发工具包消息，您必须先在账户中创建亚马逊 Chime `AppInstance` 软件开发工具包。 AWS 

**Topics**
+ [创建 AppInstance](#app-instance-steps)
+ [创建一个 AppInstanceUser](#create-app-instance-user)

## 创建 AppInstance
<a name="app-instance-steps"></a>

**为消息传递创建 `AppInstance`**

1. 在 CLI 中，运行 `aws chime-sdk-identity create-app-instance --name NameOfAppInstance.`

1. 在“创建响应”中，记下 `AppInstanceArn` 和 `arn:aws:chime:region: aws_account_id:app-instance/app_instance_id`。

## 创建一个 AppInstanceUser
<a name="create-app-instance-user"></a>

一旦您创建了一个 `AppInstance`，您就可以在该 `AppInstance` 中创建一个 `AppInstanceUser`。通常是在用户首次注册或登录应用程序时执行此操作。您也可以创建代表后端服务运行的 `AppInstanceUser`。

以下示例介绍了如何创建一个后端 `AppInstanceUser`。

```
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"
```

在“创建响应”时，记下 `AppInstanceUserArn`。其形式为：`arn:aws:chime:region: aws_account_id:app-instance/app_instance_id/user/app_instance_user_id`。在本例中，`app_instance_user_id`是 “back-end-worker。”

**注意**  
作为最佳实践，在为客户端应用程序创建 `AppInstanceUser` 时，请将 `AppInstanceUserId` 匹配该用户的现有唯一 ID（例如身份提供商的 `sub`）。该名称是附加到某些 API 实体（例如消息发送者）的可选占位符。它允许您在一个地方控制用户的显示名称，而不必从 `AppInstanceUser` ARN 中查找，ARN 也作为消息的发件人附上。