Face List Operations - Get Large Face List Training Status

Hizmet:

Azure AI Services

API Sürümü:

v1.2

Büyük Yüz Tanıma Listesi eğitim durumunun tamamlandığını veya hala devam ettiğini denetlemek için. Büyük Yüz Tanıma Listesi eğitimi, "Büyük Yüz Listesini Eğit" tarafından tetiklenen zaman uyumsuz bir işlemdir.

Eğitim süresi, Büyük Yüz Listesi'ndeki yüz girdilerinin sayısına bağlıdır. Saniyeler içinde veya 1.000.000 yüz için yarım saate kadar olabilir.

GET {endpoint}/face/{apiVersion}/largefacelists/{largeFaceListId}/training

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
apiVersion	path	True	string	API Sürümü
endpoint	path	True	string (uri)	Desteklenen Bilişsel Hizmetler uç noktaları (protokol ve konak adı, örneğin: https://{resource-name}.cognitiveservices.azure.com).
largeFaceListId	path	True	string minLength: 1 maxLength: 64 pattern: ^[a-z0-9-_]+$	Geçerli karakter küçük harf veya basamaklı harf ya da '-' veya '_', maksimum uzunluk 64'dür.

Yanıtlar

Name	Tür	Description
200 OK	TrainingResult	Başarılı bir çağrı, Büyük Yüz Tanıma Listesi'nin eğitim durumunu döndürür.
Other Status Codes	FaceErrorResponse	Beklenmeyen bir hata yanıtı. Üst Bilgiler x-ms-error-code: string

Güvenlik

Ocp-Apim-Subscription-Key

Azure Yapay Zeka Yüz Tanıma aboneliğinizin gizli anahtarı.

Tür: apiKey
İçinde: header

AADToken

Azure Active Directory OAuth2 Akışı

Tür: oauth2
Akış: accessCode
Yetkilendirme URL’si: https://api.example.com/oauth2/authorize
Belirteç URL'si: https://api.example.com/oauth2/token

Kapsamlar

Name	Description
https://cognitiveservices.azure.com/.default

Örnekler

Get Training Status of LargeFaceList

Örnek isteği

HTTP

GET {endpoint}/face/v1.2/largefacelists/your_large_face_list_id/training

Örnek yanıt

Durum kodu:

200

{
  "status": "notStarted",
  "createdDateTime": "2024-03-05T11:07:58.371Z",
  "lastActionDateTime": "2024-03-05T11:07:58.371Z",
  "lastSuccessfulTrainingDateTime": "2024-03-05T11:07:58.371Z",
  "message": null
}

Tanımlar

Name	Description
FaceError	Hata nesnesi. Yüz Tanıma Hizmeti tarafından döndürülen hata kodları ve iletiler hakkında ayrıntılı bilgi için lütfen şu bağlantıya bakın: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Hata ayrıntılarını içeren bir yanıt.
OperationStatus	Uzun süre çalışan işlemin durumu.
TrainingResult	Kapsayıcının eğitim sonucu

FaceError

Object

Hata nesnesi. Yüz Tanıma Hizmeti tarafından döndürülen hata kodları ve iletiler hakkında ayrıntılı bilgi için lütfen şu bağlantıya bakın: https://aka.ms/face-error-codes-and-messages.

Name	Tür	Description
code	string	Sunucu tanımlı hata kodları kümesinden biri.
message	string	Hatanın insan tarafından okunabilir bir gösterimi.

FaceErrorResponse

Object

Hata ayrıntılarını içeren bir yanıt.

Name	Tür	Description
error	FaceError	Hata nesnesi.

OperationStatus

Listeleme

Uzun süre çalışan işlemin durumu.

Değer	Description
notStarted	İşlem başlatılmaz.
running	İşlem hala çalışıyor.
succeeded	İşlem başarılı oldu.
failed	İşlem başarısız oldu.

TrainingResult

Object

Kapsayıcının eğitim sonucu

Name	Tür	Description
createdDateTime	string (date-time)	Kişi grubunun, büyük kişi grubunun veya büyük yüz listesinin oluşturulan saatini açıklayan birleştirilmiş UTC tarih ve saat dizesi.
lastActionDateTime	string (date-time)	Grup başarıyla eğitilmediğinde kişi grubunun, büyük kişi grubunun veya büyük yüz listesinin son değiştirme zamanını açıklayan birleştirilmiş UTC tarih ve saat dizesi null değer olabilir.
lastSuccessfulTrainingDateTime	string (date-time)	Kişi grubunun, büyük kişi grubunun veya büyük yüz listesinin son başarılı eğitim zamanını açıklayan birleştirilmiş UTC tarih ve saat dizesi.
message	string	Eğitim başarısız olduğunda hata iletisini göster (eğitim başarılı olduğunda atlanır).
status	OperationStatus	Kapsayıcının eğitim durumu.