Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Erstellen und Verwenden von Konfigurationsaliasnamen mit MediaTailor
Bevor Sie mit der Verwendung von Domänenvariablen beginnen, erstellen Sie Konfigurationsaliase für Ihre Konfiguration. Sie verwenden die Konfigurationsaliase bei der Initialisierung der Sitzung als Variablen für den Domänenersatz.
**Einschränkungen**
Beachten Sie die folgenden Einschränkungen bei der Verwendung von Konfigurationsaliasen:
+ Alle in der Domain verwendeten dynamischen Variablen müssen als `ConfigurationAliases` dynamische Variable definiert werden.
+ Den Player-Parametervariablen muss ein Präfix vorangestellt werden. `player_params.` Beispiel, `player_params.origin_domain`.
+ Die Liste der Aliaswerte muss für Domänenvariablen in Critical URLs (`VideoContentSourceUrl`,,`AdSegmentUrlPrefix`) vollständig sein. `ContentSegmentUrlPrefix`
+ Wenn eine Anfrage für eine Domainvariable mit dem Status Critical gestellt wird URLs , die entweder die dynamische Variable nicht spezifiziert oder einen ungültigen Alias verwendet, schlägt die Anfrage mit einem `400` HTTP-Statuscode fehl. Bei unkritischen Feldern (`SlateAdUrl`,`TranscodeProfileName`, Bumper URLs) werden zwar Warnungen protokolliert, die Anfrage wird jedoch nicht fehlschlagen.
**Ausweichverhalten bei fehlenden Aliasen**
Wenn Konfigurationsaliase nicht gefunden werden oder ungültig sind, MediaTailor implementiert das folgende Fallback-Verhalten:
+ **Domain-Variablen:** Wenn ein Domainvariablen-Alias fehlt oder ungültig ist, schlägt die Anfrage mit dem HTTP 400-Statuscode fehl. Für alle Domänenvariablen müssen gültige Aliase definiert sein.
+ **Nicht-Domain-Variablen: Bei Variablen**, die in Teilen verwendet werden, die nicht zur Domäne gehören URLs (wie Pfadelemente oder Abfrageparameter), führen fehlende Aliase dazu, dass leere Zeichenketten ersetzt werden.
+ **Konfigurationsvalidierung:** MediaTailor Überprüft, ob alle erforderlichen Aliase bei der Erstellung und Aktualisierung der Konfiguration vorhanden sind.
## Schritt 1: Konfigurations-Aliase erstellen
Gehen Sie wie folgt vor, um Konfigurationsaliase für den Domainersatz mithilfe der MediaTailor Konsole zu erstellen.
------
#### [ Console ]
**So erstellen Sie Konfigurationsaliase mithilfe der Konsole**
1. Öffnen Sie die MediaTailor Konsole unter. [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/)
1. **Wählen Sie auf der **Konfigurationsseite im Abschnitt Konfigurationsaliase** die Option **Player-Parameter hinzufügen** aus.**
1. Geben Sie **unter Spielerparameter** den Namen des Spielerparameters ein, den Sie als dynamische Variable verwenden möchten. Beispiel, `player_params.origin_domain`.
1. Geben Sie **unter Aliase** die Aliase und ihre Werte ein, die Sie für den Player-Parameter verwenden möchten.
1. Wählen Sie **OK** aus.
AWS Elemental MediaTailor zeigt den neuen Parameter in der Tabelle im Abschnitt **Konfigurations-Aliase** an.
1. Wiederholen Sie die vorherigen Schritte, um weitere Player-Parameter hinzuzufügen.
1. Wählen Sie **Speichern**.
------
#### [ API ]
**Um Konfigurationsaliase mithilfe der API zu erstellen**
Wenn Sie eine MediaTailor Konfiguration erstellen oder aktualisieren, verwenden Sie den `ConfigurationAliases` Parameter mit der folgenden JSON-Struktur:
```
{
"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"
}
}
}
```
------
## Schritt 2: Verwenden Sie Konfigurationsaliase bei der Sitzungsinitialisierung
Nachdem Sie die Konfigurationsaliase eingerichtet haben, können Sie sie als Ersatzvariablen für Domänen in Ihrer Anfrage zur Sitzungsinitialisierung verwenden. Auf diese Weise können Sie die Domänen für Ihre Sitzung dynamisch konfigurieren.
**Example Beispiel für Aliase für die Grundkonfiguration**
Hier ist ein einfaches Beispiel für eine Konfiguration, die Konfigurationsaliase und dynamische Domänenvariablen umfasst:
```
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 Initialisierung der Sitzung mit Aliasen**
Bei Verwendung der vorherigen Konfiguration würde eine Anfrage zur Sitzungsinitialisierung unter Verwendung der Spielervariablen und Aliase etwa wie folgt aussehen:
```
POST index.m3u8
{
"playerParams": {
"origin_domain": "pdx",
"region": "pdx",
"endpoint_id": "pdx",
"ad_type": "customized"
}
}
```
MediaTailor ersetzt die Aliaszeichenfolgen durch die zugewiesenen Werte in der Konfiguration der Konfigurationsaliase.
Die Anfrage an das ADS wird wie folgt aussehen:
```
https://abc.execute-api.us-west-2.amazonaws.com/ads?sid=[session.id]&ad_type=abc12345
```
Die Anfrage an die Quelle für die Manifeste wird wie folgt aussehen:
```
https://abc.mediapackage.us-west-2.amazonaws.com/out/v1/abcd
```