Face List Operations - Get Large Face List Training Status

Service:

Azure AI Services

API Version:

v1.1-preview.1

Als u wilt controleren of de trainingsstatus van de grote gezichtslijst is voltooid of nog steeds actief is. Grote gezichtslijsttraining is een asynchrone bewerking die wordt geactiveerd door 'Train Large Face List'.

De trainingstijd is afhankelijk van het aantal gezichtsvermeldingen in een lijst met grote gezichten. Het kan in seconden zijn, of tot een half uur voor 1.000.000 gezichten.

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

URI-parameters

Name	In	Vereist	Type	Description
apiVersion	path	True	string	API-versie
endpoint	path	True	string uri	Ondersteunde Cognitive Services-eindpunten (protocol- en hostnaam, bijvoorbeeld: https://{resource-name}.cognitiveservices.azure.com).
largeFaceListId	path	True	string	Geldig teken is letter in kleine letters of cijfers of '-' of '_', de maximale lengte is 64. Regex pattern: ^[a-z0-9-_]+$

Antwoorden

Name	Type	Description
200 OK	TrainingResult	Een geslaagde aanroep retourneert de trainingsstatus van de grote gezichtslijst.
Other Status Codes	FaceErrorResponse	Een onverwacht foutbericht. Headers x-ms-error-code: string

Beveiliging

Ocp-Apim-Subscription-Key

De geheime sleutel voor uw Azure AI Face-abonnement.

Type: apiKey
In: header

AADToken

De OAuth2-stroom van Azure Active Directory

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

Scopes

Name	Description
https://cognitiveservices.azure.com/.default

Voorbeelden

Get Training Status of LargeFaceList

Sample Request

HTTP

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

Sample Response

Status code:

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
}

Definities

Name	Description
FaceError	Het foutobject. Raadpleeg de volgende koppeling voor uitgebreide informatie over foutcodes en berichten die worden geretourneerd door de Face-service: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Een antwoord met foutdetails.
OperationStatus	De status van een langdurige bewerking.
TrainingResult	Trainingsresultaat van een container

FaceError

Het foutobject. Raadpleeg de volgende koppeling voor uitgebreide informatie over foutcodes en berichten die worden geretourneerd door de Face-service: https://aka.ms/face-error-codes-and-messages.

Name	Type	Description
code	string	Een van een door de server gedefinieerde set foutcodes.
message	string	Een door mensen leesbare weergave van de fout.

FaceErrorResponse

Een antwoord met foutdetails.

Name	Type	Description
error	FaceError	Het foutobject.

OperationStatus

De status van een langdurige bewerking.

Name	Type	Description
failed	string	De bewerking is mislukt.
notStarted	string	De bewerking is niet gestart.
running	string	De bewerking wordt nog steeds uitgevoerd.
succeeded	string	De bewerking is voltooid.

TrainingResult

Trainingsresultaat van een container

Name	Type	Description
createdDateTime	string	Een gecombineerde UTC-tekenreeks voor datum en tijd waarmee de gemaakte tijd van de personengroep, de grote personengroep of de grote gezichtslijst wordt beschreven.
lastActionDateTime	string	Een gecombineerde UTC-datum- en tijdtekenreeks die de laatste wijzigingstijd van de personengroep, grote personengroep of grote gezichtslijst beschrijft, kan een null-waarde zijn wanneer de groep niet is getraind.
lastSuccessfulTrainingDateTime	string	Een gecombineerde UTC-tekenreeks voor datum en tijd die de laatste geslaagde trainingstijd van de personengroep, grote personengroep of grote gezichtslijst beschrijft.
message	string	Foutbericht weergeven wanneer de training is mislukt (weggelaten wanneer de training is geslaagd).
status	OperationStatus	Trainingsstatus van de container.