华为云用户手册

配置介绍 表1 选择输入-配置说明 参数 配置说明 任务所在region 选择任务所在区域。 凭证 选择凭证，默认显示当前命名空间多活分区下已配置的默认凭证。 项目 选择项目，默认显示当前命名空间多活分区下已配置的默认项目。 实例 选择RDS实例名称。 表2 手动输入-配置说明 参数 配置说明 任务所在region 配置任务所在区域。 项目ID 配置项目ID。 凭证ID （可选）配置委托凭证ID。 说明： 不填写凭证ID：默认使用当前凭证。 使用委托时：凭证ID/委托项目ID需要同时填写。 委托项目ID （可选）配置委托项目ID。 实例ID 配置RDS实例ID。

跨账号执行RDS任务 当前账号通过“RDS实例重启”插件执行其他账号下的RDS任务时，需要提前创建委托和创建凭证，其步骤如下： 委托方账号创建委托并授权，授予被委托账号所需 IAM 和RDS的权限。 IAM所需最小权限策略如下： { "Version": "1.1", "Statement": [{ "Action": [ "iam:projects:listProjects" ], "Effect": "Allow" }] } RDS所需最小权限策略如下： { "Version": "1.1", "Statement": [ { "Effect": "Allow", "Action": [ "rds:instance:list", "rds:instance:restart", "rds:task:list" ] } ] } 被委托账号创建凭证，“委托账号”和“委托名”根据1配置。

配置介绍 表1 选择输入-配置说明 参数 配置说明 任务所在region 选择任务所在区域。 凭证 选择凭证，默认显示当前命名空间多活分区下已配置的默认凭证。 项目 选择项目，默认显示当前命名空间多活分区下已配置的默认项目。 实例 选择RDS实例名称。 结果处理 选择重启失败后继续执行的操作。 失败停止 失败继续 表2 手动输入-配置说明 参数 配置说明 任务所在region 配置任务所在区域。 项目ID 配置项目ID。 凭证ID （可选）配置委托凭证ID。 说明： 不填写凭证ID：默认使用当前凭证。 使用委托时：凭证ID/委托项目ID需要同时填写。 委托项目ID （可选）配置委托项目ID。 实例ID 配置RDS实例ID。 结果处理 配置重启失败后继续执行的操作。 fail_to_stop：表示失败停止。 fail_to_continue：表示失败继续。

跨账号执行 AOM 作业 当前账号执行其他账号下的AOM作业时，需要提前创建委托和创建凭证，其步骤如下： 委托方账号创建委托并授权，授予被委托账号所需IAM、AOM和E CS 的权限。 IAM所需最小权限策略如下： { "Version": "1.1", "Statement": [{ "Action": [ "iam:projects:listProjects" ], "Effect": "Allow" }] } AOM所需最小权限为“CMS FullAccess”策略，该策略为自动化运维管理员权限，拥有该权限的用户可以操作并使用自动化运维，具体详情请参考AOM权限管理。 ECS所需最小权限为“ECS CommonOperations”策略，该策略为弹性云服务器普通用户权限，拥有该权限的用户可以执行开机、关机、重启、查询弹性云服务器的操作，具体详情请参考ECS权限管理。 被委托账号创建凭证，“委托账号”和“委托名”根据1配置。

配置介绍 表1 配置说明 参数 配置说明 任务所在region 选择任务所在区域。 凭证 选择凭证，默认显示当前命名空间多活分区下已配置的默认凭证。 项目 选择项目，默认显示当前命名空间多活分区下已配置的默认项目。 作业 选择作业。 说明： 暂不支持选择全局参数含有主机列表类型参数的作业。 执行方案 选择执行方案。如果方案未上线不能使用，需要去AOM控制台将方案上线。 全局参数 输入AOM自动化运维配置的全局参数，详情请参考参数库。 分批发布 选择是否开启分批发布开关，默认不打开。 每批发布 开启分批发布后需填写每批发布数量。设置任务可以同时在多少实例上进行，限制0-100，0代表分批执行的数目无限制。 发布间隔 开启分批发布后需填写任务每批次执行的时间间隔，限制1-60，单位：秒。

