获取云端录制资源
更新时间：2025-08-05
接口描述
在启动录制前，必须先调用获取云端录制资源接口，该接口会返回一个 resourceId，在启动录制时需要携带该 resourceId。
- resourceId 存在有效期，需要在有效期内调用启动录制接口。
- 一个 resourceId 仅可用于一次启动云端录制的请求。
请求（Request）
请求URI
JSON
1GET /v1/cloudrecording/resourceid/acquire?appId={appId} HTTP/1.1| 参数名 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| appId | String | 是 | 应用ID |
请求头域
除公共头域外，无其它特殊头域。
请求体
无
响应（Response）
响应头域
除公共头域外，无其它特殊头域。
响应体
| 字段名 | 类型 | 描述 |
|---|---|---|
| resourceId | String | 录制资源ID |
| maxValidTime | Long | 资源的最大有效时间戳，等于资源申请时间 + 5 分钟。 获得 resourceId 后，必须在最大有效时间内调用启动录制接口，超时后需要重新申请resourceId |
示例
请求示例
JSON
1GET /v1/cloudrecording/resourceid/acquire?appId=testapp HTTP/1.1
2host: rtc.baidubce.com
3content-type: application/json
4authorization: {bce-authorization-string}
5x-bce-request-id: {bce-request-id}响应示例
JSON
1HTTP/1.1 200 OK
2x-bce-request-id: b06a9214-04d6-4a08-9f5d-966b04604cfb
3date: Mon, 05 Sep 2022 03:25:43 GMT
4transfer-encoding: chunked
5content-type: application/json;charset=UTF-8
6cache-control: no-cache
7{
8 "resourceId": "testResourceId",
9 "maxValidTime": 1670383421767
10}