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.
# MediaTailor Übersicht über Konfigurationsaliase
AWS Elemental MediaTailor Konfigurationsaliase ermöglichen den dynamischen Variablenersatz in URL-Domänen und anderen unterstützten Feldern. Verwenden Sie diese Funktion, um mehrere Domänen zu verwenden und sie URLs während der Sitzungsinitialisierung dynamisch zu konfigurieren.
## Anwendungsfälle
Konfigurationsaliase ermöglichen ausgeklügelte Architekturen mit mehreren Konfigurationen für die folgenden Szenarien:
+ **Geografisches Routing: Leitet** Anfragen anhand des Standorts des Betrachters mithilfe von regionsspezifischen Aliasnamen an unterschiedliche Herkunfts- oder Werbeserver weiter. [Anleitungen zur Implementierung finden CloudFront Sie unter Origin Failover.](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/high_availability_origin_failover.html)
+ **Inhaltsbasiertes Routing: Leitet** verschiedene Inhaltstypen an spezielle Quellen oder Verarbeitungspipelines weiter. Informationen zur Konfiguration des Routing-Verhaltens finden Sie unter. [Richten Sie das CDN-Routing-Verhalten ein für MediaTailor](cdn-routing-behaviors.md)
+ **Failover-Szenarien:** Implementieren Sie Backup-Origins und Ad-Server mit automatischem Failover mithilfe von Alias-Switching. Eine ausführliche Implementierung finden Sie unter [Implementieren Sie Resilienz für mehrere Regionen MediaTailor mit MQAR](media-quality-resiliency.md) und. [Planen Sie Ihre CDN-Integration für AWS Elemental MediaTailor](planning-cdn-integration.md)
+ **A/B-Tests: Testen** Sie verschiedene Werbeserver, Ursprünge oder Konfigurationen, indem Sie den Traffic auf der Grundlage der Player-Parameter weiterleiten. Anleitungen zu Belastungstests finden Sie unter [Vorbereiten und Ausführen von Leistungstests für Amazon CloudFront mit echter Benutzerüberwachung](https://aws.amazon.com/blogs/networking-and-content-delivery/prepare-and-run-performance-tests-for-amazon-cloudfront-with-real-user-monitoring/).
+ **Gerätespezifische Optimierung:** Optimieren Sie die Bereitstellung von Inhalten und die Anzeigenschaltung für verschiedene Gerätetypen oder Funktionen. Umfassende Anleitungen finden Sie unter. [Richten Sie die Manifestfilterung mit MediaTailor MediaPackage, und CDN ein](cdn-emp-manifest-filtering.md)
+ **Lastenausgleich:** Verteilen Sie die Last mithilfe von dynamischem Routing auf mehrere Origins oder Ad-Server. Anleitungen zur Implementierung finden Sie unter [Implementieren Sie Resilienz für mehrere Regionen MediaTailor mit MQAR](media-quality-resiliency.md) und[Planen Sie Ihre CDN-Integration für AWS Elemental MediaTailor](planning-cdn-integration.md).
## Unterstützte Felder
Sie können dynamische Variablen in den folgenden Konfigurationsfeldern verwenden:
+ `VideoContentSourceUrl`
+ `AdDecisionServerUrl`
+ `LivePreroll.AdDecisionServerUrl`
+ `AdSegmentUrlPrefix`
+ `ContentSegmentUrlPrefix`
+ `TranscodeProfileName`
+ `SlateAdUrl`
+ `StartUrl`
+ `EndUrl`
In den folgenden Abschnitten wird beschrieben, wie Konfigurationsaliase verwendet werden.
**Topics**
+ [Anwendungsfälle](#configuration-aliases-use-cases)
+ [Unterstützte Felder](#configuration-aliases-supported)
+ [Erstellen und Verwenden](creating-configuration-aliases.md)
+ [Beispiel für einen Ablauf](configuration-aliases-examples.md)
# 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
```
# Konfigurations-Alias mit MediaTailor Anwendungsbeispiel
Die folgenden Beispiele zeigen, wie eine vollständige MediaTailor Konfiguration mit Konfigurationsaliasen, eine Anfrage zur Sitzungsinitialisierung mit Aliasen und der Verarbeitungsablauf für Aliase aussehen.
**Example Vollständige Konfiguration mit Aliasen**
Das folgende Beispiel zeigt eine vollständige 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]",
"AdSegmentUrlPrefix": "https://[player_params.ad_cdn_domain]/ads/",
"ContentSegmentUrlPrefix": "https://[player_params.content_cdn_domain]/content/",
"TranscodeProfileName": "[player_params.transcode_profile]",
"SlateAdUrl": "https://[player_params.slate_domain]/slate/[player_params.slate_type].mp4",
"StartUrl": "https://[player_params.tracking_domain]/start?session=[session.id]",
"EndUrl": "https://[player_params.tracking_domain]/end?session=[session.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"
},
"player_params.ad_cdn_domain": {
"pdx": "ads-west.cdn.example.com",
"iad": "ads-east.cdn.example.com"
},
"player_params.content_cdn_domain": {
"pdx": "content-west.cdn.example.com",
"iad": "content-east.cdn.example.com"
},
"player_params.transcode_profile": {
"mobile": "mobile_optimized",
"desktop": "high_quality",
"tv": "4k_profile"
},
"player_params.slate_domain": {
"pdx": "slate-west.example.com",
"iad": "slate-east.example.com"
},
"player_params.slate_type": {
"standard": "default_slate",
"branded": "brand_slate"
},
"player_params.tracking_domain": {
"pdx": "tracking-west.example.com",
"iad": "tracking-east.example.com"
}
}
}
```
**Example Initialisierung der Sitzung mit Aliasen**
Das folgende Beispiel zeigt eine Anfrage zur Sitzungsinitialisierung, in der die Spielervariablen und Aliase angegeben werden:
```
POST master.m3u8
{
"playerParams": {
"origin_domain": "pdx",
"region": "pdx",
"endpoint_id": "pdx",
"ad_type": "customized",
"ad_cdn_domain": "pdx",
"content_cdn_domain": "pdx",
"transcode_profile": "mobile",
"slate_domain": "pdx",
"slate_type": "branded",
"tracking_domain": "pdx"
}
}
```
**Example Ablauf der Parameterverarbeitung**
Im folgenden Beispiel werden die Aliaszeichenfolgen MediaTailor durch die zugewiesenen Werte in den Konfigurationsaliasnamen ersetzt. Die Verarbeitung führt zu den folgenden Anfragen:
+ ADS-Anfrage:
```
https://abc.execute-api.us-west-2.amazonaws.com/ads?sid=[session.id]&ad_type=abc12345
```
+ VideoContentSource Anfrage:
```
https://abc.mediapackage.us-west-2.amazonaws.com/out/v1/abcd
```
+ AdSegmentUrlPrefix:
```
https://ads-west.cdn.example.com/ads/
```
+ ContentSegmentUrlPrefix:
```
https://content-west.cdn.example.com/content/
```
+ TranscodeProfileName:
```
mobile_optimized
```
+ SlateAdUrl:
```
https://slate-west.example.com/slate/brand_slate.mp4
```
+ StartUrl:
```
https://tracking-west.example.com/start?session=[session.id]
```
+ EndUrl:
```
https://tracking-west.example.com/end?session=[session.id]
```