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