翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon Chime SDK メッセージングの AppInstance の作成
<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` を作成したら、その `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 から検索する必要がなく、ユーザーの表示名を 1 か所で制御できます。