

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

# Memecahkan Masalah Kode Kesalahan Amazon Bedrock API
<a name="troubleshooting-api-error-codes"></a>

Bagian ini memberikan informasi terperinci tentang kesalahan umum yang mungkin Anda temui saat menggunakan Amazon Bedrock APIs, penyebab kesalahan, dan solusi untuk menyelesaikan kesalahan.

## AccessDeniedException
<a name="ts-access-denied"></a>

**Kode Status HTTP:** 403

**Penyebab:** Anda tidak memiliki izin yang cukup untuk melakukan tindakan yang diminta.

**Solusi:**
+ Verifikasi bahwa pengguna atau peran IAM Anda memiliki izin yang diperlukan untuk tindakan yang Anda coba.
+ Jika Anda menggunakan kredensil keamanan sementara, pastikan mereka belum kedaluwarsa.

## FTUFormNotFilled
<a name="ts-ftu-form"></a>

**Kode Status HTTP:** 404

**Penyebab:** Detail kasus penggunaan model belum dikirimkan untuk akun ini

**Solusi:**
+ Isi formulir detail kasus Anthropic penggunaan sebelum menggunakan model

## IncompleteSignature
<a name="ts-incomplete-signature"></a>

**Kode Status HTTP:** 400

**Penyebab:** Tanda tangan permintaan tidak sesuai dengan AWS standar.

**Solusi:**
+ Pastikan Anda menggunakan versi AWS SDK yang mendukung Amazon Bedrock.
+ Verifikasi bahwa ID kunci AWS akses dan kunci rahasia Anda telah dikonfigurasi dengan benar.
+ Jika Anda menandatangani permintaan secara manual, kami sarankan untuk memeriksa ulang proses perhitungan tanda tangan Anda.

## InternalFailure
<a name="ts-internal-failure"></a>

**Kode Status HTTP:** 500

**Penyebab:** Pemrosesan permintaan gagal karena kesalahan server

