视频点播 VOD-华为云

视频点播 VOD-创建媒资：URL拉取注入（公测中）:请求示例

请求示例创建媒资，使用URL拉取方式。基于音视频源文件URL，将音视频文件离线拉取上传到点播服务 POST https://{endpoint}/v1.0/{project_id}/asset/upload_by_url Content-Type: application/json { "upload_metadatas": [ { "url": "https://mpc-test.obs.cn-north-4.myhuaweicloud.com/Avatar_480P.mp4", "title": "Avatar test test", "video_type": "MP4", "description": "Avatar, test", "category_id": 1, "tags": "mytags", "auto_publish": 1 }, { "url": "https://mpc-test.obs.cn-north-4.myhuaweicloud.com/Avatar_720.mp4", "title": "Avatar test test", "video_type": "MP4", "description": "Avatar, test", "category_id": 1, "tags": "mytags", "auto_publish": 1 } ] }

视频点播 VOD 媒资上传

视频点播 VOD-创建媒资：URL拉取注入（公测中）:响应参数

响应参数状态码： 200 表7 响应Body参数参数参数类型描述 upload_assets Array of UploadAsset objects 待拉取创建的媒资元数据表8 UploadAsset 参数参数类型描述 url String 待拉取音视频文件的URL。 asset_id String 新创建媒资的媒资id error_code String 错误码。 error_msg String 错误描述。状态码： 400 表9 响应Body参数参数参数类型描述 error_code String 错误码。 error_msg String 错误描述。

视频点播 VOD 媒资上传

视频点播 VOD-创建媒资：URL拉取注入（公测中）:响应示例

响应示例状态码： 200 处理成功返回。 { "upload_assets" : [ { "url" : "https://mpc-test.obs.cn-north-4.myhuaweicloud.com/Avatar_480P.mp4", "asset_id" : "f488337c31c8e4622f1590735b134c65", "error_code" : null, "error_msg" : null }, { "url" : "https://mpc-test.obs.cn-north-4.myhuaweicloud.com/Avatar_720.mp4", "asset_id" : "f488337c31c8e4622f1590525b134c65", "error_code" : null, "error_msg" : null } ] } 状态码： 400 处理失败返回。 { "error_code" : "VOD.10003", "error_msg" : "The specified key does not exist." }

视频点播 VOD 媒资上传

视频点播 VOD-创建媒资：URL拉取注入（公测中）:请求参数

