Kode kesalahan Wajah Azure API

Kode kesalahan umum

Kode kesalahan ini dapat dikembalikan oleh panggilan Face API apa pun.

Kode status http Error code Error message Description
Permintaan Tidak Valid (400) BadArgument Isi permintaan tidak valid.
Permintaan Tidak Valid (400) BadArgument Kesalahan penguraian JSON. Isi JSON permintaan yang buruk atau tidak dikenali.
Permintaan Tidak Valid (400) BadArgument 'recognitionModel' tidak valid.
Permintaan Tidak Valid (400) BadArgument 'detectionModel' tidak valid.
Permintaan Tidak Valid (400) BadArgument 'nama' kosong.
Permintaan Tidak Valid (400) BadArgument 'name' terlalu panjang.
Permintaan Tidak Valid (400) BadArgument 'userData' terlalu panjang.
Permintaan Tidak Valid (400) BadArgument 'start' terlalu panjang.
Permintaan Tidak Valid (400) BadArgument 'top' tidak valid.
Permintaan Tidak Valid (400) BadArgument Target argumenFace di luar rentang.
Permintaan Tidak Valid (400) BadArgument TargetFace argumen tidak valid. Disebabkan oleh format string yang tidak valid atau nilai kiri/atas/tinggi/lebar tidak valid.
Permintaan Tidak Valid (400) InvalidURL URL gambar tidak valid. Format yang didukung termasuk JPEG, PNG, GIF(bingkai pertama) dan BMP.
Permintaan Tidak Valid (400) InvalidURL URL gambar tidak valid atau kesalahan pengunduhan dari server target. Kesalahan server jarak jauh ditampilkan: "Terjadi kesalahan saat mengirim permintaan."
Permintaan Tidak Valid (400) InvalidImage Kesalahan decoding, format gambar tidak didukung.
Permintaan Tidak Valid (400) InvalidImage Tidak ada wajah yang terdeteksi dalam gambar.
Permintaan Tidak Valid (400) InvalidImage Ada lebih dari 1 wajah dalam gambar.
Permintaan Tidak Valid (400) InvalidImageSize Ukuran gambar terlalu kecil. Ukuran file gambar yang valid harus lebih besar dari atau sama dengan 1 KB.
Permintaan Tidak Valid (400) InvalidImageSize Ukuran gambar terlalu besar. Ukuran file gambar yang valid tidak boleh lebih besar dari 6 MB.
Unauthorized (401) 401 Akses ditolak karena kunci langganan yang tidak valid atau titik akhir API yang salah. Pastikan untuk memberikan kunci yang valid untuk langganan aktif dan menggunakan titik akhir API regional yang benar untuk sumber daya Anda.
Forbidden (403) UnsupportedFeature Fitur tidak didukung, tidak memiliki persetujuan untuk satu atau beberapa fitur berikut: Identifikasi, Verifikasi. Daftar untuk akses dengan mengirimkan formulir pendaftaran.
Conflict (409) ConcurrentOperationConflict Ada operasi konflik pada sumber daya <resourceName>, silakan coba nanti.
Terlalu Banyak Permintaan (429) 429 Batas tarif terlampaui.

Kode kesalahan Deteksi Wajah

Kode kesalahan ini dapat dikembalikan oleh operasi Deteksi Wajah.

Kode status http Error code Error message Description
Permintaan Tidak Valid (400) BadArgument ReturnFaceAttributes argumen tidak valid.
Permintaan Tidak Valid (400) BadArgument 'returnFaceAttributes' tidak didukung oleh detection_02.
Permintaan Tidak Valid (400) BadArgument 'returnLandmarks' tidak didukung oleh detection_02.
Forbidden (403) UnsupportedFeature Atribut Kembali (emosi, jenis kelamin, usia, senyum, rambut wajah, rambut dan makeup) telah tidak digunakan lagi dan tidak lagi didukung. Kirim email ke tim Wajah Azure jika Anda memiliki kasus penggunaan yang bertanggung jawab yang akan mendapat manfaat dari penggunaan salah satu kemampuan terbatas.

