华为云用户手册

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token，使用Token鉴权方式时必选。通过调用 IAM 服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 domain 是 String 域名 is_ipv6 否 Boolean IPV6开关配置，默认关闭，true为开启，false为关闭

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token，使用Token鉴权方式时必填。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Authorization 否 String 使用AK/SK方式认证时必填，携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必填，请求的发生时间。 X-Project-Id 否 String 使用AK/SK方式认证时必填，携带项目ID信息。 表3 请求Body参数 参数 是否必选 参数类型 描述 bucket 是 String OBS桶名 operation 是 Integer 操作 1：授权 0：取消授权

请求示例 PUT https://{endpoint}/v1/{project_id}/guard/referer-chain { "domain" : "play.example.huawei.com", "guard_switch" : "true", "referer_config_empty" : "true", "referer_white_list" : "false", "referer_auth_list" : [ "^http://test.*com$", "abc.com" ] }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token，使用Token鉴权方式时必填。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Authorization 否 String 使用AK/SK方式认证时必填，携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必填，请求的发生时间。 X-Project-Id 否 String 使用AK/SK方式认证时必填，携带项目ID信息。 表3 请求Body参数 参数 是否必选 参数类型 描述 domain 是 String 直播域名 guard_switch 是 String referer防盗链开关：true表示开启；false表示关闭 referer_config_empty 否 String 是否包含referer头域：true表示包含；false表示不包含；guard_switch为true则必填 referer_white_list 否 String 是否为referer白名单：true表示白名单；false表示黑名单；guard_switch为true则必填 referer_auth_list 否 Array of strings 域名列表，域名为正则表达式；最多支持配置100个域名，以英文“;”进行分隔；guard_switch为true则必填

响应示例 状态码：200 查询录制配置成功 { "total" : 1, "record_config" : [ { "id" : "42810594c2fc9xxxx36b7784c76a06e8", "publish_domain" : "publish.example.com", "app" : "live", "stream" : "*", "record_type" : "CONTINUOUS_RECORD", "default_record_config" : { "record_format" : [ "HLS" ], "obs_addr" : { "bucket" : "mybucket", "location" : "region1", "object" : "record/" }, "hls_config" : { "record_cycle" : 900, "record_prefix" : "record-publish_domain-app-stream-file_start_time_unix/record-publish_domain-app-stream-file_start_time_unix", "record_ts_prefix" : "{stream}-{file_start_time_unix}-{file_end_time_unix}-{ts_sequence_number}", "record_slice_duration" : 10, "record_max_duration_to_merge_file" : 60 } } } ] } 状态码：400 参数错误 { "error_code" : "LIVE.100011001", "error_msg" : "Request Illegal" }

