华为云用户手册

前提条件 连接数据库的弹性云服务器必须和DDS实例之间网络互通，可以使用curl命令连接DDS实例服务端的IP和端口号，测试网络连通性。 curl ip:port 返回“It looks like you are trying to access MongoDB over HTTP on the native driver port.”，说明网络互通。 如果开启SSL，需要在界面上下载根证书，并上传到弹性云服务器。

前提条件 连接数据库的弹性云服务器必须和DDS实例之间网络互通，可以使用curl命令连接DDS实例服务端的IP和端口号，测试网络连通性。 curl ip:port 返回“It looks like you are trying to access MongoDB over HTTP on the native driver port.”，说明网络互通。 如果开启SSL，需要在界面上下载根证书，并上传到弹性云服务器。

报错说明 当参数错误或不匹配时，会有相应的报错提示。 表4 报错说明 报错信息 报错原因 TopicAuthorizationException projectId（项目ID）、accessKey（AK）、accessSecret（SK）参数错误或者不匹配。 UnknownTopicOrPartitionException logGroupId（日志组ID）、logStreamId（日志流ID）参数错误或者不匹配。 InvalidRecordException 仅当配置headers，上报规范化日志时，会出现此类报错： 日志格式错误或者日志中的projectId（项目ID）、logGroupId（日志组ID）、logStreamId（日志流ID）与外部设置参数不一致。

日志示例 { "tenant_project_id": "${projectId}", "tenant_group_id": "${logGroupId}", "tenant_stream_id": "${logStreamId}", "log_time_ns": "XXXXXXXXXXXXXXXXXXX", "contents": [ "This is a log 1", "This is a log 2" ], "labels": { "type": "kafka" } }

配置方式 使用Kafka协议上报日志时，需要使用到的通用参数如下。 表1 通用参数 参数名称 描述 类型 projectId 用户账号的项目ID（project id） String logGroupId LTS的日志组ID String logStreamId LTS的日志流ID String regionName 云日志服务的区域 String accessKey 用户账号的AK String accessSecret 用户账号的SK String 使用Kafka协议上报日志时，需要配置以下参数。 表2 配置参数 参数名称 说明 连接类型 当前支持SASL_PLAINTEXT hosts Kafka的IP和PORT地址，格式为 lts-kafka.${regionName}.myhuaweicloud.com:9095 其中IP根据局点进行配置，PORT固定为9095。例如北京四局点对应hosts为 lts-kafka.cn-north-4.myhuaweicloud.com:9095。 topic Kafka的topic名称，格式为 ${日志组ID}_${日志流ID}，即LTS的日志组ID和日志流ID通过下划线连接，作为topic的名称。 username Kafka访问用户名，配置为用户账号的项目ID。 password Kafka访问密码，格式为${accessKey}#${accessSecret}，即用户账号的AK和SK通过#连接，作为Kafka的访问密码。 headers 当您希望设置自定义label字段时，需要配置headers。headers的参数配置分为以下两种情况： 不配置headers，对上报的日志格式没有要求。 headers中添加header，key为LTS_LOG_TYPE，value为FORMAT，用户需要上报符合要求的规范化日志。 ${message}日志格式 仅当headers中添加了key为LTS_LOG_TYPE，value为FORMAT的header时，日志需要符合该格式规范。 表3 日志参数 参数名称 是否必选 参数类型 描述 tenant_project_id 是 String 用户账号的项目ID。 tenant_group_id 是 String LTS的日志组ID。 tenant_stream_id 是 String LTS的日志流ID。 log_time_ns 是 Long 日志数据采集时间，UTC时间（纳秒）。 说明： 采集时间需在日志存储时间范围之内，否则上报日志会被删除。比如日志组的日志存储时间是7天，则此参数不应早于当前时间的7天前。 contents 是 Array of String 日志内容 labels 是 Object 用户自定义label。 说明： 请不要将字段名称设置为内置保留字段，否则可能会造成字段名称重复、查询不精确等问题。

