本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 遷移至 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 Media Capture 命名空間是唯一可在任何區域中使用 API 端點的 API 命名空間。如需區域的詳細資訊，請參閱[Amazon Chime SDK 的可用 AWS 區域](sdk-available-regions.md)。如果您想要使用 以外的 API 端點`us-east-1`，則必須使用 `ChimeSdkMediaPipelines` 命名空間。如需目前端點的詳細資訊，請參閱本指南[API 映射](migrate-from-chm-namespace.md#name-end-map)中的 。

**更新和新的媒體管道 APIs**  
我們只會在`ChimeSdkMediaPipelines`命名空間中新增或更新媒體管道 APIs。

## 遷移管道之前
<a name="migration-prerequisites"></a>

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


| 項目 | 媒體管道命名空間 | 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  |  僅限媒體管道APIs   |  Amazon Chime 媒體管道和其他部分的 APIs   | 
|  會議  |  `us-west-2`、 `ap-southeast-1`和 `eu-central-1`區域中的媒體管道僅適用於在 Amazon Chime SDK Meetings 命名空間中建立的會議。`us-east-1` 區域中的媒體管道可與任一命名空間中任何會議端點所建立的會議搭配使用。  |  媒體管道可與任一命名空間中任何會議端點建立的會議搭配使用。  | 
| 預設作用中媒體管道 | us-east-1 區域中為 100，us-west-2、ap-southeast-1 和 eu-central-1 區域中為 10。 | 僅限 us-east-1 中的 100。 | 
|  服務連結角色  |  AWSServiceRoleForAmazonChimeSDKMediaPipelines  |     | 
|  標籤  |  可用性  |  不適用於媒體管道 APIs。  | 
| CloudTrail 事件來源 | chime-sdk-media-pipelines.amazonaws.com | https：//chime.amazonaws.com。 | 
| 媒體即時連接器 | 可用性 |  不適用於媒體管道 APIs。  | 
| 合成 | 可用性 |  不適用於媒體管道 APIs。  | 
| 串連 | 可用性 | 不可用。 | 

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

**命名空間名稱**  
Amazon Chime SDK 命名空間使用`AWS.Chime`正式名稱。Amazon Chime SDK 媒體管道命名空間使用`AWS.ChimeSDKMediaPipelines`正式名稱。名稱的精確格式因平台而異。  
例如，Node.js 程式碼的這行會處理`chime`命名空間：  

```
const chimeMediaPipelines = AWS.Chime();
```
若要遷移至 Media Pipelines SDK 命名空間，請使用新的命名空間和端點區域更新該程式碼。  

```
const chimeMediaPipelines = AWS.ChimeSDKMediaPipelines({ region: "eu-central-1" });
```

**區域**  
Amazon Chime 命名空間僅處理 US-EAST-1 區域中的 API 端點。Amazon Chime SDK Media Pipelines 命名空間可處理任何區域中的 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 媒體管道命名空間僅包含建立和管理媒體管道APIs。Amazon Chime 命名空間包含媒體管道、會議和 Amazon Chime 服務其他部分的 APIs。

**會議**  
IAD 區域中的媒體管道可與任何具有任一命名空間的會議端點所建立的會議搭配使用。

**服務連結角色**  
僅適用於 Amazon Chime SDK Media Pipelines 命名空間。建立 *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) APIs 時，必須具有呼叫 `TagResource`操作的許可。