云服务器内容精选

  • 操作步骤 登录管理控制台。 在左侧导航中单击“定时任务”。 进入“定时任务”页面。 单击定时任务页面右上角“创建定时任务”。 弹出“创建定时任务”界面。 配置定时任务信息。 任务类型:选择“重建系统盘”。 定时任务名称:用户自定义。 重建方式:默认“重装系统”。 执行周期:支持以下有几种周期,根据用户需求自行选择。 指定时间:可精确到某年某月某日某时某分某秒。 按天:可设置具体时间、间隔天数、过期时间。 按周:可设置具体日期、时间、过期时间。 按月:可设置具体月份、具体日期、时间、过期时间。 是否通知用户:根据实际情况选择,选择“通知”时可根据需要配置“通知消息”内容。 仅Windows系统支持“通知消息”。 确认重装系统盘,请输入:重装系统盘。 选择是否通知用户。 通知:执行6~10。 不通知:执行8~10。 设置“早于定时任务”时间,范围为1~10080分钟 根据所需输入通知消息内容,仅支持文本消息,范围为1~1024个字符。 单击“下一步:选择对象” 跳转至“选择应用对象”界面。 单击“下一步:选择对象”后,首次会弹出授权说明: 云服务管理员权限: 云桌面 支持定时重建和弹性扩容,因此需要租户管理员权限。 同意授权后(首次授权即可),将在 统一身份认证 服务为您创建名为 workspace_admin_trust的委托,为保证服务正常使用,在使用定时任务、桌面池期间,请不要删除或者修改workspace_admini_trust委托,详见系统委托说明章节。 在“可选对象”的下拉框中选择所有桌面/桌面/桌面池名称并勾选。 单击“立即创建”。
  • 响应示例 状态码: 200 正常。 { "tasks_records_details" : [ { "id" : "2b31e-d520xxxx-xxebedb6-e57xxxxxx", "record_id" : "2b31e-d520xxxx-xxebedb6-e57xxxxxx", "desktop_id" : "2b31e-d520xxxx-xxebedb6-e57xxxxxx", "desktop_name" : "desktop1", "exec_status" : "SUC CES S", "exec_script_id" : "string", "result_code" : "WKS.000x", "fail_reason" : "任务冲突", "start_time" : "2022-12-31 09:00:00", "end_time" : "2022-12-31 09:00:00", "time_zone" : "Asia/Shanghai" } ], "total_count" : 10 }
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 tasks_records_details Array of ScheduledTasksRecordsDetails objects 定时任务执行记录详情列表。 total_count Integer 总个数。 表5 ScheduledTasksRecordsDetails 参数 参数类型 描述 id String 任务执行记录详情id。 record_id String 任务执行记录id。 desktop_id String 桌面id。 desktop_name String 桌面名称。 exec_status String 执行状态。 exec_script_id String 执行脚本id。 result_code String 失败或者跳过原因的错误码。 fail_reason String 失败或者跳过原因。 start_time String 执行开始时间,格式为yyyy-MM-dd HH:mm:ss。 end_time String 执行结束时间,格式为yyyy-MM-dd HH:mm:ss。 time_zone String 时区。 状态码: 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码,失败时返回。 error_msg String 错误描述。 encoded_authorization_message String 加密后的详细拒绝原因,用户可以自行调用STS服务的decode-authorization-message接口进行解密。 状态码: 500 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码,失败时返回。 error_msg String 错误描述。 encoded_authorization_message String 加密后的详细拒绝原因,用户可以自行调用STS服务的decode-authorization-message接口进行解密。
  • URI GET /v2/{project_id}/scheduled-tasks/{task_id}/records/{record_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。 task_id 是 String 任务ID。 record_id 是 String 任务执行记录ID。 表2 Query参数 参数 是否必选 参数类型 描述 offset 是 Integer 用于分页查询,查询的起始记录序号,从0开始。 limit 是 Integer 用于分页查询,每页返回的个数,取值范围0~100。
  • URI GET /v2/{project_id}/scheduled-tasks 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 offset 是 Integer 用于分页查询,查询的起始记录序号,从0开始。 limit 是 Integer 用于分页查询,每页返回的个数,取值范围0~50。 task_name 否 String 任务名称。 task_type 否 String 任务类型。START:开机,STOP:关机,REBOOT:重启,HIBERNATE:休眠,REBUILD:重建系统盘,EXECUTE_SCRIPT:执行脚本,CREATE_SNAPSHOT:创建EVS镜像。 scheduled_type 否 String 执行周期类型。FIXED_TIME:指定时间,DAY:按天,WEEK:按周,MONTH:按月,LIFE_CYCLE:触发式。指定LIFE_CYCLE时,才返回触发式任务。 life_cycle_type 否 String 触发场景类型。POST_CREATE_DESKTOP_SUCCESS:创建桌面成功后,POST_REBUILD_DESKTOP_SUCCESS:重建桌面成功后,POST_REATTACH_DESKTOP_SUCCESS:触发重建的分配用户任务成功后,POST_DESKTOP_DISCONNECTED:桌面断开连接后。 last_status 否 String 最近一次执行状态。SUCCESS:成功,SKIP:跳过,FAIL:失败。
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 scheduled_tasks Array of ScheduledTask objects 定时任务列表。 total_count Integer 总个数。 表5 ScheduledTask 参数 参数类型 描述 id String 任务id。 task_name String 任务名称。 task_type String 任务类型。START:开机,STOP:关机,REBOOT:重启,HIBERNATE:休眠,REBUILD:重建系统盘,EXECUTE_SCRIPT:执行脚本,CREATE_SNAPSHOT:创建快照。 scheduled_type String 执行周期。FIXED_TIME:指定时间,DAY:按天,WEEK:按周,MONTH:按月。 life_cycle_type String 触发场景类型。 last_status String 最近一次执行状态。SUCCESS:成功,SKIP:跳过,FAIL:失败。 next_execution_time String 下一次执行时间。格式为yyyy-MM-dd HH:mm:ss。 enable Boolean 是否启用。 description String 描述。 priority Integer 优先级。触发式任务使用。 time_zone String 时区。 wait_time Integer 触发式任务触发后,等待时长。 状态码: 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码,失败时返回。 error_msg String 错误描述。 encoded_authorization_message String 加密后的详细拒绝原因,用户可以自行调用STS服务的decode-authorization-message接口进行解密。 状态码: 500 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码,失败时返回。 error_msg String 错误描述。 encoded_authorization_message String 加密后的详细拒绝原因,用户可以自行调用STS服务的decode-authorization-message接口进行解密。
  • 响应示例 状态码: 200 查询定时任务列表响应。 { "scheduled_tasks" : [ { "id" : "2b31e-d520xxxx-xxebedb6-e57xxxxxx", "task_name" : "测试任务", "task_type" : "START", "scheduled_type" : "FIXED_TIME", "life_cycle_type" : "string", "last_status" : "SUCCESS", "next_execution_time" : "2022-12-23 09:00:00", "enable" : true, "description" : "一个描述。", "priority" : 0, "time_zone" : "string", "wait_time" : 0 } ], "total_count" : 10 }
  • 响应示例 状态码: 200 成功响应。 { "count" : 0, "items" : [ { "id" : "62f48b59-0ebb-4b1e-ad35-f64948a0591b", "execute_id" : "62f48b59-0ebb-4b1e-ad35-f64948a0591b", "server_id" : "62f48b59-0ebb-4b1e-ad35-f64948a0591b", "server_name" : "APS-WKSAPP1", "status" : "WAITING", "task_type" : "RESTART_SERVER", "time_zone" : "Asia/Shanghai", "begin_time" : "2022-03-07T10:40:43.858Z", "end_time" : "2022-03-07T10:40:43.858Z", "result_code" : "WKS.00129901", "result_message" : "The service is now unavailable to process the request." } ] }
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 count Integer 总数。 items Array of ScheduleTaskExecuteDetail objects 服务器组列表,返回列表条目数量上限为分页的最大上限值。 表5 ScheduleTaskExecuteDetail 参数 参数类型 描述 id String 定时任务执行记录主键id。 execute_id String 主任务记录id。 server_id String 操作的server_id。 server_name String 操作的机器名称。 status String job状态: WAITING - 等待 RUNNING - 运行中 SUCCESS - 完成 FAILED - 失败 task_type String 定时任务类型: RESTART_SERVER - 定时重启服务器 START_SERVER - 定时开机 STOP_SERVER - 定时关机 REINSTALL_OS - 定时重装操作系统 time_zone String 时区。 begin_time String 子任务开始时间。 end_time String 子任务结束时间。 result_code String 任务执行失败时的错误码。 result_message String 任务失败原因。 状态码: 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码,失败时返回。 error_msg String 错误描述。 状态码: 401 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码,失败时返回。 error_msg String 错误描述。 状态码: 403 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码,失败时返回。 error_msg String 错误描述。 状态码: 404 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码,失败时返回。 error_msg String 错误描述。 状态码: 405 表10 响应Body参数 参数 参数类型 描述 error_code String 错误码,失败时返回。 error_msg String 错误描述。 状态码: 500 表11 响应Body参数 参数 参数类型 描述 error_code String 错误码,失败时返回。 error_msg String 错误描述。 状态码: 503 表12 响应Body参数 参数 参数类型 描述 error_code String 错误码,失败时返回。 error_msg String 错误描述。
  • URI GET /v1/{project_id}/schedule-task/{execute_history_id}/execute-detail 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目唯一标识。 execute_history_id 是 String 定时任务唯一标识。 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 查询的偏移量。 limit 否 Integer 查询的数量,值区间[1-100]。
  • 什么是定时任务 业务系统中通常存在很多场景不需要人工参与,可以在系统后台定期完成的任务。例如,系统中存在一个定时任务,在每天凌晨3点,定时将到期的商品进行下架处理。系统提供自定义定时任务,您可以根据业务需求进行在线创建、查看、删除定时任务并监控任务执行的结果。 除了在应用开发时创建定时任务,您还可以在环境配置中创建定时任务,详情请参见管理应用中的定时任务。两者的区别是在应用开发设计器中创建的定时任务,可在打包发布应用时,将定时任务一起打包发布出去。在环境配置中创建的定时任务,无法随应用发布出去。
  • 创建定时任务 参考登录AstroZero新版应用设计器中操作,登录应用设计器。 在左侧导航栏中,选择“流程”。 (可选)单击定时任务后的,为定时任务添加目录。 定时任务默认存放在根目录下,在创建定时任务前,您可以先创建定时任务存放的目录,也可以在定时任务创建后将其拖拽到指定目录。 将鼠标放在已创建的定时任务目录上,单击,进入新建定时任务页面。 如果未创建定时任务目录,请直接单击定时任务后的,进入新建定时任务页面。 配置定时任务,单击“保存”。 例如,创建一个定时任务“OfferingOffline”,用于实现从2021-11-25开始,每天零点自动将过期商品下架。其中,将过期商品下架的功能由“OfferingOffline”脚本实现。在创建定时任务之前,需要先开发实现定时任务功能的脚本。如何开发脚本,请参见脚本。 图1 配置定时任务 表1 定时任务参数说明 参数 说明 名称 输入定时任务的名称。命名要求如下: 长度不能超过64个字符,包括前缀命名空间的长度。 说明: 名称前的内容为命名空间,在AstroZero中为了避免不同租户间数据的重名,租户在首次创建应用时需要先定义一个命名空间。一个租户只能创建一个命名空间,创建后不支持修改。 必须以英文字母开头,由英文字母、数字或下划线组成,且不能以下划线结尾。 示例:OfferingOffline。 类型 选择定时任务执行的类型,支持脚本或服务编排。 脚本:使用脚本,开发实现定时任务的功能。 服务编排:使用服务编排,开发实现定时任务的功能。 示例:脚本。 服务编排/脚本 选择定时任务执行的脚本或服务编排,请确保脚本和服务编排已启用,否则在此处无法选择到。 示例:OfferingOffline。 任务首次执行时间 设置定时任务首次执行的时间。 示例:2021-11-25 00:00:00。 执行次数 设置定时任务执行的次数。 仅执行一次。 按设置的频率执行多次。 示例:按设置的频率执行多次 执行周期 “执行次数”配置为“按设置的频率执行多次”时,需要设置定时任务的执行周期。 示例:1。 执行周期单位 “执行次数”配置为“按设置的频率执行多次”时,需要设置执行任务时间的间隔单位。 示例:天。 描述 请根据实际需求,在输入框中输入定时任务的描述信息。 取值范围:1~255个字符。
  • 创建定时任务 登录新版应用设计器。 在“开始”页面,单击“新建定时任务”。 图1 新建定时任务 配置定时任务,单击“保存”。 例如,创建一个定时任务“OfferingOffline”,用于实现从2021-11-25开始,每天零点自动将过期商品下架。其中,将过期商品下架的功能由“OfferingOffline”脚本实现。在创建定时任务之前,需要先开发实现定时任务功能的脚本。如何开发脚本,请参见脚本开发。 图2 配置定时任务 表1 定时任务参数说明 参数 说明 名称 定时任务名称。 例如:OfferingOffline 类型 选择定时任务执行的类型,支持脚本或服务编排。 例如:脚本 服务编排/脚本 选择定时任务执行的脚本或服务编排。 例如:选择已启用的脚本“OfferingOffline”。 输入参数 输入脚本或服务编排的输入参数。 任务首次执行时间 首次执行脚本或服务编排的时间。 例如:2021-11-25 00:00:00 执行次数 定时任务执行次数。 仅执行一次。 按设置的频率执行多次。 例如:按设置的频率执行多次 执行周期 “执行次数”配置为“按设置的频率执行多次”时,需要设置。 例如:1 执行周期单位 “执行次数”配置为“按设置的频率执行多次”时,需要设置执行任务时间的间隔单位。 例如:天 描述 定时任务的描述信息,建议描述其用途。