Person Directory Operations - Delete Person
Usuń istniejącą osobę z katalogu osób. Utrwalone identyfikatoryFaceId, userData, nazwisko osoby i funkcje twarzy w wpisie osoby zostaną usunięte.
DELETE {endpoint}/face/{apiVersion}/persons/{personId}
Parametry identyfikatora URI
Nazwa | W | Wymagane | Typ | Opis |
---|---|---|---|---|
api
|
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). |
person
|
path | True |
string uuid |
Identyfikator osoby. |
Odpowiedzi
Nazwa | Typ | Opis |
---|---|---|
202 Accepted |
Pomyślne wywołanie zwraca pustą treść odpowiedzi. Usługa zaakceptowała żądanie i wkrótce rozpocznie przetwarzanie. Klient może wysyłać zapytania dotyczące stanu operacji i wyniku przy użyciu adresu URL określonego w nagłówku odpowiedzi "Operation-Location". Adres URL wygasa w ciągu 48 godzin. Nagłówki operation-Location: string |
|
Other Status Codes |
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 Person
Przykładowe żądanie
DELETE {endpoint}/face/v1.2-preview.1/persons/85c0c630-c9c9-40f8-8a4e-f9ae4f926ea5
Przykładowa odpowiedź
location: https://contoso.com/operationstatus
operation-Location: https://contoso.com/operationstatus
Definicje
Nazwa | Opis |
---|---|
Face |
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. |
Face |
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 |
Obiekt błędu. |