配置介绍 表1 选择输入-配置说明 参数 配置说明 任务所在region 选择任务所在区域。 凭证 选择凭证，默认显示当前命名空间多活分区下已配置的默认凭证。 项目 选择项目，默认显示当前命名空间多活分区下已配置的默认项目。 任务 选择DRS灾备任务名称。 灾备切换 配置灾备切换。 升主：升为主数据库。 降备：降为备数据库。 任务名称 请自定义输入任务名称。 表2 手动输入-配置说明 参数 配置说明 任务所在region 配置任务所在区域。 项目ID 配置项目ID。 凭证ID （可选）配置委托凭证ID。 说明： 不填写凭证ID：默认使用当前凭证。 使用委托时：凭证ID/委托项目ID需要同时填写。 委托项目ID （可选）配置委托项目ID。 任务ID 配置DRS灾备任务ID。 灾备切换 配置灾备切换。 up：升为主数据库。 down：降为备数据库。 任务名称 请自定义输入任务名称。

配置介绍 表1 配置说明 参数 配置说明 任务所在region 选择任务所在区域。 内网 域名 选择内网域名。 记录集类型 选择记录集类型。 A – 将域名指向IPv4地址 CNAME – 将域名指向另外一个域名 MX – 将域名指向邮件服务器地址 TXT – 设置文本记录 SRV – 记录提供特定服务的服务器 记录集的值 填写记录集的值。 主机记录 填写主机记录。 主机记录指域名前缀，如不填写，默认添加时使用内网域名。当“记录集类型”选择“CNAME”时，主机记录为必填项。 TTL（单位：秒） 填写TTL值。 TTL(Time-To-Live)指解析记录在本地DNS服务器中的缓存时间。如果您的服务地址经常更换，建议TTL值设置相对小些，反之，建议设置相对大些。 TTL应为300~2147483647之间的整数，如不填写，则默认300秒。 任务名称 请自定义输入任务名称。

配置介绍 表1 选择输入-配置说明 参数 配置说明 任务所在region 选择任务所在区域。 凭证 选择凭证，默认显示当前命名空间多活分区下已配置的默认凭证。 项目 选择项目，默认显示当前命名空间多活分区下已配置的默认项目。 实例 选择RDS实例名称。 权限设置 RDS权限设置。 只读：设置为只读权限。 读写：设置为读写权限。 结果处理 选择权限设置失败后继续执行的操作。 失败停止 失败继续 表2 手动输入-配置说明 参数 配置说明 任务所在region 配置任务所在区域。 项目ID 配置项目ID。 凭证ID （可选）配置委托凭证ID。 说明： 不填写凭证ID：默认使用当前凭证。 使用委托时：凭证ID/委托项目ID需要同时填写。 委托项目ID （可选）配置委托项目ID。 实例ID 配置RDS实例ID。 权限设置 RDS权限设置。 true：设置为只读权限。 false：设置为读写权限。 结果处理 配置权限设置失败后继续执行的操作。 fail_to_stop：表示失败停止。 fail_to_continue：表示失败继续。

跨账号执行RDS任务 当前账号通过“RDS实例读写设置”插件执行其他账号下的RDS任务时，需要提前创建委托和创建凭证，其步骤如下： 委托方账号创建委托并授权，授予被委托账号所需IAM和RDS的权限。 IAM所需最小权限策略如下： { "Version": "1.1", "Statement": [{ "Action": [ "iam:projects:listProjects" ], "Effect": "Allow" }] } RDS所需最小权限策略如下： { "Version": "1.1", "Statement": [ { "Effect": "Allow", "Action": [ "rds:instance:list", "rds:instance:openReadonly", "rds:task:list" ] } ] } 被委托账号创建凭证，“委托账号”和“委托名”根据1配置。

