Face List Operations - Get Large Face List Training Status

Layanan:

Azure AI Services

Versi API:

v1.2-preview.1

Untuk memeriksa status pelatihan Daftar Wajah Besar selesai atau masih berlangsung. Pelatihan Daftar Wajah Besar adalah operasi asinkron yang dipicu oleh "Latih Daftar Wajah Besar".

Waktu pelatihan tergantung pada jumlah entri wajah dalam Daftar Wajah Besar. Bisa dalam hitung detik, atau hingga setengah jam untuk 1.000.000 wajah.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
apiVersion	path	True	string	Versi API
endpoint	path	True	string uri	Titik akhir Cognitive Services yang didukung (protokol dan nama host, misalnya: https://{resource-name}.cognitiveservices.azure.com).
largeFaceListId	path	True	string	Karakter yang valid adalah huruf dalam huruf kecil atau digit atau '-' atau '_', panjang maksimum adalah 64. Pola regex: ^[a-z0-9-_]+$

Respons

Nama	Jenis	Deskripsi
200 OK	TrainingResult	Panggilan yang berhasil mengembalikan status pelatihan Daftar Wajah Besar.
Other Status Codes	FaceErrorResponse	Respons kesalahan tak terduga. Header x-ms-error-code: string

Keamanan

Ocp-Apim-Subscription-Key

Kunci rahasia untuk langganan Azure AI Face Anda.

Jenis: apiKey
Dalam: header

AADToken

Alur OAuth2 Azure Active Directory

Jenis: oauth2
Alur: accessCode
URL Otorisasi: https://api.example.com/oauth2/authorize
URL token: https://api.example.com/oauth2/token

Cakupan

Nama	Deskripsi
https://cognitiveservices.azure.com/.default

Contoh

Get Training Status of LargeFaceList

Permintaan sampel

HTTP

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

Respon sampel

Kode status:

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
}

Definisi

Nama	Deskripsi
FaceError	Objek kesalahan. Untuk detail komprehensif tentang kode kesalahan dan pesan yang dikembalikan oleh Layanan Wajah, lihat tautan berikut: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Respons yang berisi detail kesalahan.
OperationStatus	Status operasi jangka panjang.
TrainingResult	Hasil pelatihan kontainer

FaceError

Objek kesalahan. Untuk detail komprehensif tentang kode kesalahan dan pesan yang dikembalikan oleh Layanan Wajah, lihat tautan berikut: https://aka.ms/face-error-codes-and-messages.

Nama	Jenis	Deskripsi
code	string	Salah satu sekumpulan kode kesalahan yang ditentukan server.
message	string	Representasi kesalahan yang dapat dibaca manusia.

FaceErrorResponse

Respons yang berisi detail kesalahan.

Nama	Jenis	Deskripsi
error	FaceError	Objek kesalahan.

OperationStatus

Status operasi jangka panjang.

Nama	Jenis	Deskripsi
failed	string	Operasi gagal.
notStarted	string	Operasi tidak dimulai.
running	string	Operasi masih berjalan.
succeeded	string	Operasi berhasil.

TrainingResult

Hasil pelatihan kontainer

Nama	Jenis	Deskripsi
createdDateTime	string	String tanggal dan waktu UTC gabungan yang menjelaskan waktu yang dibuat dari grup orang, grup orang besar, atau daftar wajah besar.
lastActionDateTime	string	String tanggal dan waktu UTC gabungan yang menjelaskan waktu modifikasi terakhir grup orang, grup orang besar, atau daftar wajah besar, bisa berupa nilai null saat grup tidak berhasil dilatih.
lastSuccessfulTrainingDateTime	string	String tanggal dan waktu UTC gabungan yang menjelaskan waktu pelatihan terakhir yang berhasil dari grup orang, grup orang besar, atau daftar wajah besar.
message	string	Tampilkan pesan kegagalan saat pelatihan gagal (dihilangkan saat pelatihan berhasil).
status	OperationStatus	Status pelatihan kontainer.