使用方式 并行文件系统提供管理控制台、OBSA以及RESTful API接口的使用方法。用户可以在任何时间和地点对存储在并行文件系统内的文件进行处理，并且可以快速获取到处理后的文件。并行文件系统除支持POSIX文件语义外，也支持原来对象的接口，即用户仍然可以使用对象的处理方式来处理文件，实现了对象和文件的互通。 用户可以通过以下几种方式使用并行文件系统。 OBS桶的权限管理规则及权限要求同样适用于并行文件系统，用户在使用并行文件系统前需要确保具备OBS资源的访问权限。 表1 使用方式 方式 主要功能 相关链接 并行文件系统控制台 您可以在控制台创建并行文件系统，并进行查看、管理等基本操作。 创建并行文件系统 OBS API 通过OBS API来使用并行文件系统。 支持的API列表 OBSA 大数据场景推荐使用 OBS工具 其他OBS工具 并行文件系统实现了对象和文件的互通，因此您可以使用OBS提供的其他工具来使用并行文件系统，例如：obsutil，OBS Browser+等。 OBS工具 父主题： 简介

桶策略配置样例 示例1：给用户授予dir_1目录的下载权限，不包括子目录 策略配置如下所示，资源路径以/结束，这时head请求url中携带dir_1或者dir_1/都可以收到成功响应。 { "Statement":[ { "Sid":"test", "Effect":"Allow", "Principal": {"ID": ["domain/b4bf1b36d9ca43d984fbcb9491b6fce9:user/71f3901173514e6988115ea2c26d1999"]}, "Action":["*"], "Resource":[ "examplebucket/dir_1/", ] } ] }

IAM权限配置样例 示例1：给用户授予dir_1目录的下载权限，不包括子目录 策略配置如下，资源路径以/结束，这时head请求url中携带dir_1或者dir_1/都可以收到成功响应。 注意：该策略没有对dir_1中子目录或文件授予权限，所以对dir_1/file1发送head请求会收到失败响应。 { "Version": "1.1", "Statement": [ { "Effect": "Allow", "Action": [ "obs:object:GetObject", ], "Resource": [ "obs:*:*:object:examplebucket/dir_1/", ] } ] }

对象操作接口 表4 对象操作接口 接口 并行文件系统是否兼容 差异说明 PUT上传 √ 不支持的头域：x-obs-storage-class、x-obs-website-redirect-location、x-obs-server-side-encryption、x-obs-server-side-encryption-kms-key-id、x-obs-server-side-encryption-customer-algorithm、x-obs-server-side-encryption-customer-key、x-obs-server-side-encryption-customer-key-MD5、success-action-redirect、x-obs-expires 不支持直接上传低频和归档存储对象，上传后默认为标准存储，可通过生命周期或元数据修改存储类型。 POST上传 √ 不支持的头域：x-obs-storage-class、x-obs-website-redirect-location、x-obs-server-side-encryption、x-obs-server-side-encryption-kms-key-id、x-obs-server-side-encryption-customer-algorithm、x-obs-server-side-encryption-customer-key、x-obs-server-side-encryption-customer-key-MD5、success-action-redirect、x-obs-expires 复制对象 √ 只支持相同集群内并行文件系统或OBS桶之间进行复制。 获取对象内容 √ - 获取对象元数据 √ - 删除对象 √ - 批量删除对象 √ - 恢复归档存储对象 √ - 追加写对象 × - 设置对象ACL √ - 获取对象ACL √ - 修改对象元数据 √ 并行文件系统不支持修改目录的存储类型。如需修改目录中文件的存储类别，请修改文件的元数据，或者使用生命周期规则批量修改文件存储类别。 修改写对象 √ 并行文件系统新增接口，OBS桶不支持。 截断对象 √ 并行文件系统新增接口，OBS桶不支持。 重命名对象 √ 并行文件系统新增接口，OBS桶不支持。