响应参数 状态码：200 表4 响应Header参数 参数 参数类型 描述 X-request-id String 此字段携带请求ID号，以便任务跟踪。格式为：request_id-timestamp-hostname（request_id在服务器端生成UUID，timestamp为当前时间戳，hostname为处理当前接口的服务器名称） 表5 响应Body参数 参数 参数类型 描述 total Integer 查询结果的总元素数量 record_config Array of RecordRule objects 录制配置数组 表6 RecordRule 参数 参数类型 描述 id String 规则ID，由服务端返回。创建或修改的时候不携带 publish_domain String 直播推流域名 app String 应用名，如果需要匹配任意应用则需填写*。录制规则匹配的时候，优先精确app匹配，如果匹配不到，则匹配* stream String 录制的流名，如果需要匹配任意流名则需填写*。录制规则匹配的时候，优先精确stream匹配，如果匹配不到，则匹配* record_type String 录制类型，包括：CONTINUOUS_RECORD，COMMAND_RECORD。默认CONTINUOUS_RECORD。 CONTINUOUS_RECORD：持续录制，在该规则类型配置后，只要有流推送到录制系统，即触发录制。 COMMAND_RECORD：命令录制，在该规则类型配置后，在流推送到录制系统后，租户需要通过命令控制该流的录制开始和结束。 default_record_config DefaultRecordConfig object 默认录制规则配置 create_time String 创建时间，格式：yyyy-mm-ddThh:mm:ssZ，UTC时间。 在查询的时候返回 update_time String 修改时间，格式：yyyy-mm-ddThh:mm:ssZ，UTC时间。 在查询的时候返回 表7 DefaultRecordConfig 参数 参数类型 描述 record_format Array of strings 录制格式，当前支持：FLV，HLS，MP4三种格式，设置格式时必须使用大写字母 obs_addr RecordObsFileAddr object 录制保存的租户的桶信息 hls_config HLSRecordConfig object HLS配置规则 flv_config FLVRecordConfig object FLV配置规则 mp4_config MP4RecordConfig object MP4配置规则 表8 RecordObsFileAddr 参数 参数类型 描述 bucket String OBS的bucket名称 location String OBS Bucket所在RegionID object String OBS对象路径，遵守OBS Object定义。如果为空则保存到根目录 表9 HLSRecordConfig 参数 参数类型 描述 record_cycle Integer 周期录制时长 单位：秒，最小1分钟（60秒），最大12小时（43200秒）。 如果为0，则使用默认值6小时（21600秒）。 record_prefix String 录制m3u8文件,含路径和文件名的前缀， 默认Record/{publish_domain}/{app}/{record_type}/{record_format}/{stream}_{file_start_time}/{stream}_{file_start_time} record_ts_prefix String 录制ts文件名的前缀， 默认{file_start_time_unix}_{file_end_time_unix}_{ts_sequence_number} record_slice_duration Integer 录制HLS时ts的切片时长，非必填。 取值范围：[2,60] 单位：秒 默认值：10 record_max_duration_to_merge_file Integer 录制HLS文件拼接时长，如果流中断超过该时间，则生成新文件。 单位：秒 默认值：0 0：表示流中断就生成新文件。 -1：表示相同的流中断恢复后，继续在30天内的前一个文件保存。 表10 FLVRecordConfig 参数 参数类型 描述 record_cycle Integer 周期录制时长 单位：秒，最小1分钟（60秒），最大6小时（21600秒）。 如果为0，则使用默认值2小时（7200秒）。 record_prefix String 录制FLV文件，含路径和文件名的前缀， 默认Record/{publish_domain}/{app}/{record_type}/{record_format}/{stream}_{file_start_time}/{file_start_time} record_max_duration_to_merge_file Integer 录制FLV文件拼接时长，如果流中断超过该时间，则生成新文件。如果为0表示流中断就生成新文件。 单位：秒 默认值：0 表11 MP4RecordConfig 参数 参数类型 描述 record_cycle Integer 周期录制时长 单位：秒，最小1分钟（60秒），最大6小时（21600秒）。 如果为0，则使用默认值2小时（7200秒）。 record_prefix String 录制文件含路径和文件名的前缀， 默认Record/{publish_domain}/{app}/{record_type}/{record_format}/{stream}_{file_start_time}/{file_start_time} record_max_duration_to_merge_file Integer 录制mp4文件拼接时长，如果流中断超过该时间，则生成新文件。如果为0表示流中断就生成新文件。 单位：秒 默认值：0 状态码：400 表12 响应Header参数 参数 参数类型 描述 X-request-id String 此字段携带请求ID号，以便任务跟踪。格式为：request_id-timestamp-hostname（request_id在服务器端生成UUID，timestamp为当前时间戳，hostname为处理当前接口的服务器名称） 表13 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述

URI GET /v1/{project_id}/record/rules 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方法请参考获取项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 publish_domain 否 String 直播推流域名 app 否 String 流应用名称 stream 否 String 流名称 record_type 否 String 录制类型，如果不填写则查询所有录制类型，包括：CONTINUOUS_RECORD，COMMAND_RECORD。默认CONTINUOUS_RECORD。 CONTINUOUS_RECORD：持续录制，在该规则类型配置后，只要有流推送到录制系统，即触发录制。 COMMAND_RECORD：命令录制，在该规则类型配置后，在流推送到录制系统后，租户需要通过命令控制该流的录制开始和结束。 offset 否 Integer 偏移量，表示从此偏移量开始查询，offset大于等于0 limit 否 Integer 每页记录数，取值范围[1,100]，默认值10

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

