Kode status HTTP (Pencarian Azure AI)

Halaman ini menjelaskan kode status HTTP yang sering dikembalikan saat menggunakan REST API Azure AI Search.

Kode status HTTP umum

Kode	Deskripsi
200 OK (Permintaan berhasil)	Sukses di GET, PUT, atau POST. Dikembalikan untuk respons yang berhasil.
201 - Dibuat	Berhasil di PUT atau POST. Objek berhasil dibuat.
202 Diterima	Berhasil di PUT atau POST. Kode status ini dikembalikan untuk menjalankan permintaan pengindeks.
204 Tidak Ada Konten	Berhasil di PUT atau POST. Pembaruan berhasil tetapi tidak ada informasi untuk dikembalikan dalam respons.
206 Konten Sebagian	Keberhasilan parsial pada GET atau POST untuk pengambilan basis pengetahuan dalam alur kerja pengambilan agen. Dikembalikan ketika permintaan berhasil tetapi komponen nonkritis tertentu dari proses pengambilan atau peringkat gagal, yang menyebabkan hasil atau peringkat tidak lengkap yang mungkin tidak mencerminkan penilaian relevansi penuh.
207 Multi-Status	Keberhasilan parsial pada PUT atau POST. Beberapa dokumen berhasil, tetapi setidaknya satu gagal.
400 Permintaan Tidak Valid	Dikembalikan ketika ada kesalahan dalam URI permintaan, header, atau isi. Isi respons berisi pesan kesalahan yang menjelaskan apa masalah spesifiknya.
401 Tidak Sah	Dikembalikan saat kredensial hilang. Jika Anda menggunakan kontrol akses berbasis peran, Anda atau layanan pencarian kehilangan penetapan peran. Untuk masalah dalam mengakses Azure AI Search, lihat Menyambungkan ke Azure AI Search menggunakan peran. Untuk informasi selengkapnya tentang koneksi pencarian ke sumber daya lain, lihat Mengonfigurasi layanan pencarian untuk menyambungkan menggunakan identitas terkelola.
402 Pembayaran Diperlukan	Dikembalikan ketika alokasi bulanan permintaan peringkat semantik gratis habis. Anda mungkin juga melihat kesalahan ini: "Penggunaan Semantik Kueri Gratis terlampaui untuk bulan tersebut. Aktifkan penagihan semantik untuk terus menggunakan pencarian https://aka.ms/SemanticPriceDocPage"semantik ;. Untuk mengatasi error, beralih dari paket gratis ke penagihan standar.
403 Dilarang	Dikembalikan saat otorisasi gagal.
404 Tidak ditemukan	Dikembalikan ketika sumber daya tidak ada di server.
Metode 405 Tidak Didukung	Dikembalikan ketika layanan mengenali metode yang tidak didukung. Jika Anda mengkueri indeks, rumusan permintaan tersebut menyertakan titik akhir, pengumpulan dan indeks indeks, dan koleksi dokumen dan metode pencarian (misalnya, https://mydemosvc.search.windows.net/indexes/mydemoidx/docs/search?api-version=2024-07-01).
409 Konflik	Dikembalikan saat operasi tulis berkonflik. Kode status ini dikembalikan untuk pembaruan sumber daya, atau selama pengindeksan ketika dua proses mencoba memperbarui dokumen yang sama secara bersamaan. Azure AI Search menyediakan manajemen konkurensi untuk pembaruan sumber daya. Untuk informasi selengkapnya, lihat Cara mengelola konkurensi di Azure AI Search.
Prasyarat 412 Gagal	Dikembalikan saat kondisi header If-Match atau If-None-Match mengevaluasi ke false. Terkait dengan penggunaan kontrol konkurensi optimis saat mengirim permintaan HTTP untuk definisi indeks, pengindeks, set keterampilan, atau sumber data.
415 Jenis Media Tidak Didukung	Kesalahan ini dapat terjadi jika Anda menggunakan tindakan CURL atau baris perintah untuk meneruskan JSON dalam definisi objek atau permintaan, dan header permintaan tidak menentukan jenis konten aplikasi/json. Untuk CURL, jika Anda menggunakan -d flag (yang default ke x-www-form-urlencoded), Anda dapat mengganti flag tersebut dengan --json flag (yang default ke application/json), atau menambahkan .-H "Content-Type: application/json"
429 Terlalu Banyak Permintaan	Jika Anda mendapatkan kode status ini selama pembuatan objek, itu berarti Anda memiliki jumlah maksimum objek yang diizinkan untuk tingkat layanan Anda. Jika Anda mendapatkan kode kesalahan ini pada indeks aktif, biasanya berarti Anda kehabisan penyimpanan. Saat Anda mendekati batas penyimpanan, layanan dapat memasukkan status di mana Anda tidak dapat menambahkan atau memperbarui hingga Anda menghapus beberapa dokumen. Untuk informasi selengkapnya, lihat Merencanakan dan mengelola kapasitas jika Anda menginginkan lebih banyak penyimpanan, atau Memperbarui konten jika Anda ingin mengosongkan ruang dengan menghapus dokumen.
Permintaan Tertutup Klien 499	Kode status ini tidak pernah dikembalikan dalam respons, tetapi Anda mungkin melihatnya dalam entri log yang direkam oleh analitik lalu lintas pencarian dan Azure Monitor. Ini menunjukkan bahwa klien menutup koneksi sebelum respons dikembalikan oleh layanan. Saat Azure AI Search mendeteksi pembatalan yang tidak diminta oleh kode sisi layanan, atau bahwa klien tidak ada lagi, 499 dicatat.
Gateway Buruk 502	Kode status ini terjadi ketika Anda memasukkan HTTP alih-alih HTTPS dalam koneksi.
503 Layanan Tidak Tersedia	Kode status ini berarti bahwa sistem berada di bawah beban berat dan permintaan Anda tidak dapat diproses. Mitigasi termasuk menambahkan waktu tunggu ke logika coba lagi atau meningkatkan kapasitas. Layanan yang lebih baru dilengkapi dengan lebih banyak penyimpanan dan daya komputasi secara otomatis. Untuk informasi selengkapnya tentang penyetelan performa, lihat Menganalisis performa di Azure AI Search.
504: Batas Waktu Gateway	Pencarian Azure AI mendengarkan di port HTTPS 443. Jika URL layanan pencarian Anda berisi HTTP alih-alih HTTPS, kode status 504 dikembalikan.

Lihat juga

• REST API Pencarian Azure AI