配置介绍 表1 选择输入-配置说明 参数 配置说明 任务所在region 选择任务所在区域。 凭证 选择凭证，默认显示当前命名空间多活分区下已配置的默认凭证。 项目 选择项目，默认显示当前命名空间多活分区下已配置的默认项目。 任务 选择DRS灾备任务名称。 检查RPO 配置是否检查RPO。 开启 关闭 RPO阈值(单位:秒) 配置RPO阈值。 检查RTO 配置是否检查RTO。 开启 关闭 说明： 检查RPO和检查RTO必须要有一个开启。 RTO阈值(单位:秒) 配置RTO阈值。 检查时间间隔(单位:秒) 配置检查时间间隔。 检查次数 配置检查次数。 任务名称 请自定义输入任务名称。 表2 手动输入-配置说明 参数 配置说明 任务所在region 配置任务所在区域。 项目ID 配置项目ID。 凭证ID （可选）配置委托凭证ID。 说明： 不填写凭证ID：默认使用当前凭证。 使用委托时：凭证ID/委托项目ID需要同时填写。 委托项目ID （可选）配置委托项目ID。 任务ID 配置DRS灾备任务ID。 检查RPO 配置是否检查RPO。 开启 关闭 RPO阈值(单位:秒) 配置RPO阈值。 检查RTO 配置是否检查RTO。 开启 关闭 说明： 检查RPO和检查RTO必须要有一个开启。 RTO阈值(单位:秒) 配置RTO阈值。 检查时间间隔(单位:秒) 配置检查时间间隔。 检查次数 配置检查次数。 任务名称 请自定义输入任务名称。

数据中心级自动切换配置 登录MAS控制台，在“多活管理”页面单击实例，进入实例控制台。 在页面顶端导航栏选择“全局配置”。 进入“数据中心级自动切换”页面，单击“是否自动切换”开关。 “是否自动切换”配置为“关”，当MAS发生脑裂或主机房故障时，如果应用数据源正常，此时这个MAS实例下的所有监控器不会切换数据中心。通过此配置，可避免因MAS故障而导致数据中心发生不必要的切换。 “是否自动切换”配置为“开”，当MAS发生脑裂或主机房故障，或者数据源故障时，此时这个MAS实例下的监控器会根据故障切换对应的数据中心。 脑裂是指高可用集群因网络等原因导致的集群分裂出现超过一个主“大脑”的情况，当集群发生脑裂时集群之间的数据可能会出现不一致的问题，从而影响监控结果的仲裁。 当MAS发生脑裂或主机房故障，此时这个MAS实例下的所有监控器都会切换数据中心；当数据源故障时，此时这个MAS实例下的对应监控器会切换数据中心。 当创建监控器时的基础配置参数“是否自动切换”默认配置为“是”时，监控器会自动切换数据中心。 单击“确定”，完成变更自动切换配置。

操作步骤 登录MAS控制台，在“多活管理”页面，单击右上角的“创建边缘版站点”。 在“创建站点”弹窗输入边缘版站点名称，单击“确定”。 在“初始化站点”页面单击站点规格模板，单击“确定”。 在“IEF配置”页面，进行IEF配置。 等待边缘节点创建成功。 单击“下载边缘节点配置文件”，下载包含以上边缘节点密钥等信息的配置文件。 将边缘节点连接上云。完成所有边缘节点的纳管，即可部署MAS实例。 不同可用区的华为云边缘节点要求纳管节点的时候纳管到华为云上不同的可用区。 单击“下载核心软件安装工具”，下载安装程序：a. edge-installer_1.0.14_x86_64.tar.gz 是指边缘核心软件安装程； b. nodeName.tar.gz 是指创建边缘节点时系统返回的配置文件。 解压installer。 sudo tar -zxvf edge-installer_1.0.14_x86_64.tar.gz -C /opt 解压证书到/opt/IEF/Cert。 sudo mkdir -p /opt/IEF/Cert; sudo tar -zxvf nodeName.tar.gz -C /opt/IEF/Cert 执行安装命令。 cd /opt/edge-installer; sudo ./installer -op=install

MAS自定义策略样例 示例1：授权用户创建、修改和查看实例的权限。 { "Version": "1.1", "Statement": [ { "Effect": "Allow", "Action": [ "mas:instance:create", "mas:instance:modify", "mas:instance:list", "mas:instance:get" ] } ] }

