定时任务组绑定触发器(AddSchedulerJobGroupToSchedulerTrigger)
API请求
URLs
POST zstack/v1/scheduler/jobgroups/{schedulerJobGroupUuid}/scheduler/triggers/{schedulerTriggerUuid}
Headers
Authorization: OAuth the-session-uuid
Body
{
"params": {
"triggerNow": false
},
"systemTags": [],
"userTags": []
}
Note: 上述示例中systemTags、userTags字段可以省略。列出是为了表示body中可以包含这两个字段。
Curl示例
curl -H "Content-Type: application/json" \
-H "Authorization: OAuth b86c9016b4f24953a9edefb53ca0678c" \
-X POST -d '{"params":{"triggerNow":false}}' http://localhost:8080/zstack/v1/scheduler/jobgroups/997c126bb3db39f6bbda1ffe90008f51/scheduler/triggers/78341d4e8f683a3291527f4944fa6831
参数列表
名字 | 类型 | 位置 | 描述 | 可选值 | 起始版本 |
---|---|---|---|---|---|
schedulerJobGroupUuid | String | url | 定时任务组UUID | 3.4.0 | |
schedulerTriggerUuid | String | url | 触发器UUID | 3.4.0 | |
triggerNow (可选) | boolean | body(包含在params结构中) | 是否立即触发 | 3.4.0 | |
systemTags (可选) | List | body | 系统标签列表 | 3.4.0 | |
userTags (可选) | List | body | 用户标签列表 | 3.4.0 |
API返回
返回示例
{
"inventory": {
"schedulerJobGroupUuid": "ec8d2952f8f13747bbbf24f93585a63d",
"schedulerTriggerUuid": "4b5bc56b58623324afe0a57951a96064"
}
}
名字 | 类型 | 描述 | 起始版本 |
---|---|---|---|
error | ErrorCode | 错误码,若不为null,则表示操作失败, 操作成功时该字段为null。 详情参考error | 3.4.0 |
inventory | SchedulerJobGroupSchedulerTriggerRefInventory | 详情参考inventory | 3.4.0 |
#error
名字 | 类型 | 描述 | 起始版本 |
---|---|---|---|
code | String | 错误码号,错误的全局唯一标识,例如SYS.1000, HOST.1001 | 3.4.0 |
description | String | 错误的概要描述 | 3.4.0 |
details | String | 错误的详细信息 | 3.4.0 |
elaboration | String | 保留字段,默认为null | 3.4.0 |
opaque | LinkedHashMap | 保留字段,默认为null | 3.4.0 |
cause | ErrorCode | 根错误,引发当前错误的源错误,若无原错误,该字段为null | 3.4.0 |
#inventory
名字 | 类型 | 描述 | 起始版本 |
---|---|---|---|
schedulerJobGroupUuid | String | 定时任务组UUID | 3.4.0 |
schedulerTriggerUuid | String | 触发器UUID | 3.4.0 |
createDate | Timestamp | 创建时间 | 3.4.0 |
lastOpDate | Timestamp | 最后一次修改时间 | 3.4.0 |
SDK示例
Java
SDK
AddSchedulerJobGroupToSchedulerTriggerAction action = new AddSchedulerJobGroupToSchedulerTriggerAction();
action.schedulerJobGroupUuid = "997c126bb3db39f6bbda1ffe90008f51";
action.schedulerTriggerUuid = "78341d4e8f683a3291527f4944fa6831";
action.triggerNow = false;
action.sessionId = "b86c9016b4f24953a9edefb53ca0678c";
AddSchedulerJobGroupToSchedulerTriggerAction.Result res = action.call();
Python
SDK
AddSchedulerJobGroupToSchedulerTriggerAction action = AddSchedulerJobGroupToSchedulerTriggerAction()
action.schedulerJobGroupUuid = "997c126bb3db39f6bbda1ffe90008f51"
action.schedulerTriggerUuid = "78341d4e8f683a3291527f4944fa6831"
action.triggerNow = false
action.sessionId = "b86c9016b4f24953a9edefb53ca0678c"
AddSchedulerJobGroupToSchedulerTriggerAction.Result res = action.call()