Person Directory Operations - Delete Person Face

Služba:

Azure AI Services

Verze rozhraní API:

v1.2-preview.1

Odstranění tváře z osoby v adresáři osob podle zadaného id personId a trvaléfaceId.
Přidávání a odstraňování tváří ze stejné osoby se bude zpracovávat postupně. Přidávání a odstraňování tváří z různých osob se zpracovává paralelně.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
apiVersion	path	True	string	Verze rozhraní API
endpoint	path	True	string uri	Podporované koncové body služeb Cognitive Services (protokol a název hostitele, například: https://{název_prostředku}.cognitiveservices.azure.com).
persistedFaceId	path	True	string uuid	ID tváře.
personId	path	True	string uuid	ID osoby.
recognitionModel	path	True	RecognitionModel	Model rozpoznávání přidružený k tvářím.

Odpovědi

Name	Typ	Description
202 Accepted		Úspěšné volání vrátí prázdný text odpovědi. Služba žádost přijala a brzy začne zpracovávat. Klient může dotazovat stav operace a výsledek pomocí adresy URL zadané v hlavičce odpovědi Operation-Location. Platnost adresy URL vyprší za 48 hodin. Hlavičky operation-Location: string
Other Status Codes	FaceErrorResponse	Neočekávaná chybová odpověď Hlavičky x-ms-error-code: string

Zabezpečení

Ocp-Apim-Subscription-Key

Tajný klíč předplatného Azure AI Face.

Typ: apiKey
V: header

AADToken

Tok Azure Active Directory OAuth2

Typ: oauth2
Tok: accessCode
URL autorizace: https://api.example.com/oauth2/authorize
URL tokenu: https://api.example.com/oauth2/token

Rozsahy

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

Příklady

Delete Face from PersonDirectory Person

Ukázkový požadavek

HTTP

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

Ukázková odpověď

Stavový kód:

202

location: https://contoso.com/operationstatus
operation-Location: https://contoso.com/operationstatus

Definice

Name	Description
FaceError	Objekt chyby. Podrobné informace o kódech chyb a zprávách vrácených službou Rozpoznávání tváře najdete na následujícím odkazu: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Odpověď obsahující podrobnosti o chybě.
RecognitionModel	Model rozpoznávání tváře.

FaceError

Objekt chyby. Podrobné informace o kódech chyb a zprávách vrácených službou Rozpoznávání tváře najdete na následujícím odkazu: https://aka.ms/face-error-codes-and-messages.

Name	Typ	Description
code	string	Jedna ze serverově definovaných kódů chyb.
message	string	Čitelné znázornění chyby člověkem.

FaceErrorResponse

Odpověď obsahující podrobnosti o chybě.

Name	Typ	Description
error	FaceError	Objekt chyby.

RecognitionModel

Model rozpoznávání tváře.

Name	Typ	Description
recognition_01	string	Výchozí model rozpoznávání pro "Zjistit". Všechny tyto faceId vytvořené před březnem 2019 jsou vázány s tímto modelem rozpoznávání.
recognition_02	string	Model rozpoznávání vydaný v březnu 2019
recognition_03	string	Model rozpoznávání vydaný v květnu 2020.
recognition_04	string	Model rozpoznávání vydaný v únoru 2021. Pro lepší přesnost rozpoznávání se doporučuje použít tento model rozpoznávání.