添加通知配置 登录MAS控制台，在“多活管理”页面单击实例（实例所属命名空间类型为同城多活），进入实例控制台。 在页面顶端导航栏选择“全局配置”。 单击“机房监控通知配置”页面左上角的“添加通知配置”。 在弹窗中配置信息，完成后单击“确定”。 图1 新增消息服务主题 表1 通知配置 参数 配置说明 通知主题 选择通知主题，若通知主题列表为空，单击新增，添加主题后进行下一步操作。 是否通知 设置是否通知。 消息通知 服务主题创建操作请参考消息通知服务快速入门。

添加密钥 登录MAS控制台，在“多活管理”页面单击实例（实例所属命名空间类型为同城多活），进入实例控制台。 在页面顶端导航栏选择“全局配置”。 单击“密钥配置”页面左上角的“添加密钥”。 在弹窗中配置信息，单击“确定”。 图1 密钥配置 表1 密钥配置 参数 配置说明 云选择 选择消息服务所在的环境。 AK Access Key ID（访问密钥ID）。 SK Secret Access Key（秘密访问密钥）。 华为云访问密钥获取方法请参考访问密钥。

操作步骤 登录MAS控制台，在“多活管理”页面，单击边缘版站点的“购买边缘版实例”。 在购买多活管理中心页面，填写实例配置信息，系统会根据您选择的“商品类型”自动计算费用，然后单击“立即创建”。 图1 购买边缘版实例 表1 实例配置参数 参数 配置说明 命名空间 选择命名空间。 分区设置 选择多活分区的可用区，可用区由命名空间配置决定。 商品类型 边缘版。 计费模式 选择计费模式。 按需计费：按需计费是后付费模式，按多活实例的实际使用时长计费，可以随时开通/删除多活实例。 包年包月：包年包月是预付费模式，按订单的购买周期计费，价格比按需计费模式更优惠。 主机房 机房信息，选择华为云或第三方数据中心为主机房。 开启双向认证 ETCD双向认证，默认开启。 注意： 关闭双向认证有风险，请谨慎操作。 多活管理中心名称 填写多活管理中心名称，根据规划自定义。 描述 填写多活管理中心的描述信息。 网络 选择实例所关联的VPC和子网，VPC和子网须提前创建。 etcd密码 创建etcd密码。 确认密码 再次确认etcd密码，两次密码输入保持一致。 购买时长 “计费模式”选择“包年包月”时可见，选择购买多活管理中心的时长。 自动续费 “计费模式”选择“包年包月”时可见，勾选后开通自动续费。 如需续费，请在管理控制台续费管理页面进行续费操作。续费相关操作请参考续费管理。 若“计费模式”选择“按需计费”，当单击“立即创建”之后，会直接开始创建实例； 若“计费模式”选择“包年包月”，需要先支付订单费用，才会开始创建实例。 实例创建时间需要5-15分钟，请耐心等待。实例创建成功后，在控制台的“多活管理”页面可看到该实例的状态为“运行中”。 如果创建实例失败，可删除创建失败的实例，然后重新创建实例。如果重新创建仍然失败，请联系技术支持。

前提条件 已参考准备资源章节准备虚拟机资源。 有可用的VPC，并且已配置好子网与安全组，否则请参考准备资源完成VPC、子网和安全组，以及边缘节点的创建注册自建边缘节点。 已创建云连接实例，云连接域间带宽建议至少20Mbit/s，配置方法请参考配置域间带宽。 创建实例时会使用智能边缘平台IEF的容器应用，需要单独付费。计费模式如下： 套餐包计费模式：已购买套餐包。购买后，会根据实际使用情况从套餐包中直接扣费。 按需计费模式：未购买套餐包，根据实际使用情况进行扣费。 具体计费详情请参考智能边缘平台IEF。 如果用户准备的虚拟机无法通过公网访问IEF时，可以选择通过私网访问。私网访问需要满足以下条件： 已通过专线或VPN连接IEF，连接步骤参考通过专线或VPN连接IEF。 有创建多活实例的配额，否则可以删除无用实例，以空出实例配额，或者申请扩大配额。 已创建好边缘版站点并完成初始化IEF配置。

