查询云游戏任务状态
更新时间不可用
查询指定云游戏任务的当前状态。
GET
https://{domain}/v2/projects/{appid}/cloud-bullet-game/api/live-data/tasks/{taskid}/status注意
- 调用频率限制:单个 taskid 调用上限为 5 次/秒。
taskidstring必填
云游戏任务 ID,调用启动云游戏服务获得。
Authorizationstring必填
发送 HTTP 请求时,你需要将用于游戏推流使用的 RTC Token 填入 HTTP 请求头部的 Authorization 字段。Token 生成方式请参考使用 Token 鉴权。
Content-Typestring必填
数据类型,必须包含 application/json。
响应
OK
响应 Body
err_nointeger请求错误码,0 表示请求成功,非 0 表示请求失败,对应的错误原因和解决方案详见响应状态码。
err_msgstringerr_no 为非 0 时附带的错误提示信息。
logidstring请求链路 id, 用于出现未知问题时提供给声网技术支持以便定位问题。
statusstring云游戏任务状态。可能为以下值:
schedule:调度中。scheduled:调度成功。starting:任务启动中。start_failed:任务启动失败。started:任务启动成功。stopping:任务停止中。stopped:任务已停止。
请求示例
curl --request GET \
--url "https://:domain/v2/projects/:appid/cloud-bullet-game/api/live-data/tasks/:taskid/status" \
--header 'Authorization: <string>' \
--header 'Content-Type: <string>'响应示例
{
"err_no": 0,
"err_msg": "success",
"logid": "1690000000352",
"data": {
"status": "starting"
}
}