迁移到 ChimeSdkMediaPipelines 命名空间 - Amazon Chime SDK

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

迁移到 ChimeSdkMediaPipelines 命名空间

您可以使用 ChimeSdkMediaPipelines 命名空间对任何可用的 AWS 区域中的媒体管道 API 终端节点进行寻址。如果您刚开始使用 Amazon Chime SDK,则使用此命名空间。有关“区域”的更多信息,请参阅本指南中的 Amazon Ch SDK ime 服务的可用AWS区域

使用 Amazon Chime 命名空间的现有应用程序应计划迁移到专用命名空间。

迁移管道的原因

出于以下原因,我们鼓励您迁移到 ChimeSdkMediaPipelines 命名空间:

选择 API 终端节点

Amazon Chime SDK 媒体捕获命名空间是唯一可以在任何可用区域中使用 API 终端节点的 API 命名空间。有关“区域”的更多信息,请参阅 Amazon Ch SDK ime 服务的可用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

用于媒体管道和 Amazon Chime 其他部分的 API

会议

us-west-2ap-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 Ch SDK ime 服务的可用AWS区域

终端节点

要修改媒体捕获管道,必须使用与创建该管道相同的终端节点。例如,如果您通过 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 媒体管道命名空间支持标签。使用一个或多个标签调用 CreateMediaCapturePipelineCreateMediaLiveConnectorPipeline API 时,角色必须拥有调用 TagResource 操作的权限。