文档首页/魔坊（ModelArts）模型训推平台/API参考/计划事件/计划事件授权 - AcceptScheduledEvent
更新时间：2026-01-15 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 请求Body参数

参数

是否必选

参数类型

描述

notBefore

否

String

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

约束限制：不涉及。

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

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

响应参数

状态码：200

表3 响应Header参数

参数

参数类型

描述

X-request-id

String

This field is the request ID number for task tracking. Format is request_uuid-timestamp-hostname.

表4 响应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

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

约束限制：格式为UTC时间字符串：2025-09-15T07:02:30Z。

取值范围：不涉及。

默认取值：不涉及。

startTime

String

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

约束限制：格式为UTC时间字符串：2025-09-15T07:02:30Z。

取值范围：不涉及。

默认取值：不涉及。

finishTime

String

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

约束限制：格式为UTC时间字符串：2025-09-15T07:02:30Z。

取值范围：不涉及。

默认取值：不涉及。

notBefore

String

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

约束限制：大于当前时间。

取值范围：不涉及。

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

probeMsg

String

参数解释：提示信息。

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

取值范围：不涉及。

默认取值：不涉及。

redeployType

Array of strings

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

约束限制：不涉及。

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

默认取值：不涉及。

状态码：400

表5 响应Header参数

参数

参数类型

描述

X-request-id

String

This field is the request ID number for task tracking. Format is request_uuid-timestamp-hostname.

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

请求示例

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

{
  "notBefore" : "xxxx"
}

响应示例

无

状态码

状态码

描述

200

事件详情。

400

Error response

错误码

请参见错误码。

父主题：计划事件