# 计划事件授权 - AcceptScheduledEvent #### 功能介绍 计划事件授权接口用于为指定的计划事件分配或调整权限。该接口适用于以下场景：当创建新的计划事件、调整现有计划事件的权限设置或变更权限分配时，用户可通过此接口为指定的计划事件授予或修改权限。使用该接口的前提条件是计划事件已存在且用户具有管理员权限。授权操作完成后，计划事件的权限设置将被更新，相关变更将被记录以便审计。若计划事件不存在、用户无权限操作或授权信息格式不正确，接口将返回相应的错误信息。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/ModelArts/doc?api=AcceptScheduledEvent)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-modelarts/modelarts_03_0138.html)。 - 如果使用身份策略授权，当前API调用无需身份策略权限。 #### URI POST /v1/{project_id}/scheduled-events/{event_id}/accept 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释** : 用户项目ID。获取方法请参见[获取项目ID和名称](https://support.huaweicloud.com/api-modelarts/modelarts_03_0147.html)。 **约束限制**：不涉及。 **取值范围**：不涉及。 **默认取值**：不涉及。 | | event_id | 是 | String | **参数解释**：计划事件ID，取值查询计划事件列表接口的event_id字段。 **约束限制**：不涉及。 **取值范围**：系统自动生成，只能以小写字母开头，数字、中划线组成，不能以中划线结尾，长度小于63 **默认取值**：不涉及。 | 表2Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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。 | 表4redeployConfig | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-modelarts/modelarts_03_0095.html)。