请求示例 修改禁止直播推流属性。 POST https://{endpoint}/v1/{project_id}/stream/blocks { "domain" : "publish.example.huawei.com", "app_name" : "live", "stream_name" : "huawei", "resume_time" : "2018-05-19T21:10:15Z" }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token，使用Token鉴权方式时必填。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Authorization 否 String 使用AK/SK方式认证时必填，携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必填，请求的发生时间。 X-Project-Id 否 String 使用AK/SK方式认证时必填，携带项目ID信息。 表3 请求Body参数 参数 是否必选 参数类型 描述 domain 是 String 推流域名 app_name 是 String 应用名称 trans_type 否 String 转码流触发模式。 play：拉流触发转码。 publish：推流触发转码。 默认为play quality_info 是 Array of QualityInfo objects 视频质量信息 表4 QualityInfo 参数 是否必选 参数类型 描述 quality 是 String 包含如下取值： lud：超高清，系统缺省名称。 lhd：高清，系统缺省名称。 lsd：标清，系统缺省名称。 lld：流畅，系统缺省名称。 userdefine：视频质量自定义。填写userdefine时，templateName字段不能为空。 templateName 否 String 自定义模板名称。 若需要自定义模板名称，请将quality参数设置为userdefine。 多个自定义模板名称之间不能重复。 自定义模板名称不能与其他模板的quality参数重复。 若quality不为userdefine，请勿填写此字段。 PVC 否 String 是否使用窄带高清转码。 注意：该字段已不再维护，建议使用hdlb。 包含如下取值： off：不启用。 on：启用。 默认值：off。 hdlb 否 String 是否启用高清低码，较PVC相比画质增强。 提示：使用hdlb字段开启高清低码时，PVC字段不生效。 包含如下取值： off：不开启高清低码。 on：开启高清低码。 默认值：off。 codec 否 String 视频编码格式。 包含如下取值： H264：使用H.264。 H265：使用H.265。 默认为H264。 width 否 Integer 视频的长边。其中，横屏为宽（即长边），竖屏为高。单位：像素。 包含如下取值： codec的取值为H264时，width建议取值范围为[32,3840]，且必须为2整数倍。 codec的取值为H265时，width建议取值范围为[320,3840]，且必须为2的整数倍。 注意：width和height全为0时，输出的分辨率和源保持一致；width和height只有一个为0时，输出的分辨率按非0项的比例进行缩放。 默认值：0。 height 否 Integer 视频的短边。其中，横屏为宽，竖屏为高（即短边）。单位：像素。 包含如下取值： codec的取值为H264时，height建议取值范围为[32,2160]，且必须为2的整数倍。 codec的取值为H265时，height建议取值范围为[240,2160]，且必须为2的整数倍。 注意：width和height全为0时，输出的分辨率和源保持一致；width和height只有一个为0时，输出的分辨率按非0项的比例进行缩放。 默认值：0。 bitrate 是 Integer 转码视频的码率。 单位：Kbps 取值范围：40-30000。 video_frame_rate 否 Integer 转码视频帧率。 单位：fps 取值范围：0-60，0表示保持帧率不变。 默认值：0。 protocol 否 String 转码输出支持的协议类型。默认为RTMP。当前只支持RTMP。 包含如下取值： RTMP iFrameInterval 否 Integer 最大I帧间隔。 单位：帧数 取值范围：[0, 500]，默认值：50。 注意：若希望通过iFrameInterval设置i帧间隔，请将gop设为0，或不传gop参数。 gop 否 Integer 按时间设置I帧间隔。 单位：秒 取值范围：[0,10]，默认值：2。 注意：gop不为0时，则以gop设置i帧间隔，iFrameInterval字段不生效。 bitrate_adaptive 否 String 自适应码率参数。 包含如下取值： off：关闭码率自适应，目标码率按设定的码率输出。 minimum：目标码率按设定码率和源文件码率最小值输出（即码率不上扬）。 adaptive：目标码率按源文件码率自适应输出。 默认值：off。 i_frame_policy 否 String 编码输出I帧策略。 包含如下取值： auto：I帧按设置的gop时长输出。 strictSync：编码输出I帧完全和源保持一致（源是I帧则编码输出I帧，源不是I帧则编码非I帧），设置该参数后gop时长设置无效。 默认值：auto。 注意：多码率场景下建议开启I帧随源，保障多码率I帧对齐。

