音视频媒资接口
更新时间：2024-08-30
创建媒资
VOD不提供直接创建媒资的API接口，而是用申请媒资、BOS上传、处理媒资三步创建法完成创建：1) 通过申请媒资获取mediaId、BOS Bucket和BOS Key；2) 使用BOS上传视频文件；3) 通过处理媒资方法通知VOD服务文件上传完毕，VOD开始生成并处理媒资。
申请媒资
申请媒资接口用于生成媒资的唯一标识mediaId、用于存储源视频文件的sourceBucket以及源媒资文件在BOS存储中的key。sourceBucket对用户开放写权限，对于用户的BOS空间不可见。
请求语法
POST /v<version>/media?apply HTTP/1.1
accept-encoding: gzip, deflate
x-bce-date: <utc-date-string>
connection: keep-alive
accept: */*
host: vod.bj.baidubce.com
x-bce-request-id: <bce-request-id>
content-type: application/json
authorization: <bce-authorization-string>请求参数
| 参数 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| mode | String | 媒资的模式。VOD为某些特殊场景提供了不同格式的媒资，这些媒资以mode区分。 多数用户无需传递该参数。如有特殊需求，请提交工单咨询 |
否 |
请求头域
无特殊请求头域。
请求示例
POST /v1/media?apply HTTP/1.1
accept-encoding: gzip, deflate
x-bce-date: 2015-07-03T09:28:13Z
host: vod.bj.baidubce.com
accept: */*
connection: keep-alive
x-bce-request-id: c82c903b-f513-4990-b020-637bc866ee75
content-type: application/json
authorization: <bce-authorization-string>响应头域
无特殊响应头域。
响应参数
| 头域 | 类型 | 描述 |
|---|---|---|
| mediaId | String | 系统生成的媒资的唯一标识mediaId |
| sourceBucket | String | 该媒资对应的源文件上传地址在BOS存储中的Bucket |
| sourceKey | String | 该媒资对应的源文件上传地址在BOS存储中的Key |
| host | String | 该媒资对应的源文件上传地址对应的BOS存储的BOS host |
响应示例
HTTP/1.1 200 OK
Transfer-Encoding: chunked
x-bce-request-id: c82c903b-f513-4990-b020-637bc866ee75
Cache-Control: no-cache
Server: BWS
Date: Tue, 24 Mar 2015 13:34:07 GMT
Content-Type: application/json;charset=UTF-8
{
"mediaId":"mda-gaefib8idcyi36q8",
"sourceBucket":"vod-gaefbnknkxk1hsm1",
"sourceKey":"vod-gaefbnknkxk1hsm1/mda-gaefib8idcyi36q8",
"host":"bj.bcebos.com"
}处理媒资
用于对已完成申请和视频上传的媒资进行处理。
媒资的三步创建法请见创建媒资。
请求语法
PUT /v<version>/media/<mediaId>?process HTTP/1.1
accept-encoding: gzip, deflate
x-bce-date: <utc-date-string>
connection: keep-alive
accept: */*
host: vod.bj.baidubce.com
x-bce-request-id: <bce-request-id>
content-type: application/json
authorization: <bce-authorization-string>请求头域
无特殊请求头域。
请求参数
| 参数 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| title | String | 媒资名称，“媒资属性”的子参数 | 是 |
| description | String | 媒资描述，“媒资属性”的子参数 | 否 |
| sourceExtension | String | 媒资源文件扩展名，有效值：大小写字母和数字组成的最长10个字符的字符串 | 否 |
| transcodingPresetGroupName | String | 使用的转码模板组名称 | 否 |
| priority | Integer | 转码排队优先级。可选值0-9，不传默认为0。 为了更好的做用户级别的转码调度，处理媒资时候可以增加优先级概念。 同个用户下，优先级高的会被更快被处理。每个用户获取到的转码总资源是固定的，优先级仅供用户自身资源的调度，不会做跨用户比较。 也就是说，如果将所有媒资的优先级设置为9，与所有媒资的优先级设置为0的结果是一致的。 |
否 |
| actionAttributes | Object | 自定义参数 | 否 |
| +horizontalOffsetInPixel | int | 去水印参数，水印水平偏移，单位：像素，取值范围：[0, 4096] | 否 |
| +verticalOffsetInPixel | int | 去水印参数，水印垂直偏移，单位：像素，取值范围：[0, 3072] | 否 |
| +watermarkWidth | int | 去水印参数，水印宽度，单位：像素，取值范围：[1, 4096] | 否 |
| +watermarkHeight | int | 去水印参数，水印高度，单位：像素，取值范围：[1, 4096] | 否 |
| +prologueCuttingInSeconds | int | 待裁片头持续时间，单位：秒，不能与prologueCuttingMillisecond同时使用 | 否 |
| +prologueCuttingInMillisecond | int | 待裁片头持续时间，单位：毫秒，不能与prologueCuttingInSeconds同时使用 | 否 |
| +epilogueCuttingInSeconds | int | 截取的持续时间，单位：秒，不能与epilogueCuttingInMillisecond同时使用 | 否 |
| +epilogueCuttingInMillisecond | int | 截取的持续时间，单位：毫秒，不能与epilogueCuttingInSeconds同时使用 | 否 |
| +clipsMerge | object | 多贴片合成 | 否 |
| ++scope | array | 生效模版，对应于模版组中的模版名称 | 是 |
| ++videoList | arrayObject | 贴片组合 | 是 |
| +++bucketName | string | clips所在bucket | 是 |
| +++objectName | string | objectName | 是 |
| +++enableLogo | boolean | 是否允许在该片段添加水印，默认不加 | 否 |
| +++asMasterClip | boolean | 指定该片段作为主分片，默认false | 否 |
| +++mergeType | int | 合并类型。0:直接合并；1:横屏合并；2:竖屏合并。默认0 | 否 |
| +inserts | Array | 待插入（叠加）的内容，类型可以为图片、视频、音频、字幕、文本水印等。audio类型的inserts不能和其他类型inserts共存。不支持同时设置水印和inserts。多clips的任务不可设置inserts | 否 |
| ++bucket | String | BOS存储上insert文件Bucket | 是 |
| ++key | String | BOS存储上insert文件Key | 是 |
| ++type | String | insert类型，可选值 video, image, audio, subtitle, text，分别表示视频、图片、音频、字幕、文本水印。其中，video类型支持输入key为MOV、MP4等格式，image类型支持输入key为JPG、PNG、APNG、BMP、PBM、TIF、GIF等格式，audio类型支持输入key为MP3、AAC等格式，subtitle类型支持输入key为srt等格式 | 是 |
请求示例
PUT /v1/media/mda-gaefib8idcyi36q8?process HTTP/1.1
accept-encoding: gzip, deflate
x-bce-date: 2015-07-03T09:28:13Z
host: vod.bj.baidubce.com
accept: */*
connection: keep-alive
x-bce-request-id: 012b9747-f13a-4a2c-a488-02b221844dca
content-type: application/json
authorization: <bce-authorization-string>
{
"title":"my_media",
"description":"my_media_description",
"sourceExtension":"mp4",
"transcodingPresetGroupName": "presetgroup_name"
}响应头域
无特殊响应头域。
响应参数
| 参数 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| mediaId | String | 媒资的唯一标识，开发者可通过 mediaId 查询指定媒资的详细信息 | 是 |
响应示例
HTTP/1.1 200 OK
Transfer-Encoding: chunked
x-bce-request-id: 012b9747-f13a-4a2c-a488-02b221844dca
Cache-Control: no-cache
Server: BWS
Date: Tue, 24 Mar 2015 13:34:07 GMT
Content-Type: application/json;charset=UTF-8
{
"mediaId":"mda-gaefib8idcyi36q8"
}查询指定媒资
通过媒资的唯一标识 mediaId 查询指定媒资的详细信息。
请求语法
GET /v<version>/media/<mediaId> HTTP/1.1
accept-encoding: gzip, deflate
x-bce-date: <utc-date-string>
connection: keep-alive
accept: */*
host: vod.bj.baidubce.com
x-bce-request-id: <bce-request-id>
content-type: application/json
authorization: <bce-authorization-string>请求头域
无特殊请求头域。
请求参数
| 参数 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| mediaId | String | 媒资的唯一标识，开发者可通过 mediaId 查询指定媒资的详细信息 | 是 |
请求示例
GET /v1/media/mda-fhepatsnpn4rk9zk HTTP/1.1
accept-encoding: gzip, deflate
x-bce-date: 2015-03-24T13:08:44Z
connection: keep-alive
accept: */*
host: vod.bj.baidubce.com
x-bce-request-id: d97c57d0-ca44-4d1c-bfeb-941a92440968
content-type: application/json
authorization: <bce-authorization-string>响应头域
无特殊响应头域。
响应参数
| 参数 | 类型 | 描述 |
|---|---|---|
| mediaId | String | 媒资的唯一标识，开发者可通过 mediaId 查询指定媒资的详细信息 |
| status | Object | 媒资状态，可选值PROCESSING/RUNNING/FAILED/PUBLISHED/DISABLED/BANNED |
| attributes | Object | 媒资属性 |
| +title | String | 媒资名称，“媒资属性”的子参数 |
| +description | String | 媒资描述，“媒资属性”的子参数 |
| meta | Object | 媒资元数据 |
| +sourceSizeInBytes | Number | 媒资源文件大小，“媒资元数据”的子参数 |
| +sizeInBytes | Number | 媒资所占空间大小（包括源音视频文件、转码后音视频文件、缩略图等），“媒资元数据”的子参数 |
| +durationInSeconds | Number | 媒资时长，“媒资元数据”的子参数 |
| error | Object | 错误信息，仅当status=Failed时有效 |
| +code | String | 错误码，“错误信息”的子参数，有效值：TRANSCODING_FAILED（转码失败）、THUMBNAIL_FAILED（缩略图失败）、MEDIA_OVERTIME（媒资处理超时） |
| +message | String | 错误描述，“错误信息”的子参数 |
| publishTime | String | 媒资发布时间 |
| createTime | String | 媒资创建时间 |
| transcodingPresetGroupName | String | 使用的转码模板组名称 |
| playableUrlList | Array | 处理后可以播放的视频信息 |
| + transcodingPresetName | String | 使用的转码模板名称 |
| + url | String | 可以播放视频文件的地址 |
| + meta | Object | 转码结果元信息 |
| ++ sizeInBytes | Number | 转码后的视频所占空间 |
| ++ durationInSeconds | Number | 转码后的视频时长，单位秒 |
| ++ bitRateInBps | Number | 转码后的视频码率 |
| ++ frameRate | Number | 转码后的视频帧率 |
| ++ widthInPixel | Number | 转码后的视频宽度 |
| ++ heightInPixel | Number | 转码后的视频高度 |
| thumbnailList | Array | 缩略图文件的地址 |
响应示例
HTTP/1.1 200 OK
Transfer-Encoding: chunked
x-bce-request-id: d97c57d0-ca44-4d1c-bfeb-941a92440968
Cache-Control: no-cache
Server: BWS
Date: Tue, 24 Mar 2015 13:34:07 GMT
Content-Type: application/json;charset=UTF-8
{
"mediaId":"mda-fhepatsnpn4rk9zk",
"status":"success",
"attributes":{
"title":"my_media",
"description":"my_media_description"
},
"meta":{
"sourceSizeInBytes":80000,
"sizeInBytes":102400,
"durationInSeconds":60
},
"publishTime":"2015-03-25T13:37:10Z",
"createTime":"2015-03-24T13:37:10Z",
"transcodingPresetGroupName": "presetgroup_name",
"playableUrlList": [
{
"transcodingPresetName": "mp4_1920x1080_3660kbps",
"url": "http://efexzeder.exp.bcevod.com/mda-fhepatsnpn4rk9zk/sdf92ejsjowdgww230l/mda-fhepatsnpn4rk9zk.m3u8"
"meta": {
"sizeInBytes": 102400,
"durationInSeconds": 60,
"bitRateInBps": 120,
"frameRate": 30,
"widthInPixel": 120,
"heightInPixel": 360
}
},
{
"transcodingPresetName": "hls_640x360_520kbps",
"url": "http://efexzeder.exp.bcevod.com/mda-fhepatsnpn4rk9zk/0jx92ekmxdwdgwwsi34/mda-fhepatsnpn4rk9zk.mp4"
"meta": {
"sizeInBytes": 102400,
"durationInSeconds": 60,
"bitRateInBps": 120,
"frameRate": 30,
"widthInPixel": 120,
"heightInPixel": 360
}
}
],
"thumbnailList": [
"http://efexzeder.exp.bcevod.com/mda-fhepatsnpn4rk9zk/mda-fhepatsnpn4rk9zk.jpg",
]
}筛选媒资并分页显示
对用户的所有媒资进行条件筛选并分页显示。
请求语法
GET /v<version>/media?pageNo=<pageNo>&pageSize=<pageSize>&status=<status>&begin=<createTimeLowLimit>&end=<createTimeUpperLimit>&title={titlePrefix} HTTP/1.1
accept-encoding: gzip, deflate
x-bce-date: <utc-date-string>
connection: keep-alive
accept: */*
host: vod.bj.baidubce.com
x-bce-request-id: <bce-request-id>
content-type: application/json
authorization: <bce-authorization-string> 请求头域
无特殊请求头域。
请求参数
| 参数 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| pageNo | Integer | 页数。首页为第一页，有效值：正整数，默认值：1 | 否 |
| pageSize | Integer | 每页大小。有效值：1-1000的整数 | 是 |
| status | String | 媒资状态，用于筛选处于特定状态的媒资 | 否 |
| begin | Date | 媒资创建时间(createTime)上限，用于筛选创建时间等于或晚于begin的媒资 | 否 |
| end | Date | 媒资创建时间(createTime)下限，用于筛选创建时间等于或早于end的媒资 | 否 |
| title | String | 媒资标题前缀，用于筛选标题以title开头的媒资 | 否 |
请求示例
GET /v1/media?pageNo=3&pageSize=2&status=PUBLISHED&begin=2016-04-11T12:18:30Z&end=2016-04-13T12:18:30Z HTTP/1.1
accept-encoding: gzip, deflate
x-bce-date: 2015-03-24T13:08:44Z
host: vod.bj.baidubce.com
accept: */*
connection: keep-alive
x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d481
content-type: application/json
authorization: <bce-authorization-string>响应头域
无特殊响应头域。
响应参数
| 参数 | 类型 | 描述 |
|---|---|---|
| media | Object[] | 数组，每个元素为一个media类型。 media类型请参考"查询指定媒资接口"的返回 |
| pageNo | Number | 当前页数 |
| pageSize | Number | 分页大小 |
| totalCount | Number | 筛选出的媒资总数 |
响应示例
HTTP/1.1 200 OK
Transfer-Encoding: chunked
x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d481
Cache-Control: no-cache
Server: BWS
Date: Tue, 24 Mar 2015 13:08:44 GMT
Content-Type: application/json;charset=UTF-8
{
"media":[
{
"mediaId":"mda-fhepatsnpn4rk9zk",
"status":"published",
"attributes":{
"title":"my_media",
"description":"my_media_description"
},
"meta":{
"sourceSizeInBytes":80000,
"sizeInBytes":102400,
"durationInSeconds":60
},
"publishTime":"2016-04-12T14:18:30Z",
"createTime":"2016-04-12T13:18:30Z",
"transcodingPresetGroupName": "presetgroup_name",
"playableUrlList": [
{
"transcodingPresetName": "mp4_1920x1080_3660kbps",
"url": "http://efexzeder.exp.bcevod.com/mda-fhepatsnpn4rk9zk/sdf92ejsjowdgww230l/mda-fhepatsnpn4rk9zk.m3u8"
"meta": {
"sizeInBytes": 102400,
"durationInSeconds": 60,
"bitRateInBps": 120,
"frameRate": 30,
"widthInPixel": 120,
"heightInPixel": 360
}
},
{
"transcodingPresetName": "hls_640x360_520kbps",
"url": "http://efexzeder.exp.bcevod.com/mda-fhepatsnpn4rk9zk/0jx92ekmxdwdgwwsi34/mda-fhepatsnpn4rk9zk.mp4"
}
],
"thumbnailList": [
"http://efexzeder.exp.bcevod.com/mda-fhepatsnpn4rk9zk/mda-fhepatsnpn4rk9zk.jpg",
]
},
{
"mediaId":"mda-fczspxdutvmnbamq",
"status":"published",
"attributes":{
"title":"my_media",
"description":"my_media_description"
},
"meta":{
"sourceSizeInBytes":80000,
"sizeInBytes":102400,
"durationInSeconds":60
},
"publishTime":"2016-04-12T13:18:30Z",
"createTime":"2016-04-12T12:18:30Z",
"transcodingPresetGroupName": "copy_only",
"playableUrlList": [
{
"url": "http://efexzeder.exp.bcevod.com/mda-fhepatsnpn4rk9zk/sdf92ejsjowdgww230l/mda-fhepatsnpn4rk9zk.m3u8"
"meta": {
"sizeInBytes": 102400,
"durationInSeconds": 60,
"bitRateInBps": 120,
"frameRate": 30,
"widthInPixel": 120,
"heightInPixel": 360
}
}
],
"thumbnailList": [
"http://efexzeder.exp.bcevod.com/mda-fhepatsnpn4rk9zk/mda-fhepatsnpn4rk9zk.jpg",
]
}
],
"pageNo":3,
"pageSize":2,
"totalCount":10
}筛选媒资并用marker机制显示
对用户的所有媒资进行条件筛选并用marker机制显示。
请求语法
GET /v<version>/media?marker=<marker>&maxSize=<maxSize}&status=<status>&begin=<createTimeLowLimit>&end=<createTimeUpperLimit>&title=<titlePrefix> HTTP/1.1
accept-encoding: gzip, deflate
x-bce-date: <utc-date-string>
connection: keep-alive
accept: */*
host: vod.bj.baidubce.com
x-bce-request-id: <bce-request-id>
content-type: application/json
authorization: <bce-authorization-string> 请求头域
无特殊请求头域。
请求参数
| 参数 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| marker | String | 本次请求的marker，标记查询的起始位置，是上次marker机制查询返回的nextMarker，首次查询不提供本字段 | 否 |
| maxSize | Integer | 本次请求返回的任务列表的最大元素个数，有效值：[1-1000]，默认值：1000 | 否 |
| status | String | 媒资状态，用于筛选处于特定状态的媒资 | 否 |
| begin | Date | 媒资创建时间(createTime)上限，用于筛选创建时间等于或晚于begin的媒资 | 否 |
| end | Date | 媒资创建时间(createTime)下限，用于筛选创建时间等于或早于end的媒资 | 否 |
| title | String | 媒资标题前缀，用于筛选标题以title开头的媒资 | 否 |
请求示例
GET /v1/media?marker=mda-fhepatsnpn4rk9zk&maxSize=2&status=PUBLISHED&begin=2016-04-11T12:18:30Z&end=2016-04-13T12:18:30Z HTTP/1.1
accept-encoding: gzip, deflate
x-bce-date: 2015-03-24T13:08:44Z
host: vod.bj.baidubce.com
accept: */*
connection: keep-alive
x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d481
content-type: application/json
authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2015-03-24T13:08:44Z/1800/host;x-date/7e21c9cf1e4e2cc6921a407a388fe98df122c53b9f509043d841be76eb09a1f9响应头域
无特殊响应头域。
响应参数
| 参数 | 类型 | 描述 |
|---|---|---|
| media | Object[] | 数组，每个元素为一个media类型。media类型请参考"查询指定媒资"接口的返回 |
| marker | String | 本次请求的marker，标记查询的起始位置 |
| isTruncated | Boolean | true表示后面还有数据，false表示已经是最后一页 |
| nextMarker | String | 获取下一页所需要传递的marker值，仅当isTruncated为true时有效 |
响应示例
HTTP/1.1 200 OK
Transfer-Encoding: chunked
x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d481
Cache-Control: no-cache
Server: BWS
Date: Tue, 24 Mar 2015 13:08:44 GMT
Content-Type: application/json;charset=UTF-8
{
"media":[
{
"mediaId":"mda-fhepatsnpn4rk9zk",
"status":"published",
"attributes":{
"title":"my_media",
"description":"my_media_description"
},
"meta":{
"sourceSizeInBytes":80000,
"sizeInBytes":102400,
"durationInSeconds":60
},
"publishTime":"2016-04-12T14:18:30Z",
"createTime":"2016-04-12T13:18:30Z",
"transcodingPresetGroupName": "presetgroup_name",
"playableUrlList": [
{
"transcodingPresetName": "mp4_1920x1080_3660kbps",
"url": "http://efexzeder.exp.bcevod.com/mda-fhepatsnpn4rk9zk/sdf92ejsjowdgww230l/mda-fhepatsnpn4rk9zk.m3u8"
"meta": {
"sizeInBytes": 102400,
"durationInSeconds": 60,
"bitRateInBps": 120,
"frameRate": 30,
"widthInPixel": 120,
"heightInPixel": 360
}
},
{
"transcodingPresetName": "hls_640x360_520kbps",
"url": "http://efexzeder.exp.bcevod.com/mda-fhepatsnpn4rk9zk/0jx92ekmxdwdgwwsi34/mda-fhepatsnpn4rk9zk.mp4"
}
],
"thumbnailList": [
"http://efexzeder.exp.bcevod.com/mda-fhepatsnpn4rk9zk/mda-fhepatsnpn4rk9zk.jpg",
]
},
{
"mediaId":"mda-fczspxdutvmnbamq",
"status":"published",
"attributes":{
"title":"my_media",
"description":"my_media_description"
},
"meta":{
"sourceSizeInBytes":80000,
"sizeInBytes":102400,
"durationInSeconds":60
},
"publishTime":"2016-04-12T13:18:30Z",
"createTime":"2016-04-12T12:18:30Z",
"transcodingPresetGroupName": "copy_only",
"playableUrlList": [
{
"url": "http://efexzeder.exp.bcevod.com/mda-fhepatsnpn4rk9zk/sdf92ejsjowdgww230l/mda-fhepatsnpn4rk9zk.m3u8"
"meta": {
"sizeInBytes": 102400,
"durationInSeconds": 60,
"bitRateInBps": 120,
"frameRate": 30,
"widthInPixel": 120,
"heightInPixel": 360
}
}
],
"thumbnailList": [
"http://efexzeder.exp.bcevod.com/mda-fhepatsnpn4rk9zk/mda-fhepatsnpn4rk9zk.jpg",
]
}
],
"marker":"mda-fhepatsnpn4rk9zk",
"isTruncated":true,
"nextMarker":"mda-gfpj59idrpygsjtw"
}更新指定媒资
通过媒资的唯一标识 mediaId 更新指定媒资的属性，包括名称和描述。
请求语法
PUT /v<version>/media/<mediaId>?attributes HTTP/1.1
accept-encoding: gzip, deflate
x-bce-date: <utc-date-string>
connection: keep-alive
accept: */*
host: vod.bj.baidubce.com
x-bce-request-id: <bce-request-id>
content-type: application/json
authorization: <bce-authorization-string>
{
“title”:"<new-title>"
"description":"<new-description>"
}请求头域
无特殊请求头域。
请求参数
| 参数 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| mediaId | String | 媒资的唯一标识，开发者可通过 mediaId 查询指定媒资的详细信息 | 是 |
| title | String | 媒资名称 | 是 |
| description | String | 媒资描述 | 否 |
请求示例
PUT /v1/media/mda-fhepatsnpn4rk9zk?attributes HTTP/1.1
accept-encoding: gzip, deflate
x-bce-date: 2015-07-03T09:28:13Z
host: vod.bj.baidubce.com
accept: */*
connection: keep-alive
x-bce-request-id: 8776558c-81d9-4f97-8e2c-f977a286095d
content-type: application/json
authorization: <bce-authorization-string>
{
"title":"updated_title",
"description":"updated_description"
}响应头域
无特殊响应头域。
响应参数
无。
响应示例
HTTP/1.1 200 OK
x-bce-request-id: 6d0b0a36-2ffe-49d4-9d81-333a9ab9417e
Date: Tue, 24 Mar 2015 13:06:02 GMT
Transfer-Encoding: chunked
Content-Type: application/json;charset=UTF-8
Cache-Control: no-cache停用指定媒资
通过媒资的唯一标识 mediaId 停用指定媒资，仅对状态为PUBLISHED的媒资有效。
请求语法
PUT /v<version>/media/<mediaId>?disable HTTP/1.1
accept-encoding: gzip, deflate
x-bce-date: <utc-date-string>
connection: keep-alive
accept: */*
host: vod.bj.baidubce.com
x-bce-request-id: <bce-request-id>
content-type: application/json
authorization: <bce-authorization-string>请求头域
无特殊请求头域。
请求参数
| 参数 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| mediaId | String | 媒资的唯一标识，开发者可通过 mediaId 查询指定媒资的详细信息 | 是 |
请求示例
PUT /v1/media/mda-fhepatsnpn4rk9zk?disable HTTP/1.1
accept-encoding: gzip, deflate
x-bce-date: 2015-03-24T13:06:02Z
connection: keep-alive
accept: */*
host: vod.bj.baidubce.com
x-bce-request-id: 6d0b0a36-2ffe-49d4-9d81-333a9ab9417e
content-type: application/json
authorization: <bce-authorization-string>响应头域
无特殊响应头域。
响应参数
无。
响应示例
HTTP/1.1 200 OK
x-bce-request-id: 6d0b0a36-2ffe-49d4-9d81-333a9ab9417e
Date: Tue, 24 Mar 2015 13:06:02 GMT
Transfer-Encoding: chunked
Content-Type: application/json;charset=UTF-8
Cache-Control: no-cache恢复指定媒资
通过媒资的唯一标识 mediaId 恢复指定媒资，仅对状态为DISABLED的媒资有效。
请求语法
PUT /v<version>/media/<mediaId>?publish HTTP/1.1
accept-encoding: gzip, deflate
x-bce-date: <utc-date-string>
connection: keep-alive
accept: */*
host: vod.bj.baidubce.com
x-bce-request-id: <bce-request-id>
content-type: application/json
authorization: <bce-authorization-string>请求头域
无特殊请求头域。
请求参数
| 参数 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| mediaId | String | 媒资的唯一标识，开发者可通过 mediaId 查询指定媒资的详细信息 | 是 |
请求示例
PUT /v1/media/mda-fhepatsnpn4rk9zk?publish HTTP/1.1
accept-encoding: gzip, deflate
x-bce-date: 2015-03-24T13:06:02Z
connection: keep-alive
accept: */*
host: vod.bj.baidubce.com
x-bce-request-id: 6d0b0a36-2ffe-49d4-9d81-333a9ab9417e
content-type: application/json
authorization: <bce-authorization-string>响应头域
无特殊响应头域。
响应参数
无。
响应示例
HTTP/1.1 200 OK
x-bce-request-id: 6d0b0a36-2ffe-49d4-9d81-333a9ab9417e
Date: Tue, 24 Mar 2015 13:06:02 GMT
Transfer-Encoding: chunked
Content-Type: application/json;charset=UTF-8
Cache-Control: no-cache删除指定媒资
通过媒资的唯一标识 mediaId 删除指定媒资，对状态为RUNNING的媒资无效。删除后，媒资不可见。删除操作不可逆。
请求语法
DELETE /v<version>/media/<mediaId> HTTP/1.1
accept-encoding: gzip, deflate
x-bce-date: <utc-date-string>
connection: keep-alive
accept: */*
host: vod.bj.baidubce.com
x-bce-request-id: <bce-request-id>
content-type: application/json
authorization: <bce-authorization-string>请求头域
无特殊请求头域。
请求参数
| 参数 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| mediaId | String | 媒资的唯一标识，开发者可通过 mediaId 查询指定媒资的详细信息 | 是 |
请求示例
DELETE /v1/media/mda-fhepatsnpn4rk9zk HTTP/1.1
accept-encoding: gzip, deflate
x-bce-date: 2015-03-24T13:06:02Z
connection: keep-alive
accept: */*
host: vod.bj.baidubce.com
x-bce-request-id: 6d0b0a36-2ffe-49d4-9d81-333a9ab9417e
content-type: application/json
authorization: <bce-authorization-string>响应头域
无特殊响应头域。
响应参数
无。
响应示例
HTTP/1.1 200 OK
x-bce-request-id: 6d0b0a36-2ffe-49d4-9d81-333a9ab9417e
Date: Tue, 24 Mar 2015 13:06:02 GMT
Transfer-Encoding: chunked
Content-Type: application/json;charset=UTF-8
Cache-Control: no-cache