View a markdown version of this page

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

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

Memecahkan Masalah Kode Kesalahan API Amazon Bedrock

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:

  • Pastikan pengguna atau peran IAM Anda memiliki izin yang diperlukan untuk tindakan yang Anda coba.

  • Jika Anda menggunakan kredenSIAL keamanan sementara, pastikan kredenSIAL tersebut 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.

  • Pastikan ID kunci AWS akses dan kunci rahasia dikonfigurasi dengan benar.

  • Jika Anda menandatangani permintaan secara manual, sebaiknya periksa kembali proses perhitungan tanda tangan Anda.

InternalFailure

Kode Status HTTP: 500

Penyebab: Pemrosesan permintaan gagal karena kesalahan server

Solusi:

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

  • Jika masalah berlanjut, silakan hubungi Pusat AWS Dukungan dan berikan detail tentang permintaan Anda dan kesalahan yang Anda temui.

InvalidAction

Kode Status HTTP: 400

Penyebab: T indakan atau operasi yang diminta tidak valid

Solusi:

  • Sebaiknya periksa kembali ejaan dan pemformatan nama tindakan dalam permintaan Anda.

  • Verifikasi bahwa panggilan tindakan didukung oleh Amazon Bedrock dan didokumentasikan dengan benar seperti yang ditunjukkan dalam Referensi API Amazon Bedrock.

  • Pastikan Anda menggunakan versi terbaru dari AWS SDK atau CLI.

InvalidClientTokenId

Kode Status HTTP: 403

Penyebab: X.509 Sertifikat 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 kredenSIAL baru dan bukan yang lama.

AWS Perjanjian Marketplace gagal dalam waktu 15 menit

Kode Status HTTP: 403

Penyebab: Perjanjian AWS Marketplace gagal karena masalah yang mendasarinya.

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 temui.

MPAgreementBeingCreated

Kode Status HTTP: 403

Penyebab: Akun Anda tidak diizinkan untuk mengakses model ini. Lang AWS ganan 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 valid 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, perhatikan kemungkinan 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:

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

  • Pertimbangkan untuk beralih ke yang berbeda Wilayah AWS jika masalah berlanjut di Wilayah Anda saat ini. Wilayah yang berbeda mungkin memiliki tingkat beban dan ketersediaan yang bervariasi.

  • Gunakan Cross-Region inferensi untuk merutekan permintaan Anda dengan menggunakan komputasi yang berbeda. Wilayah AWS

  • Jika Anda memiliki persyaratan throughput yang tinggi, sebaiknya jelajahi Pro visioned Throughput untuk kasus penggunaan Anda.

Praktik terbaik

  • Pastikan aplikasi Anda dapat menangani 503 kode status dengan tepat dalam penanganan kesalahan dan logika coba ulang.

  • Periksa Dasbor Kesehatan AWS Layanan untuk mengetahui masalah yang diumumkan atau pemeliharaan terjadwal yang mungkin memengaruhi layanan.

Jika Anda sering mengalami kesalahan 503 atau jika kesalahan tersebut berdampak signifikan pada operasi Anda, silakan hubungi AWS Dukungan 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 tentang batas yang diberikan untuk akun Anda.

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

  • Jika Anda memiliki persyaratan throughput yang tinggi, sebaiknya jelajahi Pro visioned Throughput untuk kasus penggunaan Anda.

  • Minta kenaikan kuota dengan menghubungi manajer akun atau AWS Dukungan jika lalu lintas 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.

  • Sebaiknya perhatikan aturan validasi spesifik 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 alternatif atau titik akhir ketika sumber daya utama tidak ditemukan.

Praktik terbaik

  • Gunakan ListFoundationModels untuk mempelajari tentang model pondasi Amazon Bedrock yang tersedia yang dapat Anda gunakan.

  • Kami menyarankan menerapkan proses sinkronisasi berkala untuk memperbarui katalog sumber daya lokal Anda.

Jika Anda terus mengalami masalah setelah mencoba solusi ini, hubungi AWS Dukungan untuk bantuan dan panduan lebih lanjut yang disesuaikan dengan kasus penggunaan spesifik Anda.

Batas waktu koneksi atau reset pada koneksi yang berjalan lama atau tidak aktif

Gejala: Pang gilan API gagal dengan pengaturan ulang koneksi atau batas waktu, terutama untuk permintaan yang berjalan lama seperti streaming, pemikiran yang diperpanjang, atau respons inferensi besar, ketika lalu lintas melewati NAT Gateway, titik akhir VPC antarmuka, atau Penyeimbang Beban Jaringan. Gejala juga dapat muncul sebagai latensi start dingin yang panjang (misalnya, panggilan pertama setelah periode idle membutuhkan waktu 70+ detik, bukan beberapa yang biasa) ketika koneksi gabungan yang tidak digunakan kembali setelah jaringan diam-diam menutupnya.

Penyebab: G erbang NAT, titik akhir VPC antarmuka, dan Penyeimbang Beban Jaringan memiliki batas waktu koneksi idle tetap 350 detik. Jika koneksi TCP tetap idle lebih lama dari periode ini, koneksi terputus tanpa memberi tahu klien. Klien mungkin tidak mendeteksi koneksi yang terputus sampai permintaan berikutnya, di mana ia harus menunggu percobaan ulang OS-level TCP atau batas waktu 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 titik akhir antarmuka NAT Gateway atau VPC.

  • Aplikasi yang berjalan di instans Amazon EC2 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 tidak aktif di kumpulan koneksi di antara panggilan.

Solusi:

Mengaktifkan TCP keep-alive di klien Amazon Bedrock memerlukan dua pengaturan yang bekerja bersama. Mengatur hanya satu saja tidak cukup.

  1. Aktifkan TCP keep-alive di klien AWS SDK Anda. Objek boto3 Config menerima tcp_keepalive parameter, yang defaultnya adalah. 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 lain, lihat dokumentasi konfigurasi klien HTTP yang sesuai.

  2. Konfigurasikan interval OS-level keep-alive untuk diaktifkan 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 titik akhir NAT atau VPC, jadi ke SDK-level ep-alive saja tidak berpengaruh. Turunkan pengaturan kernel ke nilai 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 tugassecurityContext, dalam wadah init, atau di AMI node khusus. Di Amazon EC2, atur agar nilainya /etc/sysctl.d/ tetap ada di seluruh reboot.

Untuk diskusi lebih dalam tentang koneksi TCP yang sudah berjalan lama di jaringan VPC, lihat Menerapkan Koneksi TCP yang berjalan lama dalam jaringan VPC di Blog Pengiriman Jaringan & Konten AWS .

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