桶高级配置接口 表2 桶高级配置接口 接口 并行文件系统是否兼容 差异说明 设置桶策略 √ - 获取桶策略 √ - 删除桶策略 √ - 设置桶ACL √ - 获取桶ACL √ - 设置桶日志管理配置 √ - 获取桶日志管理配置 √ - 设置桶的生命周期配置 √ - 获取桶的生命周期配置 √ - 删除桶的生命周期配置 √ - 设置桶的多版本状态 × - 获取桶的多版本状态 × - 设置桶的消息通知配置 √ - 获取桶的消息通知配置 √ - 设置桶默认存储类型 × - 获取桶默认存储类型 × - 设置桶的跨区域复制配置 × - 获取桶的跨区域复制配置 × - 删除桶的跨区域复制配置 × - 设置桶标签 √ - 获取桶标签 √ - 删除桶标签 √ - 设置桶配额 √ - 获取桶配额 √ - 获取桶存量信息 √ - 设置桶清单 × - 获取桶清单 × - 列举桶清单 × - 删除桶清单 × - 设置桶的自定义域名 √ - 获取桶的自定义域名 √ - 删除桶的自定义域名 √ - 设置桶的加密配置 × - 获取桶的加密配置 × - 删除桶的加密配置 × - 设置桶归档对象直读策略 √ - 获取桶归档对象直读策略 √ - 删除桶归档对象直读策略 √ -

约束限制 操作限制 不支持将已有的OBS桶修改为并行文件系统，创建并行文件系统方法请参见创建并行文件系统。 不支持控制台设置并行文件系统的自定义域名，API设置方法参见设置自定义域名。 功能限制 暂不支持通过图片处理特性对存放在并行文件系统中的图片进行瘦身、缩放、添加水印等操作。 暂不支持服务端加密 暂不支持跨区域复制 暂不支持多版本控制 暂不支持配置桶清单 暂不支持配置静态网站托管 暂不支持配置桶默认存储类型 不支持深度归档，支持标准、低频和归档 暂不支持专属对象存储场景 暂不支持DWR数据工坊对接 并行文件系统可以挂载至多个Linux服务器实现并行读，但不建议使用此方法并发写。 性能限制 并行文件系统每TB默认提供最大带宽10MB/s。 命名限制 对并行文件系统的文件进行命名时，不允许连续使用两个“/”字符。例如，将文件命名为“test//123.txt”，该命名不符合规范，系统会出现报错。 父主题： 简介

与对象生命周期管理主要差异说明 您可以使用生命周期管理功能管理文件。目录不会因生命周期管理而转归档存储，而空目录会因生命周期管理超期删除。 对于生命周期管理规则的配置，您可以通过API配置超期、转归档存储、转低频访问存储。控制台目前仅支持配置超期、转归档存储。同样的由于并行文件系统不支持多版本，生命周期规则中配置多版本相关的超期、转归档存储、转低频访问存储也不支持。 在配置并行文件系统直读的情况下，您可以通过直读的方式读取归档存储文件。 您最多可以在一个并行文件系统下配置20条生命周期管理规则，超过20条将提示不支持。 文件满足生命周期规则的基准时间为文件数据内容最后一次做更新的时间点。 不支持使用生命周期规则向深度归档存储类型转换。 单个并行文件系统配置生命周期规则后，对于规则生效的目录有如下限制，超过限制后，将导致生命周期规则执行完成的时间延长。 每个目录下的一级子目录数不超过10万。 所有规则前缀匹配的子目录总数（文件夹总数）不超过1000万。 所有规则前缀匹配的文件总数不超过3000万。

其他说明 您如果执行rename操作， rename后的文件或rename后的目录下的文件如果满足某个生命周期规则，则匹配生命周期的基准时间仍为文件数据内容最后一次更新的时间而非rename的时间，且这些文件的生命周期管理生效时间可能会有延迟，延迟时间为0至7天。 对于文件客户端执行的拷贝操作，生命周期判断超期或者转归档存储的时间基准为拷贝的时间点。 例：文件src.txt创建时间为2019年1月1日，在2019年9月1日执行cp -a src.txt des.txt后，des.txt的生命周期管理时间以2019年9月1日来计算是否满足超期或转归档存储的时间配置。 并行文件系统生命周期，目录的删除是靠周期扫描任务进行的，从最深目录进行扫描，如果空目录符合过期条件则删除该空目录，非空目录不做处理。目录周期扫描任务扫描间隔依赖集群配置，一般为7天。单层目录为空后0-7天内删除。二级目录需等两个周期，在各目录下均无文件或目录后等待0-14天。依此递增。

