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

# Amazon Chime SDK 회의 네임스페이스로 마이그레이션
<a name="meeting-namespace-migration"></a>

[Amazon Chime SDK 회의](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) 네임스페이스는 Amazon Chime SDK 회의 리소스를 생성하고 관리하는 API의 전용 공간입니다. 네임스페이스를 사용하여 Amazon Chime SDK 회의 API 엔드포인트를 사용할 수 있는 모든 AWS 리전에서 이를 다룹니다. Amazon Chime SDK를 막 사용하기 시작한 경우 이 네임스페이스를 사용하세요. 리전에 대한 자세한 내용은 이 설명서의 [Amazon Chime SDK에 사용 가능한 AWS 리전](sdk-available-regions.md) 섹션을 참조하세요.

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

**Topics**
+ [마이그레이션하는 이유](#migration-reasons)
+ [마이그레이션하기 전](#before-migrating)
+ [네임스페이스 간 차이점](#namespace-differences)

## 마이그레이션하는 이유
<a name="migration-reasons"></a>

다음과 같은 이유로 [Amazon Chime SDK 회의](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) 네임스페이스로 마이그레이션하는 것이 좋습니다.

**API 엔드포인트 선택**  
Amazon Chime SDK 회의 네임스페이스는 [API 엔드포인트를 사용할 수 있는 리전](https://docs.aws.amazon.com/chime-sdk/latest/dg/sdk-available-regions.html) 모두에서 API 엔드포인트를 사용할 수 있는 유일한 API 네임스페이스입니다. `us-east-1` 이외의 API 엔드포인트를 사용하는 경우 Amazon Chime SDK 회의 네임스페이스를 사용해야 합니다.  
Amazon Chime SDK 회의가 AWS 리전을 사용하는 방법에 대한 자세한 내용은이 안내서의 [회의 리전](https://docs.aws.amazon.com/chime-sdk/latest/dg/chime-sdk-meetings-regions.html)을 참조하세요.

**업데이트된 회의 API 및 새 회의 API**  
Amazon Chime SDK 회의 네임스페이스에서만 회의 API를 추가하거나 업데이트합니다.

## 마이그레이션하기 전
<a name="before-migrating"></a>

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


|  | Amazon Chime SDK 회의 네임스페이스 | Amazon Chime 네임스페이스 | 
| --- | --- | --- | 
| AWS SDK 네임스페이스 | ChimeSDKMeetings | Chime | 
| 리전 | 다양함 | us-east-1 전용 | 
| 엔드포인트 | https://meetings-chime.region.amazonaws.com | https://service.chime.aws.amazon.com | 
| 서비스 보안 주체 | meetings.chime.amazonaws.com | chime.amazonaws.com | 
| API | 회의용 API 전용 | 회의 및 Amazon Chime의 기타 부분을 위한 API | 
| [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_CreateMeeting.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_CreateMeeting.html) | ExternalMeetingId 및 MediaRegion은 필수 사항 | ExternalMeetingId 및 MediaRegion은 선택 사항 | 
| [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_CreateMeetingWithAttendees.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_CreateMeetingWithAttendees.html) | ExternalMeetingId 및 MediaRegion은 필수 사항  | ExternalMeetingId 및 MediaRegion은 선택 사항 | 
| ListMeetings | 사용할 수 없음 | 사용 가능 | 
| ExternalMeetingId | 검증에 패턴 일치 포함 | Available | 
| ExternalUserId | 검증에 패턴 일치 포함  | Available | 
| 회의 태그 API | TagResource, UntagResource, ListTagsForResource | TagMeeting, UntagMeeting, ListMeetingTags | 
| 참석자 태그 | 사용할 수 없음 | 사용 가능 | 
| 울림 감소 | Available | 사용할 수 없음 | 
| 라이브 트랜스크립션 언어 식별 | Available | 사용할 수 없음 | 
| 참석자 기능 | Available | 사용할 수 없음 | 
| 미디어 복제 | Available | 사용할 수 없음 | 
| AppKey 및 TenantId | Available | 사용할 수 없음 | 
| 미디어 파이프라인 | 미디어 파이프라인은 Amazon Chime SDK 회의 네임스페이스의 여러 리전을 지원합니다. 자세한 내용은 [Amazon Chime SDK 미디어 파이프라인 네임스페이스로 마이그레이션](migrate-pipelines.md)을 참조하세요. | us-east-1 엔드포인트를 통해 사용 가능 | 
| SIP 미디어 애플리케이션 | JoinChimeMeeting 작업은 MeetingId 필요 | JoinChimeMeeting 작업은 MeetingId 불필요 | 
|  **직접 SIP 통합**  | 사용할 수 없음 | 사용 가능 | 

## 네임스페이스 간 차이점
<a name="namespace-differences"></a>

다음 섹션에서는 `Amazon Chime` 네임스페이스와 `Amazon Chime SDK Meetings` 네임스페이스의 차이점을 설명합니다.

### AWS SDK 네임스페이스
<a name="namespace-diffs"></a>

Amazon Chime SDK 네임스페이스는 `Chime` 공식 이름을 사용합니다. Amazon Chime SDK 회의 네임스페이스는 `ChimeSDKMeetings` 공식 이름을 사용합니다. 이름의 정확한 형식은 플랫폼마다 다릅니다.

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

```
const chimeMeetings = AWS.Chime();
```

Amazon Chime 회의 SDK 네임스페이스로 마이그레이션하려면 새 네임스페이스와 엔드포인트 리전으로 아래 코드를 업데이트합니다.

```
const chimeMeetings = AWS.ChimeSDKMeetings({ region: "eu-central-1" });
```

### 리전
<a name="region-diffs"></a>

[Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) 네임스페이스는 us-east-1 리전의 API 엔드포인트만 다룹니다. [Amazon Chime SDK 회의](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) 네임스페이스는 Amazon Chime SDK 회의 API 엔드포인트를 사용 가능한 모든 리전에서 이를 다룰 수 있습니다. 현재 회의 리전의 목록은 본 설명서의 [Amazon Chime SDK에 사용 가능한 AWS 리전](sdk-available-regions.md)을 참조하세요.

### 엔드포인트
<a name="endpoint-diffs"></a>

[Amazon Chime SDK 회의](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) 네임스페이스는 [Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) 네임스페이스와는 다른 API 엔드포인트를 사용합니다.

회의를 생성하는 데 사용된 엔드포인트만 회의를 수정하는 데 사용할 수 있습니다. 즉, EU-CENTRAL-1에서 엔드포인트를 통해 생성된 회의는 EU-CENTRAL-1을 통해서만 수정할 수 있습니다. 또한 `Chime` 네임스페이스를 통해 생성된 회의를 `US-EAST-1`의 `ChimeSDKMeetings` 네임스페이스로 다룰 수 없습니다. 현재 엔드포인트에 대한 자세한 내용은 이 설명서의 [API 매핑](migrate-from-chm-namespace.md#name-end-map) 섹션을 참조하세요.

### 서비스 보안 주체
<a name="service-principal-diffs"></a>

[Amazon Chime SDK 회의](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) 네임스페이스는 새로운 서비스 보안 주체인 `meetings.chime.amazonaws.com`을 사용합니다. 서비스에 액세스 권한을 부여하는 SQS, SNS 또는 기타 IAM 액세스 정책이 있는 경우, 새 서비스 보안 주체에 대한 액세스 권한을 부여하도록 해당 정책을 업데이트해야 합니다.

### API
<a name="api-diffs"></a>

[Amazon Chime SDK 회의](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) 네임스페이스에는 회의를 생성하고 관리하기 위한 API만 포함되어 있습니다. [Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) 네임스페이스에는 회의 및 Amazon Chime 서비스의 기타 부분을 위한 API가 포함되어 있습니다.

### CreateMeeting에 필요한 필드
<a name="create-meeting-diffs"></a>

Amazon Chime SDK 회의 네임스페이스에서 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html) 및 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeetingWithAttendees.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeetingWithAttendees.html) API를 사용하려면 `ExternalMeetingId` 및 `MediaRegion` 필드를 지정해야 합니다.

### 외부 ID 값
<a name="external-id-diffs"></a>

[Amazon Chime SDK 회의](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) 네임스페이스는 `ExternalMeetingId` 및 `ExternalUserId`에 사용할 수 있는 값에 대한 추가 검증을 시행합니다.

### 울림 감소
<a name="echo-reduction-diffs"></a>

[Amazon Chime SDK 회의](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) 네임스페이스는 기계 학습 기반 울림 감소를 제공하여 로컬 스피커의 소음과 소리가 다시 회의로 들어가는 것을 막는 데 도움이 됩니다. 자세한 내용은 GitHub의 설명서를 참조하세요.

### 참석자 기능
<a name="capabilities-diffs"></a>

[Amazon Chime SDK 회의](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) 네임스페이스에서는 회의 내 참석자가 오디오, 비디오 및 콘텐츠를 보내고 받을 수 있는 기능을 세부적으로 제어할 수 있습니다.

### 미디어 복제
<a name="media-replication-diffs"></a>

[Amazon Chime SDK 회의](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) 네임스페이스는 미디어 복제를 제공하여 기본 회의를 복제 회의에 연결하고 실시간 세션에 최대 10,000명을 모을 수 있습니다. 복제 세션에 연결된 참가자는 기본 세션에 연결된 발표자의 미디어를 수신하지만 기본 회의로 승격될 수는 있습니다. 자세한 내용은 이 설명서의 [Amazon Chime SDK 회의에 미디어 복제 사용](media-replication.md)을 참조하세요.

### AppKey 및 TenantId
<a name="app-keys-diffs"></a>

[Amazon Chime SDK 회의](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) 네임스페이스는 네트워크에서 특정 Amazon Chime SDK 회의로의 액세스를 제한하는 방법을 제공합니다. 자세한 내용은 이 설명서의 [Amazon Chime SDK에 AppKey 및 TenantID 사용](app-keys-tenant-ids.md)을 참조하세요.

### 미디어 파이프라인
<a name="media-pipe-diffs"></a>

Amazon Chime SDK 미디어 파이프라인은 [Amazon Chime SDK 회의](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) 또는 [Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) 네임스페이스를 사용하여 모든 회의 엔드포인트에서 생성한 회의와 작동합니다. 미디어 파이프라인 리전의 최신 목록은 [사용 가능한 리전](https://docs.aws.amazon.com/chime-sdk/latest/dg/sdk-available-regions.html)을 참조하세요.

### SIP 미디어 애플리케이션
<a name="sip-app-diffs"></a>

Amazon Chime SDK SIP 미디어 애플리케이션은 [Amazon Chime SDK 회의](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) 또는 [Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) 네임스페이스를 사용하여 모든 회의 엔드포인트에서 생성한 회의와 작동합니다. Amazon Chime SDK 회의 네임스페이스를 통해 회의를 생성한 SIP 미디어 애플리케이션을 사용하는 경우, [JoinChimeMeeting](join-chime-meeting.md) 작업에 `MeetingId` 파라미터가 필요합니다.

### 추가 API
<a name="additional-api-diffs"></a>

회의 네임스페이스에는 Chime 네임스페이스에 없는 API 목록이 점점 늘어나고 있습니다. Amazon Chime SDK를 시작하는 경우 회의 네임스페이스를 사용하여 최신 기능에 액세스하세요.