ModifyTimerGroup - 修改配置组设置

更新时间:
复制为 MD 格式

修改配置组的具体设置,例如定时任务的配置。

调试

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

调试

授权信息

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

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

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

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

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

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

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

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

操作

访问级别

资源类型

条件关键字

关联操作

ecd:ModifyTimerGroup

list

*全部资源

*

请求参数

名称

类型

必填

描述

示例值

RegionId

string

地域 ID。该功能无地域属性,该字段固定填写cn-shanghai

cn-shanghai

GroupId

string

配置组 ID。

cg-i1ruuudp92qpj****

ConfigTimers

array<object>

定时任务的配置信息。

array<object>

定时任务的配置信息。

TimerType

string

定时任务类型。

枚举值:

  • NoOperationDisconnect :

    无操作断连

  • NoConnect :

    断连任务(需指定 OperationType)

  • TimerBoot :

    定时开机

  • TimerReset :

    定时重置

  • NoOperationShutdown :

    无操作关机

  • NoOperationHibernate :

    无操作休眠

  • TimerShutdown :

    定时关机

  • NoOperationReboot :

    无操作重启

  • TimerReboot :

    定时重启

TimerBoot

CronExpression

string

定时任务 Cron 表达式。

说明

需要传入 UTC 标准时间,即北京时间每天 0 点应该传入 0 0 16 ? * 1,2,3,4,5,6,7。

0 0 16 ? * 1,2,3,4,5,6,7

Interval

integer

时间间隔,单位为分钟。

10

Enforce

boolean

是否强制执行。为 true 表示忽略桌面及连接状态检测,强制执行定时任务。

false

ResetType

string

重置类型,决定是否重置,以及要重置的磁盘范围。

枚举值:

  • RESET_TYPE_SYSTEM :

    重置系统盘

  • RESET_TYPE_USER_DISK :

    重置数据盘

  • RESET_TYPE_BOTH :

    重置系统盘和数据盘

RESET_TYPE_SYSTEM

AllowClientSetting

boolean

是否允许终端用户自行配置定时任务。

true

OperationType

string

定时任务操作类型,目前仅断连定时任务支持。

枚举值:

  • Hibernate :

    休眠

  • Shutdown :

    关机

Shutdown

TriggerType

string

无操作定时任务触发配置类型。

枚举值:

  • Advanced :

    智能判断

  • Standard :

    标准判断

Standard

ProcessWhitelist

array

无操作定时任务智能判断的进程白名单,如果指定的进程正在运行则不支持无操作定时任务。

string

进程名称。

chrome

NotificationTime

integer

SegmentTimers

array<object>

object

OperationType

string

StartCronExpression

string

EndCronExpression

string

Interval

integer

TriggerType

string

ProcessWhitelist

array

string

NotificationTime

integer

TimerOrder

integer

Timezone

string

Enforce

boolean

ResetType

string

ImageId

string

m-5b0vjqbiqu010XXXXXX

LockScreenTime

integer

1800

AppointmentTimer

integer

1764660600967

VerificationTime

integer

VerificationNotificationTime

integer

Name

string

配置组名称。

定时任务

Description

string

配置组描述信息。

定时任务

返回参数

名称

类型

描述

示例值

object

Schema of Response

RequestId

string

请求 ID。

1CBAFFAB-B697-4049-A9B1-67E1FC5F****

GroupId

string

配置组 ID。

cg-i1ruuudp92qpj****

示例

正常返回示例

JSON格式

{
  "RequestId": "1CBAFFAB-B697-4049-A9B1-67E1FC5F****",
  "GroupId": "cg-i1ruuudp92qpj****"
}

错误码

HTTP status code

错误码

错误信息

描述

400 OperationTooFrequent The operation is too frequent, please try again later. 操作过于频繁,请稍后再试

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

变更历史

更多信息,参考变更详情