操作步骤 进入购买MAS实例页面。 在购买多活管理中心页面，填写实例配置信息，系统会根据您选择的“商品类型”自动计算费用，然后单击“立即创建”。 图1 购买多活管理中心 表1 多活实例配置参数 参数 配置说明 命名空间 选择命名空间。 说明： 多活实例支持如下条件的命名空间： 同城多活：主备多活分区均为当前控制台所选区域。如需创建用于同城多活的多活实例，请选择满足此条件的命名空间。 异地容灾：备多活分区为当前控制台所选区域。如需创建用于执行工作流的多活实例，请选择满足此条件的命名空间。 分区设置 选择多活分区的可用区，可用区由命名空间配置决定。 仲裁节点 命名空间选择“同城多活”类型时可见，选择ETCD仲裁节点所属可用区，可用区选择请与业务部署架构保持一致。 计费模式 选择计费模式。 按需计费：按需计费是后付费模式，按多活实例的实际使用时长计费，可以随时开通/删除多活实例。 包年包月：包年包月是预付费模式，按订单的购买周期计费，价格比按需计费模式更优惠。 商品类型 多活实例类型，目前支持铂金版。 开启双向认证 命名空间选择“同城多活”类型时可见，ETCD双向认证，默认开启。 注意： 关闭双向认证有风险，请谨慎操作。 多活管理中心名称 填写多活管理中心名称，根据规划自定义。 描述 填写多活管理中心的描述信息。 企业项目 请选择企业项目。 网络 选择实例所关联的VPC和子网，VPC和子网须提前创建。 IPv4网段 该VPC网段为实例机器网段，请保证与您的VPC网段及其他对等连接网段不冲突。建议使用网段：10.0.0.0/24；172.16.0.0/24；192.168.0.0/24。 安全组 选择实例所关联的安全组，安全组须提前创建。 注意： 需要在安全组中开放被监控资源的端口。 etcd密码 命名空间选择“同城多活”类型时可见，创建etcd密码。 确认密码 命名空间选择“同城多活”类型时可见，再次确认etcd密码，两次密码输入保持一致。 购买时长 “计费模式”选择“包年包月”时可见，选择购买多活管理中心的时长。 自动续费 “计费模式”选择“包年包月”时可见，勾选后开通自动续费。 如需续费，请在管理控制台续费管理页面进行续费操作。续费相关操作请参考续费管理。 若“计费模式”选择“按需计费”，当单击“立即创建”之后，会直接开始创建实例； 若“计费模式”选择“包年包月”，需要先支付订单费用，才会开始创建实例。 实例创建时间需要5-15分钟，请耐心等待。实例创建成功后，在控制台的“多活管理”页面可看到该实例的状态为“运行中”。 如果创建实例失败，可删除创建失败的实例，然后重新创建实例。如果重新创建仍然失败，请联系技术支持。

准备依赖资源 在创建多活实例前您需要提前准备相关依赖资源，包括VPC、子网和安全组。每个多活实例都部署在某个虚拟私有云（VPC）中，并绑定具体的子网和安全组，通过这样的方式为MAS提供一个隔离的、用户自主配置和管理的虚拟网络环境以及安全保护策略。 创建VPC和子网的操作指导请参考创建虚拟私有云和子网，若需要在已有VPC上创建和使用新的子网，请参考为虚拟私有云创建新的子网。 创建安全组的操作指导请参考创建安全组，为安全组添加规则的操作指导请参考添加安全组规则。

CTS 支持的MAS操作 表1 CTS支持的MAS操作 操作名称 资源类型 事件名称 创建命名空间 namespace createNamespace 编辑命名空间 namespace updateNameSpace 删除命名空间 namespace deleteNameSpace 添加数据源 dataSource createDataSource 编辑数据源 dataSource updateDataSource 删除数据源 dataSource deleteDataSource 创建同步链路 dataSync createDataSyncTask 删除同步链路 dataSync deleteDataSyncTask 创建实例 instance createInstance 部署实例 instance deployInstance 删除实例 instance deleteInstance 升级实例 instance internalUpgradeInstance 创建应用 application createApplication 更新应用 application updateApplication 删除应用 application deleteApplication 批量切换应用监控 application batchSwitchMonitor 创建监控器 monitor createMonitor 更新监控器 monitor updateMonitor 删除监控器 monitor deleteMonitor 设置监控全局配置 monitor setMonitorGlobalConfig 切换监控器 monitor switchMonitor 创建数据库连接池 monitor createDBConnectionPool 更新数据库连接池 monitor updateDBConnectionPool 重置机房监控 dcmonitor resetDcMonitor 添加通知配置 globalConf setNotify 添加密钥 secret setSecret

