One or more parameter values were invalid

TL;DR — DynamoDB menerima bentuk permintaan tetapi menolak nilai spesifik di dalamnya: Set kosong, string kosong dalam kunci, nilai yang tipenya tidak cocok dengan schema, atau null di tempat yang tidak diizinkan. Baca sisa pesan — ia menyebut parameter yang tepat — dan perbaiki nilai itu.

Apa artinya

ValidationException: One or more parameter values were invalid: <specific reason>

Ini ValidationException (HTTP 400) yang body pesannya menunjuk satu nilai yang melanggar aturan — AWS mendokumentasikan pesan hanya sebagai "varies, depending upon the specific error(s) encountered". Awalannya generik; bagian pentingnya adalah apa yang mengikutinya — misalnya bahwa AttributeValue tidak boleh berisi string kosong untuk kunci, bahwa set tidak boleh kosong, atau bahwa tipe nilai kunci tidak cocok dengan schema. Ini tidak dapat dicoba ulang apa adanya; nilai harus berubah.

Mengapa itu terjadi

Alasan tipikal yang dijabarkan ekor pesan (kata-kata persis bervariasi menurut kasus):

• String kosong atau nilai binary dalam atribut kunci — string dan nilai binary non-kunci boleh kosong; kunci tabel dan index tidak.
• Set kosong — SS/NS/BS dengan nol anggota. Set harus tidak-kosong di mana pun; list dan map kosong baik-baik saja.
• Ketidakcocokan tipe untuk kunci (mis. expected: S actual: N) — tipe nilai tidak cocok dengan key schema tabel.
• Nilai null diteruskan ke atribut yang tidak menerimanya, atau marshaller mengeluarkan null untuk field undefined.
• Nilai di luar rentang untuk tipenya (lihat number overflow).

Bagaimana cara memperbaikinya

1. Baca pesan lengkap. DynamoDB menyebut parameter yang bermasalah dan aturan yang tepat — string itu adalah perbaikannya.
2. Beri kunci nilai nyata — jangan pernah string kosong atau binary kosong dalam partition/sort key.
3. Hapus set kosong — hilangkan atribut ketika Set tidak punya anggota, atau simpan skalar/NULL sebagai gantinya.
4. Cocokkan tipe ke schema — kirim kunci numerik sebagai number, kunci string sebagai string; jangan silangkan pembungkus.
5. Hapus undefined/null dari item sebelum menulis (opsi removeUndefinedValues Document Client menangani kasus umum).

FAQ

Apa arti "One or more parameter values were invalid"? Sebuah nilai spesifik dalam permintaan Anda melanggar aturan DynamoDB — paling sering string kosong dalam kunci, Set kosong, tipe yang tidak cocok dengan key schema, atau null yang tidak diizinkan. Pesan lengkap menyebut parameter dan alasan yang tepat.

Mengapa string kosong hanya gagal kadang-kadang? DynamoDB mengizinkan string kosong untuk atribut non-kunci tetapi menolaknya dalam atribut kunci. String kosong dalam partition atau sort key memunculkan "An AttributeValue may not contain an empty string"; nilai yang sama dalam atribut biasa diterima.

Kesalahan terkait

• Supplied AttributeValue is empty — atribut item tanpa nilai bertipe sama sekali.
• The provided key element does not match the schema — ketidakcocokan tipe/bentuk kunci.
• ValidationException (ikhtisar)
• Pelajari: DynamoDB data types

Referensi

• Error handling with DynamoDB — Amazon DynamoDB Developer Guide
• Supported data types and naming rules in Amazon DynamoDB — Amazon DynamoDB Developer Guide
• AttributeValue — Amazon DynamoDB API Reference

Terakhir diverifikasi 2026-07-13 terhadap dokumentasi resmi AWS yang ditautkan di atas.