请求参数表2 请求Header参数参数是否必选参数类型描述 X-Auth-Token 否 String 用户Token，使用Token鉴权方式时必选。通过调用 IAM 服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Authorization 否 String 使用AK/SK方式认证时必选，携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选，请求的发生时间。表3 请求Body参数参数是否必选参数类型描述 upload_metadatas 是 Array of UploadMetaDataByUrl objects 待拉取创建的媒资元数据表4 UploadMetaDataByUrl 参数是否必选参数类型描述 video_type 是 String 上传音视频文件的格式。取值如下：视频文件：MP4、TS、MOV、MXF、MPG、FLV、WMV、AVI、M4V、F4V、MPEG、3GP、ASF、MKV、WEBM、M3U8 音频文件：MP3、OGG、WAV、WMA、APE、FLAC、AAC、AC3、MMF、AMR、M4A、M4R、WV、MP2 若上传格式为音频文件，则不支持转码、添加水印和字幕。 title 是 String 媒资标题，长度不超过128个字节，UTF-8编码。 url 是 String 待拉取音视频文件的URL。说明： URL必须以扩展名结尾，暂只支持http和https协议，其中HTTP方式存在安全风险，建议使用HTTPS。不建议您将认证凭据等敏感信息写在URL。 description 否 String 视频描述，长度不超过1024个字节。 category_id 否 Integer 媒资分类ID。您可以调用创建媒资分类接口或在点播控制台的分类设置中创建对应的媒资分类，并获取分类ID。说明：若不设置或者设置为-1，则上传的音视频归类到系统预置的“其它”分类中。 tags 否 String 视频标签。单个标签不超过24个字节，最多不超过16个标签。多个用逗号分隔，UTF8编码。 auto_publish 否 Integer 是否自动发布。取值如下： 0：表示不自动发布。 1：表示自动发布。默认值：1。 template_group_name 否 String 转码模板组名称。若不为空，则使用指定的转码模板对上传的音视频进行转码，您可以在视频点播控制台配置转码模板，具体请参见《点播服务用户指南》中的“转码设置”。说明：若同时设置了“template_group_name”和“workflow_name”字段，则“template_group_name”字段生效。 auto_encrypt 否 Integer 是否自动加密。取值如下： 0：表示不加密。 1：表示需要加密。默认值：0。若设置为需要加密，则必须配置转码模板，且转码的输出格式是HLS。 auto_preheat 否 Integer 是否自动预热到CDN。取值如下： 0：表示不自动预热。 1：表示自动预热。默认值：0。 thumbnail 否 Thumbnail object 截图参数 review 否 Review object 媒资审核参数。说明：仅“华北-北京一”、“华北-北京四”点播服务支持此功能。 workflow_name 否 String 工作流名称。若不为空，则使用指定的工作流对上传的音视频进行处理，您可以在视频点播控制台配置工作流，具体请参见《点播服务用户指南》中的“工作流设置”。表5 Thumbnail 参数是否必选参数类型描述 type 是 String 截图类型。取值如下： time：每次进行截图的间隔时间。 dots: 按照指定的时间点截图。 quantity：按照指定张数，根据视频时长等分视频截图。 quantity 否 Integer type取值为quantity时必填。按照指定张数，根据视频时长等分视频截图。取值范围：[1,10]之间的整数。 quantity_time 否 Integer type取值为quantity时选填。按照指定时间间隔取指定张数截图。取值范围：[0,2147483647]之间的整数。 time 否 Integer 根据时间间隔采样时的时间间隔值。单位：秒。 type取值为time时。默认值：12 取值范围：[0,100]之间的整数。 dots 否 Array of integers type取值为dots时必填。指定时间截图时的时间点数组。 cover_position 否 Integer 该值表示指定第几张截图作为封面。默认值：1。 format 否 Integer 截图文件格式。取值如下： 1：jpg。默认值：1 。 aspect_ratio 否 Integer 纵横比，图像缩放方式。取值如下： 0：自适应（保持原有宽高比）。 1：16:9。默认值：0。 max_length 否 Integer 截图最长边的尺寸。单位：像素。宽边尺寸按照该尺寸与原始视频像素等比缩放计算。默认值：480。表6 Review 参数是否必选参数类型描述 template_id 否 String 审核模板ID。您可以在视频点播控制台配置审核模板后获取，具体请参见《点播服务用户指南》中的“审核设置”。说明：仅“华北-北京一”、“华北-北京四”点播服务支持此功能。 interval 否 Integer 截图检测时间间隔，取值范围为(0,100]，该参数在请求参数中忽略。 politics 否 Integer 鉴政内容检测置信度，取值范围为-1或者[0,100]，该参数在请求参数中忽略。置信度越高，说明审核结果越可信。未开启或设置为0时，表示未进行此项检测。politics、terrorism、porn三个参数不能同时为0。 terrorism 否 Integer 鉴恐内容的检测置信度，取值范围为-1或者[0,100]，该参数在请求参数中忽略。置信度越高，说明审核结果越可信。未开启或设置为0时，表示未进行此项检测。politics、terrorism、porn三个参数不能同时为0。 porn 否 Integer 鉴黄内容的检测置信度，取值范围为-1或者[0,100]，该参数在请求参数中忽略。置信度越高，说明审核结果越可信。未开启或设置为0时，表示未进行此项检测。politics、terrorism、porn三个参数不能同时为0。

视频点播 VOD 媒资上传