成本优化 成本控制 企业可以在成本中心的“预算管理”页面创建精细粒度的预算来管理成本和使用量，在实际或预测超过预算阈值时，自动发送通知给指定消息接收人。企业还可以创建预算报告，定期将指定预算进展通知给指定消息接收人。 例如企业需要创建一个云备份的按需成本预算，每月预算金额为2500元，当预测金额高于预算金额的80%时、实际使用金额大于预算金额的70%时发送预算告警。那么，创建的预算如下： 图1-4 预算基本信息 图3 设置成本范围 图4 设置提醒 详细介绍请参见使用预测和预算来跟踪成本和使用量。 资源优化 成本中心可以通过监控云备份存储库的历史消费情况和使用率，为客户提供云备份存储库资源的空闲识别和优化建议，寻找节约成本的机会。您还可以根据成本分析阶段的分析结果识别成本偏高的资源，通过云监控服务监控资源的使用情况，确定成本偏高的原因，然后采取针对性的优化措施。 监控资源利用率，评估当前存储库使用率是否过低。 监控闲置的资源，避免浪费。例如：未绑定的存储库等。 计费模式优化 不同类型的业务对资源使用周期有不同的要求，为每一类业务确定合适的计费模式，灵活组合以达到最优效果。 针对长期稳定的成熟业务，使用包年/包月计费模式。 针对不能中断的短期、突增或不可预测的业务，使用按需计费模式。 实现自动化运维 华为云也提供了丰富的运维类产品，帮助您提升运维效率，降低运维的人力成本。例如： 自动扩容：存储库在容量达到上限时，可以开启自动扩容功能。开启自动扩容后，存储库将自动扩容至原存储库容量的1.25倍。适合业务数据向上浮动较大的场景。 自动绑定：备份存储库支持将未备份的资源自动绑定至存储库上，并根据存储库绑定的备份策略的备份周期进行自动备份。开启自动绑定功能后，存储库将将自动扫描绑定未备份的资源，适合资源量庞大的场景。

成本分配 成本管理的基础是树立成本责任制，让各部门、各业务团队、各责任人参与进来，为各自消耗云服务产生的成本负责。企业可以通过成本分配的方式，将云上成本分组，归集到特定的团队或项目业务中，让各责任组织及时了解各自的成本情况。 华为云成本中心支持通过多种不同的方式对成本进行归集和重新分配，您可以根据需要选择合适的分配工具。 通过关联账号进行成本分配 企业主客户可以使用关联账号对子客户的成本进行归集，从而对子账号进行财务管理。详细介绍请参见通过关联账号维度查看成本分配。 通过企业项目进行成本分配 在进行成本分配之前，建议开通企业项目并做好企业项目的规划，可以根据企业的组织架构或者业务项目来划分。在购买云资源时选择指定企业项目，新购云资源将按此企业项目进行成本分配。详细介绍请参见通过企业项目维度查看成本分配。 图1 为云备份存储库选择企业项目 通过成本标签进行成本分配 标签是华为云为了标识云资源，按各种维度（例如用途、所有者或环境）对云资源进行分类的标记。推荐企业使用预定义标签进行成本归集，具体流程如下： 图2 为云备份存储库添加标签 详细介绍请参见通过成本标签维度查看成本分配。 使用成本单元进行成本分配 企业可以使用成本中心的“成本单元”来拆分公共成本。公共成本是指多个部门共享的计算、网络、存储或资源包产生的云成本，或无法直接通过企业项目、成本标签分配的云成本。这些成本不能直接归属于单一所有者，因此不能直接归属到某一类别。使用拆分规则，可以在各团队或业务部门之间公平地分配这些成本。详细介绍请参见使用成本单元查看成本分配。

