CreateFileDeepAnalyze - 发起恶意文件深度分析-云安全中心(Security Center)-阿里云帮助中心

接口说明

对指定文件发起恶意文件深度分析（Deep Analyze），通过 Server-Sent Events（SSE）实时流式返回分析各阶段进展。

【入参】Hash 与 EventId 至少提供其一：传入 EventId 时优先从对应告警详情中解析文件 hash；否则使用传入的 Hash（md5 或 sha256 均可）。Source 标识调用来源，用于按来源做商业化校验。

【返回】响应为 text/event-stream。服务端按处理阶段依次推送事件，事件名（event）取值：

accepted：请求已受理
authorized：来源购买校验通过
alertResolved：已从告警/入参解析出文件 hash
fileReady：文件下载链接就绪
dispatched：已投递至检测引擎（含 requestId）
result：命中分析结果（可选，异步就绪后推送）
done：本次分析流程结束
error：处理异常（含错误码与信息）

每个事件的数据体为 data 字段中的 JSON，字段随事件类型而异，详见响应结构说明。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

yundun-sas:CreateFileDeepAnalyze

create

*全部资源

*

无

请求语法

POST /instances/{instanceId} HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
SourceIp	string	否	访问源的 IP 地址。	192.168.XX.XX
Source	string	否	请求来源。根据不同的请求来源校验售卖版本，取值： edr：AgenticEDR secOpsAgent：安全运维 Agent 枚举值： edr secOpsAgent	edr
EventId	integer	否	事件 ID。已有文件类告警事件时，可以通过此参数触发深度分析。	100000001
Context	string	否	请求上下文信息。	{}
Hash	string	否	文件 hash。文件在云端已存在时，可以通过此参数触发深度分析。	d41d8cd98f00b204e9800998ecf8427e

返回参数

名称	类型	描述	示例值
	object	文件深度分析 SSE 事件信封
RequestId	string	请求 ID	E7F9C0A1-2B3D-4E5F-8A90-123456XXXXXX
Status	string	阶段状态	RUNNING
Message	string	阶段说明。	已解析文件 hash
Code	string	状态码。	FileNotExist
Data	string	分析结果。	{ "result": 0, "file_analysis": { "summary": { "ai_interpretation": "该文件为 JetBrains PhpStorm Stub 生成工具脚本，属于合法的开发者工具。代码使用 PhpParser 库解析 PHP 源码并生成 PhpStormStubsMap.php 映射文件。引擎分析未发现任何危险函数调用、外部输入处理、编码混淆或恶意行为特征，判定为正常文件。" } } }

示例

正常返回示例

JSON格式

{
  "RequestId": "E7F9C0A1-2B3D-4E5F-8A90-123456XXXXXX",
  "Status": "RUNNING",
  "Message": "已解析文件 hash",
  "Code": "FileNotExist",
  "Data": "{\n  \"result\": 0,\n  \"file_analysis\": {\n    \"summary\": {\n      \"ai_interpretation\": \"该文件为 JetBrains PhpStorm Stub 生成工具脚本，属于合法的开发者工具。代码使用 PhpParser 库解析 PHP 源码并生成 PhpStormStubsMap.php 映射文件。引擎分析未发现任何危险函数调用、外部输入处理、编码混淆或恶意行为特征，判定为正常文件。\"\n    }\n  }\n}"
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。