应用监控器切换 创建完应用并给应用创建监控器后，可对应用下的监控器进行“一键切换”和“一键回切”操作。 登录MAS控制台，在“多活管理”页面单击实例，进入实例控制台。 在页面顶端导航栏选择“应用列表”，单击应用所在行的“监控器切换”。 在“监控状态”弹窗中单击“一键切换”。 在“切换”弹窗中单击“确定”，完成应用监控的一键切换操作。 当检测到对端数据中心状态异常时，如果用户需要强制切换数据中心，需要勾选强制切换复选框，再单击“确定”进行切换。 图2 切换监控器 在“应用列表”页面单击应用所在行的“监控器切换”，在弹窗中单击“一键回切”，完成应用监控的一键回切操作。

MRS 集群版本如何进行升级？ MRS普通版本集群 MRS普通版本集群无法实现低版本到高版本的平滑升级。如需体验新版本集群相关能力，建议重新创建一个新版本的集群，然后将老版本集群的数据迁移到新的集群。 MRS LTS版本集群 MRS LTS版集群支持版本升级能力，可从历史版本升级至目标LTS版本。如果需要使用版本升级能力，需联系运维人员确认支持的升级路径并购买相关专业服务进行升级。 父主题： 升级补丁类

修订记录 表1 修改记录 修改时间 修改说明 2023-12-21 第四十一次正式发布 本次变更如下： 新增2个接口：查询媒资日播放统计数据、修改媒资文件在OBS的存储模式。 2023-07-14 第四十次正式发布 本次变更如下： 查询CDN统计信息接口中“values”字段新增单位说明。 优化查询源站统计信息接口的功能介绍。 2023-05-23 第三十九次正式发布 本次变更如下： 示例1：媒资上传（20M以下）中新增音频文件格式对应的请求头填写规则说明。 优化“示例2：媒资分段上传（20M以上）”章节内容。 获取分段上传授权接口中“content_type”字段新增文件格式说明。 2023-05-06 第三十八次正式发布 本次变更如下： 查询CDN统计信息接口新增查询统计数据存在1小时时间差的描述。 2023-03-30 第三十七次正式发布 本次变更如下： 创建媒资：OBS转存方式接口中“video_type”字段新增RMVB和WEBM视频格式。 2022-11-23 第三十六次正式发布 本次变更如下： 修改创建自定义转码模板接口中可选参数“name”、“quality_info_list”、“common”为必选参数。 更新修改转码模板接口中可选参数“group_id”、“quality_info_list”、“common”为必选参数。 修改创建转码模板组集合接口中可选参数“name”、“template_group_list”为必填参数。 更新修改转码模板组集合接口中可选参数“collection_id”为必填参数。 2022-08-22 第三十五次正式发布 本次变更如下： 移动转码模板组管理接口内容至历史API章节中，此接口后续可能停止维护，建议使用转码模板管理接口。 修改生成MD5值中的上传校验MD5生成示例代码。 修改示例2：媒资分段上传（20M以上）中可选参数“content_md5”为必填参数。 2022-08-05 第三十四次正式发布 本次变更如下： 新增转码模板管理接口。 新增转码模板集合管理接口。 2022-07-07 第三十三次正式发布 本次变更如下： 修改水印模板接口中的“timeline_start”、“timeline_duration”字段描述。 修改查询域名播放日志接口中的“Link”字段描述。 2022-05-19 第三十二次正式发布 本次变更如下： 查询指定媒资的详细信息接口新增“sign_url”参数。 URL拉取注入接口新增接口约束：用户调用该API一次最多支持拉取16条音视频。 2022-04-13 第三十一次正式发布 本次变更如下： 修改创建媒资：URL拉取注入接口的流控限制。 2022-03-16 第三十次正式发布 本次变更如下： 修改创建媒资：上传方式接口中的示例代码。 修改查询域名播放日志接口中“query_date”参数说明。 2022-02-17 第二十九次正式发布 本次变更如下： 删除媒资接口新增“delete_type”参数。 创建媒资：URL拉取注入接口“video_type”参数新增M3U8视频格式。 2022-02-11 第二十八次正式发布 本次变更如下： 新增查询域名播放日志接口。 2021-12-13 第二十七次正式发布 本次变更如下： 查询指定媒资的详细信息接口新增“dots”参数。 2021-11-26 第二十六次正式发布 本次变更如下： 修改查询指定媒资的详细信息接口“sample”字段的描述，视频截图信息，截图类型为间隔。 2021-11-22 第二十五次正式发布 本次变更如下： 修改创建水印模板接口“dx”、“dy”、“weight”、“height”字段的描述。 2021-09-18 第二十四次正式发布 本次变更如下： CDN预热接口新增接口约束，单租户每天最多预热1000个，单次提交不超过1000个。 查询托管任务详情和查询托管媒资详情接口新增“subtitle_info”参数。 2020-08-07 第二十三次正式发布 本次变更如下： 增加API调用示例：示例2：媒资分段上传（20M以上） 2020-07-06 第二十二次正式发布 本次变更如下： 增加两个应用示例，示例3：获取媒资详情和示例4：视频处理。 2020-06-29 第二十一次正式发布 本次变更如下： 优化各接口的字段描述。 2020-06-22 第二十次正式发布 本次变更如下： 根据点播API实际情况，将指定“媒资ID预热”和“指定媒资URL预热”合并为一个接口“媒资预热”，支持输入的参数可以是媒资ID和媒资URL。 2020-06-01 第十九次正式发布 本次变更如下： 下线视频拼接接口，点播服务不再支持视频拼接功能。 下线视频剪辑接口，点播服务不再支持视频剪辑功能。 2020-05-08 第十八次正式发布 本次变更如下： 媒资发布接口中，“status”增加“WAITING_TRANSCODE”取值，表示“待发布（转码排队中）”。 废弃华为云播放器SDK的数据统计功能，暂不支持统计播放器SDK的相关数据，废弃如下接口： 查询总体播放数据接口 查询单媒资播放数据接口 查询Top1000媒资信息接口 2020-05-06 第十七次正式发布 本次变更如下： 获取分段上传授权接口的“sign_url”字段修改为“sign_str”。 2020-05-01 第十六次正式发布 本次变更如下： 增加生成MD5值的示例代码。 创建媒资：上传方式接口中的“video_md5”字段增加约束描述，建议上传媒资的MD5值参生成MD5值生成。 2020-04-28 第十五次正式发布 本次变更如下： 删除媒资接口增加接口约束，正在处理中的媒资不支持删除。 2019-08-13 第十四次正式发布 本次变更如下： 废弃智能封面接口，点播服务不再支持智能封面功能。 2019-07-26 第十三次正式发布 本次变更如下： 新增查询总体播放数据接口。 新增查询单媒资播放数据接口。 新增查询Top1000媒资信息接口。 2019-06-18 第十二次正式发布 本次变更如下： 新增设置封面接口。 2019-06-13 第十一次正式发布 本次变更如下： 调整API参考文档结构。 优化文档描述、参数说明等。 2019-05-27 第十次正式发布 本次变更如下： 修改转码模板组管理接口。 2019-05-24 第九次正式发布 本次变更如下： 新增“使用前必读”章节内容。 优化“如何调用API”章节内容。 2019-05-08 第八次正式发布 本次变更如下： 新增转码模板组管理接口。 2019-04-17 第七次正式发布 本次变更如下： 新增创建媒资：URL拉取注入接口。 2019-03-05 第六次正式发布 本次变更如下： 查询媒资列表接口新增“media_type”参数。 2018-11-30 第五次正式发布 本次变更如下： 创建媒资：上传方式接口新增请求参数“smart_cover”，用于判断是否在创建媒资时开启智能封面。 创建媒资：OBS转存方式接口新增请求参数“smart_cover”，用于判断是否在创建媒资时开启智能封面。 新增智能封面接口。 2018-11-27 第四次正式发布 本次变更如下： 媒资上传接口中“video_type”字段支持的格式增加AVI、M4V、F4V和MPEG四种。 2018-11-09 第三次正式发布 本次变更如下： 新增“视频拼接”、“视频剪切”接口。 修正响应示例中的错误码。 2018-10-26 第二次正式发布 本次变更如下： 媒资发布接口中的“MetaData”结构体增加codec参数，用于判别视频编码格式。 2018-07-01 第一次正式商用发布。

