翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# MediaTailor での設定エイリアスの作成と使用
<a name="creating-configuration-aliases"></a>

ドメイン変数の使用を開始する前に、設定のための設定エイリアスを作成します。設定エイリアスは、セッション開始時のドメイン置換変数として使用します。

**制限事項**  
設定エイリアスの使用時は、以下の制限に注意してください。
+ ドメインで使用される動的変数は、すべて `ConfigurationAliases` 動的変数として定義される必要があります。
+ プレイヤーパラメータ変数の前に `player_params.` を付ける必要があります。例えば、`player_params.origin_domain` などです。
+ エイリアスされた値のリストは、重要な URLs のドメイン変数 (`VideoContentSourceUrl`、`AdSegmentUrlPrefix`、) に対して包括的である必要があります`ContentSegmentUrlPrefix`。
+ 動的変数を指定しないか、無効なエイリアスを使用する重要な URLs のドメイン変数に対してリクエストが行われた場合、リクエストは HTTP `400`ステータスコードで失敗します。重要でないフィールド (`SlateAdUrl`、、バンパー URLs) は警告をログに記録しますが`TranscodeProfileName`、リクエストは失敗しません。

**欠落しているエイリアスのフォールバック動作**  
設定エイリアスが見つからないか無効である場合、MediaTailor は次のフォールバック動作を実装します。
+ **ドメイン変数:** ドメイン変数エイリアスがないか無効の場合、リクエストは HTTP 400 ステータスコードで失敗します。すべてのドメイン変数には、有効なエイリアスが定義されている必要があります。
+ **非ドメイン変数:** URLs の非ドメイン部分 (パス要素やクエリパラメータなど) で使用される変数の場合、エイリアスがないと空の文字列置換になります。
+ **設定の検証:** MediaTailor は、設定の作成および更新オペレーション中にすべての必要なエイリアスが存在することを検証します。

## ステップ 1: 設定エイリアスを作成する
<a name="dynamic-domains-creating-configuration-alias"></a>

MediaTailor コンソールを使用してドメイン置換に使用する設定エイリアスを作成するには、以下の手順を実行します。

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

**コンソールを使用して設定エイリアスを作成する**

1. MediaTailor コンソール ([https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/)) を開きます。

1. **[Configurations]** (設定) ページの **[Configuration aliases]** (設定エイリアス) ページで、**[Add player parameter]** (プレイヤーパラメータを追加) をクリックします。

1. **Player パラメータ**には、動的変数として使用するプレイヤーパラメータの名前を入力します。例えば、`player_params.origin_domain`。

1. **エイリアス**には、プレイヤーパラメータに使用するエイリアスとその値を入力します。

1. [**OK**] を選択してください。

   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
```