Liveness Session Operations - Delete Liveness Session

서비스:

Azure AI Services

API 버전:

v1.2-preview.1

지정된 세션 ID와 일치하기 위해 모든 세션 관련 정보를 삭제합니다.

메모

세션을 삭제하면 해당 인증 토큰으로 수행된 향후 API 호출을 차단하여 세션 인증 토큰이 비활성화됩니다. 이를 사용하여 해당 토큰에 대한 액세스를 제거할 수 있지만 이러한 요청은 여전히 전체 리소스 속도 제한에 포함됩니다. TokenTTL을 활용하여 토큰이 오용되는 경우 토큰의 길이를 제한하는 것이 가장 좋습니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
apiVersion	path	True	string	API 버전
endpoint	path	True	string uri	지원되는 Cognitive Services 엔드포인트(프로토콜 및 호스트 이름, 예: https://{resource-name}.cognitiveservices.azure.com).
sessionId	path	True	string	이 세션을 참조할 고유 ID입니다.

응답

Name	형식	Description
200 OK		요청이 성공했습니다.
Other Status Codes	FaceErrorResponse	예기치 않은 오류 응답입니다. 헤더 x-ms-error-code: string

보안

Ocp-Apim-Subscription-Key

Azure AI Face 구독의 비밀 키입니다.

형식: apiKey
In(다음 안에): header

AADToken

Azure Active Directory OAuth2 흐름

형식: oauth2
Flow: accessCode
권한 부여 URL: https://api.example.com/oauth2/authorize
토큰 URL: https://api.example.com/oauth2/token

범위

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

예제

Delete Liveness Session

샘플 요청

HTTP

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

샘플 응답

상태 코드:

200

정의

Name	Description
FaceError	오류 개체입니다. Face Service에서 반환된 오류 코드 및 메시지에 대한 포괄적인 세부 정보는 다음 링크를 참조하세요. https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	오류 세부 정보가 포함된 응답입니다.

FaceError

오류 개체입니다. Face Service에서 반환된 오류 코드 및 메시지에 대한 포괄적인 세부 정보는 다음 링크를 참조하세요. https://aka.ms/face-error-codes-and-messages.

Name	형식	Description
code	string	서버에서 정의한 오류 코드 집합 중 하나입니다.
message	string	사람이 읽을 수 있는 오류 표현입니다.

FaceErrorResponse

오류 세부 정보가 포함된 응답입니다.

Name	형식	Description
error	FaceError	오류 개체입니다.