Condividi tramite


Face List Operations - Get Large Face List Training Status

Per controllare lo stato di training di Large Face List completato o ancora in corso. Il training di Large Face List è un'operazione asincrona attivata da "Train Large Face List".

Il tempo di training dipende dal numero di voci del viso in un elenco di viso di grandi dimensioni. Potrebbe essere in secondi o fino a mezz'ora per 1.000.000 visi.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
apiVersion
path True

string

Versione API

endpoint
path True

string

uri

Endpoint di Servizi cognitivi supportati (protocollo e nome host, ad esempio: https://{resource-name}.cognitiveservices.azure.com).

largeFaceListId
path True

string

Il carattere valido è lettera in maiuscolo o minuscolo o '-' o '_', lunghezza massima è 64.

Criterio di espressione regolare: ^[a-z0-9-_]+$

Risposte

Nome Tipo Descrizione
200 OK

TrainingResult

Una chiamata con esito positivo restituisce lo stato di training di Large Face List.

Other Status Codes

FaceErrorResponse

Risposta di errore imprevista.

Intestazioni

x-ms-error-code: string

Sicurezza

Ocp-Apim-Subscription-Key

Chiave privata per la sottoscrizione di Azure AI Face.

Tipo: apiKey
In: header

AADToken

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: accessCode
URL di autorizzazione: https://api.example.com/oauth2/authorize
URL token: https://api.example.com/oauth2/token

Ambiti

Nome Descrizione
https://cognitiveservices.azure.com/.default

Esempio

Get Training Status of LargeFaceList

Esempio di richiesta

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

Risposta di esempio

{
  "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
}

Definizioni

Nome Descrizione
FaceError

Oggetto error. Per informazioni dettagliate sui codici di errore e i messaggi restituiti dal servizio Viso, vedere il collegamento seguente: https://aka.ms/face-error-codes-and-messages.

FaceErrorResponse

Risposta contenente i dettagli dell'errore.

OperationStatus

Stato dell'operazione a esecuzione prolungata.

TrainingResult

Risultato del training di un contenitore

FaceError

Oggetto error. Per informazioni dettagliate sui codici di errore e i messaggi restituiti dal servizio Viso, vedere il collegamento seguente: https://aka.ms/face-error-codes-and-messages.

Nome Tipo Descrizione
code

string

Uno di un set definito dal server di codici di errore.

message

string

Rappresentazione leggibile dell'errore.

FaceErrorResponse

Risposta contenente i dettagli dell'errore.

Nome Tipo Descrizione
error

FaceError

Oggetto error.

OperationStatus

Stato dell'operazione a esecuzione prolungata.

Nome Tipo Descrizione
failed

string

L'operazione non è riuscita.

notStarted

string

L'operazione non viene avviata.

running

string

L'operazione è ancora in esecuzione.

succeeded

string

L'operazione è riuscita.

TrainingResult

Risultato del training di un contenitore

Nome Tipo Descrizione
createdDateTime

string

Stringa di data e ora UTC combinata che descrive l'ora creata del gruppo di persone, un gruppo di persone di grandi dimensioni o un elenco di volti di grandi dimensioni.

lastActionDateTime

string

Una stringa di data e ora UTC combinata che descrive l'ultima ora di modifica del gruppo di persone, un gruppo di persone di grandi dimensioni o un elenco viso di grandi dimensioni, potrebbe essere valore Null quando il gruppo non è stato eseguito correttamente il training.

lastSuccessfulTrainingDateTime

string

Stringa di data e ora UTC combinata che descrive l'ultima ora di training riuscita del gruppo di persone, un gruppo di persone di grandi dimensioni o un elenco di volti di grandi dimensioni.

message

string

Visualizzare il messaggio di errore quando il training non è riuscito (omesso quando il training ha esito positivo).

status

OperationStatus

Stato di training del contenitore.