调用ModifyPushAllTask一键下发安全检查任务_云安全中心(Security Center)-阿里云帮助中心

对资产服务器一键下发安全检查任务。

调试

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

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
SourceIp	string	否	访问源的 IP 地址。	1.2.XX.XX
Uuids	string	是	要进行安全检查的服务器 UUID 列表。多个 UUID 之间使用半角逗号（,）隔开。	inet-923b4538-0e88-409d-80ba-cb2e7487**,dc1691eb-656f-472f-b2aa-04f621f4,70452f92-9fc1-45c5-ab35-e7bf8552**
Tasks	string	是	要进行的安全检查的检查项列表。多个检查项之间使用半角逗号（,）隔开。取值： OVAL_ENTITY：CVE 漏洞 CMS：CMS 漏洞 SYSVUL：系统漏洞 SCA：应用漏洞 HEALTH_CHECK：基线 WEBSHELL：网站后门 PROC_SNAPSHOT：进程数据 PORT_SNAPSHOT：端口数据 ACCOUNT_SNAPSHOT：账号数据 SOFTWARE_SNAPSHOT：软件资产 SCA_SNAPSHOT：中间件	HEALTH_CHECK,OVAL_ENTITY

返回参数

名称	类型	描述	示例值
	object
RequestId	string	本次调用请求的 ID，是由阿里云为该请求生成的唯一标识符，可用于排查和定位问题。	91EB4AC7-7FEF-4C72-BE49-4414E459AEC2
PushTaskRsp	object	安全检查任务执行的结果。
PushTaskResultList	array<object>	安全检查任务执行失败的服务器的信息。
	object
Uuid	string	服务器 UUID。	5493fe42-61f5-4627-9aa2-8c449bbe****
GroupId	long	服务器分组的 ID。	226
Success	boolean	安全检查是否执行成功。取值： true：是 false：否	false
Region	string	服务器所在地域。	cn-beijing
InstanceName	string	服务器的名称。	TestInstance
Online	boolean	云安全中心客户端是否在线。取值： true：是 false：否说明如果客户端不在线，则云安全中心无法对该型服务器提供安全防护。	false
Message	string	安全检查任务执行失败的详细信息。	successful
Ip	string	服务器的 IP。	127.136.XX.XX
OsVersion	string	服务器操作系统的版本。	linux
InstanceId	string	服务器实例的 ID。	i-wz9f7wlklxqnvdk****

示例

正常返回示例

JSON格式

{
  "RequestId": "91EB4AC7-7FEF-4C72-BE49-4414E459AEC2",
  "PushTaskRsp": {
    "PushTaskResultList": [
      {
        "Uuid": "5493fe42-61f5-4627-9aa2-8c449bbe****",
        "GroupId": 226,
        "Success": false,
        "Region": "cn-beijing",
        "InstanceName": "TestInstance",
        "Online": false,
        "Message": "successful",
        "Ip": "127.136.XX.XX",
        "OsVersion": "linux",
        "InstanceId": "i-wz9f7wlklxqnvdk****"
      }
    ]
  }
}

错误码

HTTP status code	错误码	错误信息	描述
400	PushTaskError	Failed to push task.	下发任务失败。
400	IllegalParam	Illegal param	无效参数
400	FreeVersionNotPermit	Free version is not permitted.	免费版无法使用。
403	NoPermission	caller has no permission	当前操作未被授权，请联系主账号在RAM控制台进行授权后再执行操作。
500	ServerError	ServerError	服务故障，请稍后重试！

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

变更历史

变更时间	变更内容概要	操作
2024-07-11	OpenAPI 错误码发生变更	查看变更详情
2023-03-01	OpenAPI 描述信息更新、OpenAPI 去除了 deprecated 标记、OpenAPI 错误码发生变更	查看变更详情
2022-08-01	OpenAPI 错误码发生变更	查看变更详情
2022-08-01	OpenAPI 错误码发生变更	查看变更详情