华为账号绑定/修改邮箱后，为什么系统提示：“3天后生效”？如何处理？ 华为账号绑定/修改邮箱后，系统提示“3天后生效”。 以下原因可能导致系统提示“3天后生效”。 账号为高价值账号 账号存在盗号风险 如果您的业务需要立即生效，可通过如下方法处理： 提交工单处理。 您可在“问题描述”中输入以下信息，工单中的手机号码和邮箱请根据实际情况填写。 业务场景：(按实际情况填写) 诉求：绑定邮箱后立即生效 拨打客服电话4000-955-988，联系客服处理。 父主题： 基本概念

响应示例 状态码： 200 处理成功返回。 { "task_result_array" : [ { "asset_id" : "2305739f855413a84af9e6ad6e2b21be", "status" : "SUCCEED" } ] } 状态码： 400 处理失败返回。 { "error_code" : "VOD.10053", "error_msg" : "The request parameter is illegal, illegal field: {xx}." }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 task_result_array Array of TaskResult objects 修改媒资存储模式任务的下发结果。 表5 TaskResult 参数 参数类型 描述 asset_id String 媒资ID status String 查看修改媒资存储模式的任务是否下发成功。 SUCCEED：成功 FAILED：失败 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

请求参数 表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参数 参数 是否必选 参数类型 描述 asset_id 是 String 原媒资ID storage_mode 是 String 存储模式。 取值如下： STANDARD：标准存储。 WARM：低频存储。 COLD：归档存储。 restore_mode 否 String 归档恢复方式。 取值如下： TEMP：临时 FOREVER：永久 days 否 Integer 从归档存储临时恢复为标准存储的时间。 取值范围：1-30。 restore_tier 否 String 归档恢复选项。 EXPEDITED：快速恢复 STANDARD：标准恢复 默认值：EXPEDITED。

请求参数 表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参数 参数 是否必选 参数类型 描述 asset_id 是 String VOD分配的媒资ID，仅支持查询，不支持修改。 video_md5 否 String 视频文件MD5值。建议参考《API参考》附录下生成MD5值的媒资上传和更新示例。 video_name 否 String 视频文件名。 文件名后缀为可选。 video_type 否 String 视频文件类型。 取值为MP4、TS、MOV、MXF、MPG、FLV、WMV、AVI、M4V、F4V、MPEG、3GP、ASF、MKV cover_id 否 Integer 封面ID。 取值范围：[0,7]。 当前只支持一张封面，只能设置为0。 cover_type 否 String 封面图片格式类型。 取值如下： JPG PNG cover_md5 否 String 封面文件的MD5值。 subtitles 否 Array of Subtitle objects 字幕文件信息 表4 Subtitle 参数 是否必选 参数类型 描述 id 是 Integer 字幕id。 取值范围：[1,16]。 type 是 String 字幕文件类型，目前暂只支持“SRT”和“VTT”。 language 是 String 字幕语言类型。 name 否 String 字幕文件名称。 md5 否 String 字幕文件的MD5值。 description 否 String 字幕描述。

请求示例 更新媒资 PUT https://{endpoint}/v1.0/{project_id}/asset Content-Type: application/json { "asset_id": "f488337c31c8e4622f1590735b134c65", "cover_id": "0", "cover_type": "JPG", "subtitles": [ { "id": 1, "language": "CN", "type": "SRT", "md5": "SqcyFjJZoDZaP8oKIY6rgQ==", "description": "AAAAA" } ] }

响应示例 状态码： 200 处理成功返回。 { "asset_id" : "f488337c31c8e4622f1590735b134c65", "cover_upload_url" : "https://obs.cn-north-4.myhuaweicloud.com:443/obs-vod-1/%7Bproject_id%7D/f488337c31c8e4622f1590735b134c65/cover/Cover0.jpg?AWSAccessKeyId=CBN2JOVSQVVUREU0RCSN&Expires=1518148410&Signature=DVwzU6ejlKlSdAbwFXaSy67JpuA%3D", "subtitle_upload_urls" : [ "https://obs-vod-1.obs.cn-north-4.myhuaweicloud.com:443/14ce1d4437164aba8b364ce15866154e/53a018d2dc53ca07eb5a07a839205c9d/subtitle/1.srt?AWSAccessKeyId=CBN2JOVSQVVUREU0RCSN&Expires=1534760131&Signature=twZPabMSf%2FO%2B2H3mpo3Gsqk1uIo%3D" ] } 状态码： 403 处理失败返回。 { "error_code" : "VOD.10062", "error_msg" : "Media asset or resource does not exist, please check." }

