更新时间:2024-12-12 GMT+08:00

使用前必读

视频点播服务(Video on Demand)是集视频上传、自动化转码处理、媒体资源管理、分发加速、视频播放于一体的一站式解决方案。借助华为云提供灵活弹性解决方案,您无需关注服务依赖的底层基础设施,只需要依托高质量的媒体处理服务来快速搭建安全、弹性的点播平台。

您可以使用本文档提供API对视频点播进行相关操作,如音视频上传、转码、分类、管理等。支持的全部操作请参见API概览

在调用视频点播API之前,请确保已经充分了解视频点播相关概念,详细信息请参见产品介绍

终端节点

视频点播提供了REST(Representational State Transfer)风格API,支持您通过HTTPS请求调用,调用方法请参见如何调用API

终端节点即调用API的请求地址,不同区域的终端节点不同,您可以从地区和终端节点中查询服务的终端节点。

同时视频点播还提供多种编程语言的SDK供您使用,SDK的使用方法请参见VOD SDK

支持跨域请求的接口说明

目前视频点播服务仅以下接口支持浏览器跨域请求,如表1所示。

表1 支持跨域请求接口列表

接口名称

URI

创建媒资:上传方式

/v1.0/{project_id}/asset

确认媒资上传

/v1.0/{project_id}/asset/status/uploaded

上传检验

/v1.0/{project_id}/asset/duplication

查询媒资信息

/v1.0/{project_id}/asset/info

获取分段上传授权

/v1.0/{project_id}/asset/authority

API流控

视频点播服务设置了API流控限制,避免出现短时间内重复调用API,服务中断的情况。API流控限制说明如表2所示。

表2 API流控限制

接口分类

接口名称

单租户接口流控

(单位:次数/分钟)

接口总体流控

(单位:次数/分钟)

媒资上传

  • 创建媒资:上传方式
  • 获取分段上传授权
  • 确认媒资上传
  • 桶授权
  • 创建媒资:OBS转存方式

1500

12000

  • 创建媒资:URL拉取注入
  • 上传检验

100

1000

媒资处理

  • 视频更新
  • 媒资处理
  • 取消媒资转码任务
  • 音频提取
  • 取消提取音频任务
  • 创建审核媒资任务
  • 设置封面

100

1000

媒资管理

  • 删除媒资
  • 媒资发布
  • 媒资发布取消
  • 修改媒资属性

100

1000

查询媒资信息

1500

24000

  • 查询指定媒资的详细信息
  • 查询媒资列表

1500

12000

媒资预热

  • CDN预热
  • 查询CDN预热

100

1000

媒资分类

  • 创建媒资分类
  • 修改媒资分类
  • 删除媒资分类
  • 查询指定分类信息

100

1000

密钥查询

密钥查询

1500

12000

统计分析

  • 查询CDN统计信息
  • 查询源站统计信息
  • 查询TopN媒资信息
  • 查询域名播放日志
  • 查询媒资日播放统计数据

100

1000

水印模板管理

  • 创建水印模板
  • 修改水印模板
  • 查询水印列表
  • 删除水印模板
  • 确认水印图片上传

100

1000

多字幕封装

多字幕封装

100

1000

转码模板管理

  • 创建自定义转码模板
  • 查询转码模板列表
  • 修改转码模板
  • 删除自定义模板

100

1000

转码模板集合管理

  • 创建转码模板组集合
  • 修改转码模板组集合
  • 查询自定义模板组集合
  • 删除转码模板组集合

100

1000

转码产物管理

删除转码产物

100

1000

媒资存储模式管理

  • 修改媒资降冷粒度
  • 修改媒资文件在OBS的存储模式
  • 查询媒资降冷配置

100

1000

基本概念

  • 账号

    用户注册时的账号,账号对其所拥有的资源及云服务具有完全的访问权限,可以重置用户密码、分配用户权限等。由于账号是付费主体,为了确保账号安全,建议您不要直接使用账号进行日常管理工作,而是创建用户并使用创建的用户进行日常管理工作。

  • 用户

    由账号在IAM中创建的用户,是云服务的使用人员,具有身份凭证(密码和访问密钥)。

    在“我的凭证”下,您可以查看账号ID和用户ID。通常在调用API的鉴权过程中,您需要用到账号、用户和密码等信息。

  • 区域

    指云资源所在的物理位置,同一区域内可用区间内网互通,不同区域间内网不互通。通过在不同地区创建云资源,可以将应用程序设计的更接近特定客户的要求,或满足不同地区的法律或其他要求。

  • 可用区

    一个可用区是一个或多个物理数据中心的集合,有独立的风火水电,AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连,以满足用户跨AZ构建高可用性系统的需求。

  • 项目

    区域默认对应一个项目,这个项目由系统预置,用来隔离物理区域间的资源(计算资源、存储资源和网络资源),以默认项目为单位进行授权,用户可以访问您账号中该区域的所有资源。如果您希望进行更加精细的权限控制,可以在区域默认的项目中创建子项目,并在子项目中购买资源,然后以子项目为单位进行授权,使得用户仅能访问特定子项目中资源,使得资源的权限控制更加精确。

    图1 项目隔离模型