视频点播 VOD-查询取回数据信息:响应参数

响应参数状态码： 200 表4 响应Body参数参数参数类型描述 start_time String 统计起始时间 interval Integer 采样时间间隔 sample_data Array of VodRetrievalData objects 表5 VodRetrievalData 参数参数类型描述 retrieval_warm Double 低频存储的媒资恢复为标准存储后的文件大小 retrieval_cold Double 归档存储的媒资按标准取回模式取回的文件大小 retrieval_cold_speed Double 归档存储的媒资按快速取回模式取回的文件大小状态码： 400 表6 响应Body参数参数参数类型描述 error_code String 错误码。 error_msg String 错误描述。

视频点播 VOD 媒资存储模式管理

视频点播 VOD-查询取回数据信息:响应示例

响应示例状态码： 200 处理成功返回。 { "start_time" : "20240615000000", "interval" : 3600, "sample_data" : [ { "retrieval_warm" : 1.88, "retrieval_cold" : 2.4, "retrieval_cold_speed" : 1.9 }, { "retrieval_warm" : 3.6, "retrieval_cold" : 4.6, "retrieval_cold_speed" : 3.56 }, { "retrieval_warm" : 2.5, "retrieval_cold" : 0, "retrieval_cold_speed" : 0.08 }, { "retrieval_warm" : 0, "retrieval_cold" : 0, "retrieval_cold_speed" : 0 } ] } 状态码： 400 处理失败返回。 { "error_code" : "VOD.10053", "error_msg" : "The request parameter is illegal, illegal field: {xx}." }

视频点播 VOD 媒资存储模式管理

视频点播 VOD-查询取回数据信息:请求参数

请求参数表3 请求Header参数参数是否必选参数类型描述 X-Auth-Token 否 String 用户Token，使用Token鉴权方式时必选。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Authorization 否 String 使用AK/SK方式认证时必选，携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选，请求的发生时间。

视频点播 VOD 媒资存储模式管理

视频点播 VOD-查询取回数据信息:URI

URI GET /v1/{project_id}/asset/vod-retrieval 表1 路径参数参数是否必选参数类型描述 project_id 是 String 项目ID，获取方法请参考获取项目ID 表2 Query参数参数是否必选参数类型描述 start_time 否 String 开始时间 end_time 否 String 结束时间 interval 否 Integer 采样间隔，单位：秒，取值说明：时间跨度1天：1小时、4小时、8小时，分别对应3600秒、14400秒和28800秒。时间跨度2~7天：1小时、4小时、8小时、1天，分别对应3600秒、14400秒、28800秒和86400秒。时间跨度8~31天：4小时、8小时、1天，分别对应14400秒、28800秒和86400秒。如果不传，默认取对应时间跨度的最小间隔。

视频点播 VOD 媒资存储模式管理

视频点播 VOD-配置域名:管理域名

管理域名自有域名添加后，您可以在域名管理页面查看已添加域名的基本信息，您也可以根据实际需求停用、启用或删除已添加的域名。若开通了企业项目管理服务，则还可以查看到域名分类所在的企业项目名称。登录视频点播控制台。在左侧导航栏中，选择“域名管理”，进入域名管理界面。您可以根据实际需求选择以下操作。查看域名信息在域名列表中，可查看已添加域名的CNAME值、状态等信息。图2 域名信息单击右侧操作列的“配置”，可查看目标域名的基本配置信息，还可以为该域名配置HTTPS安全加速和防盗链。图3 域名安全配置停用域名若您需要停用某个域名，可以在需要停用的域名行单击“停用”。当“状态”变为“已停用”时，表示域名停用成功。至少要保证设置为“默认”的域名处于“已启用”状态，否则会导致点播音视频播放失败。启用域名若您需要将某个已停用的域名重新启用，可以在需要启用的域名行单击“启用”。当“状态”变为“已启用”时，表示域名启用成功。删除域名注意：仅在“停用”状态下的域名才能删除。因此，您需要先停用不需要的域名，再在需要删除的域名行单击“删除”即可。如果域名超过半年未使用，删除域名时会报错，需提交工单处理。

