Delen via


Person Directory Operations - Delete Person

Een bestaande persoon verwijderen uit persoonsdirectory. De persistentedFaceId(s), userData, person name and face feature(s) in de persoonsvermelding worden allemaal verwijderd.

DELETE {endpoint}/face/{apiVersion}/persons/{personId}

URI-parameters

Name In Vereist Type Description
apiVersion
path True

string

API-versie

endpoint
path True

string

uri

Ondersteunde Cognitive Services-eindpunten (protocol en hostnaam, bijvoorbeeld: https://{resource-name}.cognitiveservices.azure.com).

personId
path True

string

uuid

Persoons-id van de persoon.

Antwoorden

Name Type Description
202 Accepted

Een geslaagde aanroep retourneert een lege antwoordtekst. De service heeft de aanvraag geaccepteerd en wordt binnenkort verwerkt. De client kan een query uitvoeren op de bewerkingsstatus en het resultaat met behulp van de URL die is opgegeven in de antwoordheader Operation-Location. De URL verloopt over 48 uur.

Kopteksten

operation-Location: string

Other Status Codes

FaceErrorResponse

Een onverwachte foutreactie.

Kopteksten

x-ms-error-code: string

Beveiliging

Ocp-Apim-Subscription-Key

De geheime sleutel voor uw Azure AI Face-abonnement.

Type: apiKey
In: header

AADToken

De Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: accessCode
Autorisatie-URL: https://api.example.com/oauth2/authorize
Token-URL: https://api.example.com/oauth2/token

Bereiken

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

Voorbeelden

Delete Person

Voorbeeldaanvraag

DELETE {endpoint}/face/v1.2-preview.1/persons/85c0c630-c9c9-40f8-8a4e-f9ae4f926ea5

Voorbeeldrespons

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

Definities

Name Description
FaceError

Het foutobject. Raadpleeg de volgende koppeling voor uitgebreide informatie over foutcodes en berichten die worden geretourneerd door de Face-service: https://aka.ms/face-error-codes-and-messages.

FaceErrorResponse

Een antwoord met foutdetails.

FaceError

Het foutobject. Raadpleeg de volgende koppeling voor uitgebreide informatie over foutcodes en berichten die worden geretourneerd door de Face-service: https://aka.ms/face-error-codes-and-messages.

Name Type Description
code

string

Een van een door de server gedefinieerde set foutcodes.

message

string

Een leesbare weergave van de fout.

FaceErrorResponse

Een antwoord met foutdetails.

Name Type Description
error

FaceError

Het foutobject.