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

# 遷移至 Amazon Chime SDK 語音命名空間
<a name="voice-namespace-migration"></a>

[Amazon Chime SDK Voice](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Voice.html) 命名空間是 API 的專用空間 APIs ，可建立和管理 Amazon Chime SDK 語音資源。您可以使用 命名空間來處理任何 AWS 區域中的 Amazon Chime SDK 語音 API 端點，這些端點可供他們使用。如果您剛開始使用 Amazon Chime SDK，請使用此命名空間。如需區域的詳細資訊，請參閱本指南[Amazon Chime SDK 的可用 AWS 區域](sdk-available-regions.md)中的 。

使用 [Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) 命名空間的現有應用程式應計劃遷移到專用命名空間，以便使用更新的 APIs和新功能。

**Topics**
+ [遷移的原因](#first-concept-chapter)
+ [遷移之前](#voice-before-migrate)
+ [命名空間之間的差異](#voice-namespace-diffs)

## 遷移的原因
<a name="first-concept-chapter"></a>

基於下列原因，我們建議您遷移至 [Amazon Chime SDK Voice](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Voice.html) 命名空間：

**API 端點的選擇**  
Amazon Chime SDK Voice 命名空間可讓您在任何[區域中使用 API 端點，使其可供使用](https://docs.aws.amazon.com/chime-sdk/latest/dg/sdk-available-regions.html)。如果您想要使用 以外的 API 端點`us-east-1`，則必須使用 Amazon Chime SDK Voice 命名空間。如需目前端點的詳細資訊，請參閱本指南[API 映射](migrate-from-chm-namespace.md#name-end-map)中的 。

**已更新和新的語音 APIs**  
我們只在 Amazon Chime SDK Voice APIs。

## 遷移之前
<a name="voice-before-migrate"></a>

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


|  | Amazon Chime SDK 語音命名空間 | Amazon Chime 命名空間 | 
| --- | --- | --- | 
| **AWS 命名空間** | `ChimeSDKVoice` | `Chime` | 
| **區域** | 多個 | 僅限 `us-east-1` | 
| **端點** | `https://voice-chime.region.amazonaws.com` | `service.chime.aws.amazon.com` | 
| **服務主體** | `chime.amazonaws.com` | `chime.amazonaws.com` | 
| **API** | 只有 PSTN 音訊服務的 APIs  | PSTN 音訊和 Amazon Chime 其他部分的 APIs  | 
| Voice Connector 管理 | 多個區域 | us-east-1 | 
| Voice Connector 群組管理 | 多個區域 | us-east-1 | 
| SIP 媒體應用程式和 SIP 規則管理 | 多個區域 | us-east-1 | 
| 電話號碼管理 | 多個區域 | us-east-1 | 
| 呼叫分析 | 可用性 | 無 | 
| 語音設定檔網域 | 可用性 | 無 | 
| 緊急呼叫管理 | 多個區域 | us-east-1 | 
| Proxy 電話工作階段管理 | 多個區域 | us-east-1 | 
| 串流管理 | 多個區域 | us-east-1 | 
| 記錄和指標管理 | 多個區域 | us-east-1 | 

如需可用區域的詳細資訊，請參閱[語音區域](sdk-available-regions.md#voice-regions)。

## 命名空間之間的差異
<a name="voice-namespace-diffs"></a>

下列各節說明 `Amazon Chime SDK Voice`和 `Amazon Chime`命名空間之間的差異。

**AWS 命名空間**  
Amazon Chime SDK 命名空間使用`Chime`正式名稱。Amazon Chime SDK Voice 命名空間使用`ChimeSDKVoice`正式名稱。名稱的精確格式因平台而異。

例如，如果您使用 Node.js 中的 AWS SDK 來建立會議，您可以使用下列程式碼行來解決命名空間。

```
const chimeVoice = AWS.Chime();
```

若要遷移至 Amazon Chime SDK Voice 命名空間，請使用新的命名空間和端點區域更新這行程式碼。

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

**區域**  
[Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) 命名空間只能處理`us-east-1`區域中的 API 端點。[Amazon Chime SDK Voice](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) 命名空間可以解決任何可用區域中的 Amazon Chime SDK 語音 API 端點。如需語音區域的最新清單，請參閱本指南[Amazon Chime SDK 的可用 AWS 區域](sdk-available-regions.md)中的 。

**端點**  
[Amazon Chime SDK Voice](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Voice.html) 命名空間使用與 [Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) 命名空間不同的 API 端點。

只有用來建立語音動作的端點才能用來修改它。這表示透過 中的端點建立的語音動作`eu-central-1`只能透過 修改`eu-central-1`。這也表示您無法處理透過 `Chime` 命名空間建立的語音動作，其`ChimeSDKVoice`命名空間位於 中`us-east-1`。如需目前端點的詳細資訊，請參閱本指南[API 映射](migrate-from-chm-namespace.md#name-end-map)中的 。

**服務主體**  
這兩個命名空間都使用 `chime.amazonaws.com`服務主體。如果您有授予服務存取權的存取政策，則不需要更新這些政策。

**API**  
[Amazon Chime SDK Voice](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Voice.html) 命名空間僅包含 APIs以建立和管理語音動作。[Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) 命名空間包含語音 APIs 和 Amazon Chime 服務的其他部分，例如會議。

**標記**  
只有 [Amazon Chime SDK Voice](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Voice.html) 命名空間支援標籤。如需標籤的詳細資訊，請參閱 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_TagResource.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_TagResource.html)和 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_UntagResource.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_UntagResource.html)。

**媒體區域**  
如果您使用 `Chime` 命名空間來建立語音連接器和 SIP 媒體應用程式等資源，您只能在 `us-east-1`和 中執行此操作`us-west-2`，而且您必須使用`us-east-1`端點。

相反地，`ChimeSDKVoice`命名空間允許在所有支援的區域中建立資源，而不只是 `us-east-1`和 `us-west-2`。如需區域涵蓋範圍的詳細資訊，請參閱[Amazon Chime SDK 的可用 AWS 區域](sdk-available-regions.md)。