Kode kesalahan Sesi Keakuratan Wajah

Kode kesalahan ini dapat dikembalikan oleh operasi Sesi Keakuratan Wajah.

Kode status http Error code Error message Description
Permintaan Tidak Valid (400) BadArgument Parameter mulai tidak valid. Tentukan bidang 'Id' dari entri terakhir untuk melanjutkan proses daftar.
Permintaan Tidak Valid (400) BadArgument Parameter teratas tidak valid. Rentang yang valid adalah antara 1 dan 1000 inklusif.
Permintaan Tidak Valid (400) InvalidRequestBody Isi permintaan yang salah disediakan. Silakan periksa skema operasi dan coba lagi.
Permintaan Tidak Valid (400) InvalidTokenLifetime AuthTokenTimeToLiveInSeconds yang ditentukan tidak valid. Harus dalam 60 hingga 86400.
Permintaan Tidak Valid (400) InvalidLivenessOperationMode LivenessOperationMode tidak valid ditentukan. Harus 'Pasif'.
Permintaan Tidak Valid (400) InvalidDeviceCorrelationId ID korelasi perangkat diperlukan dalam isi permintaan selama pembuatan sesi atau mulai sesi. Tidak boleh null atau kosong, dan tidak boleh lebih dari 64 karakter.
Tidak Ditemukan(404) SessionNotFound ID Sesi tidak ditemukan. ID sesi kedaluwarsa atau tidak ada.

Kode kesalahan Face Identifi

Kode kesalahan ini dapat dikembalikan oleh operasi Face Identifi.

Kode status http Error code Error message Description
Permintaan Tidak Valid (400) BadArgument 'recognitionModel' tidak kompatibel.
Permintaan Tidak Valid (400) BadArgument ID grup orang tidak valid.
Permintaan Tidak Valid (400) BadArgument ID grup orang besar tidak valid.
Permintaan Tidak Valid (400) BadArgument ID grup orang dinamis tidak valid.
Permintaan Tidak Valid (400) BadArgument Argumen maxNumOfCandidatesReturned tidak valid. Rentang yang valid adalah antara [1, 100].
Permintaan Tidak Valid (400) BadArgument Argumen confidenceThreshold tidak valid. Rentang yang valid adalah antara [0, 1].
Permintaan Tidak Valid (400) BadArgument Panjang faceIds tidak dalam rentang yang valid. Rentang yang valid adalah antara [1, 10].
Permintaan Tidak Valid (400) FaceNotFound Wajah tidak ditemukan.
Permintaan Tidak Valid (400) PersonGroupNotFound Grup orang tidak ditemukan.
Permintaan Tidak Valid (400) LargePersonGroupNotFound Grup orang besar tidak ditemukan.
Permintaan Tidak Valid (400) DynamicPersonGroupNotFound Grup orang dinamis tidak ditemukan.
Permintaan Tidak Valid (400) PersonGroupNotTrained Grup orang tidak terlatih.
Permintaan Tidak Valid (400) LargePersonGroupNotTrained Kelompok orang besar tidak terlatih.
Permintaan Tidak Valid (400) PersonGroupIdAndLargePersonGroupIdBothNotNull ID grup orang besar dan ID grup orang keduanya tidak null.
Permintaan Tidak Valid (400) PersonGroupIdAndLargePersonGroupIdBothNull ID grup orang besar dan ID grup orang keduanya null.
Permintaan Tidak Valid (400) MissingIdentificationScopeParameters Tidak ada parameter cakupan identifikasi yang ada dalam permintaan.
Permintaan Tidak Valid (400) IncompatibleIdentificationScopeParametersCombination Parameter cakupan identifikasi yang tidak kompatibel ada dalam permintaan.
Conflict (409) PersonGroupTrainingNotFinished Grup orang sedang dalam pelatihan.
Conflict (409) LargePersonGroupTrainingNotFinished Kelompok orang besar sedang dalam pelatihan.

