Bagikan melalui


Face List Operations - Get Large Face List Training Status

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 yang tidak 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

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

Respon sampel

{
  "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 Face Service, silakan 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 Face Service, silakan lihat tautan berikut: https://aka.ms/face-error-codes-and-messages.

Nama Jenis Deskripsi
code

string

Salah satu set 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 menjadi 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.