**Solusi:**
+ [Kami menyarankan AWS untuk menggunakan pendekatan yang direkomendasikan untuk menggunakan [percobaan ulang dengan backoff eksponensial](https://docs.aws.amazon.com//prescriptive-guidance/latest/cloud-design-patterns/retry-backoff.html) dan jitter acak untuk meningkatkan keandalan.](https://aws.amazon.com/builders-library/timeouts-retries-and-backoff-with-jitter/)
+ Jika masalah berlanjut, silakan hubungi [Pusat AWS Dukungan](https://aws.amazon.com/support) dan berikan detail tentang permintaan Anda dan kesalahan yang Anda hadapi.

## InvalidAction
<a name="ts-invalid-action"></a>

**Kode Status HTTP:** 400

**Penyebab:** Tindakan atau operasi yang diminta tidak valid

**Solusi:**
+ Kami menyarankan untuk memeriksa ulang ejaan dan pemformatan nama tindakan dalam permintaan Anda.
+ Verifikasi bahwa panggilan tindakan didukung oleh Amazon Bedrock dan didokumentasikan dengan benar seperti yang ditunjukkan di Referensi [API Amazon Bedrock](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_Operations.html).
+ Pastikan Anda menggunakan sebagian besar up-to-date versi AWS SDK atau CLI.

## InvalidClientTokenId
<a name="ts-invalid-client-token"></a>

**Kode Status HTTP:** 403

**Penyebab:** Sertifikat X.509 atau ID kunci AWS akses yang disediakan tidak ada dalam catatan kami.

**Solusi:**
+ Pastikan Anda menggunakan ID kunci AWS akses yang benar.
+ Jika Anda baru saja membuat kunci akses baru, pastikan Anda menggunakan kredensil baru dan bukan yang lama.

## AWS Perjanjian Marketplace Gagal dalam 15 menit
<a name="ts-mp-agreement-failed"></a>

**Kode Status HTTP:** 403

**Penyebab:** Perjanjian AWS Marketplace gagal karena masalah mendasar.

**Solusi:**
+ Tinjau pesan kesalahan dan atasi masalah yang mendasarinya. Masalah mendasar yang umum adalah kesalahan pembayaran yang tidak valid dan lokasi geografis terbatas.
+ Untuk kesalahan pembayaran yang tidak valid, harap tinjau [Pembatasan pembelian kartu kredit dan debit untuk pelanggan AISPL yang menggunakan AWS Marketplace dan](https://aws-blogs-prod.amazon.com/awsmarketplace/restriction-on-credit-and-debit-card-purchases-for-aispl-customers-using-aws-marketplace/) [INVALID\$1PAYMENT\$1INSTRUMENT](https://repost.aws/questions/QU0UOsutrWSSS4nOqgHcIUJg/invalid-payment-instrument-after-requesting-model-access-in-amazon-bedrock) setelah meminta akses model di Amazon Bedrock. .

## AWS Perjanjian Marketplace Tertunda setelah 15 menit
<a name="ts-mp-agreement-pending"></a>

**Kode Status HTTP:** 403

**Penyebab:** Perjanjian AWS Marketplace belum berhasil dan sudah 15 menit sejak permintaan dibuat.

**Solusi:**
+ Coba permintaan lagi setiap 15 menit. Jika masalah berlanjut, silakan hubungi [Pusat AWS Dukungan](https://aws.amazon.com/support) dan berikan detail tentang permintaan Anda dan kesalahan yang Anda hadapi.

## MPAgreementBeingCreated
<a name="ts-mp-agreement-created"></a>

**Kode Status HTTP:** 403

**Penyebab:** Akun Anda tidak diizinkan untuk mengakses model ini. Langganan AWS Marketplace Anda untuk model ini masih diproses

**Solusi:**
+ Coba lagi setelah 15 menit

## NotAuthorized
<a name="ts-not-authorized"></a>

**Kode Status HTTP:** 400

**Penyebab:** Anda tidak memiliki izin untuk melakukan tindakan ini.

**Solusi:**
+ Tinjau izin IAM Anda dan pastikan Anda memiliki hak yang diperlukan untuk melakukan tindakan yang diminta pada sumber daya Amazon Bedrock.
+ Jika Anda menggunakan peran IAM, verifikasi bahwa peran tersebut memiliki izin dan hubungan kepercayaan yang sesuai.
+ Periksa kebijakan organisasi atau kebijakan kontrol layanan apa pun yang mungkin membatasi akses Anda.

## RequestExpired
<a name="ts-request-expired"></a>

**Kode Status HTTP:** 400

**Penyebab:** Permintaan tidak lagi berlaku karena cap waktu kedaluwarsa.

**Solusi:**
+ Pastikan jam sistem Anda disinkronkan dengan benar dengan sumber waktu yang andal.
+ Jika Anda membuat permintaan dari zona waktu yang berbeda, waspadai potensi perbedaan stempel waktu.

## ServiceUnavailable
<a name="ts-service-unavailable"></a>

**Kode Status HTTP:** 503

**Penyebab:** Layanan sementara tidak dapat menangani permintaan. 503 kesalahan digunakan untuk pelambatan biasa.

**Solusi:**
+ [Kami menyarankan AWS untuk menggunakan pendekatan yang direkomendasikan untuk menggunakan [percobaan ulang dengan backoff eksponensial](https://docs.aws.amazon.com//prescriptive-guidance/latest/cloud-design-patterns/retry-backoff.html) dan jitter acak untuk meningkatkan keandalan.](https://aws.amazon.com/builders-library/timeouts-retries-and-backoff-with-jitter/)
+ Pertimbangkan untuk beralih ke yang lain Wilayah AWS jika masalah berlanjut di Wilayah Anda saat ini. Wilayah yang berbeda mungkin memiliki tingkat beban dan ketersediaan yang berbeda-beda.
+ [Gunakan inferensi Lintas Wilayah](https://docs.aws.amazon.com//bedrock/latest/userguide/cross-region-inference.html) untuk mengelola semburan lalu lintas yang tidak direncanakan dengan mulus dengan memanfaatkan komputasi di berbagai tempat. Wilayah AWS
+ Jika Anda memiliki persyaratan throughput yang tinggi, kami sarankan untuk menjelajahi [Throughput yang Disediakan](https://docs.aws.amazon.com//bedrock/latest/userguide/prov-throughput.html) untuk kasus penggunaan Anda.

**Praktik terbaik**
+ Pastikan aplikasi Anda dapat menangani 503 kode status dengan tepat dalam penanganan kesalahan dan coba lagi logika Anda.
+ Periksa AWS Service Health Dashboard untuk setiap masalah yang diumumkan atau pemeliharaan terjadwal yang mungkin memengaruhi layanan.

Jika Anda sering mengalami 503 kesalahan atau jika berdampak signifikan pada operasi Anda, silakan hubungi [AWS Support](https://aws.amazon.com/support) untuk bantuan dan panduan lebih lanjut yang disesuaikan dengan kasus penggunaan spesifik Anda.

## ThrottlingException
<a name="ts-throttling-exception"></a>

**Kode Status HTTP:** 429

**Penyebab:** Permintaan ditolak karena melebihi kuota akun untuk Amazon Bedrock.

**Solusi:**
+ Periksa kuota layanan Amazon Bedrock di konsol [kuota layanan Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#limits_bedrock) untuk mempelajari batasan yang diberikan ke akun Anda.
+ Kami menyarankan AWS untuk menggunakan pendekatan yang direkomendasikan untuk menggunakan [percobaan ulang dengan backoff eksponensial](https://docs.aws.amazon.com//prescriptive-guidance/latest/cloud-design-patterns/retry-backoff.html). dan [jitter](https://aws.amazon.com/builders-library/timeouts-retries-and-backoff-with-jitter/) acak untuk meningkatkan keandalan.
+ Jika Anda memiliki persyaratan throughput yang tinggi, kami sarankan untuk menjelajahi [Throughput yang Disediakan](https://docs.aws.amazon.com//bedrock/latest/userguide/prov-throughput.html) untuk kasus penggunaan Anda.
+ Permintaan peningkatan kuota dengan menghubungi manajer akun atau [AWS Support](https://aws.amazon.com/support) jika traffic beban kerja Anda melebihi kuota akun Anda.

## ValidationError
<a name="ts-validation-error"></a>

**Kode Status HTTP:** 400

**Penyebab:** Input gagal memenuhi batasan yang ditentukan oleh Amazon Bedrock.

**Solusi:**
+ Tinjau dokumentasi API untuk memastikan semua parameter yang diperlukan disertakan dan diformat dengan benar.
+ Periksa apakah nilai input Anda berada dalam rentang yang diizinkan atau sesuai dengan pola yang diharapkan.
+ Kami menyarankan untuk memperhatikan aturan validasi spesifik yang disebutkan dalam referensi API untuk tindakan yang Anda gunakan.

## ResourceNotFound
<a name="ts-resource-not-found"></a>

**Kode Status HTTP:** 404

**Penyebab:** Sumber daya yang diminta tidak dapat ditemukan.

**Solusi:**
+ Verifikasi kebenaran ID model, nama titik akhir, atau pengidentifikasi sumber daya lainnya dalam permintaan Anda.
+ Harap terapkan mekanisme fallback untuk menggunakan model atau titik akhir alternatif ketika sumber daya utama tidak ditemukan.

**Praktik terbaik**
+ Gunakan [ListFoundationModels](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_ListFoundationModels.html)untuk mempelajari tentang model foundation Amazon Bedrock yang tersedia yang dapat Anda gunakan.
+ Kami menyarankan untuk menerapkan proses sinkronisasi berkala untuk memperbarui katalog sumber daya lokal Anda.

Jika Anda terus mengalami masalah setelah mencoba solusi ini, hubungi [AWS Support](https://aws.amazon.com/support) untuk bantuan dan panduan lebih lanjut yang disesuaikan dengan kasus penggunaan spesifik Anda.

## Batas waktu koneksi atau reset saat memanggil Amazon Bedrock APIs
<a name="ts-connection-timeout"></a>

**Gejala:** Panggilan API gagal dengan pengaturan ulang koneksi atau batas waktu, terutama untuk permintaan yang berjalan lama seperti streaming atau inferensi yang diperpanjang, ketika lalu lintas melewati Gateway NAT, titik akhir VPC, atau Network Load Balancer.

**Penyebab:** Gateway NAT, titik akhir VPC antarmuka, dan Network Load Balancer memiliki batas waktu koneksi idle tetap 350 detik. Jika koneksi TCP tetap idle lebih lama dari periode ini, koneksi terputus. Klien menerima paket TCP RST atau waktu permintaan habis.

**Solusi:**

Aktifkan TCP keep-alive untuk mengirim probe berkala yang mencegah koneksi menjadi idle. Untuk informasi selengkapnya, lihat [Menerapkan Koneksi TCP yang berjalan lama dalam jaringan VPC di Blog AWS Networking](https://aws.amazon.com/blogs/networking-and-content-delivery/implementing-long-running-tcp-connections-within-vpc-networking/) & Content Delivery.

Jika Anda terus mengalami masalah koneksi setelah mengaktifkan TCP keep-alive, hubungi [AWS Support](https://aws.amazon.com/support) untuk bantuan lebih lanjut.