概述
为了使开发者能够在云点播中实现资源隔离,云点播提供了应用特性。应用是云点播的一个内部概念,是一种资源划分的方式,一个应用的外在表现类似于一个独立的云点播账号。在创建应用后,点播资源的归属形式如下图所示:
说明:
本文所说的资源包括云点播中的媒体文件及其属性、由媒体文件衍生的其它文件、各类配置、CDN 域名、使用点播服务产生的统计信息等。
应用场景
云点播应用的典型应用场景如下:
多部门/多业务隔离:某企业基于腾讯云开发自有产品,其中 A 部门需要使用云点播来开发一款短视频 App,B 部门则使用云点播来开发一个影视网站。这两个点播业务需要相互隔离,但出于财务管理的考虑,该企业无法为 A 和 B 部门分别开通一个独立的腾讯云账号。这时就可以使用云点播的应用特性,为 A 和 B 部门各分配一个应用。
权限控制:在上面的多部门/多业务隔离场景中,开发者可能会有更进一步的权限控制要求,例如要求每个部门仅能访问和自己业务关联的应用,而无权限访问其它应用。这时,账号管理者可以分别为 A 和 B 部门各分配一个子用户,并授予相应的云点播应用访问权限。操作详情请参见 访问管理。
区分正式环境和测试环境:开发者想对某些点播特性进行测试,又担心会影响线上运营(例如修改 事件通知 方式,或者开启 防盗链 等)。开发者可以为正式环境和测试环境各开通一个应用,新特性先在测试环境进行验证,确认无误后再变更线上环境。
身份定义和标识
应用体系中有两类身份:管理员和应用,我们结合下图来说明它们的定义。
1. 开发者开通云点播服务后,直接生成1个默认应用,此时所有的点播资源都归属于默认应用。默认应用的标识符为开发者的腾讯云 APPID,可在控制台的 账号信息中查看。
2. 开发者开通云点播应用功能后,会另外生成一个管理员身份。管理员并不拥有任何点播资源,所有资源仍然属于默认应用。
3. 开发者使用管理员身份创建一个应用,新建的应用拥有独立的点播资源,它和默认应用的地位平等且相互隔离,可以将默认应用理解为一个特殊应用。创建应用时,云点播会为应用分配一个全平台唯一的标识符,称为应用 ID,查看方式请参见 控制台使用说明 - 应用管理。
4. 开发者使用管理员身份再次创建一个应用,这个新建的应用也拥有独立的点播资源,它与默认应用、其它应用的地位平等且相互隔离,依此类推。
说明:
如无特殊说明,下文不再区分默认应用和应用,统一用应用来表述。
能力
云点播应用体系提供以下能力:
创建及设置应用:开发者开通云点播应用功能后,能够以管理员身份在控制台上创建应用,并为每个应用设置名称和描述。
停用应用:除默认应用外,其它应用可以停用。停用操作不会清理应用下的点播资源,只会禁用其域名,其余功能(上传、转码等)不受影响。
资源隔离:应用之间的点播资源相互隔离。
通过控制台或者服务端 API 操作任一个应用的点播资源。
为每一个应用生成单独的数据统计信息,包括存储、带宽/流量、转码时长、视频智能识别时长、播放数据等。
为所有应用生成汇总的数据统计信息。
限制
云点播应用体系具有以下限制:
不支持修改默认应用的名称和描述。
不支持删除默认应用。
每个云点播账号用户最多可以创建50个应用,如超过50个应用请工单 联系我们 进行配置。
不支持为应用设置单独的计费逻辑(如设置计费方式、单独生成账单、购买专用资源包等)。一个云点播账号下的所有应用都归属于同一个云点播账号,所有应用的点播用量(包括但不限于存储、流量、转码时长、视频智能识别时长等云点播计费项)都会进行合并计算,统一收费。
控制台使用说明
开通应用
1. 登录 云点播控制台。
2. 单击左侧导航栏的开通应用,进入开通页面。
3. 单击该页面的立即使用,即可开通云点播应用功能。
说明:
如果已开通应用功能,则左侧导航栏的开通应用将不可见。
选择身份
管理员
在管理员身份下,左侧导航栏包括服务概览、应用管理、用量统计、资源包管理 和 License 管理。
服务概览:该页面展示开发者的云点播计费方式、所有应用汇总后的关键业务数据以及各应用的关键业务数据。
应用管理:该页面可以查看、创建、编辑和停用应用。各个应用的标识符(应用 ID)也在此页面展示。
用量统计:该页面可以查看账号下使用各个产品功能所消耗的用量。
资源包管理:该页面可以查看各类型资源包的使用情况。
License 管理:该页面可以查看已绑定视立方视频 License 和 短视频小程序插件 License 的使用情况。
其他应用
在创建其他应用身份下,云点播控制台的使用方法和未开通应用功能时几乎完全一致,用户可以查看和操作归属于该应用的点播资源。两者的主要区别在于应用没有自己的计费配置。
服务端 API 使用说明
在服务端 API 中指定应用
在服务端 API 2017 中指定应用
服务端 API 2017 也支持应用,使用时需要在请求中增加一个
SubAppId
参数(注意大小写),该参数与服务端 API 2017 的 公共请求参数 平级,其值为应用 ID。如果要访问的是主应用,既可以填写主应用的标识符,也可以不填。说明:
服务端 API 2017 的文档并未暴露
SubAppId
参数,但不影响使用该参数。SubAppId
参数也要参与服务端 API 的签名计算,计算规则不变。文件上传说明
在开通云点播应用功能后,开发者在上传媒体文件到云点播时需要指定上传到哪个应用下。
直播录制
服务端上传
SDK 方式
服务端 API 方式
客户端上传
说明:
vodSubAppId
参数也要参与客户端上传签名计算,计算规则不变。URL 拉取上传
URL 拉取视频上传支持上传到指定的应用。
控制台方式:具体用法请参见 控制台使用说明。
服务端 API 方式:使用 PullUpload 接口,具体用法请参见 在服务端 API 中指定应用。
权限管理
FAQ
开通其他应用后,是否影响线上原有的业务逻辑?
不影响。应用体系在设计时考虑了兼容性,所有的服务端 API 接口在不指定应用 ID 时,默认为操作默认应用。
开通应用功能是否收费?
我们使用应用功能来实现业务隔离,那么各业务该如何进行内部结算/成本分摊?
开发者被停服会对应用有什么影响?
我可以把归属于某个应用的视频迁移到另一个应用吗?
应用之间的资源是隔离的,无法迁移。