Liveness Session Operations - Get Liveness Session Audit Entries

サービス:

Azure AI Services

API バージョン:

v1.1-preview.1

セッションの要求と応答本文を取得します。

GET {endpoint}/face/{apiVersion}/detectLiveness/singleModal/sessions/{sessionId}/audit

省略可能なパラメーターを含む:

GET {endpoint}/face/{apiVersion}/detectLiveness/singleModal/sessions/{sessionId}/audit?start={start}&top={top}

URI パラメーター

名前	/	必須	型	説明
apiVersion	path	True	string	API バージョン
endpoint	path	True	string uri	サポートされている Cognitive Services エンドポイント (プロトコルとホスト名(例: https://{resource-name}.cognitiveservices.azure.com)。
sessionId	path	True	string	このセッションを参照する一意の ID。
start	query		string	"start" より大きいリソースを一覧表示します。 含まれる文字数は 64 文字以下です。 既定値は空です。
top	query		integer int32	[1, 1000] の範囲の、一覧表示する項目の数。 既定値は 1000 です。

応答

名前	型	説明
200 OK	LivenessSessionAuditEntry[]	要求は成功しました。
Other Status Codes	FaceErrorResponse	予期しないエラー応答。 ヘッダー x-ms-error-code: string

セキュリティ

Ocp-Apim-Subscription-Key

Azure AI Face サブスクリプションの秘密キー。

型: apiKey
/: header

AADToken

Azure Active Directory OAuth2 フロー

型: oauth2
フロー: accessCode
Authorization URL (承認 URL): https://api.example.com/oauth2/authorize
Token URL (トークン URL): https://api.example.com/oauth2/token

スコープ

名前	説明
https://cognitiveservices.azure.com/.default

例

Get LivenessSession Audit Entries

要求のサンプル

HTTP

GET {endpoint}/face/v1.1-preview.1/detectLiveness/singleModal/sessions/b12e033e-bda7-4b83-a211-e721c661f30e/audit?start=0&top=20

応答のサンプル

状態コード:

200

[
  {
    "id": 4,
    "sessionId": "b12e033e-bda7-4b83-a211-e721c661f30e",
    "requestId": "4af681e9-0e25-43e9-9922-a7adebf13b2f",
    "clientRequestId": "4af681e9-0e25-43e9-9922-a7adebf13b2f",
    "receivedDateTime": "2024-03-05T11:07:29.698Z",
    "request": {
      "url": "/face/v1.1-preview.1/detectliveness/singlemodal",
      "method": "POST",
      "contentLength": 18,
      "contentType": "multipart/form-data",
      "userAgent": "Mozilla/5.0 (Linux) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/117.0.0.0 Mobile Safari/537.36"
    },
    "response": {
      "body": {},
      "statusCode": 200,
      "latencyInMilliseconds": 1200
    },
    "digest": "1CC98BA83EAF1D0FF7F566FAEFCCCC787819FFA01251E2D9299143F7AD6651DB"
  }
]

定義

名前	説明
AuditLivenessResponseInfo	セッション内の応答の監査エントリ。
AuditRequestInfo	セッション内の要求の監査エントリ。
FaceError	error オブジェクト。 Face Service によって返されるエラー コードとメッセージの詳細については、次のリンクを参照してください。 https://aka.ms/face-error-codes-and-messages
FaceErrorResponse	エラーの詳細を含む応答。
FaceRectangle	顔が見つかる四角形。
ImageType	イメージの種類。
LivenessDecision	ライブネス分類の結果。
LivenessModel	ライブネス分類に使用されるモデル バージョン。
LivenessOutputsTarget	対象の顔のライブネス分類。
LivenessResponseBody	検出ライブネス API 呼び出しの応答本文。
LivenessSessionAuditEntry	セッション内の要求の監査エントリ。
LivenessWithVerifyImage	検証用の顔の詳細。
LivenessWithVerifyOutputs	顔検証出力。
QualityForRecognition	認識用の画像の品質を示します。

AuditLivenessResponseInfo

セッション内の応答の監査エントリ。

名前	型	説明
body	LivenessResponseBody	応答本文。 このフィールドのスキーマは、クライアントで使用される request.url メソッドと request.method によって異なります。
latencyInMilliseconds	integer	サーバーは、この要求の待機時間をミリ秒単位で測定しました。
statusCode	integer	クライアントに返される HTTP 状態コード。

AuditRequestInfo

セッション内の要求の監査エントリ。

名前	型	説明
contentLength	integer	要求本文の長さ (バイト単位)。
contentType	string	要求のコンテンツ タイプ。
method	string	要求の HTTP メソッド (GET、POST、DELETE など)。
url	string	ライブネス要求の相対 URL とクエリ。
userAgent	string	要求の送信に使用されたユーザー エージェント。

FaceError

error オブジェクト。 Face Service によって返されるエラー コードとメッセージの詳細については、次のリンクを参照してください。 https://aka.ms/face-error-codes-and-messages

名前	型	説明
code	string	サーバー定義のエラー コードのセットの 1 つ。
message	string	エラーの人間が判読できる表現。

FaceErrorResponse

エラーの詳細を含む応答。

名前	型	説明
error	FaceError	error オブジェクト。

FaceRectangle

顔が見つかる四角形。

名前	型	説明
height	integer	四角形の高さ (ピクセル単位)。
left	integer	画像から四角形の左端までの場合の左端からの距離 (ピクセル単位)。
top	integer	画像から四角形の上端までの上端までの距離 (ピクセル単位)。
width	integer	四角形の幅 (ピクセル単位)。

ImageType

イメージの種類。

名前	型	説明
Color	string	カラー イメージ。
Depth	string	深度イメージ。
Infrared	string	赤外線画像。

LivenessDecision

ライブネス分類の結果。

名前	型	説明
realface	string	このアルゴリズムでは、ターゲットの顔が実際の顔として分類されています。
spoofface	string	このアルゴリズムでは、ターゲットの顔がスプーフィングとして分類されています。
uncertain	string	アルゴリズムでは、ターゲットの顔を実際の顔またはスプーフィングとして分類できませんでした。

LivenessModel

ライブネス分類に使用されるモデル バージョン。

名前	型	説明
2022-10-15-preview.04	string
2023-12-20-preview.06	string

LivenessOutputsTarget

対象の顔のライブネス分類。

名前	型	説明
faceRectangle	FaceRectangle	ライブネス分類が行われた顔領域。
fileName	string	ライブネス分類が行われた顔の四角形を含むファイル名。
imageType	ImageType	ライブネス分類が行われた顔の四角形を含む画像の種類。
timeOffsetWithinFile	integer	ライブネス分類が行われた面の四角形を含むフレームのファイル内の時間オフセット。

LivenessResponseBody

検出ライブネス API 呼び出しの応答本文。

名前	型	説明
livenessDecision	LivenessDecision	対象の顔のライブネス分類。
modelVersionUsed	LivenessModel	ライブネス分類に使用されるモデル バージョン。
target	LivenessOutputsTarget	ライブネス分類に使用される特定のターゲット。
verifyResult	LivenessWithVerifyOutputs	顔検証出力。 要求が検証を使用したライブネスの場合にのみ使用できます。

LivenessSessionAuditEntry

セッション内の要求の監査エントリ。

名前	型	説明
clientRequestId	string	"client-request-id" ヘッダーでクライアントによって送信される一意の clientRequestId。
digest	string	この要求のサーバー計算ダイジェスト。 クライアントから報告されたダイジェストがサーバー計算ダイジェストと異なる場合、クライアントとサービスの間のメッセージの整合性が損なわれ、結果は信頼されません。 詳細については、この値を活用してエンド ツー エンド ソリューションをセキュリティで保護する方法に関するガイドを参照してください。
id	integer	この監査要求を参照する一意の ID。 この ID を 'start' クエリ パラメーターと共に使用して、監査結果の次のページに進みます。
receivedDateTime	string	要求が受信された UTC DateTime。
request	AuditRequestInfo	このエントリの要求。
requestId	string	サービスによって 'apim-request-id' ヘッダー内のクライアントに返される一意の requestId。
response	AuditLivenessResponseInfo	このエントリの応答。
sessionId	string	作成されたセッションの一意の sessionId。 これは、作成されてから 48 時間後に期限切れになるか、対応するセッション DELETE 操作を使用してすぐに削除される可能性があります。

LivenessWithVerifyImage

検証用の顔の詳細。

名前	型	説明
faceRectangle	FaceRectangle	比較画像の分類が行われた顔領域。
qualityForRecognition	QualityForRecognition	認識のための顔画像の品質。

LivenessWithVerifyOutputs

顔検証出力。

名前	型	説明
isIdentical	boolean	対象のライブネス顔と比較画像面が一致するかどうか。
matchConfidence	number	対象顔ライブネス顔と比較画像顔検証信頼度。
verifyImage	LivenessWithVerifyImage	検証用の顔の詳細。

QualityForRecognition

認識用の画像の品質を示します。

名前	型	説明
high	string	高品質。
low	string	低品質。
medium	string	中程度の品質。