Liveness Session Operations - Delete Liveness Session

Service:

Azure AI Services

API Version:

v1.1-preview.1

Ta bort all sessionsrelaterad information för att matcha det angivna sessions-ID:t.

Anteckning

Om du tar bort en session inaktiveras sessionsautentiseringstoken genom att framtida API-anrop som görs med den autentiseringstoken blockeras. Även om detta kan användas för att ta bort all åtkomst för denna token räknas dessa begäranden fortfarande mot övergripande resurshastighetsgränser. Det är bäst att använda TokenTTL för att begränsa längden på token om det missbrukas.

DELETE {endpoint}/face/{apiVersion}/detectLiveness/singleModal/sessions/{sessionId}

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).
sessionId	path	True	string	Det unika ID som refererar till den här sessionen.

Svar

Name	Typ	Description
200 OK		Begäran har slutförts.
Other Status Codes	FaceErrorResponse	Ett oväntat felsvar. Headers x-ms-error-code: string

Säkerhet

Ocp-Apim-Subscription-Key

Den hemliga nyckeln för din Azure AI Face-prenumeration.

Type: apiKey
In: header

AADToken

The Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: accessCode
Authorization URL: https://api.example.com/oauth2/authorize
Token URL: https://api.example.com/oauth2/token

Scopes

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

Exempel

Delete Liveness Session

Sample Request

HTTP

DELETE {endpoint}/face/v1.1-preview.1/detectLiveness/singleModal/sessions/b12e033e-bda7-4b83-a211-e721c661f30e

Sample Response

Status code:

200

Definitioner

Name	Description
FaceError	Felobjektet. Omfattande 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. Omfattande 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 läsbar återgivning av felet.

FaceErrorResponse

Ett svar som innehåller felinformation.

Name	Typ	Description
error	FaceError	Felobjektet.