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

Amazon Chime SDK Identity 名前空間への移行

Amazon Chime SDK Identity 名前空間は、 AppInstances や などの Amazon Chime SDK ID リソースの作成と管理に使用される APIs 専用の場所です AppInstanceUsers。名前空間を使用して、Amazon Chime SDK ID API エンドポイントが利用可能な任意の AWS リージョンのエンドポイントに対処します。Amazon Chime SDK を使い始めたばかりの場合は、この名前空間を使用してください。リージョンの詳細については、このガイドの「Amazon Chime SDKサービスで利用可能なAWSリージョン」を参照してください。

Amazon Chime 名前空間を使用する既存のアプリケーションでは、専用の名前空間への移行を計画する必要があります。

移行すべき理由

以下の理由から、Amazon Chime SDK Identity 名前空間に移行することをお勧めします。

移行する前に

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

名前空間の相違点

以下のセクションでは、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" });

リージョン

Amazon Chime 名前空間は、us-east-1 リージョンの API エンドポイントのみをアドレス指定します。Amazon Chime SDK Identity 名前空間は、利用可能な任意のリージョンで Amazon Chime SDK Identity API エンドポイントをアドレス指定できます。現在のエンドポイントリージョンのリストについては、本ガイドの「Amazon Chime SDKサービスで利用可能なAWSリージョン」を参照してください。

エンドポイント

Amazon Chime SDK Identity 名前空間は、Amazon Chime 名前空間とは異なる API エンドポイントを使用します。

ID リソースを更新できるのは、ID リソースの作成に使用したエンドポイントだけです。つまり、 のエンドポイントを介して AppInstance 作成された eu-central-1 は、 を介してのみ変更できますeu-central-1。また、 の ChimeSDKIdentity 名前空間を使用して Chime 名前空間を介して AppInstance 作成された をアドレス指定したりus-east-1、 AppInstance および AppInstanceUser メンバーが作成されたリージョン以外のリージョンにチャネルを作成したりすることもできません。現在のエンドポイントの詳細については、このガイドの「API マッピング」を参照してください。

サービスプリンシパル

Amazon Chime SDK Identity 名前空間は、新しいサービスプリンシパル Identity.chime.amazonaws.com を使用します。サービスへのアクセスを許可する SQS、SNS またはその他の IAM アクセスポリシーがある場合は、それらのポリシーを更新して新しいサービスプリンシパルへのアクセスを許可する必要があります。

API

Amazon Chime SDK Identity 名前空間には、メッセージングリソースの作成と管理、およびメッセージの送受信のための API のみが含まれています。Amazon Chime 名前空間には、メッセージング用および Amazon Chime サービスのその他の部分用の API が含まれています。

ユーザー有効期限

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

ボット

AppInstanceBot API を使用して、Amazon Lex V2 を搭載したチャットボットをアプリケーションに追加します。 V2 は、 AppInstanceBots アイデンティティ名前空間でのみ使用できます。ボットの詳細については、このガイドの「をインテリジェントチャネルエージェント AppInstanceBots として使用する」を参照してください。

その他の API

Identity 名前空間には、Chime 名前空間にはないその他の API が増え続けています。Amazon Chime SDK の使用を開始する場合は、Identity 名前空間を使用してすべての最新機能にアクセスできるようにしてください。現在の API の詳細については、「Amazon Chime SDK API Reference」の「Amazon Chime SDK Identity」を参照してください。