Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Creación y uso de alias de configuración con MediaTailor
<a name="creating-configuration-aliases"></a>

Antes de empezar a usar variables de dominio, debe crear alias de configuración para su configuración. Los alias de configuración se utilizan como variables de reemplazo del dominio en el momento de la inicialización de la sesión.

**Restricciones**  
Tenga en cuenta las siguientes restricciones al utilizar los alias de configuración:
+ Todas las variables dinámicas utilizadas en el dominio deben definirse como variables `ConfigurationAliases` dinámicas.
+ Las variables de los parámetros del reproductor deben ir precedidas de`player_params.`. Por ejemplo, `player_params.origin_domain`.
+ La lista de valores con alias debe ser exhaustiva para las variables de dominio críticas URLs (`VideoContentSourceUrl`,`AdSegmentUrlPrefix`,`ContentSegmentUrlPrefix`).
+ Si se realiza una solicitud para una variable de dominio crítica URLs que no especifica la variable dinámica o utiliza un alias no válido, la solicitud fallará con un código de `400` estado HTTP. Los campos no críticos (`SlateAdUrl`,`TranscodeProfileName`, bumper URLs) registrarán las advertencias pero no rechazarán la solicitud.

**Comportamiento alternativo para los alias faltantes**  
Cuando los alias de configuración no se encuentran o no son válidos, MediaTailor implementa el siguiente comportamiento alternativo:
+ **Variables de dominio:** si falta un alias de variable de dominio o no es válido, la solicitud falla con el código de estado HTTP 400. Todas las variables de dominio deben tener definidos alias válidos.
+ **Variables que no son de dominio:** en el caso de las variables que se utilizan en partes que no son de dominio URLs (como los elementos de ruta o los parámetros de consulta), si faltan alias, se reemplaza una cadena vacía.
+ **Validación de la configuración:** MediaTailor valida que todos los alias necesarios estén presentes durante las operaciones de creación y actualización de la configuración.

## Paso 1: Crear alias de configuración
<a name="dynamic-domains-creating-configuration-alias"></a>

Para crear alias de configuración para utilizarlos en la sustitución de dominios mediante la MediaTailor consola, lleve a cabo el siguiente procedimiento.

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

**Para crear alias de configuración mediante la consola**

1. Abra la MediaTailor consola en. [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/)

1. En la sección **Alias de configuración** de la página de **configuraciones**, selecciona **Añadir parámetro de reproductor**. 

1. En **Parámetro del reproductor**, introduzca el nombre del parámetro del reproductor que desee utilizar como variable dinámica. Por ejemplo, `player_params.origin_domain`. 

1. En el caso de los **alias**, introduzca los alias y sus valores que desee utilizar para el parámetro del reproductor. 

1. Seleccione **Aceptar**. 

   AWS Elemental MediaTailor muestra el nuevo parámetro en la tabla de la sección **Alias de configuración**.

1. Repita los pasos anteriores para añadir más parámetros del reproductor. 

1. Seleccione **Save**. 

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

**Para crear alias de configuración mediante la API**  
Al crear o actualizar una MediaTailor configuración, utilice el `ConfigurationAliases` parámetro con la siguiente estructura JSON: 

```
{
                "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"
                }
                }
                }
```

------

## Paso 2: Utilice los alias de configuración en la inicialización de la sesión
<a name="dynamic-domains-using-configuration-alias"></a>

Después de configurar los alias de configuración, puede usarlos como variables de reemplazo para los dominios de su solicitud de inicialización de sesión. Esto le permite configurar dinámicamente los dominios de la sesión.

**Example Ejemplo de alias de configuración básica**  
Este es un ejemplo básico de una configuración que incluye alias de configuración y variables de dominio dinámicas:  

```
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 Inicialización de la sesión con alias**  
Con la configuración anterior, una solicitud de inicialización de sesión que utilice las variables y los alias del reproductor tendría un aspecto similar al siguiente:  

```
POST index.m3u8
{
    "playerParams": {
        "origin_domain": "pdx",
        "region": "pdx",
        "endpoint_id": "pdx",
        "ad_type": "customized"
    }
}
```
MediaTailor reemplaza las cadenas de alias por los valores mapeados en la configuración de los alias de configuración.  
La solicitud al ADS tendrá el siguiente aspecto:  

```
https://abc.execute-api.us-west-2.amazonaws.com/ads?sid=[session.id]&ad_type=abc12345
```
La solicitud de los manifiestos al origen tendrá el siguiente aspecto:  

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