Security Center:GetFileDetectResult

検出結果は、検出のために送信されたファイルについてのみ取得できます。検出結果は 5 時間保持され、この期間内は繰り返しクエリを実行できます。検出のためにファイルを送信するには、 CreateFileDetect を参照してください。

ファイルの一意な識別子

ファイル検出に関連するすべての操作には HashKey パラメーターが含まれます。これは、検出対象ファイルの一意な識別子を表し、検出結果のクエリに使用されます。完全なファイルコンテンツの MD5 または SHA-256 ハッシュのみがサポートされています。

検出結果のクエリ

Ext 拡張フィールドの FileLabel フィールドを使用して、ファイルのプロパティをフィルター処理できます。たとえば、encrypted プロパティと Zip プロパティを組み合わせて、暗号化されたアーカイブをフィルター処理できます。圧縮ファイルタイプでサポートされているファイルラベル: Zip、RAR、7-Zip、XAR、ZLib、GZip、tar。Ext 拡張フィールドの Highlight フィールドを使用して、Webshell ファイル内の悪意のあるコードセグメント数の位置を特定できます。Highlight フィールドはリストタイプです。リストの各要素はコード有効値に対応し、数値はファイルの先頭からの文字単位のオフセットを表します。

ファイル検出結果をクエリする前に、以下の手順を順番に完了してください。

1. CreateFileDetectUploadUrl を呼び出して、OSS アップロードパラメーターを取得します。

2. 返された署名情報を使用して、フォームを使用してファイルを OSS にアップロードします。アップロードメソッドの詳細については、OSS PostObject フォームアップロードの開発者リファレンスを参照してください。

3. CreateFileDetect を呼び出して、ファイル検出タスクを送信します。

4. GetFileDetectResult を呼び出して、検出結果をクエリします。

以下の例は、検出結果リスト内の単一の結果を示しています。その他の応答フィールドは省略されています。

安全なファイル (Result が 0)。Score と VirusType は返されません:

{"Result": 0}

疑わしいファイル (Result が 1)。Score と VirusType が返されます:

{"Result": 1, "Score": 100, "VirusType": "WebShell"}