调用ModifyPushAllTask接口对服务器执行安全检查任务。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String ModifyPushAllTask

要执行的操作。取值:ModifyPushAllTask

SourceIp String 1.2.XX.XX

访问源的IP地址。

Uuids String inet-923b4538-0e88-409d-80ba-cb2e7487****,dc1691eb-656f-472f-b2aa-04f621f4****,70452f92-9fc1-45c5-ab35-e7bf8552****

要进行安全检查的服务器UUID列表。多个UUID之间使用半角逗号(,)隔开。

Tasks String HEALTH_CHECK,OVAL_ENTITY

要进行的安全检查的检查项列表。多个检查项之间使用半角逗号(,)隔开。取值:

  • OVAL_ENTITY:CVE漏洞
  • CMS:CMS漏洞
  • SYSVUL:系统漏洞
  • SCA:应用漏洞
  • HEALTH_CHECK:基线
  • WEBSHELL:网站后门
  • PROC_SNAPSHOT:进程数据
  • PORT_SNAPSHOT:端口数据
  • ACCOUNT_SNAPSHOT:账号数据
  • SOFTWARE_SNAPSHOT:软件资产
  • SCA_SNAPSHOT:中间件

返回数据

名称 类型 示例值 描述
RequestId String 91EB4AC7-7FEF-4C72-BE49-4414E459AEC2

本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。

PushTaskRsp Object

安全检查任务执行的结果。

PushTaskResultList Array of pushTaskResult

安全检查任务执行失败的服务器的信息。

Uuid String 5493fe42-61f5-4627-9aa2-8c449bbe****

服务器UUID。

GroupId Long 226

服务器分组的ID。

Success Boolean false

安全检查是否执行成功。取值:

  • true:是
  • false:否
Region String cn-beijing

服务器所在地域。

InstanceName String 按量计费线上监控

服务器的名称。

Online Boolean false

云安全中心客户端是否在线。取值:

  • true:是
  • false:否
说明 如果客户端不在线,则云安全中心无法对该型服务器提供安全防护。
Message String {"code":"clinent_offline","message":"客户端不在线","success":false}

安全检查任务执行失败的详细信息。

Ip String 127.XX.XX

服务器的IP。

OsVersion String linux

服务器操作系统的版本。

InstanceId String i-wz9f7wlklxqnvdk****

服务器实例的ID。

示例

请求示例

http(s)://[Endpoint]/?Action=ModifyPushAllTask
&SourceIp=1.2.XX.XX
&Uuids=inet-923b4538-0e88-409d-80ba-cb2e7487****,dc1691eb-656f-472f-b2aa-04f621f4****,70452f92-9fc1-45c5-ab35-e7bf8552****
&Tasks=HEALTH_CHECK,OVAL_ENTITY
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyPushAllTaskResponse>
    <RequestId>91EB4AC7-7FEF-4C72-BE49-4414E459AEC2</RequestId>
    <PushTaskRsp>
        <PushTaskResultList>
            <Uuid>5493fe42-61f5-4627-9aa2-8c449bbe****</Uuid>
            <GroupId>226</GroupId>
            <Success>false</Success>
            <Region>cn-beijing</Region>
            <InstanceName>按量计费线上监控</InstanceName>
            <Online>false</Online>
            <Message>{"code":"clinent_offline","message":"客户端不在线","success":false}</Message>
            <Ip>127.XX.XX</Ip>
            <OsVersion>linux</OsVersion>
            <InstanceId>i-wz9f7wlklxqnvdk****</InstanceId>
        </PushTaskResultList>
    </PushTaskRsp>
</ModifyPushAllTaskResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "91EB4AC7-7FEF-4C72-BE49-4414E459AEC2",
  "PushTaskRsp" : {
    "PushTaskResultList" : [ {
      "Uuid" : "5493fe42-61f5-4627-9aa2-8c449bbe****",
      "GroupId" : 226,
      "Success" : false,
      "Region" : "cn-beijing",
      "InstanceName" : "按量计费线上监控",
      "Online" : false,
      "Message" : "{\"code\":\"clinent_offline\",\"message\":\"客户端不在线\",\"success\":false}",
      "Ip" : "127.XX.XX",
      "OsVersion" : "linux",
      "InstanceId" : "i-wz9f7wlklxqnvdk****"
    } ]
  }
}

错误码

HttpCode 错误码 错误信息 描述
400 PushTaskError Failed to push task. 下发任务失败。
400 IllegalParam Illegal param 无效参数
500 ServerError ServerError 服务故障

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