华为云用户手册

  • 响应示例 状态码: 201 Demo Information { "result_code" : "LIVE.100000000", "result_msg" : "SUC CES S", "domain" : "push.testott.hls.com", "app_name" : "ott", "id" : "test", "sources" : [ { "url" : "rtmp://push.testott.hls.com/ott/test_1024?request_source=ott&channel_id=test", "bitrate" : 1024, "width" : 100, "height" : 100 } ] } 状态码: 400 Error response { "result_code" : "LIVE.100011001", "result_msg" : "output url pull.testott.hls.com/ott/test/index.m3u8 is exist", "domain" : "push.testott.hls.com", "app_name" : "ott", "id" : "test" }
  • 请求示例 POST https://{endpoint}/v1/{project_id}/ott/channels { "domain" : "push.testott.hls.com", "app_name" : "ott", "id" : "test", "name" : "testname", "input" : { "input_protocol" : "FLV_PULL", "sources" : [ { "url" : "http://192.168.0.1/ott/test.flv?vhost=pull.testott.hls.com", "bitrate" : 1024, "width" : 100, "height" : 100 } ], "failover_conditions" : { "input_loss_threshold_msec" : 100, "input_preference" : "EQUAL" } }, "record_settings" : { "rollingbuffer_duration" : 86400 }, "endpoints" : [ { "hls_package" : [ { "url" : "pull.testott.hls.com/ott/test/index.m3u8", "stream_selection" : [ { "key" : "sss", "max_bandwidth" : 100, "min_bandwidth" : 100 } ], "hls_version" : "1", "segment_duration_seconds" : 4, "playlist_window_seconds" : 3600 } ], "dash_package" : [ { "url" : "pull.testott.hls.com/ott/test/index.mpd", "stream_selection" : [ { "key" : "bitrate=900000-1800000", "max_bandwidth" : 1800000, "min_bandwidth" : 900000 } ], "segment_duration_seconds" : 4, "playlist_window_seconds" : 3600 } ], "mss_package" : [ { "url" : "pull.testott.hls.com/ott/channel/manifest", "stream_selection" : [ { "key" : "bitrate=900000-1800000", "max_bandwidth" : 1800000, "min_bandwidth" : 900000 } ], "segment_duration_seconds" : 4, "playlist_window_seconds" : 3600 } ] } ], "state" : "OFF" }
  • 响应参数 状态码: 201 表27 响应Body参数 参数 参数类型 描述 result_code String 错误码 result_msg String 错误描述 domain String 推流 域名 app_name String 组名或应用名,为必填项 id String 频道ID。频道唯一标识,为必填项 sources Array of SourceRsp objects 推流URL列表。创建频道时,只有入流协议为RTMP_PUSH时,会返回推流URL列表 表28 SourceRsp 参数 参数类型 描述 url String RTMP推流地址 bitrate Integer 码率。 单位:bps。取值范围:(0,104,857,600](100Mbps) width Integer 分辨率对应宽的值。取值范围:0 - 4096(4K) height Integer 分辨率对应高的值。取值范围:0 - 2160(4K) enable_snapshot Boolean 描述是否使用该流做截图 状态码: 400 表29 响应Body参数 参数 参数类型 描述 result_code String 错误码 result_msg String 错误描述 domain String 推流域名 app_name String 组名或应用名,为必填项 id String 频道ID。频道唯一标识,为必填项
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token,使用Token鉴权方式时必选。通过调用 IAM 服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 Access-Control-Allow-Internal 否 String 服务鉴权Token,服务开启鉴权,必须携带Access-Control-Allow-Internal访问服务。 Access-Control-Allow-External 否 String 服务鉴权Token,服务开启鉴权,必须携带Access-Control-Allow-External访问服务。 表3 请求Body参数 参数 是否必选 参数类型 描述 domain 是 String 频道推流域名 app_name 是 String 组名或应用名 id 是 String 频道ID。频道唯一标识,为必填项。 name 否 String 频道名。可选配置 state 是 String 频道状态 ON:频道下发成功后,自动启动拉流、转码、录制等功能 OFF:仅保存频道信息,不启动频道 input 是 InputStreamInfo object 频道入流信息 encoder_settings 否 Array of encoder_settings objects 转码模板配置 record_settings 是 record_settings object 回看录制的配置信息。 endpoints 是 Array of EndpointItem objects 频道出流信息 encoder_settings_expand 否 EncoderSettingsExpand object 音频输出配置 表4 InputStreamInfo 参数 是否必选 参数类型 描述 input_protocol 是 String 频道入流协议 FLV_PULL RTMP_PUSH HLS_PULL SRT_PULL SRT_PUSH sources 否 Array of SourcesInfo objects 频道主源流信息。入流协议为RTMP_PUSH和SRT_PUSH时,非必填项。其他情况下,均为必填项。 secondary_sources 否 Array of SecondarySourcesInfo objects 备入流数组,非必填项。如果有备入流,则主备入流必须保证路数、codec和分辨率均一致。入流协议为RTMP_PUSH时,无需填写。 failover_conditions 否 FailoverConditions object 非必填,频道供应商提供的主备音视频流URL切换的配置。 max_bandwidth_limit 否 Integer 当入流协议为HLS_PULL时,需要配置的最大带宽。 用户提供的拉流URL中,针对不同码率的音视频,均会携带带宽参数“BANDW IDT H”。 如果这里配置最大带宽,媒体直播服务从URL拉流时,会选择小于最大带宽且码率最大的音视频流,推流到源站。 如果这里未配置最大带宽,媒体直播服务从URL拉流时,会默认选择“BANDWIDTH”最高的音视频流,推流到源站。 ip_port_mode 否 Boolean 当推流协议为SRT_PUSH时,如果配置了直推源站,编码器不支持输入streamid,需要打开设置为true ip_whitelist 否 String SRT_PUSH类型时,客户push ip白名单 scte35_source 否 String 广告的scte35信号源。 仅HLS_PULL类型的频道支持此配置,且目前仅支持SEGMENTS。 ad_triggers 否 Array of strings 广告触发器配置。 包含如下取值: Splice insert:拼接插入 Provider advertisement:提供商广告 Distributor advertisement:分销商广告 Provider placement opportunity:提供商置放机会 Distributor placement opportunity:分销商置放机会 audio_selectors 否 Array of InputAudioSelector objects 设置音频选择器,最多设置8个音频选择器 表5 SourcesInfo 参数 是否必选 参数类型 描述 url 否 String 频道源流URL,用于外部拉流 bitrate 否 Integer 码率。无需直播转码时,此参数为必填项 单位:bps。取值范围:(0,104,857,600](100Mbps) width 否 Integer 分辨率对应宽的值,非必填项 取值范围:0 - 4096(4K) height 否 Integer 分辨率对应高的值,非必填项 取值范围:0 - 2160(4K) enable_snapshot 否 Boolean 描述是否使用该流做截图 bitrate_for3u8 否 Boolean 是否使用bitrate来固定码率。默认值:false passphrase 否 String 协议为SRT_PUSH时的加密信息 backup_urls 否 Array of strings 备入流地址列表 stream_id 否 String 频道为SRT_PULL类型时,拉流地址的Stream ID。 latency 否 Integer 频道为SRT_PULL类型时的拉流时延。 表6 SecondarySourcesInfo 参数 是否必选 参数类型 描述 url 否 String 频道源流URL,用于外部拉流 bitrate 否 Integer 码率。无需直播转码时,此参数为必填项 单位:bps。取值范围:(0,104,857,600](100Mbps) width 否 Integer 分辨率对应宽的值,非必填项 取值范围:0 - 4096(4K) height 否 Integer 分辨率对应高的值,非必填项 取值范围:0 - 2160(4K) bitrate_for3u8 否 Boolean 是否使用bitrate来固定码率。默认值:false passphrase 否 String 协议为SRT_PUSH时的加密信息 backup_urls 否 Array of strings 备入流地址列表 stream_id 否 String 频道为SRT_PULL类型时,拉流地址的Stream ID。 latency 否 Integer 频道为SRT_PULL类型时的拉流时延。 表7 FailoverConditions 参数 是否必选 参数类型 描述 input_loss_threshold_msec 否 Integer 入流停止的时长阈值。到达此阈值后,自动触发主备切换。 单位:毫秒,取值范围:0 - 3600000。 非必填,默认填2000ms。 input_preference 否 String 以主入流URL为第一优先级(PRIMARY)或主备URL平等切换(EQUAL)。 如果是平等切换时,使用的是备URL,不会自动切换至主URL。 非必填,默认值为EQUAL。 表8 InputAudioSelector 参数 是否必选 参数类型 描述 name 是 String 音频选择器的名称。仅支持大小写字母、数字、中划线和下划线。 同一个频道中每个选择器的名称需要唯一。 selector_settings 否 AudioSelectorSettings object 设置音频选择器 表9 AudioSelectorSettings 参数 是否必选 参数类型 描述 audio_language_selection 否 AudioSelectorLangSelection object 设置语言选择器 audio_pid_selection 否 AudioSelectorPidSelection object 设置PID选择器 表10 AudioSelectorLangSelection 参数 是否必选 参数类型 描述 language_code 是 String 语言简称,输入2或3个小写字母的语言代码。 language_selection_policy 否 String 语言输出策略。 取值如下: LOOSE:宽松匹配,示例“eng”会优先匹配源流中语言为English的音轨,如果匹配不到,则选择PID最小的音轨。 STRICT:严格匹配,示例“eng”会严格匹配源流中语言为English的音轨,如果匹配不到,媒体直播服务会自动补齐一个静音分片,当终端使用此音频选择器播放视频时,会静音播放。 表11 AudioSelectorPidSelection 参数 是否必选 参数类型 描述 pid 是 Integer 设置PID的值 表12 encoder_settings 参数 是否必选 参数类型 描述 template_id 否 String 转码模板ID 表13 record_settings 参数 是否必选 参数类型 描述 rollingbuffer_duration 是 Integer 最大回看录制时长。在此时间段内会连续不断的录制,为必选项 单位:秒。取值为“0”时,表示不支持录制;最大支持录制14天 表14 EndpointItem 参数 是否必选 参数类型 描述 hls_package 否 Array of HlsPackageItem objects HLS打包信息 dash_package 否 Array of DashPackageItem objects DASH打包信息 mss_package 否 Array of MssPackageItem objects MSS打包信息 表15 HlsPackageItem 参数 是否必选 参数类型 描述 url 是 String 客户自定义的拉流地址,包括方法、域名、路径 stream_selection 否 Array of StreamSelectionItem objects 从全量流中过滤出一个码率在[min, max]区间的流。如果不需要码率过滤可不选。 hls_version 否 String HLS版本号 segment_duration_seconds 是 Integer 频道输出分片的时长,为必选项 单位:秒。取值范围:1-10 说明: 修改分片时长会影响已录制内容的时移和回看服务,请谨慎修改! playlist_window_seconds 否 Integer 频道直播返回分片的窗口长度,为频道输出分片的时长乘以数量后得到的值。实际返回的分片数不小于3个。 单位:秒。取值范围:0 - 86400(24小时转化成秒后的取值) encryption 否 Encryption object 加密信息 ads 否 Object 广告配置 ext_args 否 Object 其他额外参数 request_args 否 PackageRequestArgs object 播放相关配置 ad_marker 否 Array of strings 广告标识。 HLS取值:["ENHANCED_SCTE35"]。 表16 DashPackageItem 参数 是否必选 参数类型 描述 url 是 String 客户自定义的拉流地址,包括方法、域名、路径 stream_selection 否 Array of StreamSelectionItem objects 从全量流中过滤出一个码率在[min, max]区间的流。如果不需要码率过滤可不选。 segment_duration_seconds 是 Integer 频道输出分片的时长,为必选项 单位:秒。取值范围:1-10 说明: 修改分片时长会影响已录制内容的时移和回看服务,请谨慎修改! playlist_window_seconds 否 Integer 频道直播返回分片的窗口长度,为频道输出分片的时长乘以数量后得到的值。实际返回的分片数不小于3个。 单位:秒。取值范围:0 - 86400(24小时转化成秒后的取值) encryption 否 Encryption object 加密信息 ads 否 Object 广告配置 ext_args 否 Object 其他额外参数 request_args 否 PackageRequestArgs object 播放相关配置 ad_marker 否 String 广告标识。 DASH取值:"xml+bin"。 表17 MssPackageItem 参数 是否必选 参数类型 描述 url 是 String 客户自定义的拉流地址,包括方法、域名、路径 stream_selection 否 Array of StreamSelectionItem objects 从全量流中过滤出一个码率在[min, max]区间的流。如果不需要码率过滤可不选。 segment_duration_seconds 是 Integer 频道输出分片的时长,为必选项 单位:秒。取值范围:1-10 说明: 修改分片时长会影响已录制内容的时移和回看服务,请谨慎修改! playlist_window_seconds 否 Integer 频道直播返回分片的窗口长度,为频道输出分片的时长乘以数量后得到的值。实际返回的分片数不小于3个。 单位:秒。取值范围:0 - 86400(24小时转化成秒后的取值) encryption 否 Encryption object 加密信息 ext_args 否 Object 其他额外参数 delay_segment 否 Integer 延播时长,单位秒 request_args 否 PackageRequestArgs object 播放相关配置 表18 StreamSelectionItem 参数 是否必选 参数类型 描述 key 否 String 拉流URL中用于码率过滤的参数 max_bandwidth 否 Integer 最大码率,单位:bps 取值范围:0 - 104,857,600(100Mbps) min_bandwidth 否 Integer 最小码率,单位:bps 取值范围:0 - 104,857,600(100Mbps) 表19 Encryption 参数 是否必选 参数类型 描述 key_rotation_interval_seconds 否 Integer 密钥缓存时间。如果密钥不变,默认缓存七天。 请注意:目前为保留字段,不支持配置。 encryption_method 否 String 加密方式。 请注意:目前为保留字段,不支持配置。 level 否 String 取值如下: content:一个频道对应一个密钥 profile:一个码率对应一个密钥 默认值:content resource_id 是 String 客户生成的DRM内容ID system_ids 是 Array of strings system_id枚举值。 取值如下: HLS:FairPlay DASH:Widevine、PlayReady MSS:PlayReady url 是 String 获取密钥的DRM地址 speke_version 是 String drm speke 版本号 当前只支持1.0 request_mode 是 String 请求模式。 取值如下: direct_http:HTTP(S)直接访问DRM。 functiongraph_proxy:FunctionGraph代理访问DRM。 http_headers 否 Array of HttpHeader objects 需要添加在drm请求头中的鉴权信息。最多支持配置5个。 仅direct_http请求模式支持配置http_headers。 urn 否 String functiongraph_proxy请求模式需要提供functiongraph的urn。 表20 HttpHeader 参数 是否必选 参数类型 描述 key 是 String 请求头中key字段名 value 是 String 请求头中key对应的value值 表21 PackageRequestArgs 参数 是否必选 参数类型 描述 record 否 Array of RecordRequestArgs objects 录制播放相关配置 timeshift 否 Array of TimeshiftRequestArgs objects 时移播放相关配置 live 否 Array of LiveRequestArgs objects 直播播放相关配置 表22 RecordRequestArgs 参数 是否必选 参数类型 描述 start_time 否 String 开始时间 end_time 否 String 结束时间 format 否 String 格式 unit 否 String 单位 表23 TimeshiftRequestArgs 参数 是否必选 参数类型 描述 back_time 否 String 时移时长字段名 unit 否 String 单位 表24 LiveRequestArgs 参数 是否必选 参数类型 描述 delay 否 String 时延字段 unit 否 String 单位 表25 EncoderSettingsExpand 参数 是否必选 参数类型 描述 audio_descriptions 否 Array of audio_descriptions objects 音频输出配置的描述信息 表26 audio_descriptions 参数 是否必选 参数类型 描述 name 是 String 音频输出配置的名称。仅支持大小写字母,数字,中划线(-),下划线(_)。 同一个频道不同的音频输出配置名称,不允许重复。 audio_selector_name 是 String 音频选择器名称 language_code_control 否 String 语言代码控制。这里的设置不会修改音频实际的语言,只会修改音频对外展示的语言。 包含如下选项: FOLLOW_INPUT:如果所选音频选择器对应的输出音频有语言,则与其保持一致,否则会以这里配置的语言代码和流名称进行兜底。推荐当前选项,为默认值。 USE_CONFIGURED:用户根据实际情况自定义输出音频的语言和流名称。 language_code 否 String 语言代码,输入2或3个小写字母。 stream_name 否 String 流名称
  • 错误码 当您调用API时,如果遇到“APIGW”开头的错误码,请参见API网关错误码进行处理。 状态码 错误码 错误信息 描述 处理措施 400 LIVE.100011001 Invalid request parameter. 请求参数非法。 可能缺少必要参数,或者参数值格式不正确,具体错误信息请查看错误描述 error_detail 字段。 400 LIVE.100011004 The protocol is not supported. The API only supports the HTTPS protocol. 协议不支持,当前API仅支持https协议,不支持http协议 请使用https协议 400 LIVE.100011006 This API is not supported in this version or is in the maintenance state. 本版本内不支持此接口或该接口处于维护状态 请稍后重试或者联系客服人员帮忙解决 400 LIVE.100011008 The API is in the maintenance state. 当前接口处于停服维护状态 请稍后重试,或提交工单,申请技术客服协助解决问题 400 LIVE.100011009 The requested user does not exist. 请求用户不存在 请确认用户的输入信息是否正确 400 LIVE.100011011 The method specified in the request is not supported. 处理禁用请求中指定的方法 确认请求的http方法是否正确 400 LIVE.100011012 Unsupported media type. 不支持的媒体类型异常 提交工单,申请技术客服协助解决问题 400 LIVE.100011013 You have not completed real-name authentication. 用户没有实名认证 请先进行实名认证 400 LIVE.100011022 LIVE.Record task exist. 录制任务已存在 停止录制命令下发之后,再次对相同流下发开始录制命令,必须间隔10秒以上。 400 LIVE.103011018 The resource already exists. 资源已存在 确认要操作的资源是否已经存在 400 LIVE.103011020 The maximum number of domain names has been reached. 域名数量超过配额 超过租户最大域名添加上限,删除不必要的域名再添加;如确有必要超额添加,请提交工单申请技术客服审核 400 LIVE.103011021 Failed to access the database. 访问DB失败 提交工单,申请技术客服协助解决问题 400 LIVE.103011022 This operation is not allowed in the current state. 当前域名的状态不支持此操作 确认域名当前状态:非停用状态不可修改、删除 400 LIVE.103011024 The ICP number does not exist. 域名对应的ICP编号不存在 请检查ICP编号是否正确 400 LIVE.103011025 The approved ICP number cannot be modified. 审核通过的许可证号不允许修改 ICP编号在首次添加审核通过后不允许修改,如有修改必要请提交工单,申请技术客服协助解决问题 400 LIVE.103011026 The domain name is in the blacklist. 域名在黑名单网站中 更换合法注册的域名进行操作 400 LIVE.103011027 The domain name is in the blacklist. 域名在非法接入黑名单中 更换合法注册的域名进行操作 400 LIVE.103011029 The domain name is in gray configuration. 此域名存在灰度配置,配置下发失败 提交工单,申请技术客服协助解决问题 400 LIVE.103011030 This domain name has customized configuration. 此域名存在定制化配置,配置下发失败 提交工单,申请技术客服协助解决问题 401 LIVE.100011002 Identity authentication failed. 身份认证失败。 一般是由于签名计算错误导致的,请参考文档中签名方法部分。 401 LIVE.100011003 You do not have permission to access the API. 未授权访问接口 请联系主账号管理员开通接口权限 401 LIVE.100011014 Your account is not allowed to access the service, because it is frozen, deleted, or has insufficient balance. 用户当前状态不允许访问,比如冻结、删除、余额不足。 华为云账户异常,请确认是否处于欠费冻结或停用状态 401 LIVE.100011015 Project ID verification failed. projectID校验失败 确认请求中的项目ID及请求头部 403 LIVE.103011016 Invalid request content. 请求内容非法 请求参数不合规范 404 LIVE.103011019 The resource does not exist. 资源不存在 确认要操作的资源是否存在或租户账号信息是否正确 500 LIVE.100011000 Internal communication error. 内部服务器通信异常 提交工单,申请技术客服协助解决问题 500 LIVE.100011005 Internal server error. 服务器内部出现错误 请稍后重试或者联系客服人员帮忙解决 500 LIVE.100011007 The number of concurrent API requests exceeds the upper limit. 接口请求超过并发限制 提交工单,申请技术客服协助解决问题 500 LIVE.103011017 Failed to synchronize data to CDN. 同步数据到CDN失败 确认域名是否已经备案并向有关部门申请取得许可;如果确认域名合法依然失败,请提交工单,申请技术客服协助解决问题 500 LIVE.103011023 Failed to synchronize the domain name to GSLB. 同步域名到GSLB失败 提交工单,申请技术客服协助解决问题 500 LIVE.103011028 Failed to synchronize the domain name to DNS. 同步域名到DNS失败 提交工单,申请技术客服协助解决问题 父主题: 附录
  • 响应示例 状态码: 200 Demo Information { "total" : 1, "channels" : [ { "domain" : "push.testott.hls.com", "app_name" : "ott", "id" : "test", "name" : "testname", "input" : { "input_protocol" : "RTMP_PUSH", "sources" : [ { "url" : "rtmp://push.testott.hls.com/ott/test_1024?request_source=ott&channel_id=test", "bitrate" : 1024, "width" : 100, "height" : 100 } ], "failover_conditions" : { "input_loss_threshold_msec" : 100, "input_preference" : "EQUAL" } }, "record_settings" : { "rollingbuffer_duration" : 86400 }, "endpoints" : [ { "hls_package" : [ { "url" : "pull.testott.hls.com/ott/test/index.m3u8", "stream_selection" : [ { "key" : "sss", "max_bandwidth" : 0, "min_bandwidth" : 0 } ], "segment_duration_seconds" : 4, "playlist_window_seconds" : 3600, "request_args" : { "record" : [ { "start_time" : "begin", "end_time" : "end", "format" : "timestamp", "unit" : "second" } ], "timeshift" : [ { "back_time" : "begin", "unit" : "second" } ], "live" : null }, "hls_version" : "1" } ], "dash_package" : [ { "url" : "pull.testott.hls.com/ott/test/index.mpd", "stream_selection" : [ { "key" : "bitrate=900000-1800000", "max_bandwidth" : 1800000, "min_bandwidth" : 900000 } ], "segment_duration_seconds" : 4, "playlist_window_seconds" : 3600, "request_args" : { "record" : [ { "start_time" : "begin", "end_time" : "end", "format" : "timestamp", "unit" : "second" } ], "timeshift" : [ { "back_time" : "begin", "unit" : "second" } ], "live" : null } } ], "mss_package" : [ { "url" : "pull.testott.hls.com/ott/channel/manifest", "stream_selection" : [ { "key" : "bitrate=900000-1800000", "max_bandwidth" : 1800000, "min_bandwidth" : 900000 } ], "segment_duration_seconds" : 4, "playlist_window_seconds" : 3600, "request_args" : { "record" : [ { "start_time" : "begin", "end_time" : "end", "format" : "timestamp", "unit" : "second" } ], "timeshift" : [ { "back_time" : "begin", "unit" : "second" } ], "live" : null } } ] } ], "state" : "OFF" } ] } 状态码: 400 Error response { "result_code" : "LIVE.103011019", "result_msg" : "The resource to access is not exists", "domain" : "push.testott.hls.com", "app_name" : "ott", "id" : "agbc" }
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 total Integer 总频道数 channels Array of CreateOttChannelInfoReq objects 频道信息 表5 CreateOttChannelInfoReq 参数 参数类型 描述 domain String 频道推流域名 app_name String 组名或应用名 id String 频道ID。频道唯一标识,为必填项。 name String 频道名。可选配置 state String 频道状态 ON:频道下发成功后,自动启动拉流、转码、录制等功能 OFF:仅保存频道信息,不启动频道 input InputStreamInfo object 频道入流信息 encoder_settings Array of encoder_settings objects 转码模板配置 record_settings record_settings object 回看录制的配置信息。 endpoints Array of EndpointItem objects 频道出流信息 encoder_settings_expand EncoderSettingsExpand object 音频输出配置 表6 InputStreamInfo 参数 参数类型 描述 input_protocol String 频道入流协议 FLV_PULL RTMP_PUSH HLS_PULL SRT_PULL SRT_PUSH sources Array of SourcesInfo objects 频道主源流信息。入流协议为RTMP_PUSH和SRT_PUSH时,非必填项。其他情况下,均为必填项。 secondary_sources Array of SecondarySourcesInfo objects 备入流数组,非必填项。如果有备入流,则主备入流必须保证路数、codec和分辨率均一致。入流协议为RTMP_PUSH时,无需填写。 failover_conditions FailoverConditions object 非必填,频道供应商提供的主备音视频流URL切换的配置。 max_bandwidth_limit Integer 当入流协议为HLS_PULL时,需要配置的最大带宽。 用户提供的拉流URL中,针对不同码率的音视频,均会携带带宽参数“BANDWIDTH”。 如果这里配置最大带宽,媒体直播服务从URL拉流时,会选择小于最大带宽且码率最大的音视频流,推流到源站。 如果这里未配置最大带宽,媒体直播服务从URL拉流时,会默认选择“BANDWIDTH”最高的音视频流,推流到源站。 ip_port_mode Boolean 当推流协议为SRT_PUSH时,如果配置了直推源站,编码器不支持输入streamid,需要打开设置为true ip_whitelist String SRT_PUSH类型时,客户push ip白名单 scte35_source String 广告的scte35信号源。 仅HLS_PULL类型的频道支持此配置,且目前仅支持SEGMENTS。 ad_triggers Array of strings 广告触发器配置。 包含如下取值: Splice insert:拼接插入 Provider advertisement:提供商广告 Distributor advertisement:分销商广告 Provider placement opportunity:提供商置放机会 Distributor placement opportunity:分销商置放机会 audio_selectors Array of InputAudioSelector objects 设置音频选择器,最多设置8个音频选择器 表7 SourcesInfo 参数 参数类型 描述 url String 频道源流URL,用于外部拉流 bitrate Integer 码率。无需直播转码时,此参数为必填项 单位:bps。取值范围:(0,104,857,600](100Mbps) width Integer 分辨率对应宽的值,非必填项 取值范围:0 - 4096(4K) height Integer 分辨率对应高的值,非必填项 取值范围:0 - 2160(4K) enable_snapshot Boolean 描述是否使用该流做截图 bitrate_for3u8 Boolean 是否使用bitrate来固定码率。默认值:false passphrase String 协议为SRT_PUSH时的加密信息 backup_urls Array of strings 备入流地址列表 stream_id String 频道为SRT_PULL类型时,拉流地址的Stream ID。 latency Integer 频道为SRT_PULL类型时的拉流时延。 表8 SecondarySourcesInfo 参数 参数类型 描述 url String 频道源流URL,用于外部拉流 bitrate Integer 码率。无需直播转码时,此参数为必填项 单位:bps。取值范围:(0,104,857,600](100Mbps) width Integer 分辨率对应宽的值,非必填项 取值范围:0 - 4096(4K) height Integer 分辨率对应高的值,非必填项 取值范围:0 - 2160(4K) bitrate_for3u8 Boolean 是否使用bitrate来固定码率。默认值:false passphrase String 协议为SRT_PUSH时的加密信息 backup_urls Array of strings 备入流地址列表 stream_id String 频道为SRT_PULL类型时,拉流地址的Stream ID。 latency Integer 频道为SRT_PULL类型时的拉流时延。 表9 FailoverConditions 参数 参数类型 描述 input_loss_threshold_msec Integer 入流停止的时长阈值。到达此阈值后,自动触发主备切换。 单位:毫秒,取值范围:0 - 3600000。 非必填,默认填2000ms。 input_preference String 以主入流URL为第一优先级(PRIMARY)或主备URL平等切换(EQUAL)。 如果是平等切换时,使用的是备URL,不会自动切换至主URL。 非必填,默认值为EQUAL。 表10 InputAudioSelector 参数 参数类型 描述 name String 音频选择器的名称。仅支持大小写字母、数字、中划线和下划线。 同一个频道中每个选择器的名称需要唯一。 selector_settings AudioSelectorSettings object 设置音频选择器 表11 AudioSelectorSettings 参数 参数类型 描述 audio_language_selection AudioSelectorLangSelection object 设置语言选择器 audio_pid_selection AudioSelectorPidSelection object 设置PID选择器 表12 AudioSelectorLangSelection 参数 参数类型 描述 language_code String 语言简称,输入2或3个小写字母的语言代码。 language_selection_policy String 语言输出策略。 取值如下: LOOSE:宽松匹配,示例“eng”会优先匹配源流中语言为English的音轨,如果匹配不到,则选择PID最小的音轨。 STRICT:严格匹配,示例“eng”会严格匹配源流中语言为English的音轨,如果匹配不到,媒体直播服务会自动补齐一个静音分片,当终端使用此音频选择器播放视频时,会静音播放。 表13 AudioSelectorPidSelection 参数 参数类型 描述 pid Integer 设置PID的值 表14 encoder_settings 参数 参数类型 描述 template_id String 转码模板ID 表15 record_settings 参数 参数类型 描述 rollingbuffer_duration Integer 最大回看录制时长。在此时间段内会连续不断的录制,为必选项 单位:秒。取值为“0”时,表示不支持录制;最大支持录制14天 表16 EndpointItem 参数 参数类型 描述 hls_package Array of HlsPackageItem objects HLS打包信息 dash_package Array of DashPackageItem objects DASH打包信息 mss_package Array of MssPackageItem objects MSS打包信息 表17 HlsPackageItem 参数 参数类型 描述 url String 客户自定义的拉流地址,包括方法、域名、路径 stream_selection Array of StreamSelectionItem objects 从全量流中过滤出一个码率在[min, max]区间的流。如果不需要码率过滤可不选。 hls_version String HLS版本号 segment_duration_seconds Integer 频道输出分片的时长,为必选项 单位:秒。取值范围:1-10 说明: 修改分片时长会影响已录制内容的时移和回看服务,请谨慎修改! playlist_window_seconds Integer 频道直播返回分片的窗口长度,为频道输出分片的时长乘以数量后得到的值。实际返回的分片数不小于3个。 单位:秒。取值范围:0 - 86400(24小时转化成秒后的取值) encryption Encryption object 加密信息 ads Object 广告配置 ext_args Object 其他额外参数 request_args PackageRequestArgs object 播放相关配置 ad_marker Array of strings 广告标识。 HLS取值:["ENHANCED_SCTE35"]。 表18 DashPackageItem 参数 参数类型 描述 url String 客户自定义的拉流地址,包括方法、域名、路径 stream_selection Array of StreamSelectionItem objects 从全量流中过滤出一个码率在[min, max]区间的流。如果不需要码率过滤可不选。 segment_duration_seconds Integer 频道输出分片的时长,为必选项 单位:秒。取值范围:1-10 说明: 修改分片时长会影响已录制内容的时移和回看服务,请谨慎修改! playlist_window_seconds Integer 频道直播返回分片的窗口长度,为频道输出分片的时长乘以数量后得到的值。实际返回的分片数不小于3个。 单位:秒。取值范围:0 - 86400(24小时转化成秒后的取值) encryption Encryption object 加密信息 ads Object 广告配置 ext_args Object 其他额外参数 request_args PackageRequestArgs object 播放相关配置 ad_marker String 广告标识。 DASH取值:"xml+bin"。 表19 MssPackageItem 参数 参数类型 描述 url String 客户自定义的拉流地址,包括方法、域名、路径 stream_selection Array of StreamSelectionItem objects 从全量流中过滤出一个码率在[min, max]区间的流。如果不需要码率过滤可不选。 segment_duration_seconds Integer 频道输出分片的时长,为必选项 单位:秒。取值范围:1-10 说明: 修改分片时长会影响已录制内容的时移和回看服务,请谨慎修改! playlist_window_seconds Integer 频道直播返回分片的窗口长度,为频道输出分片的时长乘以数量后得到的值。实际返回的分片数不小于3个。 单位:秒。取值范围:0 - 86400(24小时转化成秒后的取值) encryption Encryption object 加密信息 ext_args Object 其他额外参数 delay_segment Integer 延播时长,单位秒 request_args PackageRequestArgs object 播放相关配置 表20 StreamSelectionItem 参数 参数类型 描述 key String 拉流URL中用于码率过滤的参数 max_bandwidth Integer 最大码率,单位:bps 取值范围:0 - 104,857,600(100Mbps) min_bandwidth Integer 最小码率,单位:bps 取值范围:0 - 104,857,600(100Mbps) 表21 Encryption 参数 参数类型 描述 key_rotation_interval_seconds Integer 密钥缓存时间。如果密钥不变,默认缓存七天。 请注意:目前为保留字段,不支持配置。 encryption_method String 加密方式。 请注意:目前为保留字段,不支持配置。 level String 取值如下: content:一个频道对应一个密钥 profile:一个码率对应一个密钥 默认值:content resource_id String 客户生成的DRM内容ID system_ids Array of strings system_id枚举值。 取值如下: HLS:FairPlay DASH:Widevine、PlayReady MSS:PlayReady url String 获取密钥的DRM地址 speke_version String drm speke 版本号 当前只支持1.0 request_mode String 请求模式。 取值如下: direct_http:HTTP(S)直接访问DRM。 functiongraph_proxy:FunctionGraph代理访问DRM。 http_headers Array of HttpHeader objects 需要添加在drm请求头中的鉴权信息。最多支持配置5个。 仅direct_http请求模式支持配置http_headers。 urn String functiongraph_proxy请求模式需要提供functiongraph的urn。 表22 HttpHeader 参数 参数类型 描述 key String 请求头中key字段名 value String 请求头中key对应的value值 表23 PackageRequestArgs 参数 参数类型 描述 record Array of RecordRequestArgs objects 录制播放相关配置 timeshift Array of TimeshiftRequestArgs objects 时移播放相关配置 live Array of LiveRequestArgs objects 直播播放相关配置 表24 RecordRequestArgs 参数 参数类型 描述 start_time String 开始时间 end_time String 结束时间 format String 格式 unit String 单位 表25 TimeshiftRequestArgs 参数 参数类型 描述 back_time String 时移时长字段名 unit String 单位 表26 LiveRequestArgs 参数 参数类型 描述 delay String 时延字段 unit String 单位 表27 EncoderSettingsExpand 参数 参数类型 描述 audio_descriptions Array of audio_descriptions objects 音频输出配置的描述信息 表28 audio_descriptions 参数 参数类型 描述 name String 音频输出配置的名称。仅支持大小写字母,数字,中划线(-),下划线(_)。 同一个频道不同的音频输出配置名称,不允许重复。 audio_selector_name String 音频选择器名称 language_code_control String 语言代码控制。这里的设置不会修改音频实际的语言,只会修改音频对外展示的语言。 包含如下选项: FOLLOW_INPUT:如果所选音频选择器对应的输出音频有语言,则与其保持一致,否则会以这里配置的语言代码和流名称进行兜底。推荐当前选项,为默认值。 USE_CONFIGURED:用户根据实际情况自定义输出音频的语言和流名称。 language_code String 语言代码,输入2或3个小写字母。 stream_name String 流名称 状态码: 400 表29 响应Body参数 参数 参数类型 描述 result_code String 错误码 result_msg String 错误描述 domain String 推流域名 app_name String 组名或应用名,为必填项 id String 频道ID。频道唯一标识,为必填项
  • 请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token,使用Token鉴权方式时必选。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 Access-Control-Allow-Internal 否 String 服务鉴权Token,服务开启鉴权,必须携带Access-Control-Allow-Internal访问服务。 Access-Control-Allow-External 否 String 服务鉴权Token,服务开启鉴权,必须携带Access-Control-Allow-External访问服务。
  • URI GET /v1/{project_id}/ott/channels 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 domain 否 String 推流域名 app_name 否 String 组名或应用名 id 否 String 频道ID limit 否 Integer 每页记录数,取值范围[1,100],默认值10 offset 否 Integer 偏移量。表示从此偏移量开始查询,offset大于等于0
  • 配置Redis ACL访问账号 登录分布式缓存服务管理控制台。 在管理控制台左上角单击,选择实例所在的区域。 单击左侧菜单栏的“缓存管理”,进入实例信息页面。 单击D CS 缓存实例名称,进入该实例的基本信息页面。 选择“账号管理”进入账号管理页面。 “账号名称”为“default”的账号为实例的“默认账号”,默认账号的权限为读写权限,该账号的密码即缓存实例的访问密码。 单击“创建账号”,可以创建普通账号。 每个实例支持最多18个普通账号。 如果Redis实例开启了免密访问,创建的普通账号不生效,仅支持默认账号。 如需使用普通账号请先关闭默认账号的免密访问:单击默认账号对应“操作”列的“重置密码”即可为实例设置密码。 在弹出的创建账号窗口中,设置“账号名称”、选择账号权限为“只读”或“读写”、设置账号密码及备注。 单击“确定”,完成账号创建。 当使用创建的ACL普通账号连接实例时,需要配置实例密码为{username:password}。 以使用redis-cli连接Redis实例为例,当使用默认账号连接实例时命令如下: ./redis-cli -h {dcs_instance_address} -p 6379 -a {password} 如果使用实例创建的ACL普通账号连接,实例密码需要配置为“账号名称:账号密码”: ./redis-cli -h {dcs_instance_address} -p 6379 -a {username:password} 图1 账号管理
  • 形态变更概述 CSS 集群支持形态变更,包括集群扩容、集群规格变更、集群缩容等。当创建的集群规格不能满足业务需求时,可以通过形态变更,提高集群的使用效率,降低运维成本。 扩容 当集群数据节点(ess)的写入与查询压力大、响应时间过长时,可以通过扩容数据节点的“节点存储容量”保证数据的持久性。如果因数据量过大或操作不当导致数据节点状态异常时,可以扩容“节点数量”保证集群的可用性。 冷数据节点(ess-cold)主要用于分担ess数据节点的压力,当发现冷数据有丢失的风险时,可以扩容冷数据节点的“节点存储容量”保证冷数据的持久性,同时也支持扩容节点个数保证集群的可用性。 变更规格 当新增索引或分片分配的处理时间过长,或管理集群各个节点的协调、调度不足时,可以变更Master节点(ess-master)的“节点规格”保证集群的正常使用。 当数据节点任务分发量、结果汇聚量过大时,需要变更Client节点(ess-client)的“节点规格”。 当数据的写入与查询突然变得缓慢时,可以变更数据节点(ess)的“节点规格”提高数据节点的查询与写入效率。 当存在冷数据查询缓慢时,可以变更冷数据节点(ess-cold)的“节点规格”提高对数据查询的效率。 缩容集群节点数量 当集群有充足的能力处理当前数据时,为节省资源可以随机减小集群占用的资源。 缩容指定节点 当集群有充足的能力处理当前数据时,为节省资源可以指定一个或多个节点进行缩容。 替换指定节点 当集群中的节点发生故障,可以通过删除故障节点,重建一个一样的新节点,实现指定节点替换。 添加Master/Client节点 当集群数据面业务增长,需要动态调整集群形态时,可以增加Master/Client节点。 更改安全模式 集群创建完成后,可以通过更改安全模式进行集群模式变更。CSS服务支持如下几种安全模式更改: 非安全模式切换为安全模式:“非安全模式”切换为“安全模式+HTTP协议”或“安全模式+HTTPS协议” 安全模式切换为非安全模式:“安全模式+HTTP协议”或“安全模式+HTTPS协议”切换为“非安全模式” 切换安全模式下的协议:“安全模式+HTTP协议”切换为“安全模式+HTTPS协议”、“安全模式+HTTPS协议”切换为“安全模式+HTTP协议” 切换可用区 切换可用区包含两大场景:可用区高可用改造和可用区平移切换。 可用区高可用改造:适用于单AZ改造成两AZ、单AZ改造成三AZ或两AZ改造成三AZ的场景,目的是为了提升集群的高可用性。 可用区平移切换:适用于从一个AZ完全迁移到另一个AZ的场景,目的是为了解决当前可用区资源不足的问题。
  • 已有集群开启Kibana公网访问 您可以对已经创建的安全模式集群的Kibana公网访问进行开启、关闭、修改、查看等操作。 登录 云搜索服务 管理控制台。 在集群管理页面,单击需要配置Kibana公网访问的集群名称,进入集群基本信息页面。 选择“Kibana公网访问”,在“Kibana公网访问”右侧单击开关,打开Kibana公网访问功能。 在开启Kibana公网访问页面,配置相关参数。 表2 Kibana公网访问参数说明 参数 说明 带宽 设置公网访问的带宽。 取值范围:1-100。 单位:Mbit/s。 访问控制开关 如果关闭访问控制开关,则允许任何IP通过公网IP访问集群Kibana。如果开启访问控制开关,则只允许白名单列表中的IP通过公网IP访问集群Kibana。 白名单 设置允许访问的IP地址或网段,中间用英文逗号隔开。仅当打开“访问控制开关”时才需要配置。 建议开启白名单。 配置完成后,单击“确定”。
  • 创建集群时配置Kibana公网访问 登录 云搜索 服务管理控制台。 单击右上角的“创建集群”,进入创建集群页面。 在创建集群页面,开启“安全模式”。 “高级配置”选择“自定义”后,开启Kibana公网访问,配置相关参数。 表1 Kibana公网访问参数说明 参数 说明 带宽 设置公网访问的带宽。 取值范围:1-100。 单位:Mbit/s。 访问控制开关 如果关闭访问控制开关,则允许任何IP通过公网IP访问集群Kibana。如果开启访问控制开关,则只允许白名单列表中的IP通过公网IP访问集群Kibana。 白名单 设置允许访问的IP地址或网段,中间用英文逗号隔开。仅当打开“访问控制开关”时才需要配置。 建议开启白名单。 集群创建成功后,单击集群名称,进入集群基本信息页面,在“Kibana公网访问”页签,可以查看kibana公网访问地址。
  • 通过公网IP访问Kibana Kibana公网访问配置完成后,将会获得一个Kibana公网访问地址,用户可以通过此IP地址访问集群的Kibana。 登录云搜索服务管理控制台。 在集群管理页面,单击需要配置Kibana公网访问的集群名称,进入集群基本信息页面。 选择“Kibana公网访问”,获取kibana公网访问地址。 图1 获取Kibana公网访问地址 通过该地址,就可以在公网上面访问云搜索服务集群的Kibana。
  • 修改Kibana公网访问 对已经配置了Kibana公网访问的集群,云搜索服务支持修改带宽、修改访问控制和关闭Kibana公网访问。 登录云搜索服务管理控制台。 在集群管理页面,单击需要修改Kibana公网访问的集群名称,进入集群基本信息页面。 选择“Kibana公网访问”,修改Kibana公网访问。 修改带宽 单击“带宽”参数右侧的“修改”,在“修改Kibana公网访问带宽”页面修改带宽大小,修改完成后,单击“确定”。 修改访问控制 单击“访问控制开关”右侧的“修改”,在“修改Kibana公网访问控制”页面设置“访问控制开关”和访问“白名单”,修改完成后,单击“确定”。 关闭Kibana公网访问 在“Kibana公网访问”右侧单击开关,确认关闭Kibana公网访问功能。
  • 已有集群的标签管理 您可以对已经创建的集群的标签进行修改,删除,也可以添加标签。 登录云搜索服务管理控制台。 在集群管理页面,单击待管理标签的集群名称。 系统跳转至该集群“基本信息”页面。 左侧菜单栏选择“标签”,在此可以对集群标签进行添加,修改,删除操作。 查看 在“标签”页,可以查看当前集群的标签详情,包括标签个数,以及每个标签的键和值。 添加 单击左上角的“添加标签”,在弹出的“添加标签”窗口,输入新添加标签的键和值,并单击“确定”。 修改 只能修改已有标签的标签值。 单击标签所在行“操作”列下的“编辑”,在弹出的“编辑标签”窗口,输入修改后标签值,并单击“确定”。 删除 单击标签所在行“操作”列下的“删除”,如果确认删除,在弹出的“删除标签”窗口,单击“确定”。
  • 已有集群的标签管理 您可以对已经创建的集群的标签进行修改,删除,也可以添加标签。 登录云搜索服务管理控制台。 在集群管理页面,单击待管理标签的集群名称。 系统跳转至该集群“基本信息”页面。 左侧菜单栏选择“标签”,在此可以对集群标签进行添加,修改,删除操作。 查看 在“标签”页,可以查看当前集群的标签详情,包括标签个数,以及每个标签的键和值。 添加 单击左上角的“添加标签”,在弹出的“添加标签”窗口,输入新添加标签的键和值,并单击“确定”。 修改 只能修改已有标签的标签值。 单击标签所在行“操作”列下的“编辑”,在弹出的“编辑标签”窗口,输入修改后标签值,并单击“确定”。 删除 单击标签所在行“操作”列下的“删除”,如果确认删除,在弹出的“删除标签”窗口,单击“确定”。
  • 已有集群的标签管理 您可以对已经创建的集群的标签进行修改,删除,也可以添加标签。 登录云搜索服务管理控制台。 在集群管理页面,单击待管理标签的集群名称。 系统跳转至该集群“基本信息”页面。 左侧菜单栏选择“标签”,在此可以对集群标签进行添加,修改,删除操作。 查看 在“标签”页,可以查看当前集群的标签详情,包括标签个数,以及每个标签的键和值。 添加 单击左上角的“添加标签”,在弹出的“添加标签”窗口,输入新添加标签的键和值,并单击“确定”。 修改 只能修改已有标签的标签值。 单击标签所在行“操作”列下的“编辑”,在弹出的“编辑标签”窗口,输入修改后标签值,并单击“确定”。 删除 单击标签所在行“操作”列下的“删除”,如果确认删除,在弹出的“删除标签”窗口,单击“确定”。
  • 设置开启子域名递归解析 您可以在创建内网域名时开启“子域名递归解析”,或通过修改内网域名开启“子域名递归解析”。 创建内网域名时开启子域名递归解析 如图1所示,创建内网域名时,勾选“子域名递归解析代理”,即可开启子域名递归解析。 创建内网域名的具体操作请参考创建内网域名。 图1 创建内网域名并开启子域名递归解析 修改内网域名时开启子域名递归解析 如图2所示,修改内网域名时,勾选“子域名递归解析代理”,即可开启子域名递归解析。 修改域名的具体操作请参考管理内网域名。 图2 修改内网域名开启子域名递归解析
  • 添加转发规则 进入解析器列表页面。 单击管理控制台左上角的,选择区域和项目。 单击进入“转发规则”页签。 单击“添加转发规则”。 根据界面提示配置相关参数,详细内容请参见表1。 图1 添加转发规则 表1 添加转发规则参数说明 参数 参数说明 名称 出站终端节点的转发规则名称。 域名 终端节点规则对应的域名。 类型 默认选择“解析器”。 出站终端节点 选择需要关联的出站终端节点。 关联VPC 支持打开或关闭。 开关打开后,需要配置VPC相关信息。 区域 VPC所属区域。 打开“关联VPC”开关后,需要配置该参数。 VPC 勾选转发规则需要关联的VPC,支持多选。 打开“关联VPC”开关后,需要配置该参数。 目标IP地址 云下数据中心DNS的IP地址。 支持添加多个IP地址。 转发规则创建后,不支持修改域名、类型、出站终端节点信息。 单击“确定”。
  • 约束与限制 使用DNSSEC需要 域名注册服务 商和域名DNS服务商同时支持DNSSEC能力,当前华为云域名注册服务暂不支持DNSSEC,请提交工单联系域名注册服务配置。 DNSSEC不支持配置子域名。 关闭DNSSEC前需要先在域名服务商处删除DS记录。 在DNS控制台跨账号转移DNS解析时,需要先在域名注册服务商处删除DS记录,然后在DNS控制台关闭DNSSEC,否则可能导致解析失败。 在域名注册控制台跨账号转移域名时,需要先删除DS记录,然后在DNS控制台关闭DNSSEC,否则可能导致解析失败。 使用DNSSEC时请不要为主域名配置CNAME类型的记录集,否则会导致解析失败。
  • 操作步骤 开启DNSSEC 进入公网域名列表页面。 单击待开启DNSSEC的公网域名的名称。 默认进入“解析记录”页面。 在页面上方,选择进入“DNSSEC”页面。 在DNSSEC页面,单击“开启DNSSEC”。 图2 开启DNSSEC 查看并记录页面下方的DNSSEC信息。 记录密钥标签、摘要算法、摘要算法类型、摘要。 图3 查看DNSSEC信息 根据获取到的DNSSEC信息,前往域名注册服务商处配置DS记录。 配置DS记录 以下非华为云域名注册服务商的DS记录配置指导仅供参考,具体以域名注册服务商官网操作指导为准。 登录域名管理控制台。 在域名列表中,在目标域名所在行的操作列选择“更多 >管理”。 在域名管理页面,单击“DNSSEC”。 在DNSSEC页面,单击“添加DS记录”。 根据界面提示配置参数信息,输入1.e中获取到的DNSSEC信息。 密钥标签(Key Tag):填写DNSSEC的“密钥标签”。 加密算法(Algorithm):填写DNSSEC的“签名算法类型”和“签名算法”。 填写格式:签名算法类型-签名算法 摘要类型(Digest Type):填写DNSSEC的“摘要算法类型”和“摘要算法”。 填写格式:摘要算法类型-摘要算法 摘要(Digest):填写DNSSEC的“摘要”。 单击“确定”,完成配置。
  • 创建入站终端节点 进入解析器列表页面。 单击管理控制台左上角的,选择区域和项目。 在页面右上角,单击“创建终端节点”。 根据界面提示配置相关参数,详细内容请参见表1。 图1 创建入站终端节点 表1 创建入站终端节点参数说明 参数 参数说明 终端节点方式 支持选择“出站”、“入站”。 此处请选择“入站”。 终端节点名称 终端节点的名称。 只能由中文字符,英文字母,数字,及“_”,“-”,“.”组成。 长度为1-64字符。 区域 入站终端节点所属区域。 VPC 所有入站DNS请求将由此VPC转发到云上DNS服务器。 注意: 终端节点创建后无法更改VPC。 子网 子网必须具有可用的IP地址。目前仅支持IPv4地址。 IP地址 支持“自动选择”或“自定义”。 说明: 为了提高可靠性,请您为DNS转发至少指定两个IP地址,建议这两个地址位于不同可用区中。 您也可以在可用区添加更多IP地址。 单击“立即创建”
  • 批量导出反向解析 云解析服务支持批量导出反向解析信息,导出方式分为“导出全部数据到XLSX“ 和“导出已选中数据到XLSX”。 进入反向解析列表页面。 单击管理控制台左上角的,选择区域和项目。 在反向解析列表上方,单击“导出”。 根据界面提示选择导出方式,完成反向解析导出。 导出全部数据到XLSX:批量导出所有的反向解析信息。 导出已选中数据到XLSX:批量导出已勾选的反向解析信息。 图1 批量导出反向解析
  • 搜索语法 内网域名支持多种类型的搜索,首先了解搜索类型、搜索属性、搜索语法。详细的搜索语法和示例请参考表1。 搜索类型:精确搜索、模糊搜索。 搜索属性:域名、ID、状态、标签、企业项目。 支持精确搜索的属性:域名、ID、状态、标签、企业项目。精确搜索时必须输入完整的属性值。 支持模糊搜索的属性:域名。 按标签过滤时可选择键或键值对搜索,支持设置多个标签: 如果键不同,标签按“与”的关系搜索。 如果键相同,值不同,标签按“与”的关系搜索。 表1 内网域名搜索语法 搜索类型 支持的属性 输入格式 示例 说明 仅输入属性值,但不选择属性 默认按照域名模糊搜索。 属性值 example.com 未选择搜索属性,仅输入属性值时默认是按照域名模糊搜索。 单属性 控制台支持的所有属性 属性:属性值 状态:正常 选择属性后,输入对应的属性信息,系统进行精确搜索。 仅域名名称支持模糊搜索。 多属性 控制台支持的所有属性 属性:取值 &属性:取值 状态:正常 名称:example.com 支持选择多个不同的属性,搜索时多个属性为“与”的关系。 仅域名名称支持模糊搜索。
  • 示例2:单属性搜索 选择属性后,输入对应的属性信息。 以下属性仅支持精确搜索,需输入完整的属性值:ID、状态、标签、企业项目。 模糊搜索:仅域名名称支持模糊搜索 在内网域名列表页搜索的输入框中选择“域名”。 根据提示,输入域名名称,单击进行搜索。域名支持模糊搜索,例如输入“example123”,可以搜索到所有使用example123的域名。 图3 模糊匹配域名名称进行搜索 精确搜索:ID 在内网域名列表页搜索的输入框中选择“ID”。 根据提示,输入完整内网域名ID,单击进行搜索。 图4 按ID搜索内网域名
  • 示例4:按标签搜索 按标签过滤时可选择键或键值对搜索。 支持设置多个标签,如果键不同,则标签按“与”的关系搜索。 如果键相同,值不同,则标签按“与”的关系搜索。 单个标签搜索 在内网域名列表页搜索的输入框中选择“标签”,选择标签键值对,单击“确认”进行搜索。 图6 按标签搜索内网域名 多个标签搜索 在内网域名列表页搜索的输入框中选择“标签”,选择多个标签键值对,单击“确认”进行搜索。 按“与”的关系搜索,搜索同时具备这两个标签的域名。 图7 多个标签搜索内网域名
  • 创建出站终端节点 进入解析器列表页面。 单击管理控制台左上角的,选择区域和项目。 在页面右上角,单击“创建终端节点”。 根据界面提示配置相关参数,详细内容请参见表1。 图2 创建出站终端节点 表1 创建出站终端节点参数说明 参数 参数说明 终端节点方式 支持选择“出站”、“入站”。 此处请选择“出站”。 终端节点名称 终端节点的名称。 只能由中文字符,英文字母,数字,及“_”,“-”,“.”组成。 长度为1-64字符。 区域 出站终端节点所属区域。 VPC 云上DNS通过此VPC将转发规则指定域名的解析请求转发到指定的IP解析。 注意: 终端节点创建后无法更改VPC。 子网 子网必须具有可用的IP地址。目前仅支持IPv4地址。 IP地址 支持“自动选择”或“自定义”。 说明: 为了提高可靠性,请您为DNS转发至少指定两个IP地址,建议这两个地址位于不同可用区中。 您也可以在可用区添加更多IP地址。 单击“立即创建” 出站终端节点创建完成后,需要配置转发规则,详细内容请参见修改出站终端节点或添加转发规则。
  • 操作步骤 进入公网域名列表页面。 在域名列表上方的“批量操作”中,下拉选择“批量转移域名”。 输入转移的域名信息。 输入待转移的域名名称,一次最多转移1000个域名。 输入转移后的华为云账号ID。 在管理控制台右上角单击用户名,在下拉列表中单击“我的凭证”,即可查看账号名和账号ID。 单击“提交”,提交域名转移申请。 操作完成后,您可以在“批量操作记录”页面查看操作名称、操作结果、操作时间和状态信息,还可以下载失败操作记录。
  • 约束限制 目标账号需要通过实名认证,并启用“华北-北京四”的项目。 仅支持转移本账号下域名。 单次最多可转移1000个域名。 批量转移域名仅适用于迁移公网域名解析,不支持迁移内网域名解析记录集。 域名转移前请先确保对方账户能正常登录云解析控制台页面进行域名操作。 批量转移域名任务为异步操作,转移期间请避免对转移中的域名进行操作,以免导致数据不同步。 不支持迁移使用自定义线路的域名解析记录集。 暂不支持中国站和国际站之间互转。
共100000条