创建周期性扫描任务，包括镜像扫描、应急漏洞扫描及病毒扫描。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
yundun-sas:CreateCycleTask |
create |
*CycleTask
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| TaskName |
string |
是 |
任务名称，自定义字符串，用于标识周期性扫描任务。 |
test_virus_scan |
| TaskType |
string |
是 |
任务类型。
|
VIRUS_VUL_SCHEDULE_SCAN |
| PeriodUnit |
string |
是 |
扫描周期的单位，取值：
|
day |
| IntervalPeriod |
integer |
是 |
间隔周期。 |
7 |
| FirstDateStr |
integer |
是 |
首次执行时间。 |
1650556800000 |
| TargetStartTime |
integer |
是 |
任务开始时间（小时）。 |
0 |
| TargetEndTime |
integer |
是 |
任务结束时间（小时）。 |
6 |
| Param |
string |
否 |
扩展信息字段。 注意：本参数实际为必填项，未提供时 API 返回错误。值为 JSON 格式字符串，至少包含 targetInfo 数组。 |
{ "targetInfo": [ { "type": "groupId", "name": "TI HOST", "target": 10597*** }, { "type": "groupId", "name": "expense HOST", "target": 10597*** } ] } |
| Enable |
integer |
是 |
是否启用。取值：
|
1 |
| Source |
string |
否 |
增加任务的来源。 |
console_batch |
| ClientToken |
string |
否 |
用于保证请求的幂等性。由客户端生成该参数值，要保证在不同请求间唯一，最大值不超过 64 个 ASCII 字符，且该参数值中不能包含非 ASCII 字符。 |
0c593ea1-3bea-11e9-b96b-88e9fe637760 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
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 | 当前操作未被授权，请联系主账号在RAM控制台进行授权后再执行操作。 |
| 409 | IdempotentRequestInProgress | 使用相同 ClientToken 的请求正在处理中。 |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。