查询云端转码状态
更新时间不可用
查询云端转码任务的当前状态。
GET
https://api.sd-rtn.com/v1/projects/{appId}/rtsc/cloud-transcoder/tasks/{taskId}Query 方法用于在创建云端转码任务后查询转码状态。
鉴权
taskIdstring必填
转码任务 ID，为 UUID，用于标识本次请求操作的 Cloud transcoder。
appIdstring必填
声网为每个开发者提供的 App ID。在声网控制台创建一个项目后即可得到一个 App ID。一个 App ID 是一个项目的唯一标识。
builderTokenstring必填
通过 Acquire 方法的响应包体得到的 tokenName 的值。
注意
请确保填入的 builderToken 和你在 Create 接口中传入的 builderToken 一致。
Content-Typestring必填
application/json
响应
如果状态码为 2XX，则请求成功。
响应 Header
响应 Body
taskIdstring转码任务 ID，为 UUID，用于标识本次请求操作的 Cloud transcoder。
createTsnumber转码任务创建时的 Unix 时间戳（秒）。
statusstring转码任务的运行状态：
"IDLE": 任务未开始。"PREPARED": 任务已收到开启请求。"STARTING": 任务正在开启。"CREATED": 任务初始化完成。"STARTED": 任务已经启动。"IN_PROGRESS": 任务正在进行。"STOPPING": 任务正在停止。"STOPPED": 任务已经停止。"EXIT": 任务正常退出。"FAILURE_STOP": 任务异常退出。
注意：你可以用该字段监听任务的状态。
configobject同你在 Create 请求包体中设置的 config 字段。
createTsnumber创建服务时的 Unix 时间戳（秒）。
detailsreserved-object预留字段。
messagestring预留字段。
serviceTypestring服务类型，此处为 "cloudTranscoderV2"。
statusstring转码任务中的转码服务的运行状态：
"serviceIdle": 服务未开始。"serviceReady": 服务已经就绪。"serviceStarted": 服务已经开始。"serviceInProgress": 服务正在进行。"serviceCompleted": 服务已经停止，任务全部完成。"servicePartialCompleted": 服务已经停止，任务部分完成。"serviceValidationFailed": 服务参数验证失败。"serviceAbnormal": 服务异常退出。"serviceUnknown": 服务未知状态。
注意：该字段可用于让声网技术团队调查问题，你无需过多关注。
eventHandlersreserved-object预留字段。
workflowsreserved-object预留字段。
propertiesreserved-object预留字段。
sequenceIdstring预留字段。
variablesreserved-object预留字段。
workflowsreserved-object预留字段。
请求示例
curl --request GET \
--url "https://api.sd-rtn.com/v1/projects/:appId/rtsc/cloud-transcoder/tasks/:taskId?builderToken=string" \
--header 'Authorization: Basic <credentials>' \
--header 'Content-Type: <string>'响应示例
{
"createTs": 1661420011,
"eventHandlers": {},
"execution": {
"workflows": {}
},
"properties": {},
"sequenceId": "0",
"services": {
"cloudTranscoder": {
"config": {},
"createTs": 1661420011,
"message": "OnSlaveServiceQueryUpdated",
"serviceType": "cloudTranscoderV2",
"status": "serviceInProgress"
}
},
"status": "IN_PROGRESS",
"taskId": "c0077139e34d0949c719189a393aa***",
"variables": {},
"workflows": {}
}