Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
Sık karşılaşılan hata kodları
Bu hata kodları tüm Yüz Tanıma API'si çağrıları tarafından döndürülebilir.
| Http durum kodu | Error code | Error message | Description |
|---|---|---|---|
| Hatalı İstek (400) | BadArgument | İstek gövdesi geçersiz. | |
| Hatalı İstek (400) | BadArgument | JSON ayrıştırma hatası. | Hatalı veya tanınmayan istek JSON gövdesi. |
| Hatalı İstek (400) | BadArgument | 'recognitionModel' geçersiz. | |
| Hatalı İstek (400) | BadArgument | 'detectionModel' geçersiz. | |
| Hatalı İstek (400) | BadArgument | 'name' boş. | |
| Hatalı İstek (400) | BadArgument | 'name' çok uzun. | |
| Hatalı İstek (400) | BadArgument | 'userData' çok uzun. | |
| Hatalı İstek (400) | BadArgument | 'başlangıç' çok uzun. | |
| Hatalı İstek (400) | BadArgument | 'top' geçersiz. | |
| Hatalı İstek (400) | BadArgument | Bağımsız değişken targetFace aralık dışında. | |
| Hatalı İstek (400) | BadArgument | Geçersiz bağımsız değişken targetFace. | Geçersiz dize biçimi veya geçersiz sol/üst/yükseklik/genişlik değeri neden oldu. |
| Hatalı İstek (400) | InvalidURL | Geçersiz görüntü URL'si. | Desteklenen biçimler JPEG, PNG, GIF (ilk kare) ve BMP'dir. |
| Hatalı İstek (400) | InvalidURL | Hedef sunucudan geçersiz görüntü URL'si veya indirme hatası. Uzak sunucu hatası döndürüldü: "İstek gönderilirken bir hata oluştu." | |
| Hatalı İstek (400) | InvalidImage | Kod çözme hatası, görüntü biçimi desteklenmiyor. | |
| Hatalı İstek (400) | InvalidImage | Görüntüde yüz algılanmadı. | |
| Hatalı İstek (400) | InvalidImage | Görüntüde 1'den fazla yüz var. | |
| Hatalı İstek (400) | InvalidImageSize | Görüntü boyutu çok küçük. | Geçerli görüntü dosyası boyutu 1 KB'tan büyük veya buna eşit olmalıdır. |
| Hatalı İstek (400) | InvalidImageSize | Görüntü boyutu çok büyük. | Geçerli görüntü dosyası boyutu 6 MB'tan büyük olmamalıdır. |
| Unauthorized (401) | 401 | Geçersiz abonelik anahtarı veya yanlış API uç noktası nedeniyle erişim reddedildi. Etkin bir abonelik için geçerli bir anahtar sağladığınızdan ve kaynağınız için doğru bölgesel API uç noktasını kullandığınızdan emin olun. | |
| Forbidden (403) | UnsupportedFeature | Özellik desteklenmiyor, aşağıdaki özelliklerden biri veya daha fazlası için onay eksik: Tanımlama, Doğrulama. | Kayıt formu göndererek erişim için kaydolun. |
| Conflict (409) | ConcurrentOperationConflict | Kaynağında <resourceName>çakışma işlemi var, lütfen daha sonra deneyin. |
|
| Çok Fazla İstek Var (429) | 429 | Hız sınırı aşıldı. |
Yüz Algılama hata kodları
Bu hata kodları Yüz Algılama işlemi tarafından döndürülebilir.
| Http durum kodu | Error code | Error message | Description |
|---|---|---|---|
| Hatalı İstek (400) | BadArgument | Geçersiz bağımsız değişken returnFaceAttributes. | |
| Hatalı İstek (400) | BadArgument | 'returnFaceAttributes', detection_02 tarafından desteklenmiyor. | |
| Hatalı İstek (400) | BadArgument | 'returnLandmarks', detection_02 tarafından desteklenmiyor. | |
| Forbidden (403) | UnsupportedFeature | Dönüş Öznitelikleri (duygu, cinsiyet, yaş, gülümseme, yüz kılları, saç ve makyaj) kullanım dışı bırakılmıştır ve artık desteklenmemektedir. | Sınırlı özelliklerden herhangi birinin kullanımından yararlanabilecek sorumlu bir kullanım örneğine sahipseniz Azure Yüz Tanıma ekibine e-posta gönderin. |
Yüz Canlılığı Oturumu hata kodları
Bu hata kodları Yüz Canlılığı Oturumu işlemleri tarafından döndürülebilir.
| Http durum kodu | Error code | Error message | Description |
|---|---|---|---|
| Hatalı İstek (400) | BadArgument | Başlangıç parametresi geçersiz. Listeleme işlemine devam etmek için lütfen son girişin 'Kimlik' alanını belirtin. | |
| Hatalı İstek (400) | BadArgument | Üst parametre geçersiz. Geçerli aralık 1 ile 1000 (dahil) arasındadır. | |
| Hatalı İstek (400) | InvalidRequestBody | Yanlış istek gövdesi sağlandı. Lütfen işlem şemasını denetleyin ve yeniden deneyin. | |
| Hatalı İstek (400) | InvalidTokenLifetime | Geçersiz authTokenTimeToLiveInSeconds belirtildi. 60 ile 86400 içinde olmalıdır. | |
| Hatalı İstek (400) | InvalidLivenessOperationMode | Geçersiz livenessOperationMode belirtildi. 'Pasif' olmalıdır. | |
| Hatalı İstek (400) | InvalidDeviceCorrelationId | Oturum oluşturma veya oturum başlatma sırasında istek gövdesinde bir cihaz bağıntı kimliği gereklidir. Null veya boş olmamalıdır ve 64 karakterden fazla olmamalıdır. | |
| Bulunamadı (404) | SessionNotFound | Oturum kimliği bulunamadı. Oturum kimliğinin süresi doldu veya yok. |
Yüz Tanıma hata kodları
Bu hata kodları Yüz Tanıma işlemi tarafından döndürülebilir.
| Http durum kodu | Error code | Error message | Description |
|---|---|---|---|
| Hatalı İstek (400) | BadArgument | 'recognitionModel' uyumsuz. | |
| Hatalı İstek (400) | BadArgument | Kişi grubu kimliği geçersiz. | |
| Hatalı İstek (400) | BadArgument | Büyük kişi grubu kimliği geçersiz. | |
| Hatalı İstek (400) | BadArgument | Dinamik kişi grubu kimliği geçersiz. | |
| Hatalı İstek (400) | BadArgument | maxNumOfCandidatesReturned bağımsız değişkeni geçerli değil. | Geçerli aralık [1, 100] arasındadır. |
| Hatalı İstek (400) | BadArgument | confidenceThreshold bağımsız değişkeni geçerli değil. | Geçerli aralık [0, 1] arasındadır. |
| Hatalı İstek (400) | BadArgument | FaceId'lerin uzunluğu geçerli bir aralıkta değil. | Geçerli aralık [1, 10] arasındadır. |
| Hatalı İstek (400) | FaceNotFound | Yüz bulunamadı. | |
| Hatalı İstek (400) | PersonGroupNotFound | Kişi grubu bulunamadı. | |
| Hatalı İstek (400) | LargePersonGroupNotFound | Büyük kişi grubu bulunamadı. | |
| Hatalı İstek (400) | DynamicPersonGroupNotFound | Dinamik kişi grubu bulunamadı. | |
| Hatalı İstek (400) | PersonGroupNotTrained | Kişi grubu eğitilmemiş. | |
| Hatalı İstek (400) | LargePersonGroupNotTrained | Büyük kişi grubu eğitilmemiş. | |
| Hatalı İstek (400) | PersonGroupIdAndLargePersonGroupIdBothNotNull | Büyük kişi grubu kimliği ve kişi grubu kimliği null değildir. | |
| Hatalı İstek (400) | PersonGroupIdAndLargePersonGroupIdBothNull | Büyük kişi grubu kimliği ve kişi grubu kimliği null. | |
| Hatalı İstek (400) | MissingIdentificationScopeParameters | İstekte tanımlama kapsamı parametresi yok. | |
| Hatalı İstek (400) | IncompatibleIdentificationScopeParametersCombination | İstekte uyumsuz tanımlama kapsamı parametreleri var. | |
| Conflict (409) | PersonGroupTrainingNotFinished | Kişi grubu eğitim altında. | |
| Conflict (409) | LargePersonGroupTrainingNotFinished | Büyük kişi grubu eğitim altında. |
Yüz Doğrulama hata kodları
Bu hata kodları Yüz Doğrulama işlemiyle döndürülebilir.
| Http durum kodu | Error code | Error message | Description |
|---|---|---|---|
| Hatalı İstek (400) | BadArgument | 'recognitionModel' uyumsuz. | |
| Hatalı İstek (400) | BadArgument | Yüz Tanıma Kimliği geçersiz. | Geçerli bir faceId Yüz - Algıla'dan gelir. |
| Hatalı İstek (400) | BadArgument | Kişi kimliği geçersiz. | Kişi Grubu Kişisi Oluştur, Büyük Kişi Grubu Kişisi Oluştur veya Kişi Dizini - Kişi Oluştur'dan geçerli bir personId oluşturulur. |
| Hatalı İstek (400) | BadArgument | Kişi grubu kimliği geçersiz. | |
| Hatalı İstek (400) | BadArgument | Büyük kişi grubu kimliği geçersiz. | |
| Hatalı İstek (400) | PersonNotFound | Kişi bulunamadı. | |
| Hatalı İstek (400) | PersonGroupNotFound | Kişi Grubu bulunamadı. | |
| Hatalı İstek (400) | LargePersonGroupNotFound | Büyük Kişi Grubu bulunamadı. | |
| Bulunamadı (404) | FaceNotFound | Yüz bulunamadı. | |
| Bulunamadı (404) | PersonNotFound | Kişi bulunamadı. | |
| Bulunamadı (404) | PersistedFaceNotFound | Kişinin kalıcı yüzü bulunamadı. |
Benzer hata kodlarını bulma
Bu hata kodları Benzer Yüz Bul işlemi tarafından döndürülebilir.
| Http durum kodu | Error code | Error message | Description |
|---|---|---|---|
| Hatalı İstek (400) | BadArgument | 'recognitionModel' uyumsuz. | |
| Hatalı İstek (400) | BadArgument | Mod geçersiz. | |
| Hatalı İstek (400) | BadArgument | Yüz listesi kimliği geçersiz. | |
| Hatalı İstek (400) | BadArgument | Büyük yüz listesi kimliği geçersiz. | |
| Hatalı İstek (400) | BadArgument | LargeFaceListId, faceListId ve faceId'ler, bunlardan tam olarak biri geçerli değildir. | |
| Hatalı İstek (400) | BadArgument | LargeFaceListId, faceListId ve faceId değerlerinin tümü null. | |
| Hatalı İstek (400) | BadArgument | 2 veya daha fazla büyükFaceListId, faceListId ve faceId null değil. | |
| Hatalı İstek (400) | BadArgument | maxNumOfCandidatesReturned bağımsız değişkeni geçerli değil. | Geçerli aralık [1, 1000] arasındadır. |
| Hatalı İstek (400) | BadArgument | FaceId'lerin uzunluğu geçerli bir aralıkta değil. | Geçerli aralık [1, 1000] arasındadır. |
| Hatalı İstek (400) | FaceNotFound | Yüz bulunamadı. | |
| Hatalı İstek (400) | FaceListNotFound | Yüz listesi bulunamadı. | |
| Hatalı İstek (400) | LargeFaceListNotFound | Büyük yüz listesi bulunamadı. | |
| Hatalı İstek (400) | LargeFaceListNotTrained | Büyük yüz listesi eğitilmemiş. | |
| Hatalı İstek (400) | FaceListNotReady | Yüz listesi boş. | |
| Conflict (409) | LargeFaceListTrainingNotFinished | Büyük yüz listesi eğitim aşamasındadır. |
Yüz Tanıma Grubu hata kodları
Bu hata kodları Yüz Tanıma Grubu işlemi tarafından döndürülebilir.
| Http durum kodu | Error code | Error message | Description |
|---|---|---|---|
| Hatalı İstek (400) | BadArgument | 'recognitionModel' uyumsuz. | |
| Hatalı İstek (400) | BadArgument | FaceId'lerin uzunluğu geçerli bir aralıkta değil. | Geçerli aralık [2, 1000] arasındadır. |
Kişi Grubu işlemleri
Bu hata kodları, Kişi Grubu işlemleri tarafından döndürülebilir.
Kişi Grubu hata kodları
| Http durum kodu | Error code | Error message | Description |
|---|---|---|---|
| Hatalı İstek (400) | BadArgument | Kişi grubu kimliği geçersiz. | Geçerli karakter küçük harf, rakam, '-' veya '_' olan İngilizce harftir. Uzunluk üst sınırı 64'dür. |
| Forbidden (403) | QuotaExceeded | Kişi grubu numarası abonelik düzeyi sınırına ulaştı. | |
| Forbidden (403) | QuotaExceeded | Kişi numarası kişi grubu düzeyi sınırına ulaştı. | |
| Forbidden (403) | QuotaExceeded | Kişi numarası abonelik düzeyi sınırına ulaştı. | |
| Forbidden (403) | QuotaExceeded | Kalıcı yüz numarası sınırına ulaşıldı. | |
| Bulunamadı (404) | PersonGroupNotFound | Kişi grubu bulunamadı. | |
| Bulunamadı (404) | PersonGroupNotFound | Kişi grubu kimliği geçersiz. | |
| Bulunamadı (404) | PersonNotFound | Kişi <personId> bulunamadı. |
|
| Bulunamadı (404) | PersonNotFound | Kişi kimliği geçersiz. | |
| Bulunamadı (404) | PersistedFaceNotFound | Kalıcı yüz bulunamadı. | |
| Bulunamadı (404) | PersistedFaceNotFound | Kalıcı yüz <faceId> bulunamadı. |
|
| Bulunamadı (404) | PersistedFaceNotFound | Kalıcı yüz kimliği geçersiz. | |
| Bulunamadı (404) | PersonGroupNotTrained | Kişi grubu eğitilmemiş. | Bu hata, hiç eğitilmemiş bir grubun eğitim durumunu alma sırasında görünür. |
| Conflict (409) | PersonGroupExists | Kişi grubu zaten var. | |
| Conflict (409) | PersonGroupTrainingNotFinished | Kişi grubu eğitim altında. | Eğitim tamamlandıktan sonra yeniden deneyin. |
Büyük Kişi Grubu hata kodları
| Http durum kodu | Error code | Error message | Description |
|---|---|---|---|
| Hatalı İstek (400) | BadArgument | Büyük kişi grubu kimliği geçersiz. | Geçerli karakter küçük harf, rakam, '-' veya '_' olan İngilizce harftir. Uzunluk üst sınırı 64'dür. |
| Hatalı İstek (400) | BadArgument | Hem 'name' hem de 'userData' boş. | |
| Forbidden (403) | QuotaExceeded | Büyük kişi grup numarası abonelik düzeyi sınırına ulaştı. | |
| Forbidden (403) | QuotaExceeded | Kişi numarası büyük kişi grubu düzeyi sınırına ulaştı. | |
| Forbidden (403) | QuotaExceeded | Kişi numarası abonelik düzeyi sınırına ulaştı. | |
| Forbidden (403) | QuotaExceeded | Kalıcı yüz numarası sınırına ulaşıldı. | |
| Bulunamadı (404) | LargePersonGroupNotFound | Büyük kişi grubu bulunamadı. | |
| Bulunamadı (404) | LargePersonGroupNotFound | Büyük kişi grubu kimliği geçersiz. | |
| Bulunamadı (404) | PersonNotFound | Kişi <personId> bulunamadı. |
|
| Bulunamadı (404) | PersonNotFound | Kişi kimliği geçersiz. | |
| Bulunamadı (404) | PersistedFaceNotFound | Kalıcı yüz bulunamadı. | |
| Bulunamadı (404) | PersistedFaceNotFound | Kalıcı yüz <faceId> bulunamadı. |
|
| Bulunamadı (404) | PersistedFaceNotFound | Kalıcı yüz kimliği geçersiz. | |
| Bulunamadı (404) | LargePersonGroupNotTrained | Büyük kişi grubu eğitilmemiş. | Bu hata, hiç eğitilmemiş bir grubun eğitim durumunu alma sırasında görünür. |
| Conflict (409) | LargePersonGroupExists | Büyük kişi grubu zaten var. | |
| Conflict (409) | LargePersonGroupTrainingNotFinished | Büyük kişi grubu eğitim altında. | Eğitim tamamlandıktan sonra yeniden deneyin. |
Yüz Listesi işlemleri
Bu hata kodları Yüz Listesi işlemleri tarafından döndürülebilir.
Yüz Listesi hata kodları
| Http durum kodu | Error code | Error message | Description |
|---|---|---|---|
| Hatalı İstek (400) | BadArgument | Yüz listesi kimliği geçersiz. | Geçerli karakter küçük harf, rakam, '-' veya '_' olan İngilizce harftir. Uzunluk üst sınırı 64'dür. |
| Forbidden (403) | QuotaExceeded | Kalıcı yüz numarası sınırına ulaşıldı. | |
| Bulunamadı (404) | FaceListNotFound | Yüz listesi bulunamadı. | |
| Bulunamadı (404) | FaceListNotFound | Yüz listesi kimliği geçersiz. | |
| Bulunamadı (404) | PersistedFaceNotFound | Kalıcı yüz bulunamadı. | |
| Bulunamadı (404) | PersistedFaceNotFound | Kalıcı yüz kimliği geçersiz. | |
| Conflict (409) | FaceListExists | Yüz listesi zaten var. |
Büyük Yüz Listesi hata kodları
| Http durum kodu | Error code | Error message | Description |
|---|---|---|---|
| Hatalı İstek (400) | BadArgument | Büyük yüz listesi kimliği geçersiz. | Geçerli karakter küçük harf, rakam, '-' veya '_' olan İngilizce harftir. Uzunluk üst sınırı 64'dür. |
| Hatalı İstek (400) | BadArgument | Hem 'name' hem de 'userData' boş. | |
| Forbidden (403) | QuotaExceeded | Büyük Yüz Listesi numarasına ulaşıldı sınırı. | |
| Forbidden (403) | QuotaExceeded | Kalıcı yüz numarası sınırına ulaşıldı. | |
| Bulunamadı (404) | LargeFaceListNotFound | Büyük yüz listesi bulunamadı. | |
| Bulunamadı (404) | LargeFaceListNotFound | Büyük yüz listesi kimliği geçersiz. | |
| Bulunamadı (404) | PersistedFaceNotFound | Büyük Yüz Listesi Yüzü <faceId> bulunamadı. |
|
| Bulunamadı (404) | PersistedFaceNotFound | Kalıcı yüz kimliği geçersiz. | |
| Bulunamadı (404) | LargeFaceListNotTrained | Büyük yüz listesi eğitilmedi. | Bu hata, hiç eğitilmemiş büyük bir yüz listesinin eğitim durumunu alma sırasında görünür. |
| Conflict (409) | LargeFaceListExists | Büyük yüz listesi zaten var. | |
| Conflict (409) | LargeFaceListTrainingNotFinished | Büyük yüz listesi eğitim aşamasındadır. | Eğitim tamamlandıktan sonra yeniden deneyin. |
Kişi Dizini işlemleri
Bu hata kodları Kişi Dizini işlemleri tarafından döndürülebilir.
Kişi Dizini hata kodları
| Http durum kodu | Error code | Error message | Description |
|---|---|---|---|
| Hatalı İstek (400) | BadArgument | Bu özellik için tanıma modeli desteklenmiyor. | |
| Hatalı İstek (400) | BadArgument | 'start' geçerli bir kişi kimliği değil. | |
| Hatalı İstek (400) | BadArgument | Hem 'name' hem de 'userData' boş. | |
| Hatalı İstek (400) | DynamicPersonGroupNotFound | Dinamik kişi grubu kimliği geçersiz. | |
| Forbidden (403) | QuotaExceeded | Kişi numarası abonelik düzeyi sınırına ulaştı. | |
| Forbidden (403) | QuotaExceeded | Kalıcı yüz numarası sınırına ulaşıldı. | |
| Bulunamadı (404) | DynamicPersonGroupNotFound | Dinamik kişi grubu bulunamadı. | |
| Bulunamadı (404) | DynamicPersonGroupNotFound | DynamicPersonGroupPersonReference <groupId> bulunamadı. |
|
| Bulunamadı (404) | PersonNotFound | Kişi bulunamadı. | |
| Bulunamadı (404) | PersonNotFound | Kişi kimliği geçersiz. | |
| Bulunamadı (404) | PersistedFaceNotFound | Kalıcı yüz bulunamadı. | |
| Bulunamadı (404) | PersistedFaceNotFound | Kalıcı yüz <faceId> bulunamadı. |
|
| Bulunamadı (404) | PersistedFaceNotFound | Kalıcı Yüz Tanıma Kimliği geçersiz. | |
| Conflict (409) | DynamicPersonGroupExists | Dinamik kişi grubu kimliği <groupId> zaten var. |
Next steps