文档首页/ 魔坊（ModelArts）模型训推平台/ API参考/ 专属资源池和轻量算力集群管理/ 计划事件/ 计划事件授权 - AcceptScheduledEvent
更新时间：2026-10-22 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模式。

instanceId

否

Array of strings

参数解释：授权节点ID列表。授权重部处理时可选填,支持填入单个故障节点ID。

约束限制：不涉及。

取值范围：计划事件故障节点列表。

默认取值：不填表示授权所有节点。
表4 redeployConfig

参数

是否必选

参数类型

描述

type

否

String

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

autoFlow

否

Boolean

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

响应参数

状态码：200

表5 响应Header参数

参数

参数类型

描述

X-request-id

String

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

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

参数

参数类型

描述

id

String

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

取值范围：不涉及。

catalog

String

参数解释：事件分类。

取值范围：不涉及。

isHyperNode

String

参数解释：超节点标识。

取值范围：true / false

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: 取消

  • part-completed: 部分成功

publishTime

String

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

取值范围：不涉及。

startTime

String

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

取值范围：不涉及。

finishTime

String

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

取值范围：不涉及。

notBefore

String

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

取值范围：不涉及。

probeMsg

String

参数解释：提示信息。

取值范围：不涉及。

executeOptions

ExecuteOptions object

参数解释：执行选项。

取值范围：不涉及。

redeployType

Array of strings

参数解释：节点重部署类型列表，标识该计划事件支持的重部署方式。

取值范围：可选值如下：

  • SOFT：表示支持重部署

  • HARD：表示支持强制重部署

autoRecoveryCheckTime

String

参数解释：事件系统自动授权执行时间，格式为UTC时间字符串：2025-09-15T07:02:30Z。

取值范围：不涉及。

nodes

Array of NodeEvent objects

参数解释：事件关联节点信息列表。

取值范围：不涉及。

instanceId

String

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

取值范围：不涉及。

nodeName

String

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

取值范围：不涉及。

instanceType

String

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

取值范围可选择值如下：

  • devserver：lite-server节点

  • lite-cluster lite池

  • standard 标准池

underLyingInstanceId

String

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

取值范围：超节点涉及, snt9b 不涉及。

flavorSupportRedeploy

Boolean

参数解释：规格是否支持重部署。

取值范围：true/false。

poolName

String

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

取值范围：不涉及。

poolDisplayName

String

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

取值范围：不涉及。

jobProgress

String

参数解释：重部署执行的实时进度信息，系统自动生成。

取值范围：不涉及。
表7 ExecuteOptions

参数

参数类型

描述

serialNumber

String

参数解释：序列号。
表8 NodeEvent

参数

参数类型

描述

eventId

String

参数解释：Iaas计划事件Id。

取值范围：不涉及。

isFaultNode

Boolean

参数解释：是否故障节点。

取值范围：不涉及。

nodeName

String

参数解释：节点名称。

取值范围：不涉及。

instanceId

String

参数解释：节点ID。

取值范围：不涉及。

instanceType

String

参数解释：实例类型。

取值范围：不涉及。

underLyingInstanceId

String

参数解释：底层实例Id。

取值范围：不涉及。

flavorSupportRedeploy

Boolean

参数解释：节点规格是否支持重部署。

取值范围：不涉及。

poolName

String

参数解释：资源池名称。

取值范围：不涉及。

poolDisplayName

String

参数解释：资源池显示名称。

取值范围：不涉及。

state

String

参数解释：Iaas计划事件状态。

取值范围：不涉及。

publishTime

String

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

取值范围：不涉及。

startTime

String

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

取值范围：不涉及。

finishTime

String

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

取值范围：不涉及。

jobProgress

String

参数解释：重部署进度。

取值范围：不涉及。

状态码：400

表9 响应Header参数

参数

参数类型

描述

X-request-id

String

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

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

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

请求示例

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

{
  "notBefore" : "2025-09-15T07:02:30Z",
  "redeployConfig" : {
    "type" : "SOFT",
    "autoFlow" : true
  },
  "instanceId" : [ "string" ]
}

响应示例

无

状态码

状态码

描述

200

事件详情。

400

Error response

错误码

请参见错误码。

父主题： 计划事件

相关文档