Skip to main content

liveness_with_verify_sessions

Creates, updates, deletes, gets or lists a liveness_with_verify_sessions resource.

Overview

Nameliveness_with_verify_sessions
TypeResource
Idazure.ai_vision_face.liveness_with_verify_sessions

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
idstringThe unique ID to reference this session. Required.
authTokenTimeToLiveInSecondsintegerSeconds the session should last for. Range is 60 to 86400 seconds. Default value is 600.
createdDateTimestring (date-time)DateTime when this session was created. Required.
deviceCorrelationIdstringUnique Guid per each end-user device. This is to provide rate limiting and anti-hammering. If 'deviceCorrelationIdSetInClient' is true in this request, this 'deviceCorrelationId' must be null.
sessionExpiredbooleanWhether or not the session is expired. Required.
sessionStartDateTimestring (date-time)DateTime when this session was started by the client.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
get_liveness_with_verify_sessionsselectendpoint, api_versionstart, topLists sessions for /detectLivenessWithVerify/SingleModal. Please refer to https://learn.microsoft.com/rest/api/face/liveness-session-operations/get-liveness-with-verify-sessions for more details.
delete_liveness_with_verify_sessiondeletesession_id, endpoint, api_versionDelete all session related information for matching the specified session id. Please refer to https://learn.microsoft.com/rest/api/face/liveness-session-operations/delete-liveness-with-verify-session for more details.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
api_versionstringThe service endpoint host (no scheme), e.g. myaccount.table.cosmos.azure.com:443 - value of the client apiVersion parameter. (default: )
endpointstringThe service endpoint host (no scheme), e.g. myaccount.table.cosmos.azure.com:443 - value of the client endpoint parameter. (default: )
session_idstringThe unique ID to reference this session. Required.
startstringList resources greater than the "start". It contains no more than 64 characters. Default is empty. Default value is None.
topintegerThe number of items to list, ranging in [1, 1000]. Default is 1000. Default value is None.

SELECT examples

Lists sessions for /detectLivenessWithVerify/SingleModal. Please refer to https://learn.microsoft.com/rest/api/face/liveness-session-operations/get-liveness-with-verify-sessions for more details.

SELECT
id,
authTokenTimeToLiveInSeconds,
createdDateTime,
deviceCorrelationId,
sessionExpired,
sessionStartDateTime
FROM azure.ai_vision_face.liveness_with_verify_sessions
WHERE endpoint = '{{ endpoint }}' -- required
AND api_version = '{{ api_version }}' -- required
AND start = '{{ start }}'
AND top = '{{ top }}'
;

DELETE examples

Delete all session related information for matching the specified session id. Please refer to https://learn.microsoft.com/rest/api/face/liveness-session-operations/delete-liveness-with-verify-session for more details.

DELETE FROM azure.ai_vision_face.liveness_with_verify_sessions
WHERE session_id = '{{ session_id }}' --required
AND endpoint = '{{ endpoint }}' --required
AND api_version = '{{ api_version }}' --required
;