请求示例 创建直播转码模板，应用名称为live，转码质量为SD，转码编码格式为H264，宽为1920像素，高为1080像素。 POST 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 } ] }

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

响应示例 状态码：200 处理成功返回。 { "data_list" : [ { "time" : "2020-06-04T07:00:00Z", "value" : 0 }, { "time" : "2020-06-04T07:05:00Z", "value" : 325 } ] } 状态码：400 参数错误。 { "error_code" : "LIVE.100011001", "error_msg" : "Invalid request parameter: domain" }

响应参数 状态码：200 表4 响应Header参数 参数 参数类型 描述 X-Request-Id String 请求的唯一标识。 表5 响应Body参数 参数 参数类型 描述 data_list Array of V2BandwidthData objects 采样数据列表 表6 V2BandwidthData 参数 参数类型 描述 value Long 带宽值，单位为bps。 time String 采样时间。日期格式按照ISO8601表示法，并使用UTC时间。 格式为：YYYY-MM-DDThh:mm:ssZ。 状态码：400 表7 响应Header参数 参数 参数类型 描述 X-Request-Id String 请求的唯一标识。 表8 响应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方式认证时必选，请求的发生时间。 X-Project-Id 否 String 使用AK/SK方式认证时必选，携带项目ID信息, 与路径参数中的项目ID相同。

功能介绍 查询上行带宽数据。 最大查询跨度31天，最大查询周期1年。 指定起始时间和结束时间时，起始时间必须为时间粒度的整时刻点，结束时间为不包含整点时刻。 比如查询时间粒度为5分钟，起始时间为5分钟整时刻点，如：0分、5分、50分、55分，结束时间为不包含整点时刻点， 如：4分59秒、9分59秒、59分59秒。时间传参start_time为2020-06-04T07:00:00Z ，end_time为2020-06-04T07:04:59Z，表示统计这个时间区间5分钟粒度的带宽。如果查询不按照此规范，返回数据可能和预期不一致。

URI GET /v2/{project_id}/stats/up-bandwidth/detail 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方法请参考获取项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 publish_domains 是 Array of strings 推流域名列表，最多支持查询100个域名，多个域名以逗号分隔，若查询多个域名，则返回的是多个域名合并数据。 app 否 String 应用名称。 stream 否 String 流名。 region 否 Array of strings 区域列表。具体取值请参考省份名称缩写，不填写查询所有区域。 isp 否 Array of strings 运营商列表，取值如下： CMCC ：移动 CTCC ： 电信 CUCC ：联通 OTHER ：其他 不填写查询所有运营商。 interval 否 Integer 查询数据的时间粒度。单位：秒。 支持300秒（默认值）、3600秒和86400秒。不传值时，使用默认值300秒。 type 否 String 查询带宽类型，取值如下： RELAY：转推 不填默认查询推流带宽。 start_time 否 String 起始时间。日期格式按照ISO8601表示法，并使用UTC时间。 格式为：YYYY-MM-DDThh:mm:ssZ。 最大查询跨度31天，最大查询周期1年。 若参数为空，默认查询7天数据。 end_time 否 String 结束时间。日期格式按照ISO8601表示法，并使用UTC时间。 格式为：YYYY-MM-DDThh:mm:ssZ。 若参数为空，默认为当前时间，最大查询跨度31天，最大查询周期1年。结束时间需大于起始时间。

