文档首页/云手机服务器 CPH/API参考/云手机服务器API/编码服务管理/重启编码服务 - RestartEncodeServer
更新时间：2025-10-28 GMT+08:00
在线调试
CLI示例
查看PDF
分享

重启编码服务 - RestartEncodeServer

功能介绍

批量重启编码服务。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

POST /v1/{project_id}/cloud-phone/encode-servers/batch-restart

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目id。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。

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

表3 请求Body参数

参数

是否必选

参数类型

描述

encode_server_ids

是

Array of strings

待重启的编码服务的ID。

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

request_id

String

请求的唯一标识ID。

jobs

Array of EncodeServerJob objects

任务信息。

表5 EncodeServerJob

参数

参数类型

描述

encode_server_id

String

编码服务的唯一标识ID，编码服务相关任务包含此字段。

job_id

String

任务的唯一标识。

error_code

String

错误码。

error_msg

String

错误说明。

请求示例

批量重启encode_server_ids列表中的服务器上的编码容器

POST https://{CPH Endpoint}/v1/{project_id}/cloud-phone/encode-servers/batch-restart

{
  "encode_server_ids" : [ "d5cfa92995da40168c39b38d2aa478b3", "00b00d1b35094f13b360cdfe15a9bfee" ]
}

响应示例

状态码：200

OK

{
  "jobs" : [ {
    "job_id" : "e9d7b1a2572c4f2c9bf056a3d1b35e39",
    "encode_server_id" : "d5cfa92995da40168c39b38d2aa478b3"
  }, {
    "job_id" : "4d0a42447cac4c9697b97f07934b74bd",
    "encode_server_id" : "00b00d1b35094f13b360cdfe15a9bfee"
  } ],
  "request_id" : "c775bdf09bc0400a9138199b346cab62"
}

状态码

状态码

描述

200

OK

错误码

请参见错误码。

父主题：编码服务管理