云服务器内容精选

  • 请求参数 表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 转码后音频是否独立存储。
  • 请求示例 创建转码模板 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 } }
  • 参数模板注意事项 系统提供的默认参数模板不允许修改,只可单击参数模板名称进行查看。如果出现参数设置不合理导致数据库无法启动,可参考默认参数模板重新配置。 对于某些运行参数修改,您需在实例列表中,查看实例状态,如果显示“参数模板变更,等待重启”,则需重启关联的实例使之生效。 在数据库参数模板内设置参数不恰当可能会产生意外的不利影响,包括性能降低和系统不稳定。修改数据库参数时应始终保持谨慎,且修改数据库参数模板前要备份数据。将参数模板更改应用于生产数据库实例前,您应当在测试数据库实例上试用这些参数模板设置更改。
  • 参数模板类型 创建数据库实例时可以指定数据库参数模板为默认参数模板或已有参数模板。实例创建成功后也可以变更实例关联的参数模板。 默认参数模板 默认组包含针对运行的数据库实例进行优化的引擎默认值和数据库服务系统默认值。 自定义参数模板 如果希望数据库实例以客户自定义的引擎配置值运行,可轻松地创建一个新数据库参数模板,修改所需参数并应用到数据库实例,用以使用新数据库参数模板。 数据库参数模板与实例建立关联后,如果修改了参数模板中的参数,那么使用该参数模板的所有实例,都将获得该参数模板中对应参数的更新。
  • 响应示例 状态码: 200 处理成功返回。 { "templates" : [ { "name" : "test", "id" : "2305739f855413a84af9e6ad6ebb21be", "status" : 0, "dx" : "0.05", "dy" : "0.05", "position" : "TOPRIGHT", "width" : "0.12", "height" : null, "create_time" : "20210204092325", "image_url" : "https://103-cn-north-4.cdn-vod.huaweicloud.com/05ab5cef408026f22f62c018de60cf2e/watermark/2305739f855413a84af9e6ad6ebb21be.png", "type" : "PNG", "watermark_type" : "IMAGE", "image_process" : "TRANSPARENT", "timeline_start" : null, "timeline_duration" : null } ], "total" : 1 } 状态码: 400 处理失败返回。 { "error_code" : "VOD.10053", "error_msg" : "The request parameter is illegal, illegal field: {xx}." }
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 templates Array of WatermarkTemplate objects 水印模板信息。 total Integer 总数。 表5 WatermarkTemplate 参数 参数类型 描述 name String 水印模板名称。 id String 水印模板配置id。 status Long 启用状态。 取值为: 0:停用 1:启用 dx String 水印图片相对输出视频的水平偏移量。 默认值是0。 dy String 水印图片相对输出视频的垂直偏移量。 默认值是0。 position String 水印的位置。 width String 水印图片宽。 height String 水印图片高。 create_time String 创建时间。 image_url String 水印图片下载url。 type String 水印图片格式类型。 watermark_type String 水印类型,当前只支持IMAGE(图片水印)。 image_process String watermark_type设置为IMAGE时有效。 目前包括: ORIGINAL:只做简单缩放,不做其他处理 TRANSPARENT:图片底色透明 GRAYED:彩色图片变灰 timeline_start String 水印开始时间,与"timeline_duration"配合使用。 取值范围:[0, END)。"END"表示视频结束时间。 单位:秒。 timeline_duration String 水印持续时间,与"timeline_start"配合使用。 取值范围:(0,END-开始时间]。"END"表示视频结束时间。 单位:秒。 默认:END。 状态码: 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。
  • 请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token,使用Token鉴权方式时必选。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 Authorization 否 String 使用AK/SK方式认证时必选,携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选,请求的发生时间。
  • URI GET /v1.0/{project_id}/template/watermark 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目ID 表2 Query参数 参数 是否必选 参数类型 描述 id 否 Array of strings 水印模板配置id,一次最多10个。 page 否 Integer 分页编号。 默认为0。指定id时该参数无效。 size 否 Integer 每页记录数。 默认为10,范围[1,100]。指定id时该参数无效。
  • 请求示例 删除模板 DELETE https://{endpoint}/v1/c364070ab35041ddae68cf8b4839b60f/templates/my_template 删除模板,并提供模板id以校验是否与当前模板匹配 DELETE https://{endpoint}/v1/c364070ab35041ddae68cf8b4839b60f/templates/my_template?template_id=1b15e005-bdbb-4bd7-8f9a-a09b6774b4b3
  • 响应参数 状态码: 400 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 encoded_authorization_message String 包含有关未经授权请求的信息。 details Array of Detail objects 权限拒绝时服务返回的详细错误信息。 表5 Detail 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息 状态码: 401 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 encoded_authorization_message String 包含有关未经授权请求的信息。 details Array of Detail objects 权限拒绝时服务返回的详细错误信息。 表7 Detail 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息 状态码: 403 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 encoded_authorization_message String 包含有关未经授权请求的信息。 details Array of Detail objects 权限拒绝时服务返回的详细错误信息。 表9 Detail 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息 状态码: 404 表10 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 encoded_authorization_message String 包含有关未经授权请求的信息。 details Array of Detail objects 权限拒绝时服务返回的详细错误信息。 表11 Detail 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息 状态码: 429 表12 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 encoded_authorization_message String 包含有关未经授权请求的信息。 details Array of Detail objects 权限拒绝时服务返回的详细错误信息。 表13 Detail 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息 状态码: 500 表14 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 encoded_authorization_message String 包含有关未经授权请求的信息。 details Array of Detail objects 权限拒绝时服务返回的详细错误信息。 表15 Detail 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息
  • URI DELETE /v1/{project_id}/templates/{template_name} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,可以从调用API处获取,也可以从控制台获取。 项目ID获取方式 最小长度:3 最大长度:64 template_name 是 String 用户希望创建的模板名称 最小长度:1 最大长度:128 表2 Query参数 参数 是否必选 参数类型 描述 template_id 否 String 模板的ID。当template_id存在时,模板服务会检查template_id是否和template_name匹配,不匹配会返回400 最小长度:36 最大长度:36
  • 功能介绍 删除模板(DeleteTemplate) 此API用于删除某个模板以及模板下的全部模板版本 请谨慎操作,删除模板将会删除模板下的所有模板版本。 template_id是模板的唯一Id。此Id由 资源编排 服务在生成模板的时候生成,为UUID。由于模板名仅仅在同一时间下唯一,即用户允许先生成一个叫HelloWorld的模板,删除,再重新创建一个同名模板。对于团队并行开发,用户可能希望确保,当前我操作的模板就是我认为的那个,而不是其他队友删除后创建的同名模板。因此,使用ID就可以做到强匹配。资源编排服务保证每次创建的模板所对应的ID都不相同,更新不会影响ID。如果给予的template_id和当前模板管理的ID不一致,则返回400
  • 操作场景 导出实例的参数: 您可以将数据库实例参数列表,导出并生成一个新的参数模板,供您后期使用。请参考应用参数模板将导出的参数模板应用到新的实例。如果实例修改过规格参数,导出的参数模板中也会带有规格参数。规格参数的说明,可以参考相关参数说明。 您可以将数据库实例参数列表(参数名称,值,描述)导出到 CS V中,方便查看并分析。 导出系统参数模板和自定义参数模板: 您可以将RDS for MySQL参数模板(参数名称,值,描述)导出到CSV中,方便查看并分析。
  • 操作场景 您可以复制您创建的自定义数据库参数模板。当您已创建一个数据库参数模板,并且想在新的数据库参数模板中包含该组中的大部分自定义参数和值时,复制参数模板是一个方便的解决方案。您还可以导出某数据库实例应用的参数列表,生成一个新的参数模板,供您后期使用。 复制数据库参数模板之后,新参数模板可能不会立即显示,建议您等待5分钟再使用。 您无法复制默认参数模板。不过,您可以创建基于默认参数模板的新参数模板。
  • 注意事项 您可以修改用户创建的数据库参数模板中的参数值,但不能更改默认数据库参数模板中的参数值。 在配置数据库参数模板中的参数时需要注意以下几点: 当您修改当前实例的参数模板并保存后,仅应用于当前实例,不会对其他实例造成影响。 如果您单击实例名称,在“参数修改”页面修改当前实例的参数模板,更改动态参数并保存数据库参数模板时,系统将立即应用更改,而不管“应用”设置如何。当您更改静态参数并保存数据库参数模板时,参数更改将在您手动重启该数据库实例后生效。 当您在“参数管理”页面,修改自定义参数模板时,需执行“应用”操作,才会对实例生效。当您更改静态参数并保存数据库参数模板时,参数更改将在您应用到实例后,手动重启与数据库参数模板关联的数据库实例后生效。应用参数模板到数据库实例,请参见应用参数模板。 在数据库参数模板内设置参数不恰当可能会产生意外的不利影响,包括性能降低和系统不稳定。修改数据库参数时应始终保持谨慎,且修改数据库参数模板前要备份数据。将参数模板更改应用于生产数据库实例前,您应当在测试数据库实例上试用这些参数模板设置更改。 全局参数必须通过控制台修改,会话级参数可通过SQL修改。如果您更改一个参数值,则所做更改的应用时间将由该参数的类型决定。 云数据库RDS服务的管理控制台显示与数据库参数模板关联的数据库实例状态。例如,如果数据库实例未使用对其关联的数据库参数模板所做的最新更改,则云数据库RDS服务的管理控制台将显示状态为“等待重启”的数据库实例。您将需要手动重启数据库实例,以使最新的参数更改对该数据库实例生效。 系统提供的默认参数模板不允许修改,只可单击参数模板名进行查看。当用户参数设置不合理导致数据库无法启动时,可参考默认参数模板重新配置。