遷移到ChimeSdkMediaPipelines命名空間

您可以使用ChimeSdkMediaPipelines命名空間來解決任何可用AWS區域中的媒體管道 API 端點。如果您剛開始使用 Amazon Chime 開發套件，請使用此命名空間。如需有關「區域」的詳細資訊，請參閱本指南可用的區域中的。

使用 Amazon Chime 命名空間的現有應用程式應計劃遷移到專用命名空間。

遷移管道的原因

基於下列原因，我們建議您移轉至ChimeSdkMediaPipelines命名空間：

API 端點的選擇

Amazon Chime SDK 媒體擷取命名空間是唯一可以在任何可用 API 端點的區域中使用 API 端點的 API 命名空間。如需「區域」的詳細資訊，請參閱可用的區域。如果您想要使用以外的 API 端點us-east-1，則必須使用ChimeSdkMediaPipelines命名空間。如需有關目前端點的詳細資訊，請參閱本指南API 映射中的〈〉。

更新和新的媒體管道 API

我們只在ChimeSdkMediaPipelines命名空間中新增或更新媒體管線 API。

移轉管道之前

移轉之前，請注意命名空間之間的差異。下表列出並說明它們。

項目	媒體管道命名空	鐘聲命名空間
命名空間名	ChimeSdkMediaPipelines	鐘聲
區域	多個	僅限美國東部 1
端點	網址：//media-pipelines-chime。 地區. 亞馬遜	https://service.chime.aws.amazon.com
服務主體	媒體應用程序. 奇米. 亞馬遜	奇米亚马孙
API	僅適用於媒體管道的 API	適用於媒體管道和 Amazon Chime 其他部分的 API
会议	us-west-2、ap-southeast-1和eu-central-1區域中的媒體管道僅適用於 Amazon Chime SDK 會議命名空間中建立的會議。該us-east-1地區中的媒體管道與任何一個命名空間中任何會議端點建立的會議搭配使用。	媒體管道可使用任何命名空間中任何會議端點建立的會議。
預設作用中媒體管道	美國東部 -1 區域為 100，美國西部 -2、AP 東南 -1 和歐盟中部 -1 區域為 10。	僅在美國東部 -1 中為 100。
服務連結角色	AWSServiceRoleForAmazonChimeSDKMediaPipelines
Tags (標籤)	可用性	不適用於媒體管線 API。
CloudTrail事件來源	chime-sdk-media-pipelines. 亞馬遜	奇米. 亞馬遜網站.
媒體直播連接器	可用性	不適用於媒體管線 API。
合成	可用性	不適用於媒體管線 API。
串連	可用性	不可用。

下列清單提供有關 Chime 和AWSChimeSdkMediaPipelines命名空間之間差異的詳細資訊。

命名空間名

亞馬遜 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" });

區域

亞馬遜鐘聲命名空間僅處理 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 角色。

Tags (標籤)

Amazon Chime SDK 媒體管道命名空間支援標籤。使用一或多個標籤呼叫CreateMediaCapturePipeline或 CreateMediaLiveConnectorPipelineAPI 時，角色必須具有呼叫TagResource作業的權限。