文档首页/ 云手机服务器 CPH/ API参考/ 云手机服务器API/ 事件管理/ 授权计划事件 - AuthorizeScheduledEvent
更新时间:2026-07-24 GMT+08:00
分享

授权计划事件 - AuthorizeScheduledEvent

功能介绍

授权计划事件。当系统上报计划事件时,需要对服务器进行“授权维护”操作。

调试

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

授权信息

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

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,需具备如下身份策略权限。

    授权项

    访问级别

    资源类型(*为必须)

    条件键

    别名

    依赖的授权项

    cph:scheduledEvents:authorize

    Write

    -

    -

    -

    -

URI

POST /v1/{project_id}/cloud-phone/scheduled-events/{event_id}/authorize

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目id。

event_id

String

计划事件id。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

表3 请求Body参数

参数

是否必选

参数类型

描述

authorization_type

String

授权类型。取值范围:

maintenance:维护、

redeploy:重部署

not_before

String

计划执行开始时间。仅maintenance类型的事件支持,预约的时间需要比当前时间多5分钟以上,传空字符串表示立即执行。

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

request_id

String

请求的唯一标识ID。

请求示例

授权计划事件

POST https://{CPH Endpoint}/v1/{project_id}/cloud-phone/scheduled-events/{event_id}/authorize

{
  "authorization_type" : "maintenance",
  "not_before" : "2026-06-08T10:43:00Z"
}

响应示例

状态码:200

ok

{
  "request_id" : "95f25ae6120643ac9e0effd633b37b98"
}

状态码

状态码

描述

200

ok

错误码

请参见错误码

相关文档