Person Group Operations - Get Large Person Group Training Status

Servizio:

Azure AI Services

Versione API:

v1.2-preview.1

Per controllare lo stato di training del gruppo di persone di grandi dimensioni completato o ancora in corso. Il training del gruppo di persone di grandi dimensioni è un'operazione asincrona attivata dall'API "Train Large Person Group".
Il tempo di training dipende dal numero di voci di persona e dai visi in un gruppo di persone di grandi dimensioni. Potrebbe essere in secondi, o fino a mezz'ora per 1.000.000 persone.

GET {endpoint}/face/{apiVersion}/largepersongroups/{largePersonGroupId}/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).
largePersonGroupId	path	True	string	ID del contenitore. 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 Person Group.
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 LargePersonGroup

Esempio di richiesta

HTTP

GET {endpoint}/face/v1.2-preview.1/largepersongroups/your_large_person_group_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.