Person Group Operations - Get Large Person Group Training Status

Service:

Azure AI Services

API-versie:

v1.2-preview.1

Als u wilt controleren of de trainingsstatus van de Large Person Group is voltooid of nog steeds actief is. Training voor large person-groepen is een asynchrone bewerking die wordt geactiveerd door de API 'Grote persoonsgroep trainen'.
De trainingstijd is afhankelijk van het aantal vermeldingen van personen en hun gezichten in een grote groep personen. Het kan in seconden of maximaal een half uur duren voor 1.000.000 personen.

GET {endpoint}/face/{apiVersion}/largepersongroups/{largePersonGroupId}/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).
largePersonGroupId	path	True	string	Id van de container. Regex-patroon: ^[a-z0-9-_]+$

Antwoorden

Name	Type	Description
200 OK	TrainingResult	Een geslaagde aanroep retourneert de trainingsstatus van de Large Person Group.
Other Status Codes	FaceErrorResponse	Een onverwachte foutreactie. Kopteksten 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 Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: accessCode
Autorisatie-URL: https://api.example.com/oauth2/authorize
Token-URL: https://api.example.com/oauth2/token

Bereiken

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

Voorbeelden

Get Training Status of LargePersonGroup

Voorbeeldaanvraag

HTTP

GET {endpoint}/face/v1.2-preview.1/largepersongroups/your_large_person_group_id/training

Voorbeeldrespons

Statuscode:

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 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 leesbare weergave van de fout.

FaceErrorResponse

Een antwoord met foutdetails.

Name	Type	Description
error	FaceError	Het foutobject.

OperationStatus

De status van 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-datum- en tijdtekenreeks die de gemaakte tijd beschrijft van de persoonsgroep, grote persoonsgroep of grote gezichtslijst.
lastActionDateTime	string	Een gecombineerde UTC-datum- en tijdtekenreeks die de laatste wijzigingstijd van de persoonsgroep, grote persoonsgroep of grote gezichtslijst beschrijft, kan null-waarde zijn wanneer de groep niet is getraind.
lastSuccessfulTrainingDateTime	string	Een gecombineerde UTC-datum- en tijdtekenreeks die de laatste geslaagde trainingstijd van de persoonsgroep, grote persoonsgroep of een grote gezichtslijst beschrijft.
message	string	Foutbericht weergeven wanneer de training is mislukt (weggelaten wanneer de training is geslaagd).
status	OperationStatus	Trainingsstatus van de container.