ModifyTaskInfo - 修改任务操作

进行任务操作,当前支持修改任务执行时间点。

调试

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

授权信息

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

请求参数

名称类型必填描述示例值
RegionIdstring

实例所属的地域 ID。

cn-hangzhou
TaskIdstring

任务 ID,如需查询多个请用英文逗号(,)分隔,最多支持 30 个。

t-0mq3kfhn8i1nlt****
StepNamestring

当前执行的步骤名。您可以通过 DescribeHistoryTasks 查询指定任务 ID 当前的执行步骤。常见取值do_pause表示等待预设时间执行。

do_pause
TaskActionstring

操作名称,当前支持取值 modifySwitchTime,表示修改切换时间或恢复时间。

modifySwitchTime
ActionParamsstring

动作相关的参数,Json 格式。 当 TaskAction 取值 modifySwitchTime 时,本参数 ActionParams 取值为 {"recoverMode": "xxx", "recoverTime": "xxx"}

  • recoverMode 表示任务恢复模式,取值为:

    • imePoint:按照指定时间点执行。
    • immediate: 立即执行。
    • maintainTime:按照运维时间执行。
  • recoverTime 表示指定的时间点,UTC+0 时间,格式为 yyyy-MM-ddTHH:mm:ssZ,当 recoverModetimePoint 时,该参数必填。

{"recoverMode":"immediate"}

返回参数

名称类型描述示例值
object

Schema of Response

RequestIdstring

请求 ID。

2B98499B-E62B-56D4-8D7F-3D6D4DB260F2
ErrorTaskIdstring

失败的任务 ID,遇到一个失败即返回。

t-0mqaj5hnyofczv****
SuccessCountstring

成功任务数。

2
ErrorCodestring

错误码。

mst.errorcode.success.errormessage

示例

正常返回示例

JSON格式

{
  "RequestId": "2B98499B-E62B-56D4-8D7F-3D6D4DB260F2",
  "ErrorTaskId": "t-0mqaj5hnyofczv****",
  "SuccessCount": 2,
  "ErrorCode": "mst.errorcode.success.errormessage"
}

错误码

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