Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Creazione e utilizzo di alias di configurazione con MediaTailor
Prima di iniziare a utilizzare le variabili di dominio, create alias di configurazione per la configurazione. Gli alias di configurazione vengono utilizzati come variabili sostitutive del dominio al momento dell'inizializzazione della sessione.
**Restrizioni**
Tieni presente le seguenti restrizioni quando usi gli alias di configurazione:
+ Tutte le variabili dinamiche utilizzate nel dominio devono essere definite come variabili `ConfigurationAliases` dinamiche.
+ Le variabili dei parametri del giocatore devono avere il prefisso. `player_params.` Ad esempio, `player_params.origin_domain`.
+ L'elenco dei valori con alias deve essere esaustivo per le variabili di dominio in modalità critica URLs (`VideoContentSourceUrl`,,`AdSegmentUrlPrefix`). `ContentSegmentUrlPrefix`
+ Se viene effettuata una richiesta per una variabile di dominio in modalità critica URLs che non specifica la variabile dinamica o utilizza un alias non valido, la richiesta avrà esito negativo con un codice di stato HTTP. `400` I campi non critici (`SlateAdUrl`,`TranscodeProfileName`, bumper URLs) registreranno gli avvisi ma non falliranno la richiesta.
**Comportamento di riserva per gli alias mancanti**
Quando gli alias di configurazione non vengono trovati o non sono validi, MediaTailor implementa il seguente comportamento di fallback:
+ **Variabili di dominio:** se un alias di variabile di dominio è mancante o non valido, la richiesta ha esito negativo con il codice di stato HTTP 400. Tutte le variabili di dominio devono avere alias validi definiti.
+ **Variabili non di dominio:** per le variabili utilizzate in parti non di dominio URLs (come elementi di percorso o parametri di query), gli alias mancanti comportano la sostituzione di stringhe vuote.
+ **Convalida della configurazione:** MediaTailor verifica che tutti gli alias richiesti siano presenti durante le operazioni di creazione e aggiornamento della configurazione.
## Fase 1: Creare alias di configurazione
Per creare alias di configurazione da utilizzare per la sostituzione del dominio tramite la MediaTailor console, eseguire la procedura seguente.
------
#### [ Console ]
**Per creare alias di configurazione utilizzando la console**
1. Apri la MediaTailor console all'indirizzo [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).
1. Nella sezione **Alias di configurazione** della pagina **Configurazioni**, scegli **Aggiungi parametro giocatore**.
1. Per **Parametro Player**, inserisci il nome del parametro player che desideri utilizzare come variabile dinamica. Ad esempio, `player_params.origin_domain`.
1. Per **Alias**, inserisci gli alias e i relativi valori che desideri utilizzare per il parametro player.
1. Scegli **OK**.
AWS Elemental MediaTailor visualizza il nuovo parametro nella tabella della sezione **Alias di configurazione**.
1. Ripeti i passaggi precedenti per aggiungere altri parametri del giocatore.
1. Scegli **Save** (Salva).
------
#### [ API ]
**Per creare alias di configurazione utilizzando l'API**
Quando crei o aggiorni una MediaTailor configurazione, utilizza il `ConfigurationAliases` parametro con la seguente struttura 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"
}
}
}
```
------
## Passaggio 2: utilizzare gli alias di configurazione nell'inizializzazione della sessione
Dopo aver impostato gli alias di configurazione, è possibile utilizzarli come variabili sostitutive per i domini nella richiesta di inizializzazione della sessione. Ciò consente di configurare dinamicamente i domini per la sessione.
**Example Esempio di alias di configurazione di base**
Ecco un esempio di base di configurazione che include alias di configurazione e variabili di dominio dinamiche:
```
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 Inizializzazione della sessione con alias**
Utilizzando la configurazione precedente, una richiesta di inizializzazione della sessione che utilizza le variabili e gli alias del player sarebbe simile alla seguente:
```
POST index.m3u8
{
"playerParams": {
"origin_domain": "pdx",
"region": "pdx",
"endpoint_id": "pdx",
"ad_type": "customized"
}
}
```
MediaTailor sostituisce le stringhe di alias con i valori mappati nella configurazione degli alias di configurazione.
La richiesta all'ADS sarà simile alla seguente:
```
https://abc.execute-api.us-west-2.amazonaws.com/ads?sid=[session.id]&ad_type=abc12345
```
La richiesta all'origine dei manifesti sarà simile alla seguente:
```
https://abc.mediapackage.us-west-2.amazonaws.com/out/v1/abcd
```