Share via


Person Group Operations - Train Person Group

Inviare un'attività di training per il gruppo di persone. La formazione è un passaggio fondamentale che può essere usato solo da un gruppo di persone addestrato da "Identifica da gruppo di persone".
L'attività di training è un'attività asincrona. Il tempo di training dipende dal numero di voci di persona e dai visi in un gruppo di persone. L'operazione potrebbe essere di alcuni secondi. Per controllare lo stato del training, usare "Get Person Group Training Status".

POST {endpoint}/face/{apiVersion}/persongroups/{personGroupId}/train

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).

personGroupId
path True

string

ID del contenitore.

Regex pattern: ^[a-z0-9-_]+$

Risposte

Nome Tipo Descrizione
202 Accepted

Una chiamata riuscita restituisce un corpo di risposta vuoto.

Headers

operation-Location: string

Other Status Codes

FaceErrorResponse

Risposta di errore imprevista.

Headers

x-ms-error-code: string

Sicurezza

Ocp-Apim-Subscription-Key

Chiave privata per la sottoscrizione di Viso di Intelligenza artificiale di Azure.

Type: apiKey
In: header

AADToken

Flusso OAuth2 di Azure Active Directory

Type: oauth2
Flow: accessCode
Authorization URL: https://api.example.com/oauth2/authorize
Token URL: https://api.example.com/oauth2/token

Scopes

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

Esempio

Train PersonGroup

Sample Request

POST {endpoint}/face/v1.1-preview.1/persongroups/your_person_group_id/train

Sample Response

operation-Location: https://contoso.com/operationstatus

Definizioni

Nome Descrizione
FaceError

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

FaceErrorResponse

Risposta contenente i dettagli dell'errore.

FaceError

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

Nome Tipo Descrizione
code

string

Uno dei set definiti 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.