Face List Operations - Get Large Face List Training Status

  • Riferimento
Servizio:
Azure AI Services
Versione API:
v1.2-preview.1

Per controllare lo stato di training dell'elenco viso grande completato o ancora in corso. Il training dell'elenco dei volti di grandi dimensioni è un'operazione asincrona attivata da "Train Large Face List".

Il tempo di training dipende dal numero di voci del viso in un elenco di visi 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://{nome-risorsa}.cognitiveservices.azure.com).
largeFaceListId
 path True

string

Il carattere valido è una lettera in lettere minuscole o cifre o '-' o '_', la 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 dell'elenco viso grande.
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 Viso di Intelligenza artificiale di Azure.

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.2-preview.1/largefacelists/your_large_face_list_id/training

Risposta di esempio

Codice di stato:
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
}

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 visi di grandi dimensioni.
lastActionDateTime

string

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

string

Stringa di data e ora UTC combinata che descrive l'ora dell'ultimo training riuscito del gruppo di persone, del gruppo di persone di grandi dimensioni o dell'elenco di visi 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 del training del contenitore.