Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# MediaTailor panduan pemecahan masalah parameter
<a name="parameter-troubleshooting"></a>

AWS Elemental MediaTailor memberikan panduan untuk memecahkan masalah umum terkait parameter di MediaTailor, termasuk pembatasan karakter, masalah pengkodean URL, dan kesalahan alias konfigurasi. 

## Kesalahan pembatasan karakter
<a name="parameter-character-restriction-errors"></a>

Nilai parameter yang berisi karakter yang tidak didukung dapat menyebabkan kesalahan atau perilaku tak terduga. 

**Gejala umum**  
Gejala-gejala berikut mungkin menunjukkan masalah pembatasan karakter: 
+ Parameter tidak muncul di URL manifes
+ Kesalahan HTTP 400 selama inisialisasi sesi
+ Nilai parameter terpotong atau rusak
+ Permintaan ADS gagal karena URL yang salah format

**Langkah-langkah resolusi**  
Untuk mengatasi kesalahan pembatasan karakter: 

1. Tinjau nilai parameter untuk karakter yang tidak didukung:`:`,`?`,,`&`,`=`, `%` `/`

1. Terapkan yang tepat URL-encoding untuk karakter khusus (lihat[MediaTailor referensi parameter dan batasan](parameter-comprehensive-reference.md))

1. Hindari karakter ganda seperti `%%%` atau `==`

1. Pertimbangkan format parameter alternatif jika URL lengkap tidak dapat digunakan

**Example Contoh pengkodean URL**  
Alih-alih menggunakan:   

```
manifest.redirect_url=https://example.com/path?param=value
```
Gunakan URL-encoded format:   

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

## Kesalahan batasan panjang
<a name="parameter-length-limitation-errors"></a>

Parameter yang melebihi batas panjang dapat terpotong atau menyebabkan kesalahan. 

**Batas panjang**  
Batas panjang berikut berlaku (lihat [MediaTailor referensi parameter dan batasan](parameter-comprehensive-reference.md) untuk detail lengkapnya):
+ Parameter kueri manifes (total): 2000 karakter
+ Nama parameter ADS: 10.000 karakter
+ Nilai parameter ADS: 25.000 karakter
+ URL ADS: 25.000 karakter

**Strategi resolusi**  
Untuk menangani batasan panjang: 

1. Gunakan nama dan nilai parameter yang lebih pendek jika memungkinkan

1. Pisahkan nilai parameter besar menjadi beberapa parameter yang lebih kecil

1. Gunakan alias konfigurasi untuk memetakan alias pendek ke nilai yang lebih panjang (lihat) [MediaTailor ikhtisar alias konfigurasi](configuration-aliases-overview.md)

1. Pertimbangkan untuk menggunakan penyimpanan eksternal untuk data besar dengan referensi parameter

## Kesalahan alias konfigurasi
<a name="parameter-configuration-alias-errors"></a>

Masalah alias konfigurasi dapat mengakibatkan kesalahan HTTP 400 atau nilai parameter yang tidak terduga. 

**Kesalahan alias konfigurasi umum**  
Kesalahan berikut biasanya terjadi dengan alias konfigurasi: 
+ Kesalahan HTTP 400: Nilai alias hilang atau tidak valid
+ Variabel domain tidak diselesaikan dengan benar
+ Parameter pemain tidak diganti dengan nilai alias

**Daftar periksa resolusi**  
Untuk mengatasi kesalahan alias konfigurasi: 

1. Verifikasi semua variabel domain didefinisikan sebagai `ConfigurationAliases`

1. Pastikan variabel parameter pemain menggunakan `player_params.` awalan

1. Konfirmasikan daftar nilai alias lengkap untuk variabel domain di URL penting (`VideoContentSourceUrl`,`AdSegmentUrlPrefix`,`ContentSegmentUrlPrefix`)

1. Periksa apakah permintaan inisialisasi sesi menentukan nilai alias yang valid

1. Validasi struktur ConfigurationAliases parameter JSON

Untuk panduan pemecahan masalah terperinci, lihat[MediaTailor panduan pemecahan masalah alias konfigurasi](configuration-aliases-troubleshooting.md).

**Example Validasi alias konfigurasi**  
Pastikan konfigurasi Anda mencakup semua alias yang diperlukan:   

```
"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
    }
}
```

## Masalah aliran pemrosesan parameter
<a name="parameter-processing-flow-issues"></a>

Memahami alur pemrosesan parameter membantu memecahkan masalah dengan penerusan dan transformasi parameter. 

**Urutan pemrosesan parameter**  
MediaTailor memproses parameter dalam urutan sebagai berikut: 

1. Validasi parameter inisialisasi sesi

1. Resolusi alias konfigurasi (jika berlaku)

1. Pemfilteran parameter (ADS vs asal vs manifes)

1. Pengkodean dan pemformatan URL

1. Aplikasi parameter ke URL

**Aliran parameter debugging**  
Untuk men-debug masalah pemrosesan parameter: 

1. Verifikasi parameter ditentukan dengan benar dalam inisialisasi sesi

1. Periksa apakah alias konfigurasi diselesaikan dengan nilai yang diharapkan

1. Parameter konfirmasi muncul di URL yang benar (manifes, ADS, asal)

1. Validasi pengkodean URL diterapkan dengan benar

**Example Contoh aliran parameter**  
Inisialisasi sesi:   

```
POST master.m3u8
{
    "playerParams": {"origin_domain": "pdx"},
    "manifestParams": {"test": "123"}
}
```
Setelah resolusi dan pemrosesan alias:   
+ Permintaan asal: `https://abc.mediapackage.us-west-2.amazonaws.com/out/v1/abcd`
+ URL Manifes: `/v1/master/.../index.m3u8?aws.sessionId=session&test=123`

## Pertimbangan keamanan dan praktik terbaik
<a name="parameter-security-considerations-troubleshooting"></a>

MediaTailor menerapkan langkah-langkah keamanan untuk penanganan parameter untuk mencegah masalah keamanan umum. 

**Langkah-langkah keamanan**  
MediaTailor menerapkan langkah-langkah keamanan berikut: 

1. Batasan ukuran input untuk mencegah pembengkakan database

1. Pengkodean dan sanitasi input pengguna yang tepat

1. URL-encoding masukan untuk mencegah korupsi respons

**Praktik terbaik**  
Ikuti praktik terbaik berikut untuk penanganan parameter yang aman: 
+ Validasi nilai parameter di sisi klien sebelum mengirim
+ Gunakan alias konfigurasi untuk membatasi kemungkinan nilai parameter
+ Hindari memasukkan informasi sensitif dalam parameter
+ Memantau penggunaan parameter untuk pola yang tidak biasa
+ Pertahankan nilai parameter dalam batas panjang yang disarankan