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
<a name="parameter-troubleshooting"></a>

AWS Elemental MediaTailor bietet Anleitungen zur Behebung häufig auftretender parameterbezogener Probleme MediaTailor, einschließlich Zeicheneinschränkungen, URL-Codierungsproblemen und Konfigurationsaliasfehlern. 

## Fehler bei der Zeichenbeschränkung
<a name="parameter-character-restriction-errors"></a>

Parameterwerte, die nicht unterstützte Zeichen enthalten, 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 in Manifest-URLs nicht vorkommen
+ HTTP 400-Fehler bei der Sitzungsinitialisierung
+ Abgeschnittene oder beschädigte Parameterwerte
+ ADS-Anfragen schlagen aufgrund falsch formatierter URLs fehl

**Lösungsschritte**  
Um Fehler bei der Zeichenbeschränkung zu beheben: 

1. Überprüfen Sie die Parameterwerte auf nicht unterstützte Zeichen: `:``?`,,`&`,`=`, `%` `/`

1.  URL-encoding Bei Sonderzeichen richtig anwenden (siehe[MediaTailor Parameterreferenz und Einschränkungen](parameter-comprehensive-reference.md))

1. Vermeiden Sie Doppelzeichen wie `%%%` oder `==`

1. Ziehen Sie alternative Parameterformate in Betracht, wenn vollständige URLs nicht verwendet werden können

**Example Beispiel für eine URL-Codierung**  
Anstatt zu verwenden:   

```
manifest.redirect_url=https://example.com/path?param=value
```
Verwenden Sie URL-encoded das Format:   

```
manifest.redirect_url=https%3A%2F%2Fexample.com%2Fpath%3Fparam%3Dvalue
```

## Fehler bei der Längenbegrenzung
<a name="parameter-length-limitation-errors"></a>

Parameter, die die Längenbegrenzungen ü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 mit Längenbeschränkungen umzugehen: 

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 Daten mit Parameterreferenzen

## Fehler beim Konfigurations-Alias
<a name="parameter-configuration-alias-errors"></a>

Probleme mit dem Konfigurationsalias können zu HTTP 400-Fehlern oder unerwarteten Parameterwerten führen. 

**Häufige Fehler beim Konfigurations-Alias**  
Die folgenden Fehler treten häufig bei Konfigurationsaliasen auf: 
+ HTTP 400-Fehler: Fehlender oder ungültiger Aliaswert
+ Domänenvariablen werden nicht richtig aufgelöst
+ Player-Parameter werden nicht durch Aliaswerte ersetzt

**Checkliste zur Lösung**  
So beheben Sie Konfigurationsaliasfehler: 

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 Domain-Variablen in kritischen URLs vollständig ist (`VideoContentSourceUrl`,,`AdSegmentUrlPrefix`) `ContentSegmentUrlPrefix`

1. Vergewissern Sie sich, dass bei Anfragen zur Sitzungsinitialisierung gültige Aliaswerte angegeben sind

1. Überprüfen Sie die JSON-Struktur des Parameters ConfigurationAliases 

Eine ausführliche Anleitung zur Problembehandlung finden Sie unter[MediaTailor Leitfaden zur Fehlerbehebung bei Konfigurationsaliasen](configuration-aliases-troubleshooting.md).

**Example Validierung des 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 beim Ablauf der Parameterverarbeitung
<a name="parameter-processing-flow-issues"></a>

Wenn Sie den Ablauf der Parameterverarbeitung verstehen, können Sie Probleme mit der Parameterweiterleitung und -transformation beheben. 

**Reihenfolge der Parameterverarbeitung**  
MediaTailor verarbeitet Parameter in der folgenden Reihenfolge: 

1. Validierung der Parameter für die Sitzungsinitialisierung

1. Auflösung des Konfigurationsalias (falls zutreffend)

1. Parameterfilterung (ADS im Vergleich zum Ursprung im Vergleich zum Manifest)

1. URL-Kodierung und -Formatierung

1. Anwendung von Parametern auf URLs

**Parameterfluss debuggen**  
So debuggen Sie Probleme bei der Parameterverarbeitung: 

1. Stellen Sie sicher, dass die Parameter bei der Sitzungsinitialisierung korrekt angegeben wurden

1. Stellen Sie sicher, dass die Konfigurationsaliase die erwarteten Werte annehmen

1. Bestätigen Sie, dass die Parameter in den richtigen URLs (Manifest, ADS, Herkunft) angezeigt werden

1. Überprüfen Sie, ob 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 Aliasauflösung und -verarbeitung:   
+ Herkunft der Anfrage: `https://abc.mediapackage.us-west-2.amazonaws.com/out/v1/abcd`
+ URL des Manifests: `/v1/master/.../index.m3u8?aws.sessionId=session&test=123`

## Sicherheitsüberlegungen und bewährte Methoden
<a name="parameter-security-considerations-troubleshooting"></a>

MediaTailor implementiert Sicherheitsmaßnahmen für die Parameterbehandlung, um häufig auftretende Sicherheitsprobleme zu vermeiden. 

**Sicherheitsmaßnahmen**  
MediaTailor implementiert die folgenden Sicherheitsmaßnahmen: 

1. Beschränkungen der Eingabegröße, um ein Aufblähen der Datenbank zu verhindern

1. Richtige Kodierung und Bereinigung von Benutzereingaben

1. URL-encoding der Eingabe, um eine Beschädigung der Antwort zu verhindern

**Bewährte Methoden**  
Folgen Sie diesen bewährten Methoden für die sichere Parameterverarbeitung: 
+ Überprüfen Sie die Parameterwerte auf der Clientseite vor dem 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 ein