기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon Chime SDK 음성 네임스페이스로 마이그레이션
[Amazon Chime SDK 음성](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Voice.html) 네임스페이스는 Amazon Chime SDK 음성 리소스를 생성하고 관리하는 API의 전용 공간입니다. 네임스페이스를 사용하여 사용 가능한 모든 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) 네임스페이스를 사용하는 기존 애플리케이션은 업데이트된 API 및 새 기능을 사용하기 위해 전용 네임스페이스로의 마이그레이션을 계획해야 합니다.
**Topics**
+ [마이그레이션하는 이유](#first-concept-chapter)
+ [마이그레이션하기 전](#voice-before-migrate)
+ [네임스페이스 간 차이점](#voice-namespace-diffs)
## 마이그레이션하는 이유
다음과 같은 이유로 [Amazon Chime SDK 음성](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Voice.html) 네임스페이스로 마이그레이션하는 것이 좋습니다.
**API 엔드포인트 선택**
Amazon Chime SDK 음성 네임스페이스를 사용하면 API 엔드포인트를 [사용 가능한 리전](https://docs.aws.amazon.com/chime-sdk/latest/dg/sdk-available-regions.html)에서 이를 다룹니다. `us-east-1` 이외의 API 엔드포인트를 사용하려는 경우 Amazon Chime SDK 음성 네임스페이스를 사용해야 합니다. 현재 엔드포인트에 대한 자세한 내용은 이 설명서의 [API 매핑](migrate-from-chm-namespace.md#name-end-map) 섹션을 참조하세요.
**업데이트된 음성 API 및 새 음성 API**
Amazon Chime SDK 음성 네임스페이스에서만 음성 API를 추가하거나 업데이트합니다.
## 마이그레이션하기 전
마이그레이션하기 전에 네임스페이스 간 차이점에 유의해야 합니다. 다음 표는 네임스페이스를 나열하고 설명합니다.
| | 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 오디오 서비스용 API만 해당 | PSTN 오디오 및 Amazon Chime의 기타 부분을 위한 API |
| Voice Connector 관리 | 다중 리전 | us-east-1 |
| Voice Connector 그룹 관리 | 다중 리전 | us-east-1 |
| SIP 미디어 애플리케이션 및 SIP 규칙 관리 | 다중 리전 | us-east-1 |
| 전화번호 관리 | 다중 리전 | us-east-1 |
| 통화 분석 | Available | 사용할 수 없음 |
| 음성 프로필 도메인 | Available | 사용할 수 없음 |
| 긴급 통화 관리 | 다중 리전 | us-east-1 |
| 프록시 전화 세션 관리 | 다중 리전 | us-east-1 |
| 스트리밍 관리 | 다중 리전 | us-east-1 |
| 로깅 및 지표 관리 | 다중 리전 | us-east-1 |
사용 가능한 리전에 대한 자세한 내용은 [음성 리전](sdk-available-regions.md#voice-regions) 단원을 참조하세요.
## 네임스페이스 간 차이점
다음 섹션에서는 `Amazon Chime SDK Voice` 및 `Amazon Chime` 네임스페이스 간의 차이점을 설명합니다.
**AWS 네임스페이스**
Amazon Chime SDK 네임스페이스는 `Chime` 공식 이름을 사용합니다. Amazon Chime SDK 음성 네임스페이스는 `ChimeSDKVoice` 공식 이름을 사용합니다. 이름의 정확한 형식은 플랫폼마다 다릅니다.
예를 들어 Node.js의 AWS SDK를 사용하여 회의를 생성하는 경우 다음 코드 줄을 사용하여 네임스페이스를 처리합니다.
```
const chimeVoice = AWS.Chime();
```
Amazon Chime SDK 음성 네임스페이스로 마이그레이션하려면 새 네임스페이스와 엔드포인트 리전으로 아래 코드를 업데이트합니다.
```
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 음성](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 음성](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` 네임스페이스를 통해 생성된 음성 작업을 `us-east-1`의 `ChimeSDKVoice` 네임스페이스로 다룰 수 없습니다. 현재 엔드포인트에 대한 자세한 내용은 이 설명서의 [API 매핑](migrate-from-chm-namespace.md#name-end-map) 섹션을 참조하세요.
**서비스 보안 주체**
두 네임스페이스 모두 `chime.amazonaws.com` 서비스 보안 주체를 사용합니다. 서비스에 액세스 권한을 부여하는 액세스 정책이 있는 경우 해당 정책을 업데이트할 필요가 없습니다.
**API**
[Amazon Chime SDK 음성](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Voice.html) 네임스페이스에는 음성 작업을 생성하고 관리하기 위한 API만 포함되어 있습니다. [Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) 네임스페이스에는 음성 및 Amazon Chime 서비스의 기타 부분(예: 회의)을 위한 API가 포함되어 있습니다.
**태그 지정**
[Amazon Chime SDK 음성](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` 네임스페이스를 사용하여 Voice Connector 및 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)을 참조하세요.