文档首页/ 魔坊（ModelArts）模型训推平台/ API参考/ 专属资源池和轻量算力集群管理/ 计划事件/ 计划事件授权 - AcceptScheduledEvent
更新时间：2026-07-27 GMT+08:00
在线调试
CLI示例
查看PDF
分享

计划事件授权 - AcceptScheduledEvent

功能介绍

计划事件授权接口用于为指定的计划事件分配或调整权限。该接口适用于以下场景：当创建新的计划事件、调整现有计划事件的权限设置或变更权限分配时，用户可通过此接口为指定的计划事件授予或修改权限。使用该接口的前提条件是计划事件已存在且用户具有管理员权限。授权操作完成后，计划事件的权限设置将被更新，相关变更将被记录以便审计。若计划事件不存在、用户无权限操作或授权信息格式不正确，接口将返回相应的错误信息。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，当前API调用无需身份策略权限。

URI

POST /v1/{project_id}/scheduled-events/{event_id}/accept

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释: 用户项目ID。获取方法请参见获取项目ID和名称。

约束限制：不涉及。

取值范围：不涉及。

默认取值：不涉及。

event_id

是

String

参数解释：计划事件ID，取值查询计划事件列表接口的event_id字段。

约束限制：不涉及。

取值范围：系统自动生成，只能以小写字母开头，数字、中划线组成，不能以中划线结尾，长度小于63

默认取值：不涉及。
表2 Query参数

参数

是否必选

参数类型

描述

workspaceId

否

String

参数解释：工作空间ID，默认值为0，取值于查询workspaces列表的接口的id字段。

约束限制：系统自动生成，只能以小写字母开头，数字、中划线组成，不能以中划线结尾，且长度小于63个字符。

取值范围：不涉及。

默认取值：不涉及。

请求参数

表3 请求Body参数

参数

是否必选

参数类型

描述

notBefore

否

String

参数解释：计划执行开始时间，格式为yyyy-MM-ddTHH:mm:ssZ。

约束限制：不涉及。

取值范围：大于当前时间。

默认取值：不填表示立即执行。

redeployConfig

否

redeployConfig object

参数解释：重部署执行配置。当计划事件类型为系统维护、本地盘恢复、超节点重部署时可选择，，其余计划事件即节点重启、运维授权、超节点维护、超节点本地盘恢复均不能配置 redeployConfig。

约束限制：Lite server 系统维护、本地盘恢复无需配置重部署Type类型，不区分SOFT/HARD模式，超节点重部署计划事件无需指定 redeployConfig。
表4 redeployConfig

参数

是否必选

参数类型

描述

type

否

String

节点的重部署类型。若节点状态为不可用，将无法进行SOFT模式，只能进行HARD模式，HARD模式包含节点重置操作，会导致本地盘及云盘上的全部数据丢失，请谨慎操作

autoFlow

否

String

静默修复开关。开启autoFlow开关时，如重部署失败系统将自动流转至"系统维护"或发起"二次重部署"，并产生新的计划事件，该过程自动授权，无需二次授权

响应参数

状态码：200

表5 响应Header参数

参数

参数类型

描述

X-request-id

String

参数解释：用于任务追踪的请求标识编号。格式为 request_uuid - 时间戳 - 主机名。

取值范围：不涉及。
表6 响应Body参数

参数

参数类型

描述

id

String

参数解释：计划事件ID，取值查询计划事件列表接口的event_id字段。 系统自动生成，只能以小写字母开头，数字、中划线组成，不能以中划线结尾，长度小于63。

取值范围：不涉及。

catalog

String

参数解释：事件分类。

取值范围：可选值如下： - hardware：硬件维修。 - software：软件维修。

type

String

参数解释：事件类型。

取值范围：可选值如下：

  • system-maintenance：系统维护

  • localdisk-recovery：本地盘恢复

  • node_reboot：节点重启

  • operation-request：运维授权

  • node_maintenance：超节点维护

  • node_redeploy：超节点重部署

  • node_localdisk_recovery 超节点本地盘恢复。

