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

# Amazon Chime SDK 미디어 파이프라인 네임스페이스로 마이그레이션
<a name="migrate-pipelines"></a>

`ChimeSdkMediaPipelines` 네임스페이스를 사용하여 사용 가능한 모든 AWS 리전의 미디어 파이프라인 API 엔드포인트를 처리합니다. Amazon Chime SDK를 막 사용하기 시작한 경우 이 네임스페이스를 사용하세요. 리전에 대한 자세한 내용은 이 설명서의 [Amazon Chime SDK에 사용 가능한 AWS 리전](sdk-available-regions.md) 섹션을 참조하세요.

[Amazon Chime](https://docs.aws.amazon.com/chime/latest/APIReference/API_Operations_Amazon_Chime.html) 네임스페이스를 사용하는 기존 애플리케이션은 전용 네임스페이스로의 마이그레이션을 계획해야 합니다.

**Topics**
+ [파이프라인을 마이그레이션하는 이유](#pipeline-migration-reasons)
+ [파이프라인 마이그레이션 전](#migration-prerequisites)

## 파이프라인을 마이그레이션하는 이유
<a name="pipeline-migration-reasons"></a>

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

**API 엔드포인트 선택**  
Amazon Chime SDK 미디어 캡처 네임스페이스는 API 엔드포인트를 사용할 수 있는 모든 리전에서 API 엔드포인트를 사용할 수 있는 유일한 API 네임스페이스입니다. 리전에 대한 자세한 내용은 [Amazon Chime SDK에 사용 가능한 AWS 리전](sdk-available-regions.md) 섹션을 참조하세요. `us-east-1` 이외의 API 엔드포인트를 사용하려면 `ChimeSdkMediaPipelines` 네임스페이스를 사용해야 합니다. 현재 엔드포인트에 대한 자세한 내용은 이 설명서의 [API 매핑](migrate-from-chm-namespace.md#name-end-map) 섹션을 참조하세요.

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

## 파이프라인 마이그레이션 전
<a name="migration-prerequisites"></a>

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


| Item | 미디어 파이프라인 네임스페이스 | Chime 네임스페이스 | 
| --- | --- | --- | 
|  네임스페이스 이름  |  ChimeSdkMediaPipelines  |  Chime  | 
|  리전  |  다양함  |  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  |     | 
|  Tags  |  Available  |  미디어 파이프라인 API에는 사용할 수 없습니다.  | 
| CloudTrail 이벤트 소스 | chime-sdk-media-pipelines.amazonaws.com | chime.amazonaws.com. | 
| 미디어 라이브 커넥터 | Available |  미디어 파이프라인 API에는 사용할 수 없습니다.  | 
| 합성 | Available |  미디어 파이프라인 API에는 사용할 수 없습니다.  | 
| 연결 | Available | 사용할 수 없습니다. | 

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

**네임스페이스 이름**  
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 엔드포인트를 처리합니다. 미디어 파이프라인 리전의 현재 목록은 본 설명서의 [Amazon Chime SDK에 사용 가능한 AWS 리전](sdk-available-regions.md)을 참조하세요.

**엔드포인트**  
미디어 캡처 파이프라인을 수정하려면 파이프라인을 생성한 것과 동일한 엔드포인트를 사용해야 합니다. 예를 들어 eu-central-1의 엔드포인트를 통해 파이프라인을 생성한 경우 eu-central-1을 사용하여 해당 파이프라인과 상호 작용해야 합니다. 현재 엔드포인트에 대한 자세한 내용은 이 설명서의 [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_Meetings.html) 네임스페이스는 새로운 서비스 보안 주체인 `mediapipelines.chime.amazonaws.com`을 사용합니다. 서비스에 액세스 권한을 부여하는 Amazon S3 버킷 또는 기타 IAM 정책이 있는 경우, 새 서비스 보안 주체에 대한 액세스 권한을 부여하도록 해당 정책을 업데이트해야 합니다.  
예를 들어 미디어 파이프라인을 생성할 때는 [Amazon Chime SDK 미디어 캡처 파이프라인용 Amazon S3 버킷 생성](create-s3-bucket.md)에 나열된 정책 권한을 새 서비스 보안 주체에 추가해야 합니다. 정책에 대한 자세한 내용은 IAM 사용 설명서의 [AWS JSON 정책 요소: Principal](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html)을 참조하세요.

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

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

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

**Tags**  
[Amazon Chime SDK 미디어 파이프라인](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) 네임스페이스는 태그를 지원합니다. 역할에는 하나 이상의 태그를 사용하여 [CreateMediaCapturePipeline](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaCapturePipeline.html) 또는 [CreateMediaLiveConnectorPipeline](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaLiveConnectorPipeline.html) API를 직접 호출할 때 `TagResource` 작업을 직접 호출할 권한이 있어야 합니다.