Dela via


Person Group Operations - Delete Person Group Person

Ta bort en befintlig person från en persongrupp. PersistedFaceId, userData, personnamn och ansiktsfunktioner i personposten tas bort.

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

URI-parametrar

Name I Obligatorisk Typ Description
apiVersion
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).

personGroupId
path True

string

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

ID för containern.

personId
path True

string (uuid)

Personens ID.

Svar

Name Typ Description
200 OK

Begäran har slutförts.

Other Status Codes

FaceErrorResponse

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 Person from PersonGroup

Exempelbegäran

DELETE {endpoint}/face/v1.2-preview.1/persongroups/your_person_group_id/persons/25985303-c537-4467-b41d-bdb45cd95ca1

Exempelsvar

Definitioner

Name Description
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.

FaceErrorResponse

Ett svar som innehåller felinformation.

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

FaceError

Felobjektet.