GetAgentlessTaskCountBatch - 批量获取无代理检测任务统计结果-云安全中心(Security Center)-阿里云帮助中心

批量获取无代理检测资源风险统计，每次查询 1 至 100 个资源。

接口说明

仅支持开通云安全中心无代理检测按量付费的阿里云账号调用。UuidList 最多包含 100 个 UUID；重复 UUID 按首次出现顺序去重。返回的 Data 以 UUID 为键，不会对多个资源的结果求和。RiskMachine、ScanMachine 和 LastTaskTime 为账号级统计，同一请求中的各资源结果保持一致。

调试

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

调试

授权信息

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

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

操作

访问级别

资源类型

条件关键字

关联操作

yundun-sas:GetAgentlessTaskCountBatch

get

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
TargetType	integer	否	检测对象类型。取值： 1：主机快照 2：主机镜像 3：用户快照 4：用户镜像 5：NAS 文件系统 6：平行沙箱 7：安全修复	3
UuidList	array	是	待查询的资源 UUID 列表，支持 1 至 100 个元素。	["3bb30859-b3b5-4f28-868f-b0892c98****"]
	string	是	资源 UUID。	3bb30859-b3b5-4f28-868f-b0892c98****

返回参数

名称	类型	描述	示例值
	object
Data	object	按资源 UUID 分组的统计结果，Map 的键为资源 UUID。	{"3bb30859-b3b5-4f28-868f-b0892c98****":{"RiskMachine":1,"ScanMachine":1}}
	object	指定资源的无代理检测统计结果。	{"RiskMachine":1,"ScanMachine":1}
BaselineCheckCount	integer	基线扫描项的总数。	1
CveVulCount	integer	系统漏洞的总数。	1
EstimateUsedSize	integer	预估检测量，单位为 GB。批量统计接口当前不返回该字段。	10
LastTaskTime	integer	上次扫描时间的时间戳，单位为毫秒。	1682577532318
MaliciousFile	integer	恶意样本文件的总数。	1
RiskMachine	integer	风险主机数。	1
ScaVulCount	integer	应用漏洞的总数。	1
ScanMachine	integer	扫描主机数。	1
SensitiveFileCount	integer	敏感文件的总数。	1
SysVulCount	integer	Windows 系统漏洞的总数。	1
Vulnerability	integer	漏洞风险数。	1
RequestId	string	本次调用请求的 ID，是由阿里云为该请求生成的唯一标识符，可用于排查和定位问题。	D03DD0FD-6041-5107-AC00-383E28F1****

示例

正常返回示例

JSON格式

{
  "Data": {
    "key": {
      "BaselineCheckCount": 1,
      "CveVulCount": 1,
      "EstimateUsedSize": 10,
      "LastTaskTime": 1682577532318,
      "MaliciousFile": 1,
      "RiskMachine": 1,
      "ScaVulCount": 1,
      "ScanMachine": 1,
      "SensitiveFileCount": 1,
      "SysVulCount": 1,
      "Vulnerability": 1
    }
  },
  "RequestId": "D03DD0FD-6041-5107-AC00-383E28F1****"
}

错误码

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

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

变更历史

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