Kode kesalahan Verifikasi Wajah

Kode kesalahan ini dapat dikembalikan oleh operasi Verifikasi Wajah.

Kode status http Error code Error message Description
Permintaan Tidak Valid (400) BadArgument 'recognitionModel' tidak kompatibel.
Permintaan Tidak Valid (400) BadArgument ID Wajah tidak valid. FaceId yang valid berasal dari Face - Detect.
Permintaan Tidak Valid (400) BadArgument ID Orang tidak valid. PersonId yang valid dihasilkan dari Buat Orang Grup Orang, Buat Orang Grup Orang Besar atau Direktori Orang - Buat Orang.
Permintaan Tidak Valid (400) BadArgument ID grup orang tidak valid.
Permintaan Tidak Valid (400) BadArgument ID grup orang besar tidak valid.
Permintaan Tidak Valid (400) PersonNotFound Orang tidak ditemukan.
Permintaan Tidak Valid (400) PersonGroupNotFound Grup Orang tidak ditemukan.
Permintaan Tidak Valid (400) LargePersonGroupNotFound Grup Orang Besar tidak ditemukan.
Tidak Ditemukan(404) FaceNotFound Wajah tidak ditemukan.
Tidak Ditemukan(404) PersonNotFound Orang tidak ditemukan.
Tidak Ditemukan(404) PersistedFaceNotFound Tidak ada wajah orang yang bertahan ditemukan.

Menemukan kode kesalahan serupa

Kode kesalahan ini dapat dikembalikan oleh operasi Face Find Similar.

Kode status http Error code Error message Description
Permintaan Tidak Valid (400) BadArgument 'recognitionModel' tidak kompatibel.
Permintaan Tidak Valid (400) BadArgument Mode tidak valid.
Permintaan Tidak Valid (400) BadArgument ID daftar wajah tidak valid.
Permintaan Tidak Valid (400) BadArgument ID daftar wajah besar tidak valid.
Permintaan Tidak Valid (400) BadArgument LargeFaceListId, faceListId, dan faceIds, tidak persis salah satunya valid.
Permintaan Tidak Valid (400) BadArgument LargeFaceListId, faceListId, dan faceIds semuanya null.
Permintaan Tidak Valid (400) BadArgument 2 atau lebih largeFaceListId, faceListId, dan faceIds tidak null.
Permintaan Tidak Valid (400) BadArgument Argumen maxNumOfCandidatesReturned tidak valid. Rentang yang valid adalah antara [1, 1000].
Permintaan Tidak Valid (400) BadArgument Panjang faceIds tidak dalam rentang yang valid. Rentang yang valid adalah antara [1, 1000].
Permintaan Tidak Valid (400) FaceNotFound Wajah tidak ditemukan.
Permintaan Tidak Valid (400) FaceListNotFound Daftar wajah tidak ditemukan.
Permintaan Tidak Valid (400) LargeFaceListNotFound Daftar wajah besar tidak ditemukan.
Permintaan Tidak Valid (400) LargeFaceListNotTrained Daftar wajah besar tidak dilatih.
Permintaan Tidak Valid (400) FaceListNotReady Daftar wajah kosong.
Conflict (409) LargeFaceListTrainingNotFinished Daftar wajah besar sedang dalam pelatihan.

Kode kesalahan Grup Wajah

Kode kesalahan ini dapat dikembalikan oleh operasi Grup Wajah.

Kode status http Error code Error message Description
Permintaan Tidak Valid (400) BadArgument 'recognitionModel' tidak kompatibel.
Permintaan Tidak Valid (400) BadArgument Panjang faceIds tidak dalam rentang yang valid. Rentang yang valid adalah antara [2, 1000].

Operasi Grup Orang

Kode kesalahan ini dapat dikembalikan oleh operasi Grup Orang.

Kode kesalahan Grup Orang

