getInputFileLogByParentHash
- 印刷する
- PDF
getInputFileLogByParentHash
- 印刷する
- PDF
記事の要約
この要約は役に立ちましたか?
ご意見ありがとうございます
Classic/VPC環境で利用できます。
inputFile APIを通じて分析リクエストした圧縮ファイルの Hash値を利用して、圧縮ファイル内ファイルの分析結果を一括照会します。
リクエスト
リクエスト形式を説明します。リクエスト形式は次の通りです。
メソッド | URI |
---|---|
GET | /getInputFileLogByParentHash |
リクエストヘッダ
File Safer APIで共通して使用されるヘッダの詳細は、File Safer APIの共通ヘッダをご参照ください。
リクエストパラメータ
パラメータの説明は次の通りです。
フィールド | タイプ | 必須の有無 | 説明 |
---|---|---|---|
parentHash | String | Required | 圧縮ファイルの Hashsha1 |
fromDate | String | Conditional | 照会開始日時 |
toDate | String | Conditional | 照会終了日時 |
リクエスト例
リクエストのサンプルコードは次の通りです。
curl --location --request GET 'https://filesafer.apigw.ntruss.com/filefilter/v1/getInputFileLogByParentHash
?parentHash=f093e7767bb63ac973b697d3fd1d40a78b87b8bf' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-apigw-api-key: {API Gateway API Key}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'Accept: application/json'
レスポンス
レスポンス形式を説明します。
レスポンスボディ
レスポンスボディの説明は次の通りです。
フィールド | タイプ | 必須の有無 | 説明 |
---|---|---|---|
returnCode | String | Required | レスポンスコード |
returnMessage | String | Required | レスポンスメッセージ |
inputFileLogList[] | Array | Required | 分析リクエストされたファイルの分析結果
|
inputFileLogList[].fileType | String | Conditional | 分析したファイルの形式
|
inputFileLogList[].fileSize | Integer | Conditional | 分析したファイルのサイズ
|
inputFileLogList[].parentSha1 | String | Conditional | 圧縮ファイル自体の SHA1 Hash
|
inputFileLogList[].md5 | String | Conditional | 圧縮ファイル内分析したファイルの MD5 Hash
|
inputFileLogList[].sha1 | String | Conditional | 圧縮ファイル内分析したファイルの SHA1 Hash
|
inputFileLogList[].sha256 | String | Conditional | 圧縮ファイル内分析したファイルの SHA256 Hash
|
inputFileLogList[].analysisStatusCode | String | Conditional | 分析状態コード
|
inputFileLogList[].analysisResultCode | String | Conditional | 分析結果コード
|
inputFileLogList[].notifyYmdt | Long | - | 通知を設定した場合、通知の送信時間
|
inputFileLogList[].registrationYmdt | Long | - | ファイル流入時間
|
参考
serviceCode
とapplicationCode
はレスポンス結果に表示される場合がありますが、ユーザーが参照すべきフィールドではありません。
レスポンスステータスコード
File Safer APIで共通して使用されるレスポンスステータスコードの詳細は、File Saferのレスポンスステータスコードをご参照ください。
レスポンス例
レスポンスのサンプルコードは次の通りです。
分析したファイルがある場合
分析したファイルがある場合、レスポンスのサンプルコードは次の通りです。
{
"returnCode": "0",
"returnMessage": "success",
"inputFileLogList": [
{
"fileType": "Adobe Portable Document Format",
"fileSize": 68584,
"parentSha1": "4fa122a164fab49701d440dc376a108b2ab71bc4",
"md5": "83861ed7105eb8b9886616f9f0428b62",
"sha1": "ea445bec4e8f79c5a2f8db5a368f2c3c741e238f",
"sha256": "ff8ca1b607ab03268078d9bde33980e16ca45aa3c798e2b963ca89efd87714cc",
"analysisStatusCode": "CMPL",
"analysisResultCode": "N",
"notifyYmdt": null,
"registrationYmdt": 1697766000000,
"serviceCode": null,
"applicationCode": null
},
{
"fileType": "Adobe Portable Document Format",
"fileSize": 56686,
"parentSha1": "4fa122a164fab49701d440dc376a108b2ab71bc4",
"md5": "e162e32656ff4b4666d14bc43f9238c1",
"sha1": "d4021b08bcaa08255afd1b80bf9c39ab46116447",
"sha256": "40aa534c3cd62f4d7585a9bbf06a4af23b771d8b39127f16b2ec2503bffcd4aa",
"analysisStatusCode": "CMPL",
"analysisResultCode": "N",
"notifyYmdt": null,
"registrationYmdt": 1697766000000,
"serviceCode": null,
"applicationCode": null
}
]
}
分析したファイルがない場合
分析したファイルがない場合、レスポンスのサンプルコードは次の通りです。
{
"returnCode": "0",
"returnMessage": "success",
"inputFileLogList": [
]
}
この記事は役に立ちましたか?