对资产服务器一键下发安全检查任务。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
yundun-sas:ModifyPushAllTask |
update |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| 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 |
是 |
要进行的安全检查的检查项列表。多个检查项之间使用半角逗号(,)隔开。取值:
|
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 |
integer |
服务器分组的 ID。 |
226 |
| Success |
boolean |
安全检查是否执行成功。取值:
|
false |
| Region |
string |
服务器所在地域。 |
cn-beijing |
| InstanceName |
string |
服务器的名称。 |
TestInstance |
| Online |
boolean |
云安全中心客户端是否在线。取值:
说明
如果客户端不在线,则云安全中心无法对该型服务器提供安全防护。 |
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. | |
| 500 | ServerError | ServerError | |
| 403 | NoPermission | caller has no permission |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。