Partager via

Person Directory Operations - Delete Person Face

  • Référence
Service:
Azure AI Services
Version d'API:
v1.2-preview.1

Supprimez un visage d’une personne dans l’annuaire de personnes par personId et persistedFaceId.
L’ajout/la suppression de visages vers/à partir d’une même personne sera traité de manière séquentielle. L’ajout/la suppression de visages à/de différentes personnes est traité en parallèle.

DELETE {endpoint}/face/{apiVersion}/persons/{personId}/recognitionModels/{recognitionModel}/persistedfaces/{persistedFaceId}

Paramètres URI

Nom Dans Obligatoire Type Description
apiVersion
 path True

string

Version de l’API
endpoint
 path True

string

uri

Points de terminaison Cognitive Services pris en charge (protocole et nom d’hôte, par exemple : https://{nom-ressource}.cognitiveservices.azure.com).
persistedFaceId
 path True

string

uuid

ID de visage du visage.
personId
 path True

string

uuid

ID de personne de la personne.
recognitionModel
 path True

RecognitionModel

Le « recognitionModel » associé aux visages.

Réponses

Nom Type Description
202 Accepted

Un appel réussi retourne un corps de réponse vide. Le service a accepté la demande et commencera à traiter bientôt. Le client peut interroger l’état et le résultat de l’opération à l’aide de l’URL spécifiée dans l’en-tête de réponse « Operation-Location ». L’URL expire dans 48 heures.

En-têtes

operation-Location: string
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

Delete Face from PersonDirectory Person

Exemple de requête

DELETE {endpoint}/face/v1.2-preview.1/persons/85c0c630-c9c9-40f8-8a4e-f9ae4f926ea5/recognitionModels/recognition_01/persistedfaces/43897a75-8d6f-42cf-885e-74832febb055

Exemple de réponse

Code d’état:
202 
location: https://contoso.com/operationstatus
operation-Location: https://contoso.com/operationstatus

Définitions

Nom Description
FaceError

Objet d’erreur. 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.
RecognitionModel

Modèle de reconnaissance pour le visage.

FaceError

Objet d’erreur. 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 ensemble de codes d’erreur définis par le serveur.
message

string

Représentation lisible par l’homme de l’erreur.

FaceErrorResponse

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

Nom Type Description
error

FaceError

Objet d’erreur.

RecognitionModel

Modèle de reconnaissance pour le visage.

Nom Type Description
recognition_01

string

Modèle de reconnaissance par défaut pour « Détecter ». Tous ces faceIds créés avant mars 2019 sont liés à ce modèle de reconnaissance.
recognition_02

string

Modèle de reconnaissance publié en mars 2019.
recognition_03

string

Modèle de reconnaissance publié en mai 2020.
recognition_04

string

Modèle de reconnaissance publié en février 2021. Il est recommandé d’utiliser ce modèle de reconnaissance pour une meilleure précision de reconnaissance.