Amazon Chime SDK 음성 네임스페이스로 마이그레이션 - Amazon Chime SDK

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Amazon Chime SDK 음성 네임스페이스로 마이그레이션

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

Amazon Chime 네임스페이스를 사용하는 기존 애플리케이션은 업데이트된 API 및 새 기능을 사용하기 위해 전용 네임스페이스로의 마이그레이션을 계획해야 합니다.

마이그레이션하는 이유

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

API 엔드포인트 선택

Amazon Chime SDK 음성 네임스페이스를 사용하면 API 엔드포인트를 사용 가능한 리전에서 이를 다룹니다. us-east-1 이외의 API 엔드포인트를 사용하려는 경우 Amazon Chime SDK 음성 네임스페이스를 사용해야 합니다. 현재 엔드포인트에 대한 자세한 내용은 이 설명서의 API 매핑 섹션을 참조하세요.

업데이트된 음성 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
통화 분석 사용 가능 사용할 수 없음
음성 프로필 도메인 사용 가능 사용할 수 없음
긴급 통화 관리 다중 리전 us-east-1
프록시 전화 세션 관리 다중 리전 us-east-1
스트리밍 관리 다중 리전 us-east-1
로깅 및 지표 관리 다중 리전 us-east-1

사용 가능한 리전에 대한 자세한 내용은 본 설명서 앞부분에 있는 PSTN 리전을 참조하세요.

네임스페이스 간 차이점

다음 섹션에서는 Amazon Chime SDK VoiceAmazon 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 네임스페이스는 us-east-1 리전의 API 엔드포인트만 다룹니다. Amazon Chime SDK 음성 네임스페이스는 Amazon Chime SDK 음성 API 엔드포인트를 사용 가능한 모든 리전에서 이를 다룰 수 있습니다. 현재 음성 리전의 목록은 본 설명서의 사용 가능한 리전을 참조하세요.

엔드포인트

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

음성 작업을 생성하는 데 사용된 엔드포인트만 이를 수정하는 데 사용할 수 있습니다. 즉, eu-central-1의 엔드포인트를 통해 생성된 음성 작업은 eu-central-1을 통해서만 수정할 수 있습니다. 또한 Chime 네임스페이스를 통해 생성된 음성 작업을 us-east-1ChimeSDKVoice 네임스페이스로 다룰 수 없습니다. 현재 엔드포인트에 대한 자세한 내용은 이 설명서의 API 매핑 섹션을 참조하세요.

서비스 보안 주체

두 네임스페이스 모두 chime.amazonaws.com 서비스 보안 주체를 사용합니다. 서비스에 액세스 권한을 부여하는 액세스 정책이 있는 경우 해당 정책을 업데이트할 필요가 없습니다.

API

Amazon Chime SDK 음성 네임스페이스에는 음성 작업을 생성하고 관리하기 위한 API만 포함되어 있습니다. Amazon Chime 네임스페이스에는 음성 및 Amazon Chime 서비스의 기타 부분(예: 회의)을 위한 API가 포함되어 있습니다.

태그 지정

Amazon Chime SDK 음성 네임스페이스만 태그를 지원합니다. 태그에 대한 자세한 내용은 및 을 참조하십시오. TagResourceUntagResource

미디어 리전

Chime 네임스페이스를 사용하여 Voice Connector 및 SIP 미디어 애플리케이션과 같은 리소스를 생성하는 경우, us-east-1us-west-2에서만 생성할 수 있으며 us-east-1 엔드포인트를 사용해야 합니다.

반면 ChimeSDKVoice 네임스페이스는 us-east-1us-west-2뿐만 아니라 지원되는 모든 리전에서 리소스를 생성할 수 있습니다. 리전 범위에 대한 자세한 내용은 사용 가능한 리전을 참조하세요.