ChimeSdkMediaPipelines
名前空間を使用すると、任意の AWS リージョンのメディアパイプライン API エンドポイントをアドレス指定できます (そのリージョンでそれらのエンドポイントを利用できる場合)。Amazon Chime SDK を使い始めたばかりの場合は、この名前空間を使用してください。リージョンの詳細については、このガイドの「Amazon Chime SDK で利用可能な AWS リージョン」を参照してください。
Amazon Chime 名前空間を使用する既存のアプリケーションでは、専用の名前空間への移行を計画する必要があります。
パイプラインを移行する理由
以下の理由から、ChimeSdkMediaPipelines
名前空間に移行することをお勧めします。
API エンドポイントの選択
Amazon Chime SDK メディアキャプチャ名前空間は、API エンドポイントを利用できる任意のリージョンの API エンドポイントを使用できる唯一の API 名前空間です。リージョンの詳細については、「Amazon Chime SDK で利用可能な AWS リージョン」を参照してください。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-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 エンドポイントをアドレス指定できます (そのリージョンにそれらのエンドポイントが存在する場合)。メディアパイプラインのリージョンの最新リストについては、本ガイドの「Amazon Chime SDK で利用可能な AWS リージョン」を参照してください。
- エンドポイント
-
メディアキャプチャパイプラインを変更するには、パイプラインを作成したのと同じエンドポイントを使用する必要があります。例えば、eu-central-1 のエンドポイント経由でパイプラインを作成した場合は、eu-central-1 を使用してそのパイプラインを操作する必要があります。現在のエンドポイントの詳細については、このガイドの「API マッピング」を参照してください。
- サービスプリンシパル
-
Amazon Chime SDK メディアパイプライン名前空間は、新しいサービスプリンシパル
mediapipelines.chime.amazonaws.com
を使用します。サービスへのアクセスを許可する Amazon S3 バケットポリシーまたはその他の IAM ポリシーがある場合は、それらのポリシーを更新して新しいサービスプリンシパルへのアクセスを許可する必要があります。例えば、メディアパイプラインを作成する場合、「Amazon Chime SDK メディアキャプチャパイプラインで 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
オペレーションを呼び出すアクセス許可が必要です。