Person Directory Operations - Update Person Face

Service:

Azure AI Services

API-versie:

v1.2-preview.1

Werk het userData-veld van een persoon van een persistent gezicht bij.

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

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).
persistedFaceId	path	True	string (uuid)	Face ID van het gezicht.
personId	path	True	string (uuid)	Persoons-id van de persoon.
recognitionModel	path	True	RecognitionModel	Het 'recognitionModel' dat is gekoppeld aan gezichten.

Aanvraagbody

Name	Type	Description
userData	string	Door de gebruiker verstrekte gegevens die aan het gezicht zijn gekoppeld. De lengtelimiet is 1K.

Antwoorden

Name	Type	Description
200 OK		De aanvraag is voltooid.
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

Update Face of PersonDirectory Person

Voorbeeldaanvraag

HTTP

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

{
  "userData": "your_user_data"
}

Voorbeeldrespons

Statuscode:

200

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.
RecognitionModel	Het herkenningsmodel voor het gezicht.

FaceError

Object

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

Object

Een antwoord met foutdetails.

Name	Type	Description
error	FaceError	Het foutobject.

RecognitionModel

Inventarisatie

Het herkenningsmodel voor het gezicht.

Waarde	Description
recognition_01	Het standaardherkenningsmodel voor 'Detecteren'. Al deze faceIds die vóór 2019 maart zijn gemaakt, worden gekoppeld aan dit herkenningsmodel.
recognition_02	Het herkenningsmodel is uitgebracht in maart 2019.
recognition_03	Het herkenningsmodel is uitgebracht in 2020.
recognition_04	Het herkenningsmodel is uitgebracht in 2021 februari. Het is raadzaam om dit herkenningsmodel te gebruiken voor betere nauwkeurigheid van herkenning.