Amazon Chime SDK 메시징 네임스페이스로 마이그레이션

Amazon Chime SDK 메시징 네임스페이스는 Amazon Chime SDK 메시징 리소스를 생성하고 관리하는 API를 위한 전용 공간입니다. 네임스페이스를 사용하여 Amazon Chime SDK 메시징 API 엔드포인트를 사용할 수 있는 모든 AWS 리전의 주소를 지정할 수 있습니다. Amazon Chime SDK를 막 사용하기 시작한 경우 이 네임스페이스를 사용하세요. 리전에 대한 자세한 내용은 이 설명서의 사용 가능한 리전 섹션을 참조하세요.

Amazon Chime 네임스페이스를 사용하는 기존 애플리케이션은 전용 네임스페이스로의 마이그레이션을 계획해야 합니다.

마이그레이션하는 이유

다음과 같은 이유로 Amazon Chime SDK 메시징 네임스페이스로 마이그레이션하는 것이 좋습니다.

API 엔드포인트 선택

Amazon Chime SDK 메시징 네임스페이스는 API 엔드포인트를 사용할 수 있는 모든 지역에서 API 엔드포인트를 사용할 수 있는 유일한 API 네임스페이스입니다. 미국 동부 (버지니아 북부) 이외의 API 엔드포인트를 사용하려면 Amazon Chime SDK 메시징 네임스페이스를 사용해야 합니다.

Amazon Chime SDK 메시징에서 AWS 지역을 사용하는 방법에 대한 자세한 내용은 이 안내서의 사용 가능한 지역을 참조하십시오.

업데이트되고 새로운 메시징 API

메시징 API는 Amazon Chime SDK 메시징 네임스페이스에서만 추가하거나 업데이트합니다.

마이그레이션하기 전

마이그레이션하기 전에 네임스페이스 간 차이점에 유의해야 합니다. 다음 표에는 차이점과 그에 대한 설명이 나와 있습니다.

	Amazon Chime SDK 메시징 네임스페이스	Amazon Chime 네임스페이스
AWS SDK 네임스페이스	ChimeSDKMessaging	Chime
리전	다양함	미국 동부(버지니아 북부)에만 해당
API	메시징용 API 전용	메시징 및 Amazon Chime의 다른 부분을 위한 API
흐름	사용 가능	사용할 수 없음
엘라스틱 채널	사용 가능	사용할 수 없음

네임스페이스 간 차이점

다음 섹션에서는 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 네임스페이스는 US East (N. Virginia) 리전의 API 엔드포인트만 다룹니다. Amazon Chime SDK 메시징 네임스페이스는 사용 가능한 모든 리전의 Amazon Chime SDK 메시징 API 엔드포인트를 처리할 수 있습니다. 메시징 리전 최신 목록은 이 안내서의 사용 가능한 리전 섹션을 참조하세요.

엔드포인트

Amazon Chime SDK 메시징 네임스페이스는 Amazon Chime 네임스페이스와는 다른 API 엔드포인트를 사용합니다.

메시징 리소스를 생성하는 데 사용된 엔드포인트만 메시징 리소스를 수정하는 데 사용할 수 있습니다. 즉, Europe (Frankfurt)의 엔드포인트를 통해 만든 메시징 리소스는 Europe (Frankfurt)을 통해서만 수정할 수 있습니다. 즉, 유럽 (프랑크푸르트) 의 엔드포인트를 통해 생성된 채널은 유럽 (프랑크푸르트) 을 통해서만 수정할 수 있습니다. 또한 네임스페이스를 통해 생성된 채널에는 미국 동부 (버지니아 북부) 의 Chime ChimeSDKMessaging 네임스페이스를 사용하여 주소를 지정할 수 없습니다. 현재 엔드포인트에 대한 자세한 내용은 이 설명서의 API 매핑 섹션을 참조하세요.

서비스 보안 주체

Amazon Chime SDK 메시징 네임스페이스는 새로운 서비스 보안 주체인 messaging.chime.amazonaws.com를 사용합니다. 서비스에 대한 액세스 권한을 부여하는 SQS, SNS 또는 기타 IAM 액세스 정책이 있는 경우 새 서비스 보안 주체에 대한 액세스 권한을 부여하도록 해당 정책을 업데이트해야 합니다.

API

Amazon Chime SDK 메시징 네임스페이스에는 메시징 리소스를 생성 및 관리하고 메시지를 전송 및 수신하기 위한 API만 포함되어 있습니다. Amazon Chime 네임스페이스에는 Amazon Chime 서비스의 다른 부분과 메시징을 위한 API가 포함되어 있습니다.

채널 흐름

채널 흐름을 통해 개발자는 메시지 채널의 구성원에게 전달되기 전에 진행 중인 메시지에 대한 비즈니스 로직을 실행할 수 있습니다. 예를 들어 주민등록번호, 전화번호와 같은 민감한 데이터 또는 욕설이 전달되기 전에 메시지에서 제거하는 흐름을 만들 수 있습니다. 이는 기업 커뮤니케이션 정책 또는 기타 커뮤니케이션 지침을 구현하는 데 도움이 될 수 있습니다.

또한 채널 흐름을 사용하여 설문 조사 응답을 집계한 후 결과를 참가자에게 다시 보내거나 SMS를 통해 메시지를 보내는 등의 기능을 수행할 수 있습니다.

채널 흐름은 ChimeSDKMessaging 네임스페이스에서만 사용할 수 있습니다. 이에 대한 자세한 내용은 이 설명서의 채널 흐름을 사용하여 메시지 처리 섹션을 참조하세요.

엘라스틱 채널

엘라스틱 채널은 최대 백만 명의 채팅 사용자가 정의된 수의 하위 채널에서 자동으로 균형을 이루는 대규모 채팅 경험을 지원합니다. 엘라스틱 채널은 ChimeSDKMessaging 엔드포인트에서만 사용할 수 있습니다. 엘라스틱 채널에 대한 자세한 내용은 이 설명서의 엘라스틱 채널을 사용하여 라이브 이벤트 주최 섹션을 참조하세요.

추가 API

메시징 네임스페이스에는 Chime 네임스페이스에는 없는 추가 API 목록이 점점 늘어나고 있습니다. Amazon Chime SDK로 시작하는 경우 메시징 네임스페이스를 사용하여 모든 최신 기능에 액세스할 수 있습니다. 현재 API에 대한 자세한 내용은 Amazon Chime SDK API 참조의 Amazon Chime SDK 메시징 섹션을 참조하세요.