媒资管理 接口 说明 DELETE /v1.0/{project_id}/asset 删除媒资 POST /v1.0/{project_id}/asset/status/publish 媒资发布 POST /v1.0/{project_id}/asset/status/unpublish 媒资发布取消 GET /v1.0/{project_id}/asset/info 查询媒资信息 PUT /v1.0/{project_id}/asset/info 修改媒资属性 GET /v1.0/{project_id}/asset/details 查询指定媒资的详细信息 GET /v1.0/{project_id}/asset/list 查询媒资列表

媒资上传 接口 说明 POST /v1.0/{project_id}/asset 创建媒资：上传方式 GET /v1.1/{project_id}/asset/authority 获取分段上传授权 POST /v1.0/{project_id}/asset/status/uploaded 确认媒资上传 PUT /v1.0/{project_id}/asset/authority 桶授权 POST /v1.0/{project_id}/asset/reproduction 创建媒资：OBS转存方式 POST /v1.0/{project_id}/asset/obs/host/stock/task 创建媒资：OBS托管方式 POST /v1.0/{project_id}/asset/upload_by_url 创建媒资：URL拉取注入 GET /v1.0/{project_id}/asset/duplication 上传检验

水印模板管理 接口 说明 POST /v1.0/{project_id}/template/watermark 创建水印模板 PUT /v1.0/{project_id}/template/watermark 修改水印模板 GET /v1.0/{project_id}/template/watermark 查询水印列表 DELETE /v1.0/{project_id}/template/watermark 删除水印模板 POST /v1.0/{project_id}/watermark/status/uploaded 确认水印图片上传

