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

# Amazon Chime SDK Identity 名前空間への移行
<a name="identity-namespace-migration"></a>

[Amazon Chime SDK Identity](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Identity.html) 名前空間は、AppInstances や AppInstanceUsers などの Amazon Chime SDK ID リソースの作成と管理に使用される API 専用の場所です。名前空間を使用して、Amazon Chime SDK ID API エンドポイントが利用可能な任意の AWS リージョンのエンドポイントに対処します。Amazon Chime SDK を使い始めたばかりの場合は、この名前空間を使用してください。リージョンの詳細については、このガイドの「[Amazon Chime SDK で利用可能な AWS リージョン](sdk-available-regions.md)」を参照してください。

[Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) 名前空間を使用する既存のアプリケーションでは、専用の名前空間への移行を計画する必要があります。

**Topics**
+ [移行すべき理由](#identity-migration-reasons)
+ [移行する前に](#id-before-migrating)
+ [名前空間の相違点](#id-namespace-differences)

## 移行すべき理由
<a name="identity-migration-reasons"></a>

以下の理由から、[Amazon Chime SDK Identity](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Identity.html) 名前空間に移行することをお勧めします。

**API エンドポイントの選択**  
Amazon Chime SDK Identity 名前空間は、[API エンドポイントを利用できる任意のリージョン](https://docs.aws.amazon.com/chime-sdk/latest/dg/sdk-available-regions.html)の API エンドポイントを使用できる唯一の API 名前空間です。`us-east-1` 以外の API エンドポイントを使用する場合は、Amazon Chime SDK Identity 名前空間を使用する必要があります。現在のエンドポイントの詳細については、このガイドの「[API マッピング](migrate-from-chm-namespace.md#name-end-map)」を参照してください。

**メッセージング API の更新と新規追加**  
Amazon Chime SDK Identity 名前空間の ID API のみ追加または更新されます。

## 移行する前に
<a name="id-before-migrating"></a>

移行する前に、名前空間の相違点に注意してください｡ 以下の表では、名前空間の一覧と説明を示しています。


|  | Amazon Chime SDK Identity 名前空間 | Amazon Chime 名前空間 | 
| --- | --- | --- | 
| AWS SDK 名前空間 | ChimeSDKIdentity | Chime | 
| リージョン | 複数 | us-east-1 のみ | 
| サービスプリンシパル | https://identity.chime.amazonaws.com | https://chime.amazonaws.com | 
| API | ID 用の API のみ | ID 用の API と Amazon Chime のその他の部分 | 
| ユーザー有効期限 | 利用可能 | 利用不可 | 
| ボット | 利用可能 | 利用不可 | 

## 名前空間の相違点
<a name="id-namespace-differences"></a>

以下のセクションでは、`Chime` 名前空間と `ChimeSDKIdentity` 名前空間の相違点について説明します。

**AWS SDK 名前空間**  
Amazon Chime SDK 名前空間では `Chime` という正式名を使用します。Amazon Chime SDK Identity 名前空間では `ChimeSDKIdentity` という正式名を使用します。名前の正確な形式はプラットフォームによって異なります。

例えば、Node.js で AWS SDK を使用して ID を作成する場合は、コード行を使用して名前空間に対処します。

```
const chimeIdentity = AWS.Chime();
```

`ChimeSDKIdentity` 名前空間に移行するには、このコード行を新しい名前空間とエンドポイントリージョンで更新します。

```
const chimeIdentity = AWS.ChimeSDKIdentity({ region: "eu-central-1" });
```

**Regions**  
[Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) 名前空間は、`us-east-1` リージョンの API エンドポイントのみをアドレス指定します。[Amazon Chime SDK Identity](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Identity.html) 名前空間は、利用可能な任意のリージョンで Amazon Chime SDK Identity API エンドポイントをアドレス指定できます。現在のエンドポイントリージョンのリストについては、本ガイドの「[Amazon Chime SDK で利用可能な AWS リージョン](sdk-available-regions.md)」を参照してください。

**エンドポイント**  
[Amazon Chime SDK Identity](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Identity.html) 名前空間は、[Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) 名前空間とは異なる API エンドポイントを使用します。

ID リソースを更新できるのは、ID リソースの作成に使用したエンドポイントだけです。つまり、`eu-central-1` のエンドポイントを介して作成された AppInstance は、`eu-central-1` 経由でしか変更できないということです。また、Chime 名前空間を介して作成された AppInstance を `us-east-1` の ChimeSDKIdentity 名前空間を使用してアドレス指定したり、AppInstance メンバーと AppInstanceUser メンバーが作成されたリージョン以外のリージョンにチャネルを作成したりすることもできません。現在のエンドポイントの詳細については、このガイドの「[API マッピング](migrate-from-chm-namespace.md#name-end-map)」を参照してください。

**サービスプリンシパル**  
[Amazon Chime SDK Identity](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Messaging.html) 名前空間は、新しいサービスプリンシパル `Identity.chime.amazonaws.com` を使用します。サービスへのアクセスを許可する SQS、SNS またはその他の IAM アクセスポリシーがある場合は、それらのポリシーを更新して新しいサービスプリンシパルへのアクセスを許可する必要があります。

**API**  
[Amazon Chime SDK Identity](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Identity.html) 名前空間には、メッセージングリソースの作成と管理、およびメッセージの送受信のための API のみが含まれています。[Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) 名前空間には、メッセージング用および Amazon Chime サービスのその他の部分用の API が含まれています。

**ユーザー有効期限**  
AppInstanceUsers の作成時に有効期限を設定すると、一時的なユーザーを作成できます。例えば、大規模なブロードキャストの間だけ存在するチャットユーザーを作成できます。AppInstanceUsers の有効期限の設定をサポートしているのは Identity 名前空間のみです。

**ボット**  
[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_identity-chime_AppInstanceBot.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_identity-chime_AppInstanceBot.html) API を使用して、Amazon Lex V2 を搭載したチャットボットをアプリケーションに追加します。AppInstanceBots は Identity 名前空間でのみ使用できます。ボットの詳細については、このガイドの「[AppInstanceBots を Amazon Chime SDK メッセージングのインテリジェントチャネルエージェントとして使用する](appinstance-bots.md)」を参照してください。

**その他の API**  
Identity 名前空間には、Chime 名前空間にはないその他の API が増え続けています。Amazon Chime SDK の使用を開始する場合は、Identity 名前空間を使用してすべての最新機能にアクセスできるようにしてください。現在の API の詳細については、「*Amazon Chime SDK API Reference*」の「[Amazon Chime SDK Identity](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Identity.html)」を参照してください。