接口约束 请求Body参数的设置要求，如下所示： 参数video_md5、video_name、video_type、cover_type、cover_md5、subtitles必须至少设置一个。 如果更新视频，参数video_md5、video_name、video_type为必填项，不能为空值。 如果更新封面，参数cover_id、cover_type、cover_md5为必填项，不能为空值。 如果上传字幕文件，参数subtitles的id、type和language为必填项，不能为空值。 如果未按照上述要求，正确设置参数，将无法正常返回接口响应消息。

请求参数 表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参数 参数 是否必选 参数类型 描述 video_type 是 String 转存的音视频文件类型。 取值如下： 视频文件：MP4、TS、MOV、MXF、MPG、FLV、WMV、AVI、M4V、F4V、MPEG、3GP、ASF、MKV、HLS、RMVB、WEBM 音频文件：MP3、OGG、WAV、WMA、APE、FLAC、AAC、AC3、MMF、AMR、M4A、M4R、WV、MP2 若上传格式为音频文件，则不支持转码、添加水印和字幕。 说明： 当video_type选择HLS时，storage_mode（存储模式）需选择存储在租户桶，且输出路径设置为和输入路径在同一个目录。 title 是 String 媒资标题，长度不超过128个字节，UTF-8编码。 description 否 String 视频描述，长度不超过1024个字节。 category_id 否 Integer 媒资分类ID。 您可以调用创建媒资分类接口或在点播控制台的分类设置中创建对应的媒资分类，并获取分类ID。 说明： 若不设置或者设置为-1，则上传的音视频归类到系统预置的“其它”分类中。 tags 否 String 视频标签。 单个标签不超过16个字节，最多不超过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 工作流名称。若不为空，则使用指定的工作流对上传的音视频进行处理，您可以在视频点播控制台配置工作流，具体请参见《点播服务用户指南》中的“工作流设置”。 input 是 File_addr object 媒资存储参数信息。查询接口，仅媒资为托管时有返回值。 storage_mode 否 Integer 存储模式。 取值如下： 0：表示视频拷贝到点播桶。 1：表示视频存储在租户桶。 默认值：0 output_bucket 否 String 输出桶名，“storage_mode”为1时必选。 output_path 否 String 输出路径名，“storage_mode”为1时必选。 表4 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。 表5 Review 参数 是否必选 参数类型 描述 template_id 是 String 审核模板ID。您可以在视频点播控制台配置审核模板后获取，具体请参见《点播服务用户指南》中的“审核设置”。 说明： 仅“华北-北京一”、“华北-北京四”点播服务支持此功能。 interval 否 Integer 截图检测时间间隔，取值范围为[0,100]，该参数在请求参数中忽略。 politics 否 Integer 鉴政内容检测置信度，取值范围为[0,100]，该参数在请求参数中忽略。 置信度越高，说明审核结果越可信。未开启或设置为0时，表示未进行此项检测。 terrorism 否 Integer 鉴恐内容的检测置信度，取值范围为[0,100]，该参数在请求参数中忽略。 置信度越高，说明审核结果越可信。未开启或设置为0时，表示未进行此项检测。 porn 否 Integer 鉴黄内容的检测置信度，取值范围为[0,100]，该参数在请求参数中忽略。 置信度越高，说明审核结果越可信。未开启或设置为0时，表示未进行此项检测。 表6 File_addr 参数 是否必选 参数类型 描述 bucket 是 String OBS的bucket名称。 location 是 String 桶所在的区域名， 如“华北-北京四”的区域名为“cn-north-4”，创建的桶所在区域必须和点播服务所在区域保持一致。 object 是 String 文件的存储路径。

