Person Directory Operations - Delete Person Face
Löschen Sie ein Gesicht aus einer Person im Personenverzeichnis anhand der angegebenen personId und persistedFaceId.
Das Hinzufügen/Löschen von Gesichtern zu/von derselben Person wird sequenziell verarbeitet. Das Hinzufügen/Löschen von Gesichtern zu/von verschiedenen Personen wird parallel verarbeitet.
DELETE {endpoint}/face/{apiVersion}/persons/{personId}/recognitionModels/{recognitionModel}/persistedfaces/{persistedFaceId}
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
api
|
path | True |
string |
API-Version |
endpoint
|
path | True |
string uri |
Unterstützte Cognitive Services-Endpunkte (Protokoll und Hostname, z. B. https://{resource-name}.cognitiveservices.azure.com). |
persisted
|
path | True |
string uuid |
Gesichtserkennungs-ID des Gesichts. |
person
|
path | True |
string uuid |
Personen-ID der Person. |
recognition
|
path | True |
Das "recognitionModel", das Gesichtern zugeordnet ist. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
202 Accepted |
Ein erfolgreicher Aufruf gibt einen leeren Antworttext zurück. Der Dienst hat die Anforderung akzeptiert und wird in Kürze mit der Verarbeitung beginnen. Der Client kann den Vorgang status und das Ergebnis mithilfe der url abfragen, die im Antwortheader "Operation-Location" angegeben ist. Die URL ist 48 Stunden lang gültig. Header operation-Location: string |
|
Other Status Codes |
Eine unerwartete Fehlerantwort. Header x-ms-error-code: string |
Sicherheit
Ocp-Apim-Subscription-Key
Der geheime Schlüssel für Ihr Azure KI-Gesichtserkennungsabonnement.
Typ:
apiKey
In:
header
AADToken
Der Azure Active Directory OAuth2-Flow
Typ:
oauth2
Ablauf:
accessCode
Autorisierungs-URL:
https://api.example.com/oauth2/authorize
Token-URL:
https://api.example.com/oauth2/token
Bereiche
Name | Beschreibung |
---|---|
https://cognitiveservices.azure.com/.default |
Beispiele
Delete Face from PersonDirectory Person
Beispielanforderung
DELETE {endpoint}/face/v1.1-preview.1/persons/85c0c630-c9c9-40f8-8a4e-f9ae4f926ea5/recognitionModels/recognition_01/persistedfaces/43897a75-8d6f-42cf-885e-74832febb055
Beispiel für eine Antwort
location: https://contoso.com/operationstatus
operation-Location: https://contoso.com/operationstatus
Definitionen
Name | Beschreibung |
---|---|
Face |
Das Fehlerobjekt. Ausführliche Informationen zu Fehlercodes und Meldungen, die vom Gesichtserkennungsdienst zurückgegeben werden, finden Sie unter folgendem Link: https://aka.ms/face-error-codes-and-messages. |
Face |
Eine Antwort, die Fehlerdetails enthält. |
Recognition |
Das Erkennungsmodell für das Gesicht. |
FaceError
Das Fehlerobjekt. Ausführliche Informationen zu Fehlercodes und Meldungen, die vom Gesichtserkennungsdienst zurückgegeben werden, finden Sie unter folgendem Link: https://aka.ms/face-error-codes-and-messages.
Name | Typ | Beschreibung |
---|---|---|
code |
string |
Einer von einem serverdefiniertem Satz von Fehlercodes. |
message |
string |
Eine lesbare Darstellung des Fehlers. |
FaceErrorResponse
Eine Antwort, die Fehlerdetails enthält.
Name | Typ | Beschreibung |
---|---|---|
error |
Das Fehlerobjekt. |
RecognitionModel
Das Erkennungsmodell für das Gesicht.
Name | Typ | Beschreibung |
---|---|---|
recognition_01 |
string |
Das Standarderkennungsmodell für "Detect". Alle faceIds, die vor März 2019 erstellt wurden, sind mit diesem Erkennungsmodell verbunden. |
recognition_02 |
string |
Das Erkennungsmodell wurde im März 2019 veröffentlicht. |
recognition_03 |
string |
Das Erkennungsmodell wurde im Mai 2020 veröffentlicht. |
recognition_04 |
string |
Das Erkennungsmodell wurde im Februar 2021 veröffentlicht. Es wird empfohlen, dieses Erkennungsmodell zu verwenden, um die Erkennungsgenauigkeit zu verbessern. |