前提条件 已创建包含Doris服务的集群，集群内各服务运行正常。 待连接Doris数据库的节点与 MRS 集群网络互通。 创建具有Doris管理权限的用户。 集群已启用Kerberos认证（安全模式） 在 FusionInsight Manager中创建一个人机用户，例如“dorisuser”，创建一个拥有“Doris管理员权限”的角色绑定给该用户。 使用新建的用户dorisuser重新登录FusionInsight Manager，修改该用户初始密码。 集群未启用Kerberos认证（普通模式） 使用admin用户连接Doris后，创建具有管理员权限的角色并绑定给用户。 已安装MySQL客户端，相关操作可参考使用MySQL客户端连接Doris。

前提条件 已创建包含Doris服务的集群，集群内各服务运行正常。 待连接Doris数据库的节点与MRS集群网络互通。 创建具有Doris管理权限的用户。 集群已启用Kerberos认证（安全模式） 在FusionInsight Manager中创建一个人机用户，例如“dorisuser”，创建一个拥有“Doris管理员权限”的角色绑定给该用户。 使用新建的用户dorisuser重新登录FusionInsight Manager，修改该用户初始密码。 集群未启用Kerberos认证（普通模式） 使用admin用户连接Doris后，创建具有管理员权限的角色并绑定给用户。 已安装MySQL客户端，相关操作可参考使用MySQL客户端连接Doris。 已准备待导入至Doris的数据文件。

域名准入要求及规范 限制项 说明 域名准入条件 中国大陆： 华为账号已完成实名认证。 域名已在工信部备案，且当前备案信息正常可用。 加速域名接入时需通过 内容审核 。 中国大陆境外： 加速域名接入时需通过内容审核。 全球： 已在华为云进行实名认证。 域名已在工信部备案，且当前备案信息正常可用。 加速域名接入时需通过内容审核。 加速域名 域名基础规范： 域名长度不能超过200个字符，支持大小写字母、数字、“-”、“.”“*”，“*”必须是首字符，首字符不能是“-”或“.”。 域名单节点长度不超过63个字符，即：***.***.com中，***的字符数最多63个。 每个账号最多支持加速100个域名。 加速域名不允许重复添加。 CDN不支持非法网站接入，对于已接入CDN的域名，会进行定期复审，如发现存在违规行为，将立即中止该域名的 CDN加速 ，同时中止该用户名下所有域名的CDN服务。 加速域名处于“停用”或“审核未通过”状态超过120天，CDN平台会启动删除域名流程，平台复核后会删除该域名相关记录。记录删除后如果想要再次使用该域名加速，需要重新添加域名。 如果域名超过180天没有任何访问流量，CDN平台会启动域名停用流程，平台复核后会停用该域名。 欠费及攻击处理规则： 欠费进入保留期后，CDN将停用您的加速域名，删除加速域名的CNAME解析，此时将无法访问域名。 当域名受攻击时，CDN节点会承受攻击流量，不会造成源站被攻击瘫痪。如果攻击流量太大造成节点不能正常服务，CDN会封禁加速域名，最终域名状态调整为“停用”，停止CDN加速服务。因攻击时占用了CDN节点资源，所以会产生相关费用。 泛域名接入规范：支持添加泛域名作为加速域名，如：您在CDN添加泛域名*.test.com作为加速域名，并将*.test.com解析至CDN生成的CNAME域名后，那么您所有*.test.com的次级域名（如a.test.com）都将默认支持CDN加速。泛域名（*.test.com）的三级域名（如b.a.test.com）不会被CDN加速。 A账号添加泛域名后，其他账号不能再添加该泛域名的所有次级域名。 泛域名的所有次级域名的加速都会产生费用，泛域名有多个次级域名时，CDN统计时将泛域名的产生的流量做汇总，不提供单个次级域名的计费数据。 说明： 刷新或预热泛域名缓存时，需要每个子域名单独预热或刷新，示例： 泛域名：*.a.com，子域名：1.a.com、2.a.com、3.a.com。 刷新时需要刷新具体子域名的URL，即输入：http://1.a.com/abc.jpg而不是http://*.a.com/abc.jpg。