Kode status http Error code Error message Description
Permintaan Tidak Valid (400) BadArgument ID grup orang tidak valid. Karakter yang valid adalah huruf bahasa Inggris dalam huruf kecil, digit, '-' atau '_'. Panjang maksimum adalah 64.
Forbidden (403) QuotaExceeded Nomor grup orang mencapai batas tingkat langganan.
Forbidden (403) QuotaExceeded Jumlah orang mencapai batas tingkat grup orang.
Forbidden (403) QuotaExceeded Jumlah orang mencapai batas tingkat langganan.
Forbidden (403) QuotaExceeded Jumlah wajah yang bertahan mencapai batas.
Tidak Ditemukan(404) PersonGroupNotFound Grup orang tidak ditemukan.
Tidak Ditemukan(404) PersonGroupNotFound ID grup orang tidak valid.
Tidak Ditemukan(404) PersonNotFound Orang <personId> tidak ditemukan.
Tidak Ditemukan(404) PersonNotFound ID Orang tidak valid.
Tidak Ditemukan(404) PersistedFaceNotFound Wajah yang bertahan tidak ditemukan.
Tidak Ditemukan(404) PersistedFaceNotFound Wajah <faceId> yang bertahan tidak ditemukan.
Tidak Ditemukan(404) PersistedFaceNotFound ID wajah yang dipertahankan tidak valid.
Tidak Ditemukan(404) PersonGroupNotTrained Grup orang tidak terlatih. Kesalahan ini muncul pada mendapatkan status pelatihan grup yang tidak pernah dilatih.
Conflict (409) PersonGroupExists Grup orang sudah ada.
Conflict (409) PersonGroupTrainingNotFinished Grup orang sedang dalam pelatihan. Coba lagi setelah pelatihan selesai.

Kode kesalahan Grup Orang Besar

Kode status http Error code Error message Description
Permintaan Tidak Valid (400) BadArgument ID grup orang besar tidak valid. Karakter yang valid adalah huruf bahasa Inggris dalam huruf kecil, digit, '-' atau '_'. Panjang maksimum adalah 64.
Permintaan Tidak Valid (400) BadArgument Baik 'nama' maupun 'userData' kosong.
Forbidden (403) QuotaExceeded Jumlah grup orang besar mencapai batas tingkat langganan.
Forbidden (403) QuotaExceeded Jumlah orang mencapai batas tingkat grup orang besar.
Forbidden (403) QuotaExceeded Jumlah orang mencapai batas tingkat langganan.
Forbidden (403) QuotaExceeded Jumlah wajah yang bertahan mencapai batas.
Tidak Ditemukan(404) LargePersonGroupNotFound Grup orang besar tidak ditemukan.
Tidak Ditemukan(404) LargePersonGroupNotFound ID grup orang besar tidak valid.
Tidak Ditemukan(404) PersonNotFound Orang <personId> tidak ditemukan.
Tidak Ditemukan(404) PersonNotFound ID Orang tidak valid.
Tidak Ditemukan(404) PersistedFaceNotFound Wajah yang bertahan tidak ditemukan.
Tidak Ditemukan(404) PersistedFaceNotFound Wajah <faceId> yang bertahan tidak ditemukan.
Tidak Ditemukan(404) PersistedFaceNotFound ID wajah yang dipertahankan tidak valid.
Tidak Ditemukan(404) LargePersonGroupNotTrained Kelompok orang besar tidak terlatih. Kesalahan ini muncul pada mendapatkan status pelatihan grup yang tidak pernah dilatih.
Conflict (409) LargePersonGroupExists Grup orang besar sudah ada.
Conflict (409) LargePersonGroupTrainingNotFinished Kelompok orang besar sedang dalam pelatihan. Coba lagi setelah pelatihan selesai.

Operasi Daftar Wajah

Kode kesalahan ini dapat dikembalikan oleh operasi Daftar Wajah.

Kode kesalahan Daftar Wajah