请求示例 转存存储在OBS桶中的HLS视频至点播服务中（ts文件需和m3u8文件在同一目录下） POST https://{endpoint}/v1.0/{project_id}/asset/reproduction Content-Type: application/json { "video_type": "HLS", "title": "tittle", "auto_publish": 1, "input": { "bucket": "bucket_name", "location": "cn-north-4", "object": "test/hls/test_video.m3u8" }, "storage_mode": 1, "output_bucket": "bucket_name", "output_path": "test/hls" } 转存存储在OBS桶中的音视频文件至点播服务中 POST https://{endpoint}/v1.0/{project_id}/asset/reproduction Content-Type: application/json { "input": { "bucket": "bucket", "location": "cn-north-4", "object": "path" }, "title": "title", "description": "des", "category_id": -1, "tags": "test", "video_type": "MP4", "auto_publish": 1, "template_group_name": "tempName" }

请求参数 表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参数 参数 是否必选 参数类型 描述 bucket 是 String OBS桶名称。 operation 是 String 是否进行桶授权。 取值如下： 0：取消授权。 1：授权。

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

响应示例 状态码： 200 处理成功返回。 [ { "id" : "334", "name" : "电影", "children" : [ { "id" : "335", "name" : "电视", "children" : [ ] } ] } ] 状态码： 400 处理失败返回。 { "error_code" : "VOD.10053", "error_msg" : "The request parameter is illegal, illegal field: {xx}." }

响应示例 状态码： 200 处理成功返回。 { "asset_id" : "f488337c31c8e4622f1590735b134c65", "video_upload_url" : "https://obs.cn-north-4.myhuaweicloud.com:443/obs-vod-1/%7Bproject_id%7D/f488337c31c8e4622f1590735b134c65/Avatar_480P.mp4?AWSAccessKeyId=CBN2JOVSQVVUREU0RCSN&Expires=1518147618&Signature=kZYh0hEos2VJhjjdHC2zVAHGyXA%3D", "cover_upload_url" : "https://obs.cn-north-4.myhuaweicloud.com:443/obs-vod-1/%7Bproject_id%7D/f488337c31c8e4622f1590735b134c65/cover/Cover0.jpg?AWSAccessKeyId=CBN2JOVSQVVUREU0RCSN&Expires=1518147619&Signature=eVoLA54Qi6cG9vZbS3fuaIw1RDQ%3D", "subtitle_upload_urls" : [ "https://obs-vod-1.obs.cn-north-4.myhuaweicloud.com:443/14ce1d4437164aba8b364ce15866154e/53a018d2dc53ca07eb5a07a839205c9d/subtitle/1.srt?AWSAccessKeyId=CBN2JOVSQVVUREU0RCSN&Expires=1534760131&Signature=twZPabMSf%2FO%2B2H3mpo3Gsqk1uIo%3D" ], "target" : { "bucket" : "obs-vod-1", "location" : "cn-north-4", "object" : "093bb6b6c4fc460ab90a40d8b821dda3/a2053aef99725711dad3e02dc6cd5f89/0a9b70035b78b8a19c6d9e7c2693d93c.mp4" } } 状态码： 403 处理失败返回。 { "error_code" : "VOD.10064", "error_msg" : "Media asset classification does not exist, please check." }

响应参数 状态码： 200 表7 响应Body参数 参数 参数类型 描述 asset_id String 媒体ID video_upload_url String 视频上传URL cover_upload_url String 封面上传地址 subtitle_upload_urls Array of strings 字幕文件上传url数组 target File_addr object 媒资存储参数信息。查询接口，仅媒资为托管时有返回值。 表8 File_addr 参数 参数类型 描述 bucket String OBS的bucket名称。 location String 桶所在的区域名， 如“华北-北京四”的区域名为“cn-north-4”，创建的桶所在区域必须和点播服务所在区域保持一致。 object String 文件的存储路径。 状态码： 403 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。