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

# MediaTailor를 사용하여 구성 별칭 생성 및 사용
<a name="creating-configuration-aliases"></a>

도메인 변수를 사용하기 전에 구성에 대한 구성 별칭을 생성합니다. 세션 초기화 시 구성 별칭을 도메인 대체 변수로 사용합니다.

**제한 사항**  
구성 별칭을 사용할 때 다음 제한 사항에 유의하세요.
+ 도메인에 사용되는 모든 동적 변수는 `ConfigurationAliases` 동적 변수로 정의되어야 합니다.
+ 플레이어 파라미터 변수에는 접두사가 붙어야 합니다`player_params.`. 예를 들어 `player_params.origin_domain`입니다.
+ 별칭이 지정된 값 목록은 중요한 URLs(`VideoContentSourceUrl`, `AdSegmentUrlPrefix`, `ContentSegmentUrlPrefix`)의 도메인 변수에 대해 포괄적이어야 합니다.
+ 동적 변수를 지정하지 않거나 잘못된 별칭을 사용하는 중요한 URLs의 도메인 변수에 대한 요청이 이루어진 경우 HTTP `400` 상태 코드와 함께 요청이 실패합니다. 중요하지 않은 필드(`SlateAdUrl`, `TranscodeProfileName`, 범퍼 URLs)는 경고를 로깅하지만 요청에 실패하지는 않습니다.

**누락된 별칭에 대한 대체 동작**  
구성 별칭을 찾을 수 없거나 유효하지 않은 경우 MediaTailor는 다음 대체 동작을 구현합니다.
+ **도메인 변수:** 도메인 변수 별칭이 누락되거나 유효하지 않은 경우 HTTP 400 상태 코드와 함께 요청이 실패합니다. 모든 도메인 변수에는 유효한 별칭이 정의되어 있어야 합니다.
+ **비도메인 변수:** URLs의 비도메인 부분에 사용되는 변수(예: 경로 요소 또는 쿼리 파라미터)의 경우 별칭이 누락되면 빈 문자열이 대체됩니다.
+ **구성 검증:** MediaTailor는 구성 생성 및 업데이트 작업 중에 필요한 모든 별칭이 있는지 확인합니다.

## 1단계: 구성 별칭 생성
<a name="dynamic-domains-creating-configuration-alias"></a>

MediaTailor 콘솔을 사용하여 도메인 교체에 사용할 구성 별칭을 생성하려면 다음 절차를 수행합니다.

------
#### [ Console ]

**콘솔을 사용하여 구성 별칭을 생성하려면**

1. [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/) MediaTailor 콘솔을 엽니다.

1. **구성 페이지의 구성 별칭** 섹션에서 **플레이어 파라미터 추가**를 선택합니다. **** 

1. **플레이어 파라미터**에 동적 변수로 사용할 플레이어 파라미터의 이름을 입력합니다. 예를 들어 `player_params.origin_domain`입니다.

1. **별칭**에 플레이어 파라미터에 사용할 별칭과 해당 값을 입력합니다.

1. **확인**을 선택합니다.

   AWS Elemental MediaTailor 는 **구성 별칭** 섹션의 테이블에 새 파라미터를 표시합니다.

1. 이전 단계를 반복하여 플레이어 파라미터를 더 추가합니다.

1. **저장**을 선택합니다.

------
#### [ API ]

**API를 사용하여 구성 별칭을 생성하려면**  
MediaTailor 구성을 생성하거나 업데이트할 때 다음 JSON 구조와 함께 `ConfigurationAliases` 파라미터를 사용합니다.

```
{
                "ConfigurationAliases": {
                "player_params.origin_domain": {
                "pdx": "abc.mediapackage.us-west-2.amazonaws.com",
                "iad": "xyz.mediapackage.us-east-1.amazonaws.com"
                },
                "player_params.ad_type": {
                "customized": "abc12345",
                "default": "defaultAdType"
                }
                }
                }
```

------

## 2단계: 세션 초기화에서 구성 별칭 사용
<a name="dynamic-domains-using-configuration-alias"></a>

구성 별칭을 설정한 후 세션 초기화 요청에서 도메인의 대체 변수로 사용할 수 있습니다. 이렇게 하면 세션의 도메인을 동적으로 구성할 수 있습니다.

**Example 기본 구성 별칭 예제**  
다음은 구성 별칭과 동적 도메인 변수를 포함하는 구성의 기본 예제입니다.  

```
PUT /playbackConfiguration
{
    "Name": "aliasedConfig",
    "AdDecisionServerUrl": "https://abc.execute-api.us-west-2.amazonaws.com/ads?sid=[session.id]&ad_type=[player_params.ad_type]",
    "VideoContentSourceUrl": "https://[player_params.origin_domain].mediapackage.[player_params.region].amazonaws.com/out/v1/[player_params.endpoint_id]",
    "ConfigurationAliases": {
        "player_params.origin_domain": {
            "pdx": "abc",
            "iad": "xyz"
        },
        "player_params.region": {
            "pdx": "us-west-2",
            "iad": "us-east-1"
        },
        "player_params.endpoint_id": {
            "pdx": "abcd",
            "iad": "wxyz"
        },
        "player_params.ad_type": {
            "customized": "abc12345",
            "default": "defaultAdType"
        }
    }
}
```

**Example 별칭을 사용한 세션 초기화**  
앞의 구성을 사용하면 플레이어 변수와 별칭을 사용한 세션 초기화 요청은 다음과 비슷합니다.  

```
POST index.m3u8
{
    "playerParams": {
        "origin_domain": "pdx",
        "region": "pdx",
        "endpoint_id": "pdx",
        "ad_type": "customized"
    }
}
```
MediaTailor는 별칭 문자열을 구성 별칭 구성의 매핑된 값으로 바꿉니다.  
ADS에 대한 요청은 다음과 같습니다.  

```
https://abc.execute-api.us-west-2.amazonaws.com/ads?sid=[session.id]&ad_type=abc12345
```
매니페스트의 오리진에 대한 요청은 다음과 같습니다.  

```
https://abc.mediapackage.us-west-2.amazonaws.com/out/v1/abcd
```