ChimeSdkMediaPipelines 名前空間への移行

ChimeSdkMediaPipelines 名前空間を使用すると、任意の AWS リージョンのメディアパイプライン API エンドポイントをアドレス指定できます (そのリージョンでそれらのエンドポイントを利用できる場合)。Amazon Chime SDK を使い始めたばかりの場合は、この名前空間を使用してください。リージョンの詳細については、このガイドの「利用できるリージョン」を参照してください。

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

パイプラインを移行する理由

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

API エンドポイントの選択

Amazon Chime SDK メディアキャプチャ名前空間は、API エンドポイントを利用できる任意のリージョンの API エンドポイントを使用できる唯一の API 名前空間です。リージョンの詳細については、「利用できるリージョン」を参照してください。us-east-1 以外の API エンドポイントを使用する場合は、ChimeSdkMediaPipelines 名前空間を使用する必要があります。現在のエンドポイントの詳細については、このガイドの「API マッピング」を参照してください。

更新および新規追加されたメディアパイプライン API

ChimeSdkMediaPipelines 名前空間のメディアパイプライン API のみを追加または更新します。

パイプラインを移行する前に

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

項目	メディアパイプライン名前空間	Chime 名前空間
名前空間名	ChimeSdkMediaPipelines	Chime
リージョン	複数	us-east-1 のみ
エンドポイント	https://media-pipelines-chime.region.amazonaws.com	https://service.chime.aws.amazon.com
サービスプリンシパル	mediapipelines.chime.amazonaws.com	chime.amazonaws.com
API	メディアパイプラインの API のみ	メディアパイプラインの API と Amazon Chime のその他の部分
会議	us-west-2、ap-southeast-1、eu-central-1 リージョンのメディアパイプラインは、Amazon Chime SDK 会議の名前空間で作成された会議でのみ機能します。us-east-1 リージョンのメディアパイプラインは、どちらの名前空間のどの会議エンドポイントによって作成された会議でも動作します。	メディアパイプラインは、どちらの名前空間のどの会議エンドポイントによって作成された会議でも動作します。
デフォルトのアクティブメディアパイプライン	us-east-1 リージョンでは 100、us-west-2、ap-southeast-1、および eu-central-1 の各リージョンでは 10。	us-east-1 の 100 のみ。
サービスリンクロール	AWSServiceRoleForAmazonChimeSDKMediaPipelines
タグ	使用可能	メディアパイプライン API では使用できません。
CloudTrail イベントソース	chime-sdk-media-pipelines.amazonaws.com	chime.amazonaws.com
メディアライブコネクタ	使用可能	メディアパイプライン API では使用できません。
コンポジット	使用可能	メディアパイプライン API では使用できません。
連結	使用可能	利用不可。

以下のリストは、Chime 名前空間と AWSChimeSdkMediaPipelines 名前空間の違いの詳細を示しています。

名前空間名

Amazon Chime SDK 名前空間では AWS.Chime という正式名を使用します。Amazon Chime SDK メディアパイプライン名前空間では、AWS.ChimeSDKMediaPipelines という正式な名前を使用します。名前の正確な形式はプラットフォームによって異なります。

例えば、Node.js コードの次の行は chime 名前空間をアドレス指定します。

const chimeMediaPipelines = AWS.Chime();

メディアパイプライン SDK 名前空間に移行するには、そのコードを新しい名前空間とエンドポイントリージョンで更新します。

const chimeMediaPipelines = AWS.ChimeSDKMediaPipelines({ region: "eu-central-1" });

リージョン

Amazon Chime 名前空間は、US-EAST-1 リージョンの API エンドポイントのみをアドレス指定します。Amazon Chime SDK メディアパイプライン名前空間は、任意のリージョンの Amazon Chime SDK メディアパイプライン API エンドポイントをアドレス指定できます (そのリージョンにそれらのエンドポイントが存在する場合)。メディアパイプラインのリージョンの最新リストについては、本ガイドの「利用できるリージョン」を参照してください。

エンドポイント

メディアキャプチャパイプラインを変更するには、パイプラインを作成したのと同じエンドポイントを使用する必要があります。例えば、eu-central-1 のエンドポイント経由でパイプラインを作成した場合は、eu-central-1 を使用してそのパイプラインを操作する必要があります。現在のエンドポイントの詳細については、このガイドの「API マッピング」を参照してください。

サービスプリンシパル

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

例えば、メディアパイプラインを作成する場合、「Amazon S3 バケットの作成」に記載されているポリシー権限を新しいサービスプリンシパルに追加する必要があります。ポリシーの詳細については、「IAM ユーザーガイド」の「AWS JSON ポリシーの要素: プリンシパル」を参照してください。

API

Amazon Chime SDK メディアパイプライン名前空間には、メディアパイプラインを作成および管理する API のみが含まれています。Amazon Chime 名前空間には、メディアパイプライン、会議、および Amazon Chime サービスのその他の部分用の API が含まれています。

会議

IAD リージョンのメディアパイプラインは、どちらの名前空間のどの会議エンドポイントによって作成された会議でも動作します。

サービスリンクロール

Amazon Chime SDK メディアパイプライン名前空間専用。AWSServiceRoleForAmazonChimeSDKMediaPipelines ロールを作成します。

タグ

Amazon Chime SDK メディアパイプライン名前空間は、タグをサポートします。1 つ以上のタグを含む CreateMediaCapturePipeline API または CreateMediaLiveConnectorPipeline API を呼び出す場合、ロールには TagResource オペレーションを呼び出すアクセス許可が必要です。