description

String

参数解释：对计划事件的描述信息。系统自动生成。

取值范围：不涉及。

state

String

参数解释：事件状态。

取值范围：可选择值如下：

  • inquiring: 待授权,

  • scheduled: 待执行,

  • executing: 执行中,

  • completed: 执行成功

  • failed: 执行失败

  • canceled: 取消

instanceType

String

参数解释：节点类型归属。

取值范围可选择值如下：

  • devserver：lite-server节点

  • lite-cluster lite池

  • standard 标准池

instanceId

String

参数解释：服务器ID。计算服务系统自动生成的实例ID，长度小于63。

取值范围：不涉及。

nodeName

String

参数解释：节点名称，取值自节点详情的metadata.name字段。系统自动生成，只能以小写字母开头，数字、中划线组成，不能以中划线结尾，小于63个字符。

取值范围：不涉及。

poolName

String

参数解释：资源池名称, lite-cluster、standard才具有，取值自资源池详情的metadata.name字段。系统自动生成，只能以小写字母开头，数字、中划线组成，不能以中划线结尾，小于63个字符。

取值范围：不涉及。

poolDisplayName

String

参数解释：资源池对外显示的名称, lite-cluster、standard才具有，取值自资源池详情的metadata.name字段。只能以小写字母开头，数字、中划线组成，不能以中划线结尾，且长度为[36-63]个字符。

取值范围：不涉及。

publishTime

String

参数解释：事件发布时间。

取值范围：不涉及。

startTime

String

参数解释：事件开始时间。

取值范围：不涉及。

finishTime

String

参数解释：事件完成时间。

取值范围：不涉及。

notBefore

String

参数解释：事件计划执行开始时间，格式为UTC时间字符串：2025-09-15T07:02:30Z。

取值范围：不涉及。

probeMsg

String

参数解释：提示信息。

取值范围：不涉及。

jobProgress

String

参数解释：计划事件执行的实时进度信息，系统自动生成。

取值范围：不涉及。

redeployType

Array of strings

参数解释：节点的重部署类型。

取值范围：可选值如下：- HARD：表示支持强制重部署, - SOFT：表示支持重部署

underLyingInstanceId

String

参数解释：snt9b23 场景对应ECS服务器ID。计算服务系统自动生成的实例ID，长度小于63。

取值范围：snt9b23 涉及, snt9b 不涉及。

状态码：400

表7 响应Header参数

参数

参数类型

描述

X-request-id

String

参数解释：用于任务追踪的请求标识编号。格式为 request_uuid - 时间戳 - 主机名。

取值范围：不涉及。
表8 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

请求示例

POST https://{endpoint}/v1/{project_id}/scheduled-events/{event_id}/accept

{
  "notBefore" : "2024-01-01T00:00:00Z",
  "redeployConfig" : {
    "type" : "SOFT",
    "autoFlow" : true
  }
}

响应示例

状态码：200

事件详情。

计划事件授权。

{
  "id" : "event-001",
  "catalog" : "software",
  "type" : "system-maintenance",
  "description" : "test-think",
  "state" : "scheduled",
  "instanceType" : "lite-cluster",
  "instanceId" : "instance-6f5da086876d4cd084d36f8bd3346036",
  "nodeName" : "node-abc123",
  "poolName" : "pool-6f5da086876d4cd084d36f8bd3346036",
  "poolDisplayName" : "test",
  "publishTime" : "2025-09-15T07:02:30Z",
  "startTime" : "2025-09-16T07:02:30Z",
  "finishTime" : "",
  "notBefore" : "2025-09-16T07:02:30Z",
  "probeMsg" : "",
  "redeployType" : [ "SOFT" ]
}

状态码

状态码

描述

200

事件详情。

400

Error response

错误码

请参见错误码。

父主题： 计划事件

相关文档