Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Création et utilisation d'alias de configuration avec MediaTailor
Avant de commencer à utiliser des variables de domaine, vous devez créer des alias de configuration pour votre configuration. Vous utilisez les alias de configuration comme variables de remplacement de domaine au moment de l'initialisation de la session.
**Restrictions**
Notez les restrictions suivantes lorsque vous utilisez des alias de configuration :
+ Toutes les variables dynamiques utilisées dans le domaine doivent être définies en tant que variables `ConfigurationAliases` dynamiques.
+ Les variables des paramètres du joueur doivent être préfixées par`player_params.`. Par exemple, `player_params.origin_domain`.
+ La liste des valeurs aliasées doit être exhaustive pour les variables de domaine dans critical URLs (`VideoContentSourceUrl`,`AdSegmentUrlPrefix`,`ContentSegmentUrlPrefix`).
+ Si une demande est faite pour une variable de domaine critique URLs qui ne spécifie pas la variable dynamique ou utilise un alias non valide, la demande échouera avec un code d'`400`état HTTP. Les champs non critiques (`SlateAdUrl`,`TranscodeProfileName`, bumper URLs) enregistreront les avertissements mais ne feront pas échouer la demande.
**Comportement de secours en cas d'alias manquants**
Lorsque les alias de configuration sont introuvables ou ne sont pas valides, MediaTailor implémente le comportement de secours suivant :
+ **Variables de domaine :** si un alias de variable de domaine est manquant ou non valide, la demande échoue avec le code d'état HTTP 400. Des alias valides doivent être définis pour toutes les variables de domaine.
+ **Variables non liées au domaine :** pour les variables utilisées dans des parties non liées au domaine de URLs (telles que les éléments de chemin ou les paramètres de requête), les alias manquants entraînent le remplacement de chaînes vides.
+ **Validation de la configuration :** MediaTailor vérifie que tous les alias requis sont présents lors des opérations de création et de mise à jour de la configuration.
## Étape 1 : créer des alias de configuration
Pour créer des alias de configuration à utiliser pour le remplacement de domaines à l'aide de la MediaTailor console, effectuez la procédure suivante.
------
#### [ Console ]
**Pour créer des alias de configuration à l'aide de la console**
1. Ouvrez la MediaTailor console à l'adresse [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).
1. Dans la section **Alias de configuration** de la page **Configurations**, choisissez **Ajouter un paramètre de joueur**.
1. Dans **Paramètre du joueur**, entrez le nom du paramètre du joueur que vous souhaitez utiliser comme variable dynamique. Par exemple, `player_params.origin_domain`.
1. **Dans Alias**, entrez les alias et leurs valeurs que vous souhaitez utiliser pour le paramètre du joueur.
1. Choisissez **OK**.
AWS Elemental MediaTailor affiche le nouveau paramètre dans le tableau de la section **Alias de configuration**.
1. Répétez les étapes précédentes pour ajouter d'autres paramètres au joueur.
1. Choisissez **Enregistrer**.
------
#### [ API ]
**Pour créer des alias de configuration à l'aide de l'API**
Lorsque vous créez ou mettez à jour une MediaTailor configuration, utilisez le `ConfigurationAliases` paramètre avec la structure JSON suivante :
```
{
"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"
}
}
}
```
------
## Étape 2 : Utiliser des alias de configuration lors de l'initialisation de session
Après avoir configuré les alias de configuration, vous pouvez les utiliser comme variables de remplacement pour les domaines dans votre demande d'initialisation de session. Cela vous permet de configurer dynamiquement les domaines de votre session.
**Example Exemple d'alias de configuration de base**
Voici un exemple de configuration de base qui inclut des alias de configuration et des variables de domaine dynamiques :
```
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 Initialisation de session avec des alias**
En utilisant la configuration précédente, une demande d'initialisation de session utilisant les variables et les alias du lecteur ressemblerait à ce qui suit :
```
POST index.m3u8
{
"playerParams": {
"origin_domain": "pdx",
"region": "pdx",
"endpoint_id": "pdx",
"ad_type": "customized"
}
}
```
MediaTailor remplace les chaînes d'alias par les valeurs mappées dans la configuration des alias de configuration.
La demande adressée à l'ADS ressemblera à ce qui suit :
```
https://abc.execute-api.us-west-2.amazonaws.com/ads?sid=[session.id]&ad_type=abc12345
```
La demande adressée à l'origine pour les manifestes ressemblera à ce qui suit :
```
https://abc.mediapackage.us-west-2.amazonaws.com/out/v1/abcd
```