View a markdown version of this page

Memecahkan Masalah Kode Kesalahan Amazon Bedrock API - Amazon Bedrock
AccessDeniedExceptionFTUFormNotFilledIncompleteSignatureInternalFailureInvalidActionInvalidClientTokenIdAWS Perjanjian Marketplace Gagal dalam 15 menitAWS Perjanjian Marketplace Tertunda setelah 15 menitMPAgreementBeingCreatedNotAuthorizedRequestExpiredServiceUnavailableThrottlingExceptionValidationErrorResourceNotFoundBatas waktu koneksi atau reset pada koneksi yang berjalan lama atau idle

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

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

AccessDeniedException

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

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

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

Kode Status HTTP: 500

Penyebab: Pemrosesan permintaan gagal karena kesalahan server

Solusi:

InvalidAction

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.

  • Pastikan Anda menggunakan versi AWS SDK atau CLI terbaru.

InvalidClientTokenId

Kode Status HTTP: 403

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

Solusi:

  • Verifikasi bahwa 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

Kode Status HTTP: 403

Penyebab: Perjanjian AWS Marketplace gagal karena masalah mendasar.

Solusi:

AWS Perjanjian Marketplace Tertunda setelah 15 menit

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 dan berikan detail tentang permintaan Anda dan kesalahan yang Anda hadapi.

MPAgreementBeingCreated

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

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

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

Kode Status HTTP: 503

Penyebab: Layanan sementara tidak dapat menangani permintaan. 503 kesalahan menunjukkan bahwa layanan mengalami permintaan tinggi atau kendala kapasitas sementara. Ini tidak terkait dengan kuota tingkat akun atau batas tarif Anda (yang mengembalikan 429). ThrottlingException

Solusi:

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 untuk bantuan dan panduan lebih lanjut yang disesuaikan dengan kasus penggunaan spesifik Anda.

ThrottlingException

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 untuk mempelajari batasan yang diberikan ke akun Anda.

  • Kami menyarankan AWS untuk menggunakan pendekatan yang direkomendasikan untuk menggunakan percobaan ulang dengan backoff eksponensial. dan jitter acak untuk meningkatkan keandalan.

  • Jika Anda memiliki persyaratan throughput yang tinggi, kami sarankan untuk menjelajahi Throughput yang Disediakan untuk kasus penggunaan Anda.

  • Permintaan peningkatan kuota dengan menghubungi manajer akun atau AWS Support jika traffic beban kerja Anda melebihi kuota akun Anda.

ValidationError

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 apa pun yang disebutkan dalam referensi API untuk tindakan yang Anda gunakan.

ResourceNotFound

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 ListFoundationModelsuntuk 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 untuk bantuan dan panduan lebih lanjut yang disesuaikan dengan kasus penggunaan spesifik Anda.

Batas waktu koneksi atau reset pada koneksi yang berjalan lama atau idle

Gejala: Panggilan API gagal dengan pengaturan ulang koneksi atau batas waktu, terutama untuk permintaan yang berjalan lama seperti streaming, pemikiran yang diperluas, atau respons inferensi besar, ketika lalu lintas melewati Gateway NAT, titik akhir VPC antarmuka, atau Network Load Balancer. Gejala juga dapat muncul sebagai latensi cold-start yang lama (misalnya, panggilan pertama setelah periode idle membutuhkan waktu 70+ detik, bukan beberapa detik biasa) ketika koneksi gabungan idle digunakan kembali setelah jaringan diam-diam menjatuhkannya.

Penyebab: Gateway NAT, titik akhir VPC antarmuka, dan Network Load Balancer memiliki batas waktu koneksi idle tetap 350 detik. Jika koneksi TCP tetap menganggur lebih lama dari periode ini, koneksi terputus tanpa memberi tahu klien. Klien mungkin tidak mendeteksi koneksi yang terputus hingga permintaan berikutnya, di mana ia harus menunggu percobaan ulang atau batas waktu OS-level TCP sebelum membangun kembali koneksi.

Ketika ini berlaku:

  • Aplikasi yang berjalan di Amazon EKS atau Amazon ECS di mana lalu lintas pod ke Amazon Bedrock keluar melalui NAT Gateway atau titik akhir antarmuka VPC.

  • Aplikasi yang berjalan di instans Amazon EC2 berada di belakang NAT Gateway, titik akhir VPC antarmuka untuk Amazon Bedrock, atau Network Load Balancer.

  • Long-running atau beban kerja yang meledak di mana koneksi klien Amazon Bedrock diam di kumpulan koneksi di antara panggilan.

Solusi:

Mengaktifkan TCP keep-alive pada klien Amazon Bedrock memerlukan dua pengaturan yang bekerja sama. Pengaturan hanya satu saja tidak cukup.

  1. Aktifkan TCP keep-alive di klien AWS SDK Anda. ConfigObjek boto3 menerima tcp_keepalive parameter, yang defaultnya. False Setel ke True saat membangun klien Amazon Bedrock:

    import boto3
from botocore.config import Config

config = Config(tcp_keepalive=True)
client = boto3.client("bedrock-runtime", config=config)

    Untuk AWS SDK lainnya, lihat dokumentasi konfigurasi klien HTTP yang sesuai.

  2. Konfigurasikan interval OS-level keep-alive untuk menyala sebelum batas waktu idle 350 detik. Linux default ke net.ipv4.tcp_keepalive_time = 7200 (2 jam), yang jauh lebih lama dari batas waktu idle NAT atau VPC endpoint, jadi keep-alive saja tidak berpengaruh. SDK-level Turunkan pengaturan kernel ke nilai dengan aman di bawah 350 detik (misalnya, 45 detik):

    sysctl -w net.ipv4.tcp_keepalive_time=45

    Di Amazon EKS dan Amazon ECS, terapkan sysctl di pod atau tasksecurityContext, dalam container init, atau di AMI node kustom. Di Amazon EC2, atur /etc/sysctl.d/ agar nilainya tetap ada saat reboot.

Untuk diskusi lebih dalam tentang koneksi TCP yang berjalan lama di jaringan VPC, lihat Menerapkan Koneksi TCP yang berjalan lama dalam jaringan VPC di Blog Networking & Content Delivery. AWS

Jika Anda terus mengalami masalah koneksi setelah menerapkan kedua pengaturan, hubungi AWS Support untuk bantuan lebih lanjut.