1. 接口描述
接口请求域名: cwp.api3.fincloud.tencent.cn。
查看恶意文件详情
默认接口请求频率限制:20次/秒。
接口更新时间:2021-12-09 20:22:45。
接口既验签名又鉴权。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见公共请求参数。
| 参数名称 | 必选 | 允许NULL | 类型 | 描述 |
|---|---|---|---|---|
| Action | 是 | 否 | String | 公共参数,本接口取值:DescribeMalwareInfo |
| Version | 是 | 否 | String | 公共参数,本接口取值:2018-02-28 |
| Region | 是 | 否 | String | 公共参数,地域信息本接口不需要传递此参数。 |
| Id | 是 | 否 | Int64 | 唯一ID 示例值: 1023290 |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| MalwareInfo | MalwareInfo | 恶意文件详情信息 示例值:查看 |
| RequestId | String | 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
4. 错误码
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见公共错误码。
| 错误码 | 描述 |
|---|---|
| InternalError | 内部错误。 |
| InvalidParameter.ParsingError | 参数解析错误。 |
| InvalidParameter.MissingParameter | 参数缺失。 |
| InvalidParameter.InvalidFormat | 参数格式错误。 |
| MissingParameter | 缺少参数错误。 |
| ResourceNotFound | 资源不存在。 |
| FailedOperation.APIServerFail | 调用API服务失败。 |
| InvalidParameter | 参数错误。 |
| InvalidParameterValue | 参数取值错误。 |
5. 示例
示例1 查看恶意文件详情
输入示例
https://cwp.api3.fincloud.tencent.cn/?Action=DescribeMalwareInfo
&Id=10000
&<Public request parameters>
输出示例
{
"Response": {
"MalwareInfo": {
"VirusName": "name1",
"FileSize": 10,
"MD5": "87f70257f93a96273664ea5ef842c2c3",
"FilePath": "/data/path1",
"FileCreateTime": "2020-10-01 01:02:03",
"FileModifierTime": "2020-10-01 02:02:03",
"HarmDescribe": "desc1",
"SuggestScheme": "suggest1",
"ServersName": "srv1",
"HostIp": "172.16.20.1",
"ProcessName": "prcess1",
"ProcessID": "14245",
"Tags": [
"tag1"
],
"Breadth": "10",
"Heat": "80",
"Id": 1,
"FileName": "/data/file1",
"CreateTime": "2020-10-01 00:02:03",
"LatestScanTime": "2020-10-02 00:02:03",
"Reference": "ref1",
"MachineWanIp": "14.13.12.1",
"PsTree": "[{\"pid\":6109,\"exe\":\"/bin/busybox\",\"cmdline\":\"rm -rf /tmp/exp.so\",\"account\":\"polkitd:lighthouse\",\"start_time\":1699012235,\"exe_perm\":\"-rwxr-xr-x\",\"exe_mtime\":1576692277,\"sessionid\":306****",
"MachineStatus": "ONLINE",
"Status": 1,
"Level": 1,
"CheckPlatform": "platform1",
"Uuid": "6cf3c132-aaa-bbbb-b08d-98be9421372a",
"ModifyTime": "2020-10-01 00:02:03",
"StrFileAccessTime": "2020-10-01 00:02:03",
"MachineExtraInfo": {
"WanIP": "14.13.12.1",
"PrivateIP": "172.16.20.1",
"NetworkType": 0,
"NetworkName": "vpc",
"InstanceID": "ins-iv1kdw",
"HostName": "host1"
},
"References": [
"ref1"
]
},
"RequestId": "8564b09e-0e04-4516-bb59-db09742503c2"
}
}