メインコンテンツまでスキップ

マルウェア検査状態の確認

マルウェア検査のリクエスト後、検査の進行状況と結果を確認します。

Notes​

  • Polling: 検査が進行中(code: 3)の場合、500ms後に再度照会する必要があります。
  • Virus Names: 複数のウイルスが検出された場合は、カンマで区切られます。scanMessageに返されます。

Method​

GET​

/inspection/malware/{jobId}

Request Path Parameter​

KEYOBJECTDESC
jobIdString検査リクエスト時に受け取った作業ID (必須)

Response Body (json)​

KEYOBJECTDESC
codeint検査結果コード（下の表を参照）
msgString結果メッセージ
jobIdString作業 ID
logReasonintログリゼンコード
scanMessageStringマルウェア検出時のマルウェア名（任意）

Response Code​

CODEDESCDESC_DETAIL
0検査完了検査が正常に完了しました。logReasonで未検出(990001)または検出(990003)を区別します。
1検査例外ファイルサイズの超過、ウイルス対策未使用、重複リクエスト、キューの超過などにより、検査が実行されませんでした。
2検査エラーワクチンサービス通信エラー、エンジンエラー、リクエストエラーなどの検査中にエラーが発生しました。
3検査進行中現在ファイルに対してウイルススキャンを実施中です。
5アクセスブロックAPIアクセス制御によりリクエストがブロックされました。

Log Reason Code​

状態照会で返される結果です。

進行中​

code: 3​

CODEMESSAGEDESC
990017ワクチン検査待機中リクエストが受信され、キューで処理待ちです。
990002ワクチン検査進行中現在ファイルに対してウイルススキャンを実施中です。

成功​

code: 0​

CODEMESSAGEDESC
990001ウイルス未検出ウイルスは検出されませんでした。
990002ワクチン検査進行中現在ファイルに対してウイルススキャンを実施中です。
990003[ブロック] ウイルス検出 (感染ファイル削除)アップロードされたファイルでウイルスが検出されました。

例外​

code: 1​

CODEMESSAGEDESC
990008[例外] ワクチン検査ファイルサイズ超過ファイルサイズがウイルススキャンの制限サイズを超えているため、スキャンが実行されませんでした。
990010[例外] 重複作業ID検査要求既存の作業IDでは、検査リクエストを実行しませんでした。別の作業IDを使用してください。
990011[例外] ワクチン検査未使用ワクチン検査機能が無効になっています。
990015[例外] ワクチン検査待機列の超過サーバーの処理キューが満杯で、リクエストを受け付けることができませんでした。しばらくしてから再試行してください。

エラー​

code: 2​

CODEMESSAGEDESC
990007[エラー] ワクチンサービス通信エラーワクチンサービスと通信プロセス中にエラーが発生し、検査できませんでした。
990013[エラー] ワクチンサービスエラーワクチンエンジンの検査プロセス中にエラーが発生し、検査できませんでした。
990014[エラー] ワクチン検査リクエストエラーワクチンサービスでリクエスト前にエラーが発生し、検査できませんでした。
990016[エラー] ワクチン検査のタイムアウトワクチンエンジンの検査時間が超過したため、結果を提供できません。

Sample​

REQUEST​

curl -X GET "{{url}}/inspection/malware/8bc422e1-af1b-11f0-bf7b-7117406ac6f5"

RESPONSE - ワクチン検査進行中 (200 OK)​

{
   "code": 3,
   "msg": "현재 파일에 대해 바이러스 검사를 진행 중입니다.",
   "jobId": "8bc422e1-af1b-11f0-bf7b-7117406ac6f5"
}

RESPONSE - ウイルス未検出 (200 OK)​

{
   "code": 0,
   "msg": "바이러스가 검출되지 않았습니다.",
   "jobId": "8bc422e1-af1b-11f0-bf7b-7117406ac6f5",
   "logReason": 990001
}

RESPONSE - [ブロック] ウイルス検出 (感染ファイル削除) (200 OK)​

{
   "code": 0,
   "msg": "업로드하신 파일에서 바이러스가 탐지되었습니다.",
   "jobId": "f89d9593-af1b-11f0-bf7b-7117406ac6f5",
   "logReason": 990003,
   "scanMessage": "Trojan.Jeki.2"
}

RESPONSE - [例外] ワクチン検査ファイルサイズ超過 (200 OK)​

{
   "code": 1,
   "msg": "파일 크기가 백신 검사 제한 크기를 초과하여 검사가 수행되지 않았습니다.",
   "jobId": "18ae81f4-af1c-11f0-bf7b-7117406ac6f5",
   "logReason": 990008
}

RESPONSE - [例外] ワクチン検査未使用 (200 OK)​

{
   "code": 1,
   "msg": "백신 검사 기능이 비활성화되어 있습니다.",
   "jobId": "7f3e9a21-af1c-11f0-bf7b-7117406ac6f5",
   "logReason": 990011
}

RESPONSE - [例外] 重複作業ID検査リクエスト (200 OK)​

{
   "code": 1,
   "msg": "기존에 사용된 작업 ID로, 검사 요청을 수행하지 않았습니다. 다른 작업 ID를 사용해 주세요",
   "jobId": "e3b8c7d2-af1c-11f0-bf7b-7117406ac6f5",
   "logReason": 990010
}

RESPONSE - [例外] ワクチン検査キューの超過 (200 OK)​

{
   "code": 1,
   "msg": "서버의 처리 대기열이 가득차 요청을 수락하지 못했습니다. 잠시 후 다시 시도해 주세요",
   "jobId": "c4d7f3e2-af1c-11f0-bf7b-7117406ac6f5",
   "logReason": 990015
}

RESPONSE - [エラー] ワクチンサービス通信エラー (200 OK)​

{
   "code": 2,
   "msg": "백신 서비스와 통신 과정 중 오류가 발생하여 검사하지 못했습니다.",
   "jobId": "d5c6dd09-af1c-11f0-bf7b-7117406ac6f5",
   "logReason": 990007
}

RESPONSE - [エラー] ワクチンサービスエラー (200 OK)​

{
   "code": 2,
   "msg": "백신 엔진의 검사 과정중 오류가 발생하여 검사하지 못했습니다.",
   "jobId": "a9f2c153-af1c-11f0-bf7b-7117406ac6f5",
   "logReason": 990013
}

RESPONSE - [エラー] ワクチン検査リクエストエラー (200 OK)​

{
   "code": 2,
   "msg": "백신 서비스로 요청 전 오류가 발생하여 검사하지 못했습니다.",
   "jobId": "b2d1e764-af1c-11f0-bf7b-7117406ac6f5",
   "logReason": 990014
}

RESPONSE - [エラー] ワクチン検査タイムアウト (200 OK)​

{
   "code": 2,
   "msg": "백신 엔진의 검사 시간이 초과되어 결과를 제공할 수 없습니다.",
   "jobId": "6f5a2b91-af1c-11f0-bf7b-7117406ac6f5",
   "logReason": 990016
}

RESPONSE - Access Denied (200 OK)​

{
   "code": 5,
   "msg": "Sanitization Request Blocked by API Access control.",
   "jobId": "52617927-af1c-11f0-bf7b-7117406ac6f5"
}

Processing Flow​

  • このフローは参考用として顧客に提供されません。