统计分析 接口 说明 GET /v1.0/{project_id}/asset/cdn-statistics 查询CDN统计信息 GET /v1.0/{project_id}/asset/vod-statistics 查询源站统计信息 GET /v1.0/{project_id}/asset/top-statistics 查询TopN视频信息 GET /v1.0/{project_id}/vod/cdn/logs 查询域名播放日志 GET /v1/{project_id}/asset/daily-summary 查询媒资日播放统计数据

转码模板集合管理 接口 说明 POST /v1.0/{project_id}/asset/template-collection/transcodings 创建转码模板组集合 PUT /v1.0/{project_id}/asset/template-collection/transcodings 修改转码模板组集合 GET /v1.0/{project_id}/asset/template-collection/transcodings 查询自定义模板组集合 DELETE /v1.0/{project_id}/asset/template-collection/transcodings 删除转码模板组集合

媒资处理 接口 说明 PUT /v1.0/{project_id}/asset 视频更新 POST /v1.0/{project_id}/asset/process 媒资处理 DELETE /v1.0/{project_id}/asset/process 取消媒资转码任务 POST /v1.0/{project_id}/asset/extract_audio 音频提取 DELETE /v1.0/{project_id}/asset/extract_audio 取消提取音频任务 POST /v1.0/{project_id}/asset/review 创建审核媒资任务 PUT /v1.0/{project_id}/asset/cover 设置封面

转码模板管理 接口 说明 POST /v2/{project_id}/asset/template/transcodings 创建自定义转码模板 GET /v2/{project_id}/asset/template/transcodings 查询转码模板列表 PUT /v2/{project_id}/asset/template/transcodings 修改转码模板 DELETE /v2/{project_id}/asset/template/transcodings 删除自定义模板