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

マルウェアスキャン状態照会

マルウェアスキャンリクエスト後、スキャン進行状態および結果を照会します。

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​

  • このフローは参考用で顧客に提供しない