所有文档

          音视频点播 VOD

          音视频媒资接口

          创建媒资

          VOD不提供直接创建媒资的API接口,而是用申请媒资、BOS上传、处理媒资三步创建法完成创建:1) 通过申请媒资获取mediaId、BOS Bucket和BOS Key;2) 使用BOS上传视频文件;3) 通过处理媒资方法通知VOD服务文件上传完毕,VOD开始生成并处理媒资。

          申请媒资

          申请媒资接口用于生成媒资的唯一标识mediaId、用于存储源视频文件的sourceBucket以及源媒资文件在BOS存储中的key。sourceBucket对用户开放写权限,对于用户的BOS空间不可见。

          注意:成功申请媒资后,请参考媒资三步创建法于一周内完成BOS上传及媒资处理,否则相应的mediaId将逾期失效。

          请求语法

          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
          上一篇
          公共头域
          下一篇
          播放器服务接口