本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 创建和使用配置别名 MediaTailor
<a name="creating-configuration-aliases"></a>

在开始使用域变量之前，需要为配置创建配置别名。在会话初始化时，您可以使用配置别名作为域替换变量。

**限制**  
使用配置别名时，请注意以下限制：
+ 域中使用的所有动态变量都必须定义为`ConfigurationAliases`动态变量。
+ 玩家参数变量前缀必须为。`player_params.`例如 `player_params.origin_domain`。
+ 对于处于临界状态 URLs (,,`ContentSegmentUrlPrefix`) 的域变量`VideoContentSourceUrl`，`AdSegmentUrlPrefix`别名值列表必须详尽无遗。
+ 如果请求的关键 URLs 域变量未指定动态变量或使用无效别名，则请求将失败，并显示 HTTP `400` 状态码。非关键字段（`SlateAdUrl`、`TranscodeProfileName`、bump URLs er）将记录警告，但不会使请求失败。

**缺少别名的后备行为**  
当找不到配置别名或配置别名无效时，将 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. **在**配置页面的配置别名**部分，选择**添加玩家参数**。**

1. 在 P **layer 参数**中，输入要用作动态变量的玩家参数的名称。例如 `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
```