Kode status http Error code Error message Description
Permintaan Tidak Valid (400) BadArgument ID daftar wajah tidak valid. Karakter yang valid adalah huruf bahasa Inggris dalam huruf kecil, digit, '-' atau '_'. Panjang maksimum adalah 64.
Forbidden (403) QuotaExceeded Jumlah wajah yang bertahan mencapai batas.
Tidak Ditemukan(404) FaceListNotFound Daftar wajah tidak ditemukan.
Tidak Ditemukan(404) FaceListNotFound ID daftar wajah tidak valid.
Tidak Ditemukan(404) PersistedFaceNotFound Wajah yang bertahan tidak ditemukan.
Tidak Ditemukan(404) PersistedFaceNotFound ID wajah yang dipertahankan tidak valid.
Conflict (409) FaceListExists Daftar wajah sudah ada.

Kode kesalahan Daftar Wajah Besar

Kode status http Error code Error message Description
Permintaan Tidak Valid (400) BadArgument ID daftar wajah besar tidak valid. Karakter yang valid adalah huruf bahasa Inggris dalam huruf kecil, digit, '-' atau '_'. Panjang maksimum adalah 64.
Permintaan Tidak Valid (400) BadArgument Baik 'nama' maupun 'userData' kosong.
Forbidden (403) QuotaExceeded Jumlah Daftar Wajah Besar mencapai batas.
Forbidden (403) QuotaExceeded Jumlah wajah yang bertahan mencapai batas.
Tidak Ditemukan(404) LargeFaceListNotFound Daftar wajah besar tidak ditemukan.
Tidak Ditemukan(404) LargeFaceListNotFound ID daftar wajah besar tidak valid.
Tidak Ditemukan(404) PersistedFaceNotFound Wajah <faceId> Daftar Wajah Besar tidak ditemukan.
Tidak Ditemukan(404) PersistedFaceNotFound ID wajah yang dipertahankan tidak valid.
Tidak Ditemukan(404) LargeFaceListNotTrained Daftar wajah besar tidak dilatih. Kesalahan ini muncul pada mendapatkan status pelatihan daftar wajah besar yang tidak pernah dilatih.
Conflict (409) LargeFaceListExists Daftar wajah besar sudah ada.
Conflict (409) LargeFaceListTrainingNotFinished Daftar wajah besar sedang dalam pelatihan. Coba lagi setelah pelatihan selesai.

Operasi Direktori Orang

Kode kesalahan ini dapat dikembalikan oleh operasi Direktori Orang.

Kode kesalahan Direktori Orang

Kode status http Error code Error message Description
Permintaan Tidak Valid (400) BadArgument Model pengenalan tidak didukung untuk fitur ini.
Permintaan Tidak Valid (400) BadArgument 'start' bukan ID orang yang valid.
Permintaan Tidak Valid (400) BadArgument Baik 'nama' maupun 'userData' kosong.
Permintaan Tidak Valid (400) DynamicPersonGroupNotFound ID grup orang dinamis tidak valid.
Forbidden (403) QuotaExceeded Jumlah orang mencapai batas tingkat langganan.
Forbidden (403) QuotaExceeded Jumlah wajah yang bertahan mencapai batas.
Tidak Ditemukan(404) DynamicPersonGroupNotFound Grup orang dinamis tidak ditemukan.
Tidak Ditemukan(404) DynamicPersonGroupNotFound DynamicPersonGroupPersonReference <groupId> tidak ditemukan.
Tidak Ditemukan(404) PersonNotFound Orang tidak ditemukan.
Tidak Ditemukan(404) PersonNotFound ID Orang tidak valid.
Tidak Ditemukan(404) PersistedFaceNotFound Wajah yang bertahan tidak ditemukan.
Tidak Ditemukan(404) PersistedFaceNotFound Wajah <faceId> yang bertahan tidak ditemukan.
Tidak Ditemukan(404) PersistedFaceNotFound Id Wajah Yang Dipertahankan tidak valid.
Conflict (409) DynamicPersonGroupExists ID <groupId> grup orang dinamis sudah ada.

Next steps