完成媒资封面上传
更新时间：2024-12-17
与媒资上传流程类似，自定义媒资的封面图，也需要通过申请媒资封面上传、上传封面图文件、完成媒资封面上传三步来完成。
通过本接口可以通知VOD服务媒资封面图已经上传完毕，VOD将会更新媒资的封面信息。
请求结构
Http
1POST /v2/medias/cover/complete_upload HTTP/1.1
2connection: keep-alive
3host: vod.bj.baidubce.com
4content-type: application/json
5x-bce-request-id: <bce-request-id>
6x-bce-date: <utc-date-string>
7authorization: <bce-authorization-string>
8
9{
10 // 请求参数
11}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| mediaId | string | 是 | RequestBody参数 | 媒资ID |
| uploadKey | string | 否 | RequestBody参数 | 请求申请媒资封面上传返回的临时上传key |
返回头域
除公共头域，无其它特殊头域。
返回参数
无。
示例
完成媒资封面上传
请求内容
Http
1POST /v2/medias/cover/complete_upload HTTP/1.1
2host: vod.bj.baidubce.com
3accept: */*
4connection: keep-alive
5content-type: application/json
6x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d481
7x-bce-date: 2024-03-24T13:08:44Z
8authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2024-03-24T13:08:44Z/1800/host;x-bce-date/7e21c9cf1e4e2cc6921a407a388fe98df122c53b9f509043d841be76eb09a1f9
9
10{
11 "mediaId": "mda-emcvg7qrib0xq2y5",
12 "uploadKey": "tmp/cover/emdkmqy4t0yzihwx8c5f/demo.jpg"
13}返回内容
Http
1HTTP/1.1 200 OK
2Transfer-Encoding: chunked
3x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d481
4Cache-Control: no-cache
5Date: Tue, 24 Mar 2024 13:08:44 GMT
6Content-Type: application/json;charset=UTF-8错误码
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。
| 错误码 | 错误信息 | HTTP状态码 | 描述 |
|---|---|---|---|
| MediaCoverNotFound | Media cover not found with uploadKey : xxx | 404 Bad Request | 未找到媒资封面图 |