Face List Operations - Get Large Face List Training Status

Service:

Azure AI Services

Version d'API:

v1.1-preview.1

Pour case activée l’entraînement de la liste de visages volumineux status terminé ou en cours. L’entraînement de la liste de visages volumineux est une opération asynchrone déclenchée par « Entraîner une grande liste de visages ».

Le temps d’entraînement dépend du nombre d’entrées de visages dans une liste de visages volumineux. Il peut être en secondes, ou jusqu’à une demi-heure pour 1 000 000 visages.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
apiVersion	path	True	string	Version d'API
endpoint	path	True	string uri	Points de terminaison Cognitive Services pris en charge (protocole et nom d’hôte, par exemple : https://{resource-name}.cognitiveservices.azure.com).
largeFaceListId	path	True	string	Le caractère valide est une lettre en minuscules ou chiffre ou « - » ou « _ », la longueur maximale est de 64. Modèle d’expression régulière: ^[a-z0-9-_]+$

Réponses

Nom	Type	Description
200 OK	TrainingResult	Un appel réussi retourne les status d’entraînement de la liste de visages volumineux.
Other Status Codes	FaceErrorResponse	Réponse d’erreur inattendue. En-têtes x-ms-error-code: string

Sécurité

Ocp-Apim-Subscription-Key

Clé secrète de votre abonnement Azure AI Face.

Type: apiKey
Dans: header

AADToken

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: accessCode
URL d’autorisation: https://api.example.com/oauth2/authorize
URL du jeton: https://api.example.com/oauth2/token

Étendues

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

Exemples

Get Training Status of LargeFaceList

Exemple de requête

HTTP

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

Exemple de réponse

Code d’état:

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
}

Définitions

Nom	Description
FaceError	Objet error. Pour plus d’informations sur les codes d’erreur et les messages retournés par le service Visage, reportez-vous au lien suivant : https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Réponse contenant les détails de l’erreur.
OperationStatus	Status d’une opération de longue durée.
TrainingResult	Résultat de l’apprentissage d’un conteneur

FaceError

Objet error. Pour plus d’informations sur les codes d’erreur et les messages retournés par le service Visage, reportez-vous au lien suivant : https://aka.ms/face-error-codes-and-messages.

Nom	Type	Description
code	string	Un des ensembles de codes d’erreur définis par le serveur.
message	string	Représentation lisible de l’erreur.

FaceErrorResponse

Réponse contenant les détails de l’erreur.

Nom	Type	Description
error	FaceError	Objet error.

OperationStatus

Status d’une opération de longue durée.

Nom	Type	Description
failed	string	L’opération a échoué.
notStarted	string	L’opération n’est pas démarrée.
running	string	L’opération est toujours en cours d’exécution.
succeeded	string	L’opération a réussi.

TrainingResult

Résultat de l’apprentissage d’un conteneur

Nom	Type	Description
createdDateTime	string	Chaîne de date et d’heure UTC combinée qui décrit l’heure de création du groupe de personnes, du grand groupe de personnes ou de la grande liste de visages.
lastActionDateTime	string	Une chaîne de date et d’heure UTC combinée qui décrit l’heure de la dernière modification du groupe de personnes, d’un grand groupe de personnes ou d’une grande liste de visages peut être une valeur Null lorsque le groupe n’est pas correctement entraîné.
lastSuccessfulTrainingDateTime	string	Chaîne de date et d’heure UTC combinée qui décrit l’heure de la dernière formation réussie du groupe de personnes, du grand groupe de personnes ou de la grande liste de visages.
message	string	Afficher le message d’échec en cas d’échec de l’entraînement (omis lorsque l’entraînement réussit).
status	OperationStatus	Formation status du conteneur.