云服务器内容精选

  • 操作场景 您可以复制您创建的自定义数据库参数模板。当您已创建一个数据库参数模板,并且想在新的数据库参数模板中包含该组中的大部分自定义参数和值时,复制参数模板是一个方便的解决方案。您还可以导出某数据库实例应用的参数列表,生成一个新的参数模板,供您后期使用。 复制数据库参数模板之后,新参数模板可能不会立即显示,建议您等待5分钟再使用。 您无法复制默认参数模板。不过,您可以创建基于默认参数模板的新参数模板。
  • 操作场景 您可以复制您创建的自定义数据库参数模板。当您已创建一个数据库参数模板,并且想在新的数据库参数模板中包含该组中的大部分自定义参数和值时,复制参数模板是一个方便的解决方案。您还可以导出某数据库实例应用的参数列表,生成一个新的参数模板,供您后期使用。 复制数据库参数模板之后,新参数模板可能不会立即显示,建议您等待5分钟再使用。 您无法复制默认参数模板。不过,您可以创建基于默认参数模板的新参数模板。
  • 注意事项 您可以修改用户创建的数据库参数模板中的参数值,但不能更改默认数据库参数模板中的参数值。 在配置数据库参数模板中的参数时需要注意以下几点: 当您修改当前实例的参数模板并保存后,仅应用于当前实例,不会对其他实例造成影响。 如果您单击实例名称,在“参数修改”页面修改当前实例的参数模板,更改动态参数并保存数据库参数模板时,系统将立即应用更改,而不管“应用”设置如何。当您更改静态参数并保存数据库参数模板时,参数更改将在您手动重启该数据库实例后生效。 当您在“参数管理”页面,修改自定义参数模板时,需执行“应用”操作,才会对实例生效。当您更改静态参数并保存数据库参数模板时,参数更改将在您应用到实例后,手动重启与数据库参数模板关联的数据库实例后生效。应用参数模板到数据库实例,请参见应用参数模板。 在数据库参数模板内设置参数不恰当可能会产生意外的不利影响,包括性能降低和系统不稳定。修改数据库参数时应始终保持谨慎,且修改数据库参数模板前要备份数据。将参数模板更改应用于生产数据库实例前,您应当在测试数据库实例上试用这些参数模板设置更改。 全局参数必须通过控制台修改,会话级参数可通过SQL修改。如果您更改一个参数值,则所做更改的应用时间将由该参数的类型决定。 云数据库RDS服务的管理控制台显示与数据库参数模板关联的数据库实例状态。例如,如果数据库实例未使用对其关联的数据库参数模板所做的最新更改,则云数据库RDS服务的管理控制台将显示状态为“等待重启”的数据库实例。您将需要手动重启数据库实例,以使最新的参数更改对该数据库实例生效。 系统提供的默认参数模板不允许修改,只可单击参数模板名进行查看。当用户参数设置不合理导致数据库无法启动时,可参考默认参数模板重新配置。
  • 注意事项 并非所有数据库引擎参数都可在客户创建的数据库参数模板中进行更改。 如果您想使用您自己的数据库参数模板,只需创建一个新的数据库参数模板,创建实例的时候选择该参数模板,如果是在创建实例后有这个需求,可以重新应用该参数模板,请参见应用参数模板。 如果您已成功创建数据库参数模板,并且想在新的数据库参数模板中包含该组中的大部分自定义参数和值时,复制参数模板是一个方便的解决方案,请参见复制参数模板。 云数据库RDS和文档数据库服务不共享参数模板配额。每个用户最多可以创建100个云数据库RDS参数模板,各云数据库RDS引擎共享该配额。
  • 请求示例 URI样例 POST https://gaussdb-nosql.cn-north-7.myhuaweicloud.com/v3/375d8d8fad1f43039e23d3b6c0f60a19/configurations/comparison 比较源参数模板和目标参数模板 { "source_configuration_id" : "0764fdcd949b411ba76c2b762b80c212pr06", "target_configuration_id" : "fa42c57bb62844e490052f2ff9d5a264pr06" }
  • 请求参数 表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参数 参数 是否必选 参数类型 描述 name 是 String 水印模板名称。 watermark_type 否 String 水印类型,当前只支持IMAGE(图片水印)。 image_process 否 String watermark_type设置为IMAGE时有效。 目前包括: ORIGINAL:只做简单缩放,不做其他处理 TRANSPARENT:图片底色透明 GRAYED:彩色图片变灰 dx 否 String 水印图片相对输出视频的水平偏移量,默认值是0。 设置方法有两种,建议小数型,整数型可能导致控制台图片无法预览,但不影响转码: 整数型:表示图片起点水平偏移视频顶点的像素值,单位px。取值范围:[0,4096] 小数型:表示图片起点相对于视频分辨率宽的水平偏移比率。取值范围:(0,1),支持4位小数,如0.9999,超出部分系统自动丢弃。 dy 否 String 水印图片相对输出视频的垂直偏移量,默认值是0。 设置方法有两种,建议小数型,整数型可能导致控制台图片无法预览,但不影响转码: 整数型:表示图片起点垂直偏移视频顶点的像素值,单位px。取值范围:[0,4096] 小数型:表示图片起点相对于视频分辨率高的垂直偏移比率。取值范围:(0,1),支持4位小数,如0.9999,超出部分系统自动丢弃。 position 否 String 水印的位置,默认TOPRIGHT。 目前包括: TOPRIGHT:右上位置 TOPLEFT:左上位置 BOTTOMRIGHT:右下位置 BOTTOMLEFT:左下位置 width 否 String 水印图片宽,建议小数型,整数型可能导致控制台图片无法预览,但不影响转码。 值有两种形式: 整数型代水印图片宽的像素值,范围[8,4096],单位px。 小数型代表相对输出视频分辨率宽的比率,范围(0,1),支持4位小数,如0.9999,超出部分系统自动丢弃。 height 否 String 水印图片高,建议小数型,整数型可能导致控制台图片无法预览,但不影响转码。 值有两种形式: 整数型代表水印图片高的像素值,范围[8,4096],单位px。 小数型代表相对输出视频分辨率高的比率,范围(0,1),支持4位小数,如0.9999,超出部分系统自动丢弃。 timeline_start 否 String 水印开始时间,与"timeline_duration"配合使用。 取值范围:[0, END)。"END"表示视频结束时间。 单位:秒。 timeline_duration 否 String 水印持续时间,与"timeline_start"配合使用。 取值范围:(0,END-开始时间]。"END"表示视频结束时间。 单位:秒。 默认:END。 type 是 String 仅支持png、jpg和jpeg格式的图片作为水印模板,传值仅支持JPG、JPEG和PNG三种字符串。 md5 否 String 水印图片MD5值。
  • 响应示例 状态码: 200 处理成功返回 { "id" : "a52ba84366abebb4c4614e1b16973549", "upload_url" : "https://vod-bucket-26-cn-north-4.obs.cn-north-4.myhuaweicloud.com:443/05ab5cef408026f22f62c018de60cf2e/a52ba84366abebb4c4614e1b16973549/watermark.png?AWSAccessKeyId=MZH0LUL329N1SSXNB3S4&Expires=1625479312&Signature=eF9ERWN5QwuZFUfPdoddHW64Vro%3D" } 状态码: 400 处理失败返回 { "error_code" : "VOD.10053", "error_msg" : "The request parameter is illegal, illegal field: {xx}." }
  • 请求示例 创建转码模板 POST https://{endpoint}/v2/{project_id}/asset/template/transcodings Content-Type: application/json { "name": "trans_template_test", "is_default": true, "is_auto_encrypt": false, "quality_info_list": [ { "video": { "width": 1280, "height": 720, "bitrate": 1000, "quality": "HD", "frame_rate": 0 }, "audio": { "sample_rate": "AUDIO_SAMPLE_AUTO", "channels": "AUDIO_CHANNELS_1", "bitrate": 0 } } ], "watermark_template_ids": [], "common": { "pvc": false, "video_codec": "H264", "audio_codec": "AAC", "format": "HLS", "hls_interval": 5 } }
  • 请求参数 表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参数 参数 是否必选 参数类型 描述 name 是 String 模板组名称 is_default 否 Boolean 是否设置成默认转码模板,默认false不设置为默认 is_auto_encrypt 否 Boolean 配置是否加密输出音视频,默认false不加密。 当前只支持加密输出HLS格式的音视频流,不会对原始上传的音视频进行加密处理。非HLS转码输出的音视频格式,此字段不可配置。开启此配置前,请参考《VOD用户指南》的“HLS加密设置”章节获取密钥URL。 quality_info_list 是 Array of QualityInfoList objects 画质配置信息列表 common 是 CommonInfo object 高清低码开关,编码格式多路共同参数 watermark_template_ids 否 Array of strings 绑定的水印模板组ID数组 description 否 String 模板介绍 表4 QualityInfoList 参数 是否必选 参数类型 描述 video 否 VideoInfo object 模板视频信息。video和audio至少配置一个参数。 audio 否 AudioInfo object 模板音频信息 表5 VideoInfo 参数 是否必选 参数类型 描述 quality 是 String 画质 4K默认分辨率3840*2160,码率8000kbit/s 2K默认分辨率2560*1440,码率7000kbit/s FULL_HD默认分辨率1920*1080,码率3000kbit/s HD默认分辨率1280*720,码率1000kbit/s SD默认分辨率854*480,码率600kbit/s FLUENT默认分辨率480*270,码率300kbit/s width 否 Integer 视频宽度 height 否 Integer 视频高度 bitrate 是 Integer 码率,单位:kbit/s frame_rate 是 Integer 帧率,单位是帧每秒。 取值范围:0或[5,60]之间的整数。 默认为0,0代表自适应。 表6 AudioInfo 参数 是否必选 参数类型 描述 sample_rate 是 String 音频采样率(有效值范围) AUDIO_SAMPLE_AUTO (default), AUDIO_SAMPLE_22050:22050Hz AUDIO_SAMPLE_32000:32000Hz AUDIO_SAMPLE_44100:44100Hz AUDIO_SAMPLE_48000:48000Hz AUDIO_SAMPLE_96000:96000Hz bitrate 否 Integer 音频码率(单位:Kbps) channels 是 String 声道数(有效值范围) AUDIO_CHANNELS_1:单声道 AUDIO_CHANNELS_2:双声道 AUDIO_CHANNELS_5_1:5.1声道 表7 CommonInfo 参数 是否必选 参数类型 描述 pvc 是 Boolean 高清低码开关 video_codec 是 String 视频编码格式 audio_codec 否 String 音频编码格式 AAC:AAC格式 (default) HEAAC1:HEAAC1格式 HEAAC2:HEAAC2格式 MP3:MP3格式 is_black_cut 否 Boolean 黑边剪裁类型,默认false不开启黑边剪裁 format 是 String 格式 hls_interval 是 Integer 分片时长,范围2-10(默认为5秒) upsample 否 Boolean 开启后可以提升视频的分辨率,增加采样点的数量。 adaptation 否 String 转码后的片源分辨率自适应方式。 取值如下: SHORT:短边自适应。转码模板的宽和高都设置,用其中的短边与片源短边对比,然后片源长边按此比例进行缩放。 LONG:长边自适应。转码模板的宽和高都设置,用其中的长边与片源长边对比,然后片源短边按此比例进行缩放。 NONE:按设置宽高适应,为默认值。按照转码模板设置的宽高输出。 说明: V1接口(已废弃)不支持设置该参数,默认按SHORT处理。V2接口默认按NONE处理,V1和V2接口默认值有差异,在调用时需要注意该参数值的设置。 控制台是通过V2接口创建的转码模板,实际与V1接口创建转码模板的默认值保值一致,为SHORT。 preset 否 Integer 编码质量等级,取值[0,2] 0表示默认方式,1表示转码效率优先,2表示转码质量优先。 max_iframes_interval 否 Integer I帧最大间隔,取值范围:[2,10]。默认值:5,单位秒。 hls_audio_separate 否 Boolean 转码后音频是否独立存储。
  • 参数模板注意事项 系统提供的默认参数模板不允许修改,只可单击参数模板名称进行查看。如果出现参数设置不合理导致数据库无法启动,可参考默认参数模板重新配置。 对于某些运行参数修改,您需在实例列表中,查看实例状态,如果显示“参数模板变更,等待重启”,则需重启关联的实例使之生效。 在数据库参数模板内设置参数不恰当可能会产生意外的不利影响,包括性能降低和系统不稳定。修改数据库参数时应始终保持谨慎,且修改数据库参数模板前要备份数据。将参数模板更改应用于生产数据库实例前,您应当在测试数据库实例上试用这些参数模板设置更改。
  • 参数模板类型 创建数据库实例时可以指定数据库参数模板为默认参数模板或已有参数模板。实例创建成功后也可以变更实例关联的参数模板。 默认参数模板 默认组包含针对运行的数据库实例进行优化的引擎默认值和数据库服务系统默认值。 自定义参数模板 如果希望数据库实例以客户自定义的引擎配置值运行,可轻松地创建一个新数据库参数模板,修改所需参数并应用到数据库实例,用以使用新数据库参数模板。 数据库参数模板与实例建立关联后,如果修改了参数模板中的参数,那么使用该参数模板的所有实例,都将获得该参数模板中对应参数的更新。
  • 相关API 接口名称 调用说明 获取Token 调用该接口获取到Token,再调用其他接口时,需要在请求消息头中添加“Authorization”,其值即为Token。 获取设备列表 调用该接口获取到isdp唯一设备ID。 保存设备模板时,需要输入isdp唯一设备ID。 添加设备 调用该接口添加设备。 修改设备 调用该接口修改设备。 删除设备 调用该接口删除设备。 获取设备信息 调用该接口获取设备信息。
  • 请求参数 参数 类型 是否必填 描述 isdpDeviceIds String 是 isdp唯一设备ID集,List形式 获取isdp唯一设备ID API请参见:摄像头列表查询(好望云平台)(API名称:getDeviceList) templateId Long 是 模板编号 templateCode String 是 模板代码 templateName String 是 模板名称 templateParams String 是 模板参数集,List形式 objectId String 是 审核项编号 objectCode String 是 审核项代码 objectName String 是 审核项名称
  • 请求示例 { "isdpDeviceIds": ["21024125389SL7002176--1","21024125389SL7002178--1"], "templateId": 88888888, "templateCode":"bestDC", "templateName":"bestDC识别对象模板", "templateParams":[ { "objectId":"30", "objectCode":"helmet", "objectName":"安全帽" }, { "objectId":"31", "objectCode":"high_visible_vest", "objectName":"荧光衣" }, { "objectId":"32", "objectCode":"fire", "objectName":"火" }, { "objectId":"33", "objectCode":"smoke", "objectName":"烟" }, { "objectId":"34", "objectCode":"face", "objectName":"人脸" } ] }
  • 请求示例 修改直播转码模板,应用名称为live,转码质量为SD,转码编码格式为H264,宽为1920像素,高为1080像素。 PUT https://{endpoint}/v1/{project_id}/template/transcodings { "domain" : "play.example.com", "app_name" : "live", "quality_info" : [ { "quality" : "lsd", "hdlb" : "off", "codec" : "H264", "width" : 1920, "height" : 1080, "bitrate" : 4500, "video_frame_rate" : 20, "gop" : 4 }, { "quality" : "userdefine", "templateName" : "yourTemplateName", "hdlb" : "off", "codec" : "H264", "width" : 1920, "height" : 1080, "bitrate" : 4500, "video_frame_rate" : 20, "gop" : 4 } ] }