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

# Amazon Chime SDK メディアパイプライン名前空間への移行
<a name="migrate-pipelines"></a>

`ChimeSdkMediaPipelines` 名前空間を使用して、利用可能な任意の AWS リージョンのメディアパイプライン API エンドポイントに対処します。Amazon Chime SDK を使い始めたばかりの場合は、この名前空間を使用してください。リージョンの詳細については、このガイドの「[Amazon Chime SDK で利用可能な AWS リージョン](sdk-available-regions.md)」を参照してください。

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

**Topics**
+ [パイプラインを移行する理由](#pipeline-migration-reasons)
+ [パイプラインを移行する前に](#migration-prerequisites)

## パイプラインを移行する理由
<a name="pipeline-migration-reasons"></a>

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

**API エンドポイントの選択**  
Amazon Chime SDK メディアキャプチャ名前空間は、API エンドポイントを利用できる任意のリージョンの API エンドポイントを使用できる唯一の API 名前空間です。リージョンの詳細については、「[Amazon Chime SDK で利用可能な AWS リージョン](sdk-available-regions.md)」を参照してください。`us-east-1` 以外の API エンドポイントを使用する場合は、`ChimeSdkMediaPipelines` 名前空間を使用する必要があります。現在のエンドポイントの詳細については、このガイドの「[API マッピング](migrate-from-chm-namespace.md#name-end-map)」を参照してください。

**更新および新規追加されたメディアパイプライン API**  
`ChimeSdkMediaPipelines` 名前空間のメディアパイプライン API のみを追加または更新します。

## パイプラインを移行する前に
<a name="migration-prerequisites"></a>

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


| Item | メディアパイプライン名前空間 | 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 名前空間と AWS ChimeSdkMediaPipelines 名前空間の違いの詳細を示しています。

**名前空間名**  
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 リージョン](sdk-available-regions.md)」を参照してください。

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

**サービスプリンシパル**  
[Amazon Chime SDK メディアパイプライン](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html)名前空間は、新しいサービスプリンシパル `mediapipelines.chime.amazonaws.com` を使用します。サービスへのアクセスを許可する Amazon S3 バケットポリシーまたはその他の IAM ポリシーがある場合は、それらのポリシーを更新して新しいサービスプリンシパルへのアクセスを許可する必要があります。  
例えば、メディアパイプラインを作成する場合、「[Amazon Chime SDK メディアキャプチャパイプラインで Amazon S3 バケットを作成する](create-s3-bucket.md)」に記載されているポリシー権限を新しいサービスプリンシパルに追加する必要があります。ポリシーの詳細については、「IAM ユーザーガイド」の「[AWS JSON ポリシーの要素: プリンシパル](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html)」を参照してください。

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

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

**サービスにリンクされたロール**  
Amazon Chime SDK メディアパイプライン名前空間専用。*AWSServiceRoleForAmazonChimeSDKMediaPipelines* ロールを作成します。

**タグ**  
[Amazon Chime SDK メディアパイプライン](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html)名前空間は、タグをサポートします。1 つ以上のタグを含む [CreateMediaCapturePipeline](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaCapturePipeline.html) API または [CreateMediaLiveConnectorPipeline](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaLiveConnectorPipeline.html) API を呼び出す場合、ロールには `TagResource` オペレーションを呼び出すアクセス許可が必要です。