视频点播 VOD 域名管理

视频点播 VOD-配置域名:注意事项

注意事项若您开通了企业项目管理服务，则添加域名时，支持为域名划分企业项目方便进行分类管理。默认的企业项目为“default”，您可以参考创建企业项目添加更多企业项目类型，以满足您的业务需求。系统会对您名下的所有域名进行自动检查，对长期未有播放行为产生的域名进行下线操作，具体如下所示：域名停用：若某个域名在一个月内未有下行流量产生，则停用该域名，点播控制台上对应域名为“已停用”状态。域名删除：若某个域名在两个月内未有下行流量产生，则删除该域名。域名停用或删除后，不能再使用该域名进行媒资的分发和播放，但不影响媒资的上传、处理等操作。当域名处于停用等异常状态时，对媒资进行删除等操作，会存在CDN缓存无法清除的情况。需要域名恢复正常后，用户再次触发媒资的缓存清除操作。域名恢复：若域名被停用，您可以在点播控制台的“域名管理”中手动启用。若域名已被删除，则需要重新添加该域名，并配置CNAME，才可再次使用该域名。需要注意的是，开通点播服务时系统分配的加速域名（当前系统域名资源已分配完），删除后无法恢复。域名解禁：若域名备案到期后，该域名会被封禁，届时，该域名相关的点播资源将无法使用。您需要重新在工信部或华为云备案中心完成该域名的备案后，提交工单申请解封。如果域名超过半年未使用，删除域名时会报错，需提交工单处理。

视频点播 VOD 域名管理

视频点播 VOD-配置域名:添加域名

添加域名登录视频点播控制台。在左侧导航栏中，选择“域名管理”，进入域名管理界面。单击“新增域名”，进入“添加域名”页面。参数配置说明如表1所示表1 添加域名参数说明域名输入已备案的域名。最多可添加5个域名，不支持添加中文域名和泛域名，如“*.example.com”。建议使用二级以上域名，如“example.yourdomain.com”。企业项目若您开通了企业项目管理服务，则需要选择“企业项目”，将新建域名进行分类管理。服务范围当前域名的服务范围。包括如下选项：中国大陆：仅中国大陆的用户，可以访问当前域名的视频点播内容。中国大陆境外：仅中国大陆境外的用户，可以访问当前域名的视频点播内容。全球：全球用户，均可以访问当前域名的视频点播内容。单击“确定”，完成添加。在域名列表中会新增一条“状态”为“配置中”的域名记录。大概3-5分钟时间，当“状态”为“已启用”时，域名添加成功。域名添加成功后，系统将会为添加的域名分配一个CNAME值。在域名DNS服务商处配置CNAME解析，并验证CNAME是否生效，具体操作请参见配置CNAME。若域名添加后未配置CNAME就设置为默认启用，则可能导致点播中的音视频无法正常播放，封面无法正常显示等异常。在已添加的域名后单击“设为默认”，可以将自有域名设置为默认域名。每个账户仅能设置一个默认域名，且设置为“默认”的域名必须处于正常启用状态。设置后，您还需要开启该域名的HTTPS安全加速，并上传HTTPS证书，才可以使用该域名向外提供视频点播功能。

视频点播 VOD 域名管理

视频点播 VOD-快速使用点播服务:全局设置（可选）

