# 使用前必读 视频点播服务（Video on Demand）是集视频上传、自动化转码处理、媒体资源管理、分发加速、视频播放于一体的一站式解决方案。借助华为云提供灵活弹性解决方案，您无需关注服务依赖的底层基础设施，只需要依托高质量的媒体处理服务来快速搭建安全、弹性的点播平台。 您可以使用本文档提供API对视频点播进行相关操作，如音视频上传、转码、分类、管理等。支持的全部操作请参见[API概览](https://support.huaweicloud.com/api-vod/vod_04_0001_0.html)。 在调用视频点播API之前，请确保已经充分了解视频点播相关概念，详细信息请参见[产品介绍](https://support.huaweicloud.com/productdesc-vod/vod030001.html)。 #### 终端节点 视频点播提供了REST（Representational State Transfer）风格API，支持您通过HTTPS请求调用，调用方法请参见[如何调用API](https://support.huaweicloud.com/api-vod/vod_04_0107.html)。 终端节点即调用API的**请求地址** ，不同区域的终端节点不同，您可以从[地区和终端节点](https://console.huaweicloud.com/apiexplorer/#/endpoint/VOD)中查询服务的终端节点。 同时视频点播还提供多种编程语言的SDK供您使用，SDK的使用方法请参见[VOD SDK](https://support.huaweicloud.com/ssdk-vod/vod_05_0001.html)。 #### 支持跨域请求的接口说明 目前视频点播服务仅以下接口支持浏览器跨域请求，如[表1]所示。 表1支持跨域请求接口列表 | 接口名称 | URI | |:---|:---| | [创建媒资：上传方式](https://support.huaweicloud.com/api-vod/vod_04_0196.html) | /v1.0/{project_id}/asset | | [确认媒资上传](https://support.huaweicloud.com/api-vod/vod_04_0198.html) | /v1.0/{project_id}/asset/status/uploaded | | [上传检验](https://support.huaweicloud.com/api-vod/vod_04_0050.html) | /v1.0/{project_id}/asset/duplication | | [查询媒资信息](https://support.huaweicloud.com/api-vod/vod_04_0022.html) | /v1.0/{project_id}/asset/info | | [（即将下线）查询托管媒资详情](https://support.huaweicloud.com/api-vod/ShowTakeOverAssetDetails.html) | /v1.0/{project_id}/asset/obs/host/task/details | | [获取分段上传授权](https://support.huaweicloud.com/api-vod/vod_04_0197.html) | /v1.0/{project_id}/asset/authority | #### API流控 视频点播服务设置了API流控限制，避免出现短时间内重复调用API，服务中断的情况。API流控限制说明如[表2]所示。 表2API流控限制 | 接口分类 | 接口名称 | 单租户接口流控 （单位：次数/分钟） | 接口总体流控 （单位：次数/分钟） | |:---|:---|:---|:---| | 媒资上传 | - 创建媒资：上传方式 - 获取分段上传授权 - 确认媒资上传 - 桶授权 - 创建媒资：OBS转存方式 | 1500 | 12000 | | 媒资上传 | - 创建媒资：OBS托管方式 - 创建媒资：URL拉取注入 - 上传检验 | 100 | 1000 | | 媒资处理 | - 视频更新 - 媒资处理 - 取消媒资转码任务 - 音频提取 - 取消提取音频任务 - 创建审核媒资任务 - 设置封面 | 100 | 1000 | | 媒资管理 | - 删除媒资 - 媒资发布 - 媒资发布取消 - 修改媒资属性 - 查询媒资任务信息 | 100 | 1000 | | 媒资管理 | 查询媒资信息 | 1500 | 24000 | | 媒资管理 | - 查询指定媒资的详细信息 - 查询媒资列表 | 1500 | 12000 | | （即将下线）OBS托管管理 | - 查询托管任务 - 查询托管任务详情 | 100 | 1000 | | （即将下线）OBS托管管理 | 查询托管媒资详情 | 1500 | 12000 | | 媒资预热 | CDN预热 | 10 | 250 | | 媒资预热 | 查询CDN预热 | 100 | 1000 | | 媒资刷新 | - CDN刷新 - 查询CDN刷新 | 100 | 1000 | | 媒资分类 | - 创建媒资分类 - 修改媒资分类 - 删除媒资分类 - 查询指定分类信息 | 100 | 1000 | | 密钥查询 | 查询密钥 | 1500 | 12000 | | 统计分析 | - 查询CDN统计信息 - 查询源站统计信息 - 查询TopN媒资信息 - 查询域名播放日志 - 查询媒资日播放统计数据 | 100 | 1000 | | 水印模板管理 | - 创建水印模板 - 修改水印模板 - 查询水印列表 - 删除水印模板 - 确认水印图片上传 | 100 | 1000 | | 转码模板管理 | - 创建自定义转码模板 - 查询转码模板列表 - 修改转码模板 - 删除自定义模板 | 100 | 1000 | | 转码模板集合管理 | - 创建转码模板组集合 - 修改转码模板组集合 - 查询自定义模板组集合 - 删除转码模板组集合 | 100 | 1000 | | 转码产物管理 | 删除转码产物 | 100 | 1000 | | 媒资存储模式管理 | - 修改媒资降冷粒度 - 修改媒资文件在OBS的存储模式 - 查询媒资降冷配置 - 查询取回数据信息 | 100 | 1000 | | HTTPS配置 | - 配置HTTPS - 查询HTTPS配置 | 100 | 1000 | | 媒资编辑管理 | - 创建编辑任务 - 查询编辑任务 - 取消编辑任务 | 100 | 1000 | | 截图管理 | - 查询截图任务结果列表 - 查询截图详情 | 1500 | 12000 | | 截图管理 | 删除媒资下的多个截图 | 100 | 1000 | #### 基本概念 - 账号 用户注册时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账号是付费主体，为了确保账号安全，建议您不要直接使用账号进行日常管理工作，而是创建用户并使用创建的用户进行日常管理工作。 - 用户 由账号在IAM中创建的用户，是云服务的使用人员，具有身份凭证（密码和访问密钥）。 在[我的凭证](https://console.huaweicloud.com/iam/#/myCredential)下，您可以查看账号ID和用户ID。通常在调用API的鉴权过程中，您需要用到账号、用户和密码等信息。 - 区域 指云资源所在的物理位置，同一区域内可用区间内网互通，不同区域间内网不互通。通过在不同地区创建云资源，可以将应用程序设计的更接近特定客户的要求，或满足不同地区的法律或其他要求。 - 可用区 一个可用区是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。 - 项目 区域默认对应一个项目，这个项目由系统预置，用来隔离物理区域间的资源（计算资源、存储资源和网络资源），以默认项目为单位进行授权，用户可以访问您账号中该区域的所有资源。如果您希望进行更加精细的权限控制，可以在区域默认的项目中创建子项目，并在子项目中购买资源，然后以子项目为单位进行授权，使得用户仅能访问特定子项目中资源，使得资源的权限控制更加精确。 图1项目隔离模型 ![](https://support.huaweicloud.com/api-vod/zh-cn_image_0000002295445884.png)