아마존 차임 SDK 보이스 네임스페이스로 마이그레이션 - Amazon Chime SDK

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

아마존 차임 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 Voice 네임스페이스를 사용하면 API 엔드포인트를 사용할 수 있는 모든 지역에서 API 엔드포인트를 사용할 수 있습니다. 이외의 us-east-1 API 엔드포인트를 사용하려면 Amazon Chime SDK 음성 네임스페이스를 사용해야 합니다. 현재 엔드포인트에 대한 자세한 내용은 이 API 매핑 가이드의 을 참조하십시오.

업데이트된 음성 API 및 새 음성 API

Amazon Chime SDK 음성 네임스페이스에서만 음성 API를 추가하거나 업데이트합니다.

마이그레이션하기 전

마이그레이션하기 전에 네임스페이스 간의 차이점을 알아두세요. 다음 표에는 이러한 목록과 설명이 나와 있습니다.

아마존 차임 SDK 보이스 네임스페이스

아마존 차임 네임스페이스

AWS네임스페이스

ChimeSDKVoice

Chime

리전

Multiple

us-east-1

엔드포인트

https://voice-chime.region.amazonaws.com

service.chime.aws.amazon.com

서비스 책임자

chime.amazonaws.com

chime.amazonaws.com

API

PSTN 오디오 서비스용 전용 API

PSTN 오디오 및 아마존 차임의 다른 부분을 위한 API

음성 커넥터 관리 여러 지역 us-east-1
음성 커넥터 그룹 관리 여러 지역 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 네임스페이스

아마존 차임 SDK 네임스페이스는 공식 이름을 사용합니다. Chime Amazon Chime SDK 음성 네임스페이스는 공식 이름을 사용합니다. ChimeSDKVoice 이름의 정확한 형식은 플랫폼에 따라 다릅니다.

예를 들어 Node.js AWS SDK를 사용하여 회의를 만드는 경우 다음 코드 줄을 사용하여 네임스페이스를 처리합니다.

const chimeVoice = AWS.Chime();

Amazon Chime SDK Voice 네임스페이스로 마이그레이션하려면 이 코드 줄을 새 네임스페이스와 엔드포인트 리전으로 업데이트하십시오.

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

Amazon Chime 네임스페이스는 해당 지역의 API 엔드포인트만 처리할 수 있습니다. us-east-1 Amazon Chime SDK 음성 네임스페이스는 사용 가능한 모든 지역의 Amazon Chime SDK 음성 API 엔드포인트를 처리할 수 있습니다. 현재 음성 지역 목록은 이 사용 가능한 리전 가이드의 내용을 참조하십시오.

엔드포인트

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

음성 액션을 만드는 데 사용된 엔드포인트만 수정에 사용할 수 있습니다. 즉, 에서 엔드포인트를 통해 생성된 음성 액션은 를 통해서만 수정할 eu-central-1 수 있습니다. eu-central-1 또한 네임스페이스가 있는 Chime 네임스페이스를 통해 생성된 음성 액션을 처리할 수 없다는 의미이기도 합니다ChimeSDKVoice. us-east-1 현재 엔드포인트에 대한 자세한 내용은 이 API 매핑 가이드의 을 참조하십시오.

서비스 보안 주체

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

API

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

태그 지정

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

미디어 지역

Chime네임스페이스를 사용하여 음성 커넥터 및 SIP 미디어 응용 프로그램과 같은 리소스를 만드는 경우 us-east-1us-west-2 에서만 만들 수 있으며 엔드포인트를 사용해야 합니다. us-east-1

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