Kode status HTTP (Pencarian Azure AI)
Halaman ini menjelaskan kode status HTTP yang sering dikembalikan saat menggunakan Azure AI Search API.
Kode status HTTP umum
| Kode | Deskripsi |
|---|---|
| 200 OK | Sukses di GET, PUT, atau POST. Dikembalikan untuk respons yang berhasil. Selama pengindeksan, kode ini menunjukkan semua item telah disimpan tahan lama dan akan mulai diindeks. Pengindeksan berjalan di latar belakang dan membuat dokumen baru dapat dikueri dan dapat dicari beberapa detik setelah operasi pengindeksan selesai. |
| 201 Dibuat | Sukses di PUT atau POST. Objek berhasil dibuat atau diperbarui. |
| 204 Diterima | Sukses di PUT atau POST. Indeks atau dokumen berhasil diunggah. |
| 207 Multi-Status | Keberhasilan parsial untuk PUT atau POST. Beberapa dokumen berhasil, tetapi setidaknya satu gagal. |
| 400 Permintaan Buruk | Dikembalikan saat ada kesalahan dalam permintaan URI, header, atau isi. Isi respons berisi pesan kesalahan yang menjelaskan apa masalah spesifiknya. |
| 403 Terlarang | Dikembalikan saat Anda meneruskan kunci api yang tidak valid. |
| 404 Tidak Ditemukan | Dikembalikan ketika sumber daya tidak ada di server. Jika Anda mengelola atau mengkueri indeks, periksa sintaks dan verifikasi bahwa nama indeks ditentukan dengan benar. |
| Metode 405 Tidak Didukung | Dikembalikan ketika permintaan menentukan metode yang dikenali, tetapi tidak didukung. Jika Anda mengkueri indeks, rumusan permintaan tersebut menyertakan titik akhir, pengumpulan dan indeks indeks, serta koleksi dokumen dan metode pencarian (misalnya, https://mydemosvc.search.windows.net/indexes/mydemoidx/docs/search?api-version=2020-06-30). |
| 409 Konflik | Dikembalikan ketika operasi tulis berkonflik. Kesalahan 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, atau sumber data. |
| 429 Terlalu Banyak Permintaan | Jika kesalahan ini terjadi saat Anda mencoba membuat indeks, itu berarti Anda sudah memiliki jumlah maksimum indeks yang diizinkan untuk tingkat harga Anda. Jumlah indeks yang disimpan di Azure AI Search terlihat di dasbor layanan pencarian di portal Azure. Untuk melihat indeks menurut nama, pilih petak Indeks . Atau, Anda juga bisa mendapatkan daftar indeks berdasarkan nama menggunakan operasi Daftar Indeks . Lihat Daftar Indeks untuk detailnya. Jika kesalahan ini terjadi selama pengunggahan dokumen, itu menunjukkan bahwa Anda telah melebihi kuota Anda pada jumlah dokumen per indeks. Anda harus membuat indeks baru atau meningkatkan untuk batas kapasitas yang lebih tinggi. |
| 499 Permintaan Tertutup Klien | Kesalahan 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, kesalahan 499 dicatat. |
| 502 Gateway Buruk | Kesalahan ini terjadi ketika Anda memasukkan HTTP alih-alih HTTPS dalam koneksi. |
| 503 Layanan Tidak Tersedia | Kesalahan ini berarti bahwa sistem berada di bawah beban berat dan permintaan Anda tidak dapat diproses saat ini. Penting: Dalam hal ini, kami sangat menyarankan agar kode klien Anda mundur dan menunggu sebelum mencoba kembali. Ini akan memberi sistem waktu untuk pulih, meningkatkan kemungkinan permintaan di masa mendatang akan berhasil. Dengan cepat mencoba kembali permintaan Anda hanya akan memperpanjang situasi. Lihat Menganalisis performa untuk informasi selengkapnya tentang pembatasan dan cara mencegah kondisi ini. |
| 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. |