Person Directory Operations - Delete Person Face
Ta bort ett ansikte från en person i Person Directory med angivet personId och persistedFaceId.
Att lägga till/ta bort ansikten till/från en samma person bearbetas sekventiellt. Att lägga till/ta bort ansikten till/från olika personer bearbetas parallellt.
DELETE {endpoint}/face/{apiVersion}/persons/{personId}/recognitionModels/{recognitionModel}/persistedfaces/{persistedFaceId}
URI-parametrar
Name | I | Obligatorisk | Typ | Description |
---|---|---|---|---|
api
|
path | True |
string |
API-version |
endpoint
|
path | True |
string uri |
Cognitive Services-slutpunkter som stöds (protokoll och värdnamn, till exempel: https://{resource-name}.cognitiveservices.azure.com). |
persisted
|
path | True |
string uuid |
Ansikts-ID för ansiktet. |
person
|
path | True |
string uuid |
Person-ID för personen. |
recognition
|
path | True |
Den "recognitionModel" som är associerad med ansikten. |
Svar
Name | Typ | Description |
---|---|---|
202 Accepted |
Ett lyckat anrop returnerar en tom svarstext. Tjänsten har godkänt begäran och kommer snart att börja bearbetas. Klienten kan köra frågor mot åtgärdsstatusen och resultatet med hjälp av den URL som anges i svarshuvudet "Åtgärdsplats". URL:en upphör att gälla om 48 timmar. Sidhuvuden operation-Location: string |
|
Other Status Codes |
Ett oväntat felsvar. Sidhuvuden x-ms-error-code: string |
Säkerhet
Ocp-Apim-Subscription-Key
Den hemliga nyckeln för din Azure AI Face-prenumeration.
Typ:
apiKey
I:
header
AADToken
The Azure Active Directory OAuth2 Flow
Typ:
oauth2
Flow:
accessCode
Auktoriseringswebbadress:
https://api.example.com/oauth2/authorize
Token-webbadress:
https://api.example.com/oauth2/token
Omfattningar
Name | Description |
---|---|
https://cognitiveservices.azure.com/.default |
Exempel
Delete Face from PersonDirectory Person
Exempelbegäran
DELETE {endpoint}/face/v1.2-preview.1/persons/85c0c630-c9c9-40f8-8a4e-f9ae4f926ea5/recognitionModels/recognition_01/persistedfaces/43897a75-8d6f-42cf-885e-74832febb055
Exempelsvar
location: https://contoso.com/operationstatus
operation-Location: https://contoso.com/operationstatus
Definitioner
Name | Description |
---|---|
Face |
Felobjektet. Mer information om felkoder och meddelanden som returneras av ansiktstjänsten finns i följande länk: https://aka.ms/face-error-codes-and-messages. |
Face |
Ett svar som innehåller felinformation. |
Recognition |
Igenkänningsmodellen för ansiktet. |
FaceError
Felobjektet. Mer information om felkoder och meddelanden som returneras av ansiktstjänsten finns i följande länk: https://aka.ms/face-error-codes-and-messages.
Name | Typ | Description |
---|---|---|
code |
string |
En av en serverdefinierad uppsättning felkoder. |
message |
string |
En mänsklig läsbar representation av felet. |
FaceErrorResponse
Ett svar som innehåller felinformation.
Name | Typ | Description |
---|---|---|
error |
Felobjektet. |
RecognitionModel
Igenkänningsmodellen för ansiktet.
Name | Typ | Description |
---|---|---|
recognition_01 |
string |
Standardigenkänningsmodellen för "Detect". Alla faceIds som skapades före mars 2019 är kopplade till den här igenkänningsmodellen. |
recognition_02 |
string |
Igenkänningsmodellen släpptes 2019 mars. |
recognition_03 |
string |
Igenkänningsmodell som släpptes 2020 maj. |
recognition_04 |
string |
Igenkänningsmodellen släpptes 2021 februari. Vi rekommenderar att du använder den här igenkänningsmodellen för bättre igenkänningsnoggrannhet. |