기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon Chime SDK 메시징 네임스페이스로 마이그레이션
[Amazon Chime SDK 메시징](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Messaging.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) 네임스페이스를 사용하는 기존 애플리케이션은 전용 네임스페이스로의 마이그레이션을 계획해야 합니다.
**Topics**
+ [마이그레이션하는 이유](#migration-reasons)
+ [마이그레이션하기 전](#before-migrating)
+ [네임스페이스 간 차이점](#namespace-differences)
## 마이그레이션하는 이유
다음과 같은 이유로 [Amazon Chime SDK 메시징](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Messaging.html) 네임스페이스로 마이그레이션하는 것이 좋습니다.
**API 엔드포인트 선택**
Amazon Chime SDK 메시징 네임스페이스는 [사용 가능한 모든 리전](https://docs.aws.amazon.com/chime-sdk/latest/dg/sdk-available-regions.html)에서 API 엔드포인트를 사용할 수 있는 유일한 API 네임스페이스입니다. 미국 동부(버지니아 북부) 이외의 API 엔드포인트를 사용하려면 Amazon Chime SDK 메시징 네임스페이스를 사용해야 합니다.
Amazon Chime SDK 메시징이 AWS 리전을 사용하는 방법에 대한 자세한 내용은이 안내서의 [사용 가능한 리전](https://docs.aws.amazon.com/chime-sdk/latest/dg/available-regions.html)을 참조하세요.
**업데이트되고 새로운 메시징 API**
메시징 API는 Amazon Chime SDK 메시징 네임스페이스에서만 추가하거나 업데이트합니다.
## 마이그레이션하기 전
마이그레이션하기 전에 네임스페이스 간 차이점에 유의해야 합니다. 다음 표에는 차이점과 그에 대한 설명이 나와 있습니다.
| | Amazon Chime SDK 메시징 네임스페이스 | Amazon Chime 네임스페이스 |
| --- | --- | --- |
| AWS SDK 네임스페이스 | ChimeSDKMessaging | Chime |
| 리전 | 다양함 | 미국 동부(버지니아 북부)에만 해당 |
| API | 메시징용 API 전용 | 메시징 및 Amazon Chime의 다른 부분을 위한 API |
| 흐름 | Available | 사용할 수 없음 |
| 엘라스틱 채널 | Available | 사용할 수 없음 |
## 네임스페이스 간 차이점
다음 섹션에서는 `Amazon Chime` 네임스페이스와 `Amazon Chime SDK Messaging` 네임스페이스의 차이점을 설명합니다.
**AWS SDK 네임스페이스**
Amazon Chime SDK 네임스페이스는 `Chime` 공식 이름을 사용합니다. Amazon Chime SDK 메시징 네임스페이스는 `ChimeSDKMessaging` 공식 이름을 사용합니다. 이름의 정확한 형식은 플랫폼마다 다릅니다.
예를 들어 Node.js의 AWS SDK를 사용하여 메시징을 생성하는 경우 코드 줄을 사용하여 네임스페이스를 처리합니다.
```
const chimeMessaging = AWS.Chime();
```
Amazon Chime 메시징 SDK로 마이그레이션하려면 이 코드 줄을 새 네임스페이스와 엔드포인트 리전으로 업데이트하세요.
```
const chimeMessaging = AWS.ChimeSDKMessaging({ region: "Europe (Frankfurt)" });
```
**리전**
[Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) 네임스페이스는 `US East (N. Virginia)` 리전의 API 엔드포인트만 다룹니다. [Amazon Chime SDK 메시징](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Messaging.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_Messaging.html) 네임스페이스는 [Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) 네임스페이스와는 다른 API 엔드포인트를 사용합니다.
메시징 리소스를 생성하는 데 사용된 엔드포인트만 메시징 리소스를 수정하는 데 사용할 수 있습니다. 즉, `Europe (Frankfurt)`의 엔드포인트를 통해 만든 메시징 리소스는 `Europe (Frankfurt)`을 통해서만 수정할 수 있습니다. 즉, 유럽(프랑크푸르트)의 엔드포인트를 통해 생성된 채널은 유럽(프랑크푸르트)을 통해서만 수정할 수 있습니다. 또한 `Chime` 네임스페이스를 통해 생성된 채널은 미국 동부(버지니아 북부)의 `ChimeSDKMessaging` 네임스페이스로 주소를 지정할 수 없다는 의미이기도 합니다. 현재 엔드포인트에 대한 자세한 내용은 이 설명서의 [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_Messaging.html) 네임스페이스는 새로운 서비스 보안 주체인 `messaging.chime.amazonaws.com`를 사용합니다. 서비스에 대한 액세스 권한을 부여하는 SQS, SNS 또는 기타 IAM 액세스 정책이 있는 경우 새 서비스 보안 주체에 대한 액세스 권한을 부여하도록 해당 정책을 업데이트해야 합니다.
**API**
[Amazon Chime SDK 메시징](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Messaging.html) 네임스페이스에는 메시징 리소스를 생성 및 관리하고 메시지를 전송 및 수신하기 위한 API만 포함되어 있습니다. [Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) 네임스페이스에는 Amazon Chime 서비스의 다른 부분과 메시징을 위한 API가 포함되어 있습니다.
**채널 흐름**
채널 흐름을 통해 개발자는 메시지 채널의 구성원에게 전달되기 전에 진행 중인 메시지에 대한 비즈니스 로직을 실행할 수 있습니다. 예를 들어 주민등록번호, 전화번호와 같은 민감한 데이터 또는 욕설이 전달되기 전에 메시지에서 제거하는 흐름을 만들 수 있습니다. 이는 기업 커뮤니케이션 정책 또는 기타 커뮤니케이션 지침을 구현하는 데 도움이 될 수 있습니다.
또한 채널 흐름을 사용하여 설문 조사 응답을 집계한 후 결과를 참가자에게 다시 보내거나 SMS를 통해 메시지를 보내는 등의 기능을 수행할 수 있습니다.
채널 흐름은 `ChimeSDKMessaging` 네임스페이스에서만 사용할 수 있습니다. 이에 대한 자세한 내용은 이 설명서의 [채널 흐름을 사용하여 Amazon Chime SDK 메시징용 메시지 처리](using-channel-flows.md) 섹션을 참조하세요.
**엘라스틱 채널**
엘라스틱 채널은 최대 백만 명의 채팅 사용자가 정의된 수의 하위 채널에서 자동으로 균형을 이루는 대규모 채팅 경험을 지원합니다. 엘라스틱 채널은 `ChimeSDKMessaging` 엔드포인트에서만 사용할 수 있습니다. 엘라스틱 채널에 대한 자세한 내용은 이 설명서의 [엘라스틱 채널을 사용하여 Amazon Chime SDK 회의에서 라이브 이벤트 주최](elastic-channels.md) 섹션을 참조하세요.
**추가 API**
메시징 네임스페이스에는 `Chime` 네임스페이스에는 없는 추가 API 목록이 점점 늘어나고 있습니다. Amazon Chime SDK로 시작하는 경우 메시징 네임스페이스를 사용하여 모든 최신 기능에 액세스할 수 있습니다. 현재 API에 대한 자세한 내용은 Amazon Chime SDK API 참조**의 [Amazon Chime SDK 메시징](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Messaging.html) 섹션을 참조하세요.