全局设置（可选）可选配置，若您对上传的音视频有转码、水印、加密、消息通知的需求，您可以在上传音视频文件前完成相关配置，然后在上传时或上传后使用模板进行处理。设置转码模板上传音视频时默认按照系统模板组转码，若您需要上传音视频时自定义转码，请参考转码设置创建自定义转码模板组。您也可以参考配置转码模板的视频指导进行操作。设置视频水印视频水印在转码过程中压制，如您需要使用视频水印，请参考水印设置配置水印模板并启用。如果在全局设置中添加了视频水印模板并启用，则上传的视频默认压制水印。如需对新上传视频取消使用水印，请回到全局设置界面取消水印启用。安全设置为保障视频安全，华为云点播服务提供内容加密能力，若您需要，请参考安全设置配置加密参数。配置加密参数后，还需在配置转码模板时开启加密开关才能对视频内容进行加密，请参考转码设置开启加密开关。分类设置若您需要对已上传视频进行分类，请参考分类设置配置视频分类。消息订阅若您需要对任务执行状态进行实时通知，请参考消息订阅设置。

视频点播 VOD

视频点播 VOD-快速使用点播服务:配置域名

配置域名当前系统域名资源已分配完，若您在开通点播服务后未分配有系统域名，则需要将已备案的域名添加到点播服务中才能进行媒资加速分发。登录视频点播控制台。在左侧导航栏中，选择“域名管理”，进入域名管理界面。单击“新增域名”，进入“添加域名”页面。参数配置说明如表1所示表1 添加域名参数说明域名输入已备案的域名。最多可添加5个域名，不支持添加中文域名和泛域名，如“*.example.com”。建议使用二级以上域名，如“example.yourdomain.com”。企业项目若您开通了企业项目管理服务，则需要选择“企业项目”，将新建域名进行分类管理。服务范围当前域名的服务范围。包括如下选项：中国大陆：仅中国大陆的用户，可以访问当前域名的视频点播内容。中国大陆境外：仅中国大陆境外的用户，可以访问当前域名的视频点播内容。全球：全球用户，均可以访问当前域名的视频点播内容。单击“确定”，完成添加。在域名列表中会新增一条“状态”为“配置中”的域名记录。大概3-5分钟时间，当“状态”为“已启用”时，域名添加成功。域名添加成功后，系统将会为添加的域名分配一个CNAME值。在域名DNS服务商处配置CNAME解析，并验证CNAME是否生效，具体操作请参见配置CNAME。若域名添加后未配置CNAME就设置为默认启用，则可能导致点播中的音视频无法正常播放，封面无法正常显示等异常。在已添加的域名后单击“设为默认”，可以将自有域名设置为默认域名。每个账户仅能设置一个默认域名，且设置为“默认”的域名必须处于正常启用状态。设置后，您还需要开启该域名的HTTPS安全加速，并上传HTTPS证书，才可以使用该域名向外提供视频点播功能。

视频点播 VOD

视频点播 VOD-快速使用点播服务:播放音视频

播放音视频上传到点播服务的音视频可以在控制台进行预览播放，也可以通过使用第三方播放器进行播放。控制台预览：在音视频管理界面，单击视频封面，在弹出的播放器中单击播放图标，即可开始预览播放。在控制台预览播放音视频，需确保已开启该域名的HTTPS安全加速，并上传HTTPS证书。播放器播放：在视频行单击右侧“管理”，选择“播放地址”页签，在“操作”列单击复制播放URL，将复制的播放URL输入到播放器中进行播放，例如，使用VLC播放器。

视频点播 VOD

视频点播 VOD-创建用户并授权使用VOD:示例流程

示例流程图1 给用户授权VOD只读权限流程创建用户组并授权在IAM控制台创建用户组，并授予VOD只读权限“VOD ReadOnlyAccess”。创建用户并加入用户组在IAM控制台创建用户，并将其加入1中创建的用户组。用户登录并验证权限新创建的用户登录控制台，切换至授权区域，验证权限：在“服务列表”中选择视频点播服务，进入“全局配置”界面，若提示权限不足，表示“VOD ReadOnlyAccess”已生效。在“服务列表”中选择除弹性云服务器外的任一服务，若提示权限不足，表示“VOD ReadOnlyAccess”已生效。

视频点播 VOD IAM权限管理

云服务器内容精选

视频点播 VOD

7*24

备案

专业服务

退订

建议反馈

售前咨询热线