内容审核 限制项 说明 内容审核 CDN不支持接入违反相关法律法规的域名，包括但不限于： 涉黄、涉赌、涉毒、涉诈、侵权内容的网站 游戏私服类网站 盗版游戏 / 软件 / 盗版视频网站 P2P类金融网站 彩票类网站 违规医院和药品类网站 网站无法正常访问或内容不含有任何实质信息 说明： 如果您的加速域名含有以上违规的内容，您将自行承担相关风险。 如果发现涉黄、涉赌、涉毒、涉诈等违规行为，CDN将执行域名封禁策略（删除相关加速域名且不允许再次接入，与违规域名使用相同源站的加速域名同样执行域名封禁策略），账号加速域名配额降为0。

源站规范及限制 限制项 说明 源站 源站数量：每个加速域名最多可以添加50个源站。 源站IP： 使用IP作为源站地址时，CDN节点回源时直接访问该IP地址。 支持配置IPv4，暂不支持IPv6。 源站域名： 首字符为字母或数字，支持大小写字母、数字、“-”、“.”，长度不能超过255个字符。 源站域名不能与加速域名相同。 您也可以将“源站域名”设置为对象存储桶域名。 说明： 如果您需要将非华为云服务商的对象存储桶作为您的源站，可以将对象存储桶访问域名作为“源站域名”接入CDN。 不支持私有桶通过源站域名的形式接入CDN。 如果您将对象存储桶作为您的源站，对象存储桶将根据它的收费规则收取回源流量费用。 OBS桶域名：可以选择当前账号下的OBS桶域名或自定义OBS桶域名。使用OBS桶域名作为源站接入CDN，OBS会收取CDN回源的流量费用，回源流量费用将按照公网流出费用进行结算。如果您使用了OBS 3.0及以上版本的桶作为华为云CDN的源站，可以购买OBS回源流量包抵扣回源流量，具体请见CDN加速OBS计费规则。 如果您的OBS私有桶内容不适合为加速域名提供回源数据，请勿将该私有桶设置为源站。 使用自定义OBS桶域名作为源站时，域名必须以.myhuaweicloud.com或.myhuaweicloud.cn结尾。 如果OBS私有桶设置为源站，请开启OBS委托授权，同时勾选“私有桶”选项，否则将会导致回源失败。 如果您使用自定义OBS私有桶作为源站，您需要为私有桶配置桶策略，配置详见自定义OBS私有桶策略配置。 如果您的OBS桶开启了静态网站托管业务，请在添加加速域名时勾选“静态网站托管”，这样用户访问的时候就不会显示桶中所有文件列表。 当OBS配置了镜像回源且CDN侧开启Range回源时，如果镜像源站未遵循RFC Range Requests标准，对range请求响应非206 ，CDN会回源失败。如需支持该场景，请提工单申请。

其他使用限制 限制项 说明 回源 回源超时时间：CDN默认回源超时时间为30s。 文件 文件上传：CDN支持上传文件，最大上传300M，文件上传会收取流量费用。 请求方式 常见的HTTP请求方式里面，CDN支持GET、PUT、POST和DELETE这几种请求方式。 物联网卡访问限制 根据中华人民共和国工业和信息化部（简称：工信部）的相关规定（详见《关于印发〈物联网卡安全分类管理实施指引（试行）〉的通知》（工网安函[2020]1173号）），华为云CDN在中国大陆无法为使用物联网卡的终端提供加速服务，使用物联网卡的终端设备访问华为云CDN时，很可能会无法连接到节点IP。

审计与日志 审计 云审计 服务（Cloud Trace Service， CTS ），是华为 云安全 解决方案中专业的日志审计服务，提供对各种云资源操作记录的收集、存储和查询功能，可用于支撑安全分析、合规审计、资源跟踪和问题定位等常见应用场景。 用户开通云审计服务后，CTS可记录CDN的操作事件用于审计。 CTS的详细介绍和开通配置方法，请参见CTS快速入门。 CDN支持审计的操作事件请参见使用CTS审计CDN。 开启了云审计服务后，系统开始记录CDN资源的操作。您可以在云审计服务控制台查看最近7天的操作记录，具体操作指导请参见查看审计事件。 日志 CDN记录了所有域名（包括已删除域名，如果客户开通了企业项目，则已删除域名不支持此功能）被网络用户访问的详细日志，客户可以下载最近30天内指定时间段的日志，对相关业务资源被访问情况进行详细分析。查看CDN日志请参考离线日志。 父主题： 安全

加速案例 本次测试采用业内通用的基调测速方法，服务商为听云。测试对象为华为云OBS桶、华为云CDN。测试运营商为中国联通和中国电信。 时延性能 单位：秒 可用性 经测试，OBS桶和CDN的可用性均为100%。 详细数据 时间 OBS桶源站 CDN 时延（秒） 可用性（%） 监测点数 时延（秒） 可用性（%） 监测点数 11月18日15:12 1.149 100 57 1.227 100 62 11月18日16:12 1.075 100 167 0.616 100 169 11月18日17:12 0.867 100 172 0.433 100 171 11月18日18:12 0.7 100 169 0.321 100 169 11月18日19:12 0.94 100 173 0.534 100 173 11月18日20:12 1.119 100 176 0.765 100 176 11月18日21:12 0.841 100 175 0.609 100 176 11月18日22:12 0.983 100 181 0.682 100 180 11月18日23:12 0.923 100 173 0.58 100 174 11月19日00:12 1.08 100 184 0.737 100 184 11月19日01:12 1.147 100 180 0.812 100 178 11月19日02:12 1.29 100 181 0.853 100 183 11月19日03:12 1.041 100 177 0.617 100 176 11月19日04:12 1.339 100 184 0.997 100 184 11月19日05:12 1.035 100 179 0.74 100 179 11月19日06:12 0.865 100 180 0.566 100 181 11月19日07:12 1.258 100 176 1.071 100 175 11月19日08:12 1.338 100 170 0.878 100 170 11月19日09:12 1.085 100 155 0.705 100 155 11月19日10:12 1.213 100 168 0.822 100 169

通用指标 CDN通用指标（非全量指标）如下表所示： 参数 描述 时延 指完成整个文件的上传或下载所需的总时长。 丢包率 指在网络传输中所丢失数据包数量占所发送数据组的比率。 回源率 回源率分为回源请求数比例及回源流量比例两种。 回源请求数比：指CDN节点对于没有缓存、缓存过期（可缓存）和不可缓存的请求占全部请求记录的比例。 回源流量比：回源流量是CDN节点回源请求资源时产生流量。回源流量比=回源流量/（回源流量+用户请求访问的流量），比值越低，性能越好。 缓存命中率 缓存命中率分为请求命中率和流量命中率，缓存命中率越高，性能越好。 请求命中率 = 命中缓存的请求数 / 请求总数。 流量命中率 = 命中缓存产生的流量 / 请求总流量 请求总流量：指命中缓存产生的流量和请求回源产生的流量之和。 说明： 流量命中率越低，回源流量越大，源站的流出流量越大，源站带宽资源占用越大，其代表了源站服务器收到的负载压力，请重点关注流量命中率。 使用CDN后，时延、丢包率、回源率通常会降低，缓存命中率则会提高。但是由于业务场景和业务类型不同，即使您选择了相同配置的CDN服务，实际产生的加速效果也不相同，因此本文仅提供了定性的指标以供观测。 回源率、缓存命中率是指使用CDN后的衡量指标，如果您没有使用CDN，回源请求数为100%，缓存命中率为0。

工作原理 当用户访问使用CDN服务的网站时，本地DNS服务器通过CNAME方式将最终域名请求重定向到CDN服务。CDN通过一组预先定义好的策略（如内容类型、地理区域、网络负载状况等），将当时能够最快响应用户的CDN节点IP地址提供给用户，使用户可以以最快的速度获得网站内容。使用CDN后的HTTP请求处理流程如下。 HTTP请求流程说明： 用户在浏览器输入要访问的网站域名www.example.com，向本地DNS发起域名解析请求。 本地DNS检查缓存中是否有www.example.com的IP地址记录。如果有，则直接返回给终端用户；如果没有，则向网站授权DNS查询。 网站DNS服务器解析发现域名已经解析到了CNAME：www.example.com.c.cdnhwc1.com。 请求被指向CDN服务。 CDN对域名进行智能解析，将响应速度最快的CDN节点IP地址返回给本地DNS。 用户获取响应速度最快的CDN节点IP地址。 浏览器在得到最佳节点的IP地址以后，向CDN节点发出访问请求。 如果该IP地址对应的节点已缓存该资源，节点将数据直接返回给用户，如图中步骤7和8，请求结束。此时由最佳节点返回资源给用户，达到加速目的。 如果该IP地址对应的节点未缓存该资源，节点回源请求资源。获取资源后，结合用户自定义配置的缓存策略，将资源缓存至节点，如图中的北京节点，并返回给用户，请求结束。用户再次请求该资源时，将由节点返回已缓存的资源给用户，无需回源，达到加速目的。配置缓存策略的操作方法，请参见缓存配置。

示例流程 操作流程如图1所示 图1 操作流程 创建用户组并授权 在IAM控制台创建用户组，并授予CDN加速域名只读权限“CDN DomainReadOnlyAccess”。 创建用户并加入用户组 在IAM控制台创建用户，并将其加入1中创建的用户组。 用户登录并验证权限 新创建的用户登录控制台，验证CDN加速域名的只读权限： 对加速域名进行启用或停用操作，如果提示权限不足，表示“CDN DomainReadOnlyAccess”已生效。 在“服务列表”中选择除CDN外的任一服务，如果提示权限不足，表示“CDN DomainReadOnlyAccess”已生效。

CDN回源原理 终端用户发起请求：终端用户访问一个网站时，DNS解析将客户端（如浏览器）请求的URL指向CDN加速域名。 CDN节点查找缓存：如果CDN节点已缓存该资源，节点将数据直接返回给客户端，从而实现快速响应。 回源请求：如果CDN节点未缓存请求的资源，CDN节点会根据域名配置的回源策略，向源站发起回源请求。 回源获取资源：源站接收到CDN节点的回源请求后，根据请求的URL和参数，返回相应的资源给CDN节点。 节点缓存&响应资源：CDN节点在获取到源站返回的资源后，会将资源返回给客户端，同时将资源缓存在节点，以便下次请求可以直接返回缓存的资源给客户端。

支持的回源配置项 修改回源相关配置需要加速域名处于“已开启”或“配置中”状态，并且未被CDN锁定、禁用。 功能 说明 修改回源协议 如果您需要指定CDN回源时的请求协议，您需要配置回源方式。 配置回源SNI 如果源站IP绑定了多个域名，当CDN节点以HTTPS协议访问源站时，您可以设置回源SNI，指定CDN节点在回源时访问的域名。 回源URL改写 如果您的回源请求URL与源站URL不匹配，您可以改写回源URL，提高回源请求URL与源站的匹配度，提升回源命中率。 配置高级回源 如果您需要根据不同的资源类型或路径回源到不同源站，可以通过高级回源配置实现。 Range回源 如果您的资源内容较大，希望CDN回源时分片返回内容，以便缩短大文件的分发时间，提升回源效率，减少回源消耗，您需要设置Range回源。 回源跟随 如果您的源站地址因业务需求做了301/302 重定向，您需要开启回源跟随功能才可以将重定向的资源缓存到CDN节点，达到加速分发的效果。 回源是否校验ETag 如果您的源站资源未改变，该资源缓存到期后不希望CDN回源获取资源，以达到节约源站带宽的目的，您需要配置回源是否校验ETag。 修改回源超时时间 如果您需要根据源站特性和业务场景调整回源超时时间，您需要配置此项。 回源请求头 如果您想在回源时加入指定的HTTP消息头部，改写终端用户请求URL中的头部信息，您需要设置回源请求头。 动态加速回源模式 如果您想动态内容回源请求时根据权重（默认是择优回源）回源，您需要设置动态加速回源模式。