Face List Operations - Get Large Face List Training Status
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 |
---|---|---|---|---|
api
|
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). |
large
|
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: |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
Un appel réussi retourne les status d’entraînement de la liste de visages volumineux. |
|
Other Status Codes |
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
GET {endpoint}/face/v1.1-preview.1/largefacelists/your_large_face_list_id/training
Exemple de réponse
{
"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 |
---|---|
Face |
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. |
Face |
Réponse contenant les détails de l’erreur. |
Operation |
Status d’une opération de longue durée. |
Training |
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 |
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 |
Formation status du conteneur. |