本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 迁移到 Amazon Chime SDK 媒体管道命名空间
<a name="migrate-pipelines"></a>

您可以使用`ChimeSdkMediaPipelines`命名空间来寻址媒体管道 API 端点 AWS 所在的任何区域。如果您刚开始使用 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 命名空间。有关“区域”的更多信息，请参阅 [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 | 
| Regions | 多个 | 仅限 us-east-1 | 
| 端点 | https://media-pipelines-chime.*区域 .amaz* onaws.com | https://service.chime.aws.amazon.com | 
| 服务主体 | mediapipelines.chime.amazonaws.com | chime.amazonaws.com | 
| API | 仅适用于媒体管道的 API | 用于媒体管道和 Amazon Chime 其他部分的 API | 
| 会议 | `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。 | 
| Service-linked 角色 | 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" });
```

**Regions**  
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 区域中的媒体管道适用于由任一命名空间中的任何会议终端节点创建的会议。

**Service-linked 角色**  
仅适用于 Amazon Chime SDK 媒体管道命名空间。创建 *AWSServiceRoleForAmazonChimeSDKMediaPipelines*角色。

**标签**  
[Amazon Chime SDK 媒体管道](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html)命名空间支持标签。使用一个或多个标签调用[CreateMediaCapturePipeline](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaCapturePipeline.html)或 [CreateMediaLiveConnectorPipeline](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaLiveConnectorPipeline.html)API 时，该角色必须具有调用`TagResource`操作的权限。