ChimeSdkMediaPipelines 네임스페이스로 마이그레이션

ChimeSdkMediaPipelines 네임스페이스를 사용하면 사용 가능한 모든 AWS 리전의 미디어 파이프라인 API 엔드포인트에 주소를 지정할 수 있습니다. Amazon Chime SDK를 막 사용하기 시작한 경우 이 네임스페이스를 사용하세요. 리전에 대한 자세한 내용은 이 설명서의 사용 가능한 리전 섹션을 참조하세요.

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

파이프라인을 마이그레이션하는 이유

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

API 엔드포인트 선택

Amazon Chime SDK 미디어 캡처 네임스페이스는 API 엔드포인트를 사용할 수 있는 모든 리전에서 API 엔드포인트를 사용할 수 있는 유일한 API 네임스페이스입니다. 리전에 대한 자세한 내용은 사용 가능한 리전 섹션을 참조하세요. us-east-1 이외의 API 엔드포인트를 사용하려면 ChimeSdkMediaPipelines 네임스페이스를 사용해야 합니다. 현재 엔드포인트에 대한 자세한 내용은 이 설명서의 API 매핑 섹션을 참조하세요.

업데이트된 미디어 파이프라인 API 및 새 미디어 파이프라인 API

ChimeSdkMediaPipelines 네임스페이스에서 미디어 파이프라인 API만 추가하거나 업데이트합니다.

파이프라인 마이그레이션 전

마이그레이션하기 전에 네임스페이스 간 차이점에 유의해야 합니다. 다음 표는 네임스페이스를 나열하고 설명합니다.

항목	미디어 파이프라인 네임스페이스	Chime 네임스페이스
네임스페이스 이름	ChimeSdkMediaPipelines	Chime
리전	Multiple	us-east-1 전용
엔드포인트	https://media-pipelines-chime.region.amazonaws.com	https://service.chime.aws.amazon.com
서비스 보안 주체	mediapipelines.chime.amazonaws.com	chime.amazonaws.com
API	미디어 파이프라인용 API 전용	미디어 파이프라인 및 Amazon Chime의 기타 부분을 위한 API
회의	us-west-2, ap-southeast-1, 및 eu-central-1 리전의 미디어 파이프라인은 Amazon Chime SDK 회의 네임스페이스에서 생성된 회의에서만 작동합니다. us-east-1 리전의 미디어 파이프라인은 각 네임스페이스의 모든 회의 엔드포인트에서 생성된 회의에서 작동합니다.	미디어 파이프라인은 각 네임스페이스의 모든 회의 엔드포인트에서 생성된 회의에서 작동합니다.
기본 활성 미디어 파이프라인	us-east-1 리전에서 100, us-west-2, ap-southeast-1, eu-central-1 리전에서 10	us-east-1에서만 100
서비스 연결 역할	AWSServiceRoleForAmazonChimeSDKMediaPipelines
태그	사용 가능	미디어 파이프라인 API에는 사용할 수 없습니다.
CloudTrail 이벤트 소스	chime-sdk-media-pipelines.amazonaws.com	chime.amazonaws.com.
미디어 라이브 커넥터	사용 가능	미디어 파이프라인 API에는 사용할 수 없습니다.
합성	사용 가능	미디어 파이프라인 API에는 사용할 수 없습니다.
연결	사용 가능	해당 사항 없음.

다음 목록은 Chime 및 AWSChimeSdkMediaPipelines 네임스페이스 간의 차이에 대한 자세한 정보를 제공합니다.

네임스페이스 이름

Amazon Chime SDK 네임스페이스는 AWS.Chime 공식 이름을 사용합니다. Amazon Chime SDK 미디어 파이프라인 네임스페이스는 AWS.ChimeSDKMediaPipelines 공식 이름을 사용합니다. 이름의 정확한 형식은 플랫폼마다 다릅니다.

예를 들어, 다음 Node.js 코드 줄은 chime 네임스페이스의 주소를 지정합니다.

const chimeMediaPipelines = AWS.Chime();

미디어 파이프라인 SDK 네임스페이스로 마이그레이션하려면 새 네임스페이스와 엔드포인트 리전으로 해당 코드를 업데이트하세요.

const chimeMediaPipelines = AWS.ChimeSDKMediaPipelines({ region: "eu-central-1" });

리전

Amazon Chime 네임스페이스는 US-EAST-1 리전의 API 엔드포인트만 처리합니다. Amazon Chime SDK 미디어 파이프라인 네임스페이스는 해당 엔드포인트가 있는 모든 리전의 Amazon Chime SDK 미디어 파이프라인 API 엔드포인트를 처리합니다. 미디어 파이프라인 리전의 현재 목록은 본 설명서의 사용 가능한 리전을 참조하세요.

엔드포인트

미디어 캡처 파이프라인을 수정하려면 파이프라인을 생성한 것과 동일한 엔드포인트를 사용해야 합니다. 예를 들어 eu-central-1의 엔드포인트를 통해 파이프라인을 생성한 경우 eu-central-1을 사용하여 해당 파이프라인과 상호 작용해야 합니다. 현재 엔드포인트에 대한 자세한 내용은 이 설명서의 API 매핑 섹션을 참조하세요.

서비스 보안 주체

Amazon Chime SDK 미디어 파이프라인 네임스페이스는 새로운 서비스 보안 주체인 mediapipelines.chime.amazonaws.com을 사용합니다. 서비스에 액세스 권한을 부여하는 Amazon S3 버킷 또는 기타 IAM 정책이 있는 경우, 새 서비스 보안 주체에 대한 액세스 권한을 부여하도록 해당 정책을 업데이트해야 합니다.

예를 들어 미디어 파이프라인을 생성할 때는 Amazon S3 버킷 생성에 나열된 정책 권한을 새 서비스 보안 주체에 추가해야 합니다. 정책에 대한 자세한 내용은 IAM 사용 설명서의 AWS JSON 정책 요소: Principal을 참조하세요.

API

Amazon Chime SDK 미디어 파이프라인 네임스페이스에는 미디어 파이프라인을 생성하고 관리하는 API만 포함됩니다. Amazon Chime 네임스페이스에는 미디어 파이프라인, 회의 및 Amazon Chime 서비스의 기타 부분을 위한 API가 포함되어 있습니다.

회의

IAD 리전의 미디어 파이프라인은 각 네임스페이스의 모든 회의 엔드포인트에서 생성한 회의에서 작동합니다.

서비스 연결 역할

Amazon Chime SDK 미디어 파이프라인 네임스페이스에만 해당됩니다. AWSServiceRoleForAmazonChimeSDKMediaPipelines 역할을 생성합니다.

태그

Amazon Chime SDK 미디어 파이프라인 네임스페이스는 태그를 지원합니다. 역할에는 하나 이상의 태그를 사용하여 CreateMediaCapturePipeline 또는 CreateMediaLiveConnectorPipeline API를 직접 호출할 때 TagResource 작업을 직접 호출할 권한이 있어야 합니다.