本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 建立 AppInstance Amazon Chime SDK 訊息
<a name="create-app-instance"></a>

若要使用 Amazon Chime SDK 訊息，您必須先`AppInstance`在 AWS 帳戶中建立 Amazon Chime SDK。

**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`，您可以在該 `AppInstanceUser`中建立 `AppInstance`。您通常會在使用者第一次註冊或登入您的應用程式時執行此操作。您也可以建立 `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 也會附加為訊息的寄件者。