全部产品
Search

搜索本产品

    云原生数据库 PolarDB：ModifyActiveOperationTasks - 修改运维事件的计划切换时间

    文档中心

    云原生数据库 PolarDB：ModifyActiveOperationTasks - 修改运维事件的计划切换时间

    更新时间：Aug 28, 2026

    修改实例计划内运维事件的切换时间。

    调试

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

    调试

    授权信息

    下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

    • 操作：是指具体的权限点。

    • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

    • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

      • 对于必选的资源类型，用前面加 * 表示。

      • 对于不支持资源级授权的操作，用全部资源表示。

    • 条件关键字：是指云产品自身定义的条件关键字。

    • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

    操作

    访问级别

    资源类型

    条件关键字

    关联操作

    polardb:ModifyActiveOperationTasks

    update

    *全部资源

    *

    		 无 无

    请求参数

    名称

    类型

    必填

    描述

    示例值
    RegionId

    string

    是

    地域 ID。

    说明

    您可以调用 DescribeRegions 接口查看目标账号下所有的集群的地域信息。

    cn-beijing
    TaskIds

    string

    是

    任务 ID 列表。

    11111,22222
    SwitchTime

    string

    否

    要设置的计划切换时间，格式为 yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。

    说明

    • 不能晚于最晚操作时间。

    • 您可以调用 DescribeActiveOperationTasks，通过返回参数 Deadline 的值来获取最晚操作时间。

    2023-04-25T06:00:00Z
    ImmediateStart

    integer

    否

    是否立即进入执行调度。

    • 0：否 (默认) 。

    • 1: 是。

    说明

    • 取值为 0 时 switchTime 要求必填；

    • 值为 1 时 switchTime 不生效，事件开始时间将设置为当前时间，切换时间根据新的开始时间自动计算。 事件立即进入执行调度（并非立即切换），进行切换的前置准备，准备完成后，进行切换。您可以调用 DescribeActiveOperationTasks，通过返回参数 PrepareInterval 的值来获取准备时间。

    0

    返回参数

    名称

    类型

    描述

    示例值

    object

    RequestId

    string

    请求 ID。

    42CD2EF5-D77E-5AD4-961B-159330D98286
    TaskIds

    string

    任务 ID 列表。

    11111,22222

    示例

    正常返回示例

    JSON格式

    {
  "RequestId": "42CD2EF5-D77E-5AD4-961B-159330D98286",
  "TaskIds": "11111,22222"
}

    错误码

    HTTP status code

    错误码

    错误信息

    描述
    400 StartTimeBeforeNow The start time should be later than current time. 操作失败，时间参数设置不正确。开始时间应晚于当前时间。
    400 TaskHasStarted Task has started. 任务已经开始。
    400 IncorrectTaskStatus Certain task's status does not support this operation.
    400 IncorrectTaskType Current task does not support this operation. 操作失败，当前任务状态不支持该操作。
    400 RequiredParam.NotFound Required input param is not found. 所需的输入参数不存在。
    400 TaskModifyError Part of the tasks cannot be modified. 操作失败，部分任务无法修改。请稍等会重试。
    400 SwitchTimeAfterDeadline The switch time should be earlier than deadline. 操作失败，时间参数设置不正确。切换时间应早于截止时间。
    400 InvalidTime.Format InvalidTime.Format Specified time is not valid.

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

    变更历史

    更多信息，参考变更详情。