计划事件授权
功能介绍
计划事件授权接口用于为指定的计划事件分配或调整权限。该接口适用于以下场景：当创建新的计划事件、调整现有计划事件的权限设置或变更权限分配时，用户可通过此接口为指定的计划事件授予或修改权限。使用该接口的前提条件是计划事件已存在且用户具有管理员权限。授权操作完成后，计划事件的权限设置将被更新，相关变更将被记录以便审计。若计划事件不存在、用户无权限操作或授权信息格式不正确，接口将返回相应的错误信息。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
POST /v1/{project_id}/scheduled-events/{event_id}/accept
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
参数解释: 用户项目ID。获取方法请参见获取项目ID和名称。 约束限制：不涉及。 取值范围：不涉及。 默认取值：不涉及。 |
|
event_id |
是 |
String |
参数解释：计划事件ID，取值查询计划事件列表接口的event_id字段。 约束限制：不涉及。 取值范围：系统自动生成，只能以小写字母开头，数字、中划线组成，不能以中划线结尾，长度小于63 默认取值：不涉及。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
notBefore |
否 |
String |
参数解释：计划执行开始时间，格式为yyyy-MM-ddTHH:mm:ssZ。 约束限制：不涉及。 取值范围：大于当前时间。 默认取值：不填表示立即执行。 |
响应参数
状态码：200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
X-request-id |
String |
This field is the request ID number for task tracking. Format is request_uuid-timestamp-hostname. |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
String |
参数解释：计划事件ID，取值查询计划事件列表接口的event_id字段。 系统自动生成，只能以小写字母开头，数字、中划线组成，不能以中划线结尾，长度小于63。 取值范围：不涉及。 |
|
catalog |
String |
参数解释：事件分类。 取值范围：可选值如下： - hardware：硬件维修。 - software：软件维修。 |
|
type |
String |
参数解释：事件类型。 取值范围：可选值如下：
|
|
description |
String |
参数解释：对计划事件的描述信息。系统自动生成。 取值范围：不涉及。 |
|
state |
String |
参数解释：事件状态。 取值范围：可选择值如下：
|
|
instanceType |
String |
参数解释：节点类型归属。 取值范围可选择值如下：
|
|
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
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
X-request-id |
String |
This field is the request ID number for task tracking. Format is request_uuid-timestamp-hostname. |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
错误码 |
|
error_msg |
String |
错误描述 |
请求示例
/v1/{project_id}/scheduled-events/{event_id}/accept
{
"notBefore" : "xxxx"
}
响应示例
无
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
事件详情。 |
|
400 |
Error response |
错误码
请参见错误码。
