使用DescribeQuaraFileDownloadInfo查询安全告警隔离文件的下载链接-云安全中心-阿里云-云安全中心(Security Center)-阿里云帮助中心

调试

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

调试

授权信息

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

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

操作

访问级别

资源类型

条件关键字

关联操作

yundun-sas:DescribeQuaraFileDownloadInfo

get

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
QuaraFileId	integer	否	隔离文件 ID。说明如果不输入该参数，调用 RollbackSuspEventQuaraFile 接口不会取消对文件隔离箱中文件的隔离，即调用该接口不生效。调用 DescribeSuspEventQuaraFiles 接口可获取隔离文件 ID（Id 参数的值）。 QuaraFileId 依赖以下前置链：（1）ECS 实例需安装 SAS Agent 并处于在线状态；（2）Agent 需检测到恶意文件产生安全告警；（3）通过 HandleSecurityEvents 接口（OperationCode=quara）对告警执行隔离；（4）调用 DescribeSuspEventQuaraFiles 接口获取 QuaraFileId。注意：此参数实际为必填项，未提供时 API 返回错误码 -101（400），提示「没有提供需要回滚的文件 id」。	123
From	string	否	请求来源标识，固定为 sas。	sas

返回参数

名称	类型	描述	示例值
	object
Uuid	string	资产唯一标识。	4fe8e1cd-3c37-4851-b9de-124da32c****
QuaraFileId	integer	隔离文件 ID。	123
RequestId	string	阿里云为该请求生成的唯一标识符。	29874225-EAAC-5415-8501-32DD20FXXXXX
DownloadUrl	string	下载链接。有效时间 5 分钟。	https://xxxxxxxx.oss-cn-hangzhou-1.aliyuncs.com/xxxxx/xxxxxxxxxxxxxx?Expires=1671448125&OSSAccessKeyId=xxx
Path	string	文件路径。	/etc/test
Md5	string	文件 MD5 值。	bb62ef1311bc564377a0378d3axxxxxx
Tag	string	告警记录标签。	6d4ff40a22b15c86adecf2aa48xxxxx

示例

正常返回示例

JSON格式

{
  "Uuid": "4fe8e1cd-3c37-4851-b9de-124da32c****",
  "QuaraFileId": 123,
  "RequestId": "29874225-EAAC-5415-8501-32DD20FXXXXX",
  "DownloadUrl": "https://xxxxxxxx.oss-cn-hangzhou-1.aliyuncs.com/xxxxx/xxxxxxxxxxxxxx?Expires=1671448125&OSSAccessKeyId=xxx",
  "Path": "/etc/test",
  "Md5": "bb62ef1311bc564377a0378d3axxxxxx",
  "Tag": "6d4ff40a22b15c86adecf2aa48xxxxx"
}

错误码

HTTP status code	错误码	错误信息	描述
500	ServerError	ServerError	服务故障，请稍后重试！
403	NoPermission	caller has no permission	当前操作未被授权，请联系主账号在RAM控制台进行授权后再执行操作。

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

变更历史

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