Udostępnij za pośrednictwem


Face List Operations - Delete Face List Face

Usuń twarz z listy twarzy według określonego identyfikatora faceListId i utrwalonegoFaceId.
Dodawanie/usuwanie twarzy do/z tej samej listy twarzy jest przetwarzane sekwencyjnie i do/z różnych list twarzy są równolegle.

DELETE {endpoint}/face/{apiVersion}/facelists/{faceListId}/persistedfaces/{persistedFaceId}

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
apiVersion
path True

string

Wersja interfejsu API

endpoint
path True

string (uri)

Obsługiwane punkty końcowe usług Cognitive Services (protokół i nazwa hosta, na przykład: https://{nazwa-zasobu}.cognitiveservices.azure.com).

faceListId
path True

string

minLength: 1
maxLength: 64
pattern: ^[a-z0-9-_]+$

Prawidłowy znak to litera w małych literach lub cyfrach lub "-" lub "_", maksymalna długość to 64.

persistedFaceId
path True

string (uuid)

Face ID twarzy.

Odpowiedzi

Nazwa Typ Opis
200 OK

Żądanie zakończyło się pomyślnie.

Other Status Codes

FaceErrorResponse

Nieoczekiwana odpowiedź na błąd.

Nagłówki

x-ms-error-code: string

Zabezpieczenia

Ocp-Apim-Subscription-Key

Klucz tajny subskrypcji rozpoznawania twarzy w usłudze Azure AI.

Typ: apiKey
W: header

AADToken

Przepływ OAuth2 usługi Azure Active Directory

Typ: oauth2
Flow: accessCode
Adres URL autoryzacji: https://api.example.com/oauth2/authorize
Adres URL tokenu: https://api.example.com/oauth2/token

Zakresy

Nazwa Opis
https://cognitiveservices.azure.com/.default

Przykłady

Delete Face from FaceList

Przykładowe żądanie

DELETE {endpoint}/face/v1.2-preview.1/facelists/your_face_list_id/persistedfaces/43897a75-8d6f-42cf-885e-74832febb055

Przykładowa odpowiedź

Definicje

Nazwa Opis
FaceError

Obiekt błędu. Aby uzyskać szczegółowe informacje na temat kodów błędów i komunikatów zwracanych przez usługę rozpoznawania twarzy, zapoznaj się z następującym linkiem: https://aka.ms/face-error-codes-and-messages.

FaceErrorResponse

Odpowiedź zawierająca szczegóły błędu.

FaceError

Obiekt błędu. Aby uzyskać szczegółowe informacje na temat kodów błędów i komunikatów zwracanych przez usługę rozpoznawania twarzy, zapoznaj się z następującym linkiem: https://aka.ms/face-error-codes-and-messages.

Nazwa Typ Opis
code

string

Jeden z zdefiniowanych przez serwer zestaw kodów błędów.

message

string

Czytelna dla człowieka reprezentacja błędu.

FaceErrorResponse

Odpowiedź zawierająca szczegóły błędu.

Nazwa Typ Opis
error

FaceError

Obiekt błędu.