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
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
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 dalam manifes URLs
+ Kesalahan HTTP 400 selama inisialisasi sesi
+ Nilai parameter terpotong atau rusak
+ Permintaan ADS gagal karena cacat URLs
**Langkah resolusi**
Untuk mengatasi kesalahan pembatasan karakter:
1. Tinjau nilai parameter untuk karakter yang tidak didukung:`:`,`?`,`&`,`=`, `%` `/`
1. Terapkan pengkodean URL yang tepat 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 penuh URLs tidak dapat digunakan
**Example Contoh pengkodean URL**
Alih-alih menggunakan:
```
manifest.redirect_url=https://example.com/path?param=value
```
Gunakan format yang dikodekan URL:
```
manifest.redirect_url=https%3A%2F%2Fexample.com%2Fpath%3Fparam%3Dvalue
```
## Kesalahan batasan panjang
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
+ ADS URLs: 25.000 karakter
**Strategi resolusi**
Untuk menangani keterbatasan 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
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 menyelesaikan 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 critical URLs (`VideoContentSourceUrl`,,) `AdSegmentUrlPrefix` `ContentSegmentUrlPrefix`
1. Periksa apakah permintaan inisialisasi sesi menentukan nilai alias yang valid
1. Validasi struktur parameter JSON ConfigurationAliases
Untuk panduan pemecahan masalah terperinci, lihat. [MediaTailor panduan pemecahan masalah alias konfigurasi](configuration-aliases-troubleshooting.md)
**Example Konfigurasi alias validasi**
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
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 ada)
1. Pemfilteran parameter (ADS vs asal vs manifes)
1. Pengkodean dan pemformatan URL
1. Parameter aplikasi untuk URLs
**Aliran parameter debugging**
Untuk men-debug masalah pemrosesan parameter:
1. Verifikasi parameter ditentukan dengan benar dalam inisialisasi sesi
1. Periksa apakah alias konfigurasi diselesaikan ke nilai yang diharapkan
1. Konfirmasi parameter muncul di benar URLs (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
MediaTailor menerapkan langkah-langkah keamanan untuk penanganan parameter untuk mencegah masalah keamanan umum.
**Langkah-langkah keamanan**
MediaTailor menerapkan langkah-langkah keamanan berikut:
1. Keterbatasan ukuran input untuk mencegah bongkahan basis data
1. Pengkodean dan sanitasi input pengguna yang tepat
1. Pengkodean URL input untuk mencegah korupsi respons
**Praktik terbaik**
Ikuti praktik terbaik ini untuk penanganan parameter yang aman:
+ Validasi nilai parameter di sisi klien sebelum mengirim
+ Gunakan alias konfigurasi untuk membatasi nilai parameter yang mungkin
+ Hindari memasukkan informasi sensitif dalam parameter
+ Memantau penggunaan parameter untuk pola yang tidak biasa
+ Simpan nilai parameter dalam batas panjang yang disarankan