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 Leitfaden zur Fehlerbehebung bei Parametern
AWS Elemental MediaTailor bietet Anleitungen zur Behebung häufiger Probleme im Zusammenhang mit Parametern MediaTailor, einschließlich Zeichenbeschränkungen, Problemen mit der URL-Kodierung und Fehlern bei Konfigurationsalias.
## Fehler bei der Zeichenbeschränkung
Parameterwerte, die Zeichen enthalten, die nicht unterstützt werden, können zu Fehlern oder unerwartetem Verhalten führen.
**Häufige Symptome**
Die folgenden Symptome können auf Probleme mit der Zeichenbeschränkung hinweisen:
+ Parameter, die nicht im Manifest vorkommen URLs
+ HTTP 400-Fehler bei der Sitzungsinitialisierung
+ Verkürzte oder beschädigte Parameterwerte
+ ADS-Anfragen schlagen aufgrund eines fehlerhaften Formats fehl URLs
**Lösungsschritte**
So beheben Sie Fehler bei der Zeichenbeschränkung:
1. Überprüfen Sie die Parameterwerte für nicht unterstützte Zeichen: `:``?`,,`&`,`=`, `%` `/`
1. Wenden Sie die richtige URL-Kodierung für Sonderzeichen an (siehe) [MediaTailor Parameterreferenz und Einschränkungen](parameter-comprehensive-reference.md)
1. Vermeiden Sie Doppelzeichen wie oder `%%%` `==`
1. Ziehen Sie alternative Parameterformate in Betracht, wenn full URLs nicht verwendet werden kann
**Example Beispiel für die URL-Codierung**
Anstatt zu verwenden:
```
manifest.redirect_url=https://example.com/path?param=value
```
Verwenden Sie das URL-kodierte Format:
```
manifest.redirect_url=https%3A%2F%2Fexample.com%2Fpath%3Fparam%3Dvalue
```
## Fehler bei der Längenbegrenzung
Parameter, die Längenbeschränkungen überschreiten, können gekürzt werden oder Fehler verursachen.
**Längenbeschränkungen**
Es gelten die folgenden Längenbeschränkungen (vollständige [MediaTailor Parameterreferenz und Einschränkungen](parameter-comprehensive-reference.md) Informationen finden Sie unter):
+ Manifest-Abfrageparameter (insgesamt): 2000 Zeichen
+ ADS-Parameternamen: 10.000 Zeichen
+ ADS-Parameterwerte: 25.000 Zeichen
+ ADS URLs: 25.000 Zeichen
**Lösungsstrategien**
Um Längenbeschränkungen zu handhaben:
1. Verwenden Sie nach Möglichkeit kürzere Parameternamen und -werte
1. Teilen Sie große Parameterwerte in mehrere kleinere Parameter auf
1. Verwenden Sie Konfigurationsaliase, um kurze Aliase längeren Werten zuzuordnen (siehe) [MediaTailor Übersicht über Konfigurationsaliase](configuration-aliases-overview.md)
1. Erwägen Sie die Verwendung eines externen Speichers für große Datenmengen mit Parameterreferenzen
## Alias-Fehler bei der Konfiguration
Probleme mit Konfigurationsalias können zu HTTP 400-Fehlern oder unerwarteten Parameterwerten führen.
**Häufige Fehler bei Konfigurations-Alias**
Die folgenden Fehler treten häufig bei Konfigurationsaliasnamen auf:
+ HTTP 400-Fehler: Fehlender oder ungültiger Aliaswert
+ Domänenvariablen werden nicht korrekt aufgelöst
+ Player-Parameter werden nicht durch Aliaswerte ersetzt
**Checkliste für die Lösung**
So beheben Sie Fehler bei Konfigurations-Alias:
1. Stellen Sie sicher, dass alle Domänenvariablen definiert sind als `ConfigurationAliases`
1. Stellen Sie sicher, dass Player-Parametervariablen ein `player_params.` Präfix
1. Vergewissern Sie sich, dass die Liste der Aliaswerte für Domänenvariablen im kritischen Bereich URLs (`VideoContentSourceUrl`,,`AdSegmentUrlPrefix`) vollständig ist `ContentSegmentUrlPrefix`
1. Vergewissern Sie sich, dass Anfragen zur Sitzungsinitialisierung gültige Aliaswerte angeben
1. Überprüfen Sie die JSON-Struktur des Parameters ConfigurationAliases
Eine ausführliche Anleitung zur Fehlerbehebung finden Sie unter[MediaTailor Leitfaden zur Fehlerbehebung bei Konfigurationsaliasen](configuration-aliases-troubleshooting.md).
**Example Validierung von Konfigurations-Alias**
Stellen Sie sicher, dass Ihre Konfiguration alle erforderlichen Aliase enthält:
```
"ConfigurationAliases": {
"player_params.origin_domain": {
"pdx": "abc.mediapackage.us-west-2.amazonaws.com",
"iad": "xyz.mediapackage.us-east-1.amazonaws.com"
// Must include all possible values used in session initialization
}
}
```
## Probleme mit dem Ablauf der Parameterverarbeitung
Wenn Sie den Ablauf der Parameterverarbeitung verstehen, können Sie Probleme bei der Parameterweiterleitung und -transformation beheben.
**Reihenfolge der Parameterverarbeitung**
MediaTailor verarbeitet Parameter in der folgenden Reihenfolge:
1. Überprüfung der Parameter für die Initialisierung der Sitzung
1. Auflösung des Konfigurationsalias (falls zutreffend)
1. Parameterfilterung (ADS im Vergleich zu Origin und Manifest)
1. URL-Kodierung und -Formatierung
1. Parameteranwendung auf URLs
**Debuggen des Parameterflusses**
So debuggen Sie Probleme mit der Parameterverarbeitung:
1. Stellen Sie sicher, dass die Parameter bei der Sitzungsinitialisierung korrekt angegeben wurden
1. Stellen Sie sicher, dass die Konfigurationsaliase zu den erwarteten Werten aufgelöst werden
1. Vergewissern Sie sich, dass die Parameter korrekt angezeigt werden URLs (Manifest, ADS, Origin)
1. Stellen Sie sicher, dass die URL-Codierung korrekt angewendet wurde
**Example Beispiel für einen Parameterfluss**
Initialisierung der Sitzung:
```
POST master.m3u8
{
"playerParams": {"origin_domain": "pdx"},
"manifestParams": {"test": "123"}
}
```
Nach der Auflösung und Verarbeitung des Alias:
+ Herkunft der Anfrage: `https://abc.mediapackage.us-west-2.amazonaws.com/out/v1/abcd`
+ Manifest-URL: `/v1/master/.../index.m3u8?aws.sessionId=session&test=123`
## Sicherheitsüberlegungen und bewährte Methoden
MediaTailor implementiert Sicherheitsmaßnahmen für die Parameterbehandlung, um allgemeine Sicherheitsprobleme zu vermeiden.
**Sicherheitsmaßnahmen**
MediaTailor implementiert die folgenden Sicherheitsmaßnahmen:
1. Beschränkungen der Eingabegröße, um eine Überlastung der Datenbank zu verhindern
1. Richtige Kodierung und Bereinigung von Benutzereingaben
1. URL-Kodierung der Eingabe, um eine Beschädigung der Antwort zu verhindern
**Best Practices**
Folgen Sie diesen bewährten Methoden für die sichere Handhabung von Parametern:
+ Überprüfen Sie die Parameterwerte auf der Clientseite, bevor Sie sie senden
+ Verwenden Sie Konfigurationsaliase, um mögliche Parameterwerte einzuschränken
+ Vermeiden Sie es, vertrauliche Informationen in Parameter aufzunehmen
+ Überwachen Sie die Verwendung von Parametern auf ungewöhnliche Muster
+ Halten Sie die Parameterwerte innerhalb der empfohlenen Längengrenzen