CreateCycleTask - 新增通用计划扫描任务

更新时间:
复制 MD 格式

创建周期性扫描任务,包括镜像扫描、应急漏洞扫描及病毒扫描。

调试

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

调试

授权信息

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

请求参数

名称

类型

必填

描述

示例值

TaskName

string

任务名称。

  • VIRUS_VUL_SCHEDULE_SCAN:病毒扫描。

  • IMAGE_SCAN:镜像扫描。

  • EMG_VUL_SCHEDULE_SCAN:应急漏洞扫描。

EMG_VUL_SCHEDULE_SCAN

TaskType

string

任务类型。

  • VIRUS_VUL_SCHEDULE_SCAN:病毒扫描。

  • IMAGE_SCAN:镜像扫描。

  • EMG_VUL_SCHEDULE_SCAN:应急漏洞扫描。

VIRUS_VUL_SCHEDULE_SCAN

PeriodUnit

string

扫描周期的单位,取值:

  • day:天。

  • hour:小时。

day

IntervalPeriod

integer

间隔周期。

7

FirstDateStr

integer

首次执行时间。

1650556800000

TargetStartTime

integer

任务开始时间(小时)。

0

TargetEndTime

integer

任务结束时间(小时)。

6

Param

string

扩展信息字段。

{ "targetInfo": [ { "type": "groupId", "name": "TI HOST", "target": 10597*** }, { "type": "groupId", "name": "expense HOST", "target": 10597*** } ] }

Enable

integer

是否启用。取值:

  • 1:开启

  • 0:关闭

1

Source

string

增加任务的来源。

console_batch

ClientToken

string

客户端 Token,用于保证请求幂等性。不同请求应使用不同的 Token;只支持 ASCII 字符,长度不超过 64 个字符。

返回参数

名称

类型

描述

示例值

object

RequestId

string

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

86CFF42E-E00A-57A3-8656-22291EFB****

ConfigId

string

配置对应的 ID。

00cfa8161da093089e6804ba6a33****

示例

正常返回示例

JSON格式

{
  "RequestId": "86CFF42E-E00A-57A3-8656-22291EFB****",
  "ConfigId": "00cfa8161da093089e6804ba6a33****"
}

错误码

HTTP status code

错误码

错误信息

描述

400 RdCheckNoPermission Resource directory account verification has no permission.
400 IdempotentParameterMismatch 相同的 ClientToken 被用于不同的请求参数。
500 ServerError ServerError
500 RdCheckInnerError Resource directory account service internal error.
403 NoPermission caller has no permission
409 IdempotentRequestInProgress 使用相同 ClientToken 的请求正在处理中。

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

变更历史

更多信息,参考变更详情