华为云用户手册

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 id String 图片id。 name String 图片名称。 url String 访问地址。 状态码： 400 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码 CBS.XXXX。 error_msg String 错误详情。 状态码： 500 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 CBS.XXXX。 error_msg String 错误详情。

URI POST https://{endpoint}/v1/{project_id}/digital-human/video/{video_id}/upload/image 表1 路径参数 参数 是否必选 参数类型 描述 endpoint 是 String 终端节点，即调用API的请求地址。 不同服务不同区域的endpoint不同，您可以从终端节点中获取。 例如，CBS服务在“华北-北京四”区域的“endpoint”为“cbs-ext.cn-north-4.myhuaweicloud.com”。 project_id 是 String 项目ID，用于资源隔离。请参见获取项目ID。 video_id 是 String 视频id。可以通过调用获取视频列表接口获取。 表2 Query参数 参数 是否必选 参数类型 描述 name 是 String 图片名。

调用API获取项目ID 项目ID还用通过调用查询指定条件下的项目信息API获取。 获取项目ID的接口为“GET https://{Endpoint}/v3/projects”，其中{Endpoint}为IAM的终端节点，可以从地区和终端节点获取。接口的认证鉴权请参见认证鉴权。 响应示例如下，例如，对话机器人服务部署的区域为“cn-north-4”，响应消息体中查找“name”为“cn-north-4”，其中projects下的“id”即为项目ID。 { "projects": [ { "domain_id": "65382450e8f64ac0870cd180d14e684b", "is_domain": false, "parent_id": "65382450e8f64ac0870cd180d14e684b", "name": "project_name", "description": "", "links": { "next": null, "previous": null, "self": "https://www.example.com/v3/projects/a4a5d4098fb4474fa22cd05f897d6b99" }, "id": "a4a5d4098fb4474fa22cd05f897d6b99", "enabled": true } ], "links": { "next": null, "previous": null, "self": "https://www.example.com/v3/projects" } }

请求示例 统计用户问关键词 GET https://cbs-ext.cn-north-4.myhuaweicloud.com/v1/{project_id}/qabots/{qabot_id}/requests/keywords Request Header: Content-Type: application/json X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Python语言请求代码示例 import requests url = "https://{endpoint}/v1/{project_id}/qabots/{qabot_id}/requests/keywords?top={top}&start_time={start_time}&end_time={end_time}" token = "用户获取得到的实际token值" headers = {'Content-Type': 'application/json', 'X-Auth-Token': token} response = requests.get(url, headers=headers, json=body, verify=False) print(response.text) Java语言请求代码示例 import java.io.BufferedReader; import java.io.InputStream; import java.io.InputStreamReader; import java.net.HttpURLConnection; import java.net.URL; public class CBSDemo { public void cbsDemo() { try { //endpoint、projectId、qabot_id等需要替换成实际信息。 URL url = new URL("https://{endpoint}/v1/{project_id}/qabots/{qabot_id}/requests/keywords?top={top}&start_time={start_time}&end_time={end_time}"); String token = "用户获取得到的实际token值"; HttpURLConnection connection = (HttpURLConnection) url.openConnection(); connection.setRequestMethod("GET"); connection.setDoInput(true); connection.setDoOutput(false); connection.addRequestProperty("Content-Type", "application/json"); connection.addRequestProperty("X-Auth-Token", token); InputStream is = connection.getInputStream(); BufferedReader br = new BufferedReader(new InputStreamReader(is, "UTF-8")); while (br.ready()) { System.out.println(br.readLine()); } } catch (Exception e) { e.printStackTrace(); } } public static void main(String[] args) { CBSDemo CBSDemo = new CBSDemo(); CBSDemo.cbsDemo(); } }

响应示例 状态码：200 成功响应示例 { "keywords": [ { "keyword":"桌面云", "freq":15 }, { "keyword":"弹性云服务器", "freq":15 } ] } 状态码：400 失败响应示例 { "error_code":"CBS.0021", "error_msg":"request parameter error" }

响应参数 状态码： 200 表4 响应参数 参数 参数类型 描述 keywords Array of KeyWordsStat objects 指定时间范围内，用户问关键词列表。调用失败时无此字段。 表5 KeyWordsStat 参数 参数类型 描述 keyword String 关键词。 freq Long 关键词频次。 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。

URI GET https://{endpoint}/v1/{project_id}/qabots/{qabot_id}/requests/keywords?top={top}&start_time={start_time}&end_time={end_time} 表1 路径参数 参数 是否必选 参数类型 描述 endpoint 是 String 终端节点，即调用API的请求地址。 不同服务不同区域的endpoint不同，您可以从终端节点中获取。 例如，CBS服务在“华北-北京四”区域的“endpoint”为“cbs-ext.cn-north-4.myhuaweicloud.com”。 project_id 是 String 项目ID，用于资源隔离。请参见获取项目ID。 qabot_id 是 String qabot编号，UUID格式，如：303a0a00-c88a-43e3-aa2f-d5b8b9832b02。 获取方法： 登录对话机器人服务控制台，在智能问答机器人列表中查看qabot_id。 表2 Query参数 参数 是否必选 描述 top 否 用户问题关键词列表显示的个数。默认值为10，取值范围[1-50]。 start_time 否 查询的起始时间，long，UTC时间，采用毫秒时间戳，默认值为0。 end_time 否 查询的结束时间，long，UTC时间，采用毫秒时间戳，默认值为当前时间的毫秒数。

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 request_id String 调用成功时的返回请求ID。 调用失败时无此字段。 updated_time String 反馈满意度的时间。格式为“yyyy-MM-dd THH:mm:ssZ”。其中，T指某个时间的开始；Z指UTC时间。 调用失败时无此字段。 状态码： 400 表5 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。

URI POST https://{endpoint}/v1/{project_id}/qabots/{qabot_id}/requests/{request_id}/satisfaction 表1 路径参数 参数 是否必选 参数类型 描述 endpoint 是 String 终端节点，即调用API的请求地址。 不同服务不同区域的endpoint不同，您可以从终端节点中获取。 例如，CBS服务在“华北-北京四”区域的“endpoint”为“cbs-ext.cn-north-4.myhuaweicloud.com”。 project_id 是 String 项目ID，用于资源隔离。请参见获取项目ID。 qabot_id 是 String qabot编号，UUID格式，如：303a0a00-c88a-43e3-aa2f-d5b8b9832b02。 进入问答机器人的Console界面，在“机器人名称/ID”列显示对应的qabot_id。 request_id 是 String 请求ID，获取方式请参见响应参数中的request_id。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 用于获取操作API的权限。获取Token接口响应消息头中X-Subject-Token的值即为Token。 Content-Type 是 String 消息体的类型（格式），参数值为“application/json”。 表3 请求Body参数 参数 是否必选 参数类型 描述 degree 是 Integer 满意度评分，当前仅支持二级评分，1表示满意，-1表示不满意，标注为不满意的问答会加入到未解决问题中。

请求示例 对智能问答返回结果的满意度评价为满意 POST https://{endpoint}/v1/1604d8170cd84440a81281e5a3a04f8b/qabots/303a0a00-c88a-43e3-aa2f-d5b8b9832b02/requests/303a0a00-c88a/satisfaction Request Header: Content-Type: application/json X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Request Body: { "degree":1 } Python语言请求代码示例 import requests url = "https://{endpoint}/v1/{project_id}/qabots/{qabot_id}/requests/{request_id}/satisfaction" body = {"degree":1} token = "用户获取得到的实际token值" headers = {'Content-Type': 'application/json', 'X-Auth-Token': token} response = requests.post(url, headers=headers, json=body, verify=False) print(response.text) Java语言请求代码示例 import java.io.BufferedReader; import java.io.InputStream; import java.io.InputStreamReader; import java.io.OutputStreamWriter; import java.net.HttpURLConnection; import java.net.URL; public class CBSDemo { public void cbsDemo() { try { //endpoint、projectId、qabot_id需要替换成实际信息。 URL url = new URL("https://{endpoint}/v1/{project_id}/qabots/{qabot_id}/requests/{request_id}/satisfaction"); String token = "用户获取得到的实际token值"; HttpURLConnection connection = (HttpURLConnection) url.openConnection(); connection.setRequestMethod("POST"); connection.setDoInput(true); connection.setDoOutput(true); connection.addRequestProperty("Content-Type", "application/json"); connection.addRequestProperty("X-Auth-Token", token); //输入参数 String body = "{\"degree\":1}"; OutputStreamWriter osw = new OutputStreamWriter(connection.getOutputStream(), "UTF-8"); osw.append(body); osw.flush(); InputStream is = connection.getInputStream(); BufferedReader br = new BufferedReader(new InputStreamReader(is, "UTF-8")); while (br.ready()) { System.out.println(br.readLine()); } } catch (Exception e) { e.printStackTrace(); } } public static void main(String[] args) { CBSDemo CBSDemo = new CBSDemo(); CBSDemo.cbsDemo(); } }

操作步骤 进入行业视频管理服务后台。 在华为账号登录框，单击“注册”，进入账号注册界面。 单击选中“华为账号”，在华为账号注册页面，输入手机号、验证码、密码并确认密码，单击“注册”。 如果需要注册行业视频管理账号，则单击选中“行业视频管理服务账号”，跳转至行业视频管理服务账号注册页面，参考注册行业视频管理服务账号进行创建。 此处注册的华为账号与创建华为云租户中注册的华为账号（华为云实名认证）不同。 此处的华为账号用于登录行业视频管理服务后台，创建企业后可以对所在企业或组织的人员、设备等进行管理。 创建华为云租户中的华为账号指真实的个人或企业登录华为云的账号信息，客户的基本信息、订单信息、费用信息都和客户的账号相关联。

约束限制 XGPU功能仅在Nvidia Tesla T4、V100上支持。 HCE OS内核版本为5.10及以上版本。 GPU实例已安装535.54.03版本的NVIDIA驱动。 GPU实例已安装18.09.0-300或更高版本的docker。 XGPU服务的隔离功能不支持以UVM的方式申请显存，即调用CUDA API cudaMallocManaged()，更多信息，请参见NVIDIA官方文档。请使用其他方式申请显存，例如调用cudaMalloc()等。 受GPU虚拟化技术的限制，容器内应用程序初始化时，通过nvidia-smi监测工具监测到的实时算力可能超过容器可用的算力上限。 当CUDA应用程序创建时，会在GPU卡上申请一小部分UVM显存（在Nvidia Tesla T4上大约为3 MiB），这部分显存属于管理开销，不受XGPU服务管控。 暂不支持同时在裸机环境以及该环境直通卡的虚拟机中同时使用

XGPU服务使用示例 影响XGPU服务的环境变量如下表所示，您可以在创建容器时指定环境变量的值。容器引擎可以通过XGPU服务获得算力和显存。 表1 影响XGPU服务的环境变量 环境变量名称 取值类型 说明 示例 GPU_IDX Integer 指定容器可使用的GPU显卡。 为容器分第一张显卡： GPU_IDX=0 GPU_CONTAINER_MEM Integer 设置容器内可使用的显存大小，单位 MiB。 为容器分配的显存大小为5120MiB： GPU_CONTAINER_MEM=5120 GPU_CONTAINER_QUOTA_PERCENT Integer 指定显卡算力分配百分比。 算力支持最小1%粒度的划分，推荐最小算力不低于4%。 为容器分配50%的算力比例： GPU_CONTAINER_QUOTA_PERCEN=50 GPU_POLICY Integer 指定GPU使用的算力隔离的策略。 0：不隔离算力，即原生调度。 1：固定算力调度。 2：平均调度。 3：抢占调度。 4：权重抢占调度。 5：混合调度。 6：权重弱调度。 算力隔离策略示例详见XGPU算力调度示例。 设置算力隔离策略为固定算力调度：GPU_POLICY=1 GPU_CONTAINER_PRIORITY Integer 指定容器的优先级。 0：低优先级 1：高优先级 创建高优先级容器： GPU_CONTAINER_PRIORITY=1 以nvidia的docker创建两个容器为例，介绍XGPU服务的使用方法，数据规划如下。 表2 数据规划 参数 容器1 容器2 说明 GPU_IDX 0 0 指定两个容器使用第一张显卡。 GPU_CONTAINER_QUOTA_PERCENT 50 30 为容器1分配50%算力，为容器2分配30%算力。 GPU_CONTAINER_MEM 5120 1024 为容器1分配5120MiB显存，为容器2分配1024MiB显存。 GPU_POLICY 1 1 设置第一张显卡使用固定算力调度策略。 GPU_CONTAINER_PRIORITY 1 0 指定容器1为高优先级容器，容器2为低优先级容器。 配置示例： docker run --rm -it --runtime=nvidia -e GPU_CONTAINER_QUOTA_PERCENT=50 -e GPU_CONTAINER_MEM=5120 -e GPU_IDX=0 -e GPU_POLICY=1 -e GPU_CONTAINER_PRIORITY=1 --shm-size 16g -v /mnt/:/mnt nvcr.io/nvidia/tensorrt:19.07-py3 bash docker run --rm -it --runtime=nvidia -e GPU_CONTAINER_QUOTA_PERCENT=30 -e GPU_CONTAINER_MEM=1024 -e GPU_IDX=0 -e GPU_POLICY=1 -e GPU_CONTAINER_PRIORITY=0 --shm-size 16g -v /mnt/:/mnt nvcr.io/nvidia/tensorrt:19.07-py3 bash

修订记录 发布日期 更新说明 2024-03-30 第八次正式发布 新增 HCE OS的REPO源配置与软件安装 修改 迁移操作，补充备份相关描述。 2023-12-30 第七次正式发布 修改 XGPU算力调度示例，补充权重弱调度（policy=6）内容。 动态加速，补充动态应用加速工具字符交互界面指令内容。 2023-11-10 第六次正式发布 新增 内核异常事件分析指南 动态加速 修改 约束限制，兼容性支持ko格式。 评估软件兼容性，支持扫描嵌套目录。 工具概述，新增支持EulerOS 2.9/2.10和HCE OS 2.0 ARM操作系统的兼容性评估。 冲突包列表，更新冲突包列表。 约束限制，增加约束限制。 概述，增加动态加速介绍，以及静态加速和动态加速的优缺点。 配置文件，增加动态加速配置文件及参数说明。 安装并使用XGPU、XGPU算力调度示例，增加混部调度相关描述。 制作Docker镜像并启动容器，修改约束限制以及完善操作步骤内容。 评估软件兼容性，补充ARM架构软件兼容性扫描示例内容。 迁移操作，迁移工具安装包版本号更新以及修改系统迁移说明内容。 约束限制，修改约束限制。 约束限制，修改约束限制。 安装并使用XGPU，修改约束限制。 2023-08-03 第五次正式发布 修改 准备工作，增加motd_setup参数。 OSMT命令帮助信息，增加--nocheck参数。 HCE OS获取openEuler扩展软件包，更新操作步骤。 概述、静态加速，支持hce-wae-auto命令优化应用程序，增加相关内容。 XGPU共享技术概述，算力支持力度由5%优化至1%，修改对应描述；增加“XGPU功能仅在Nvidia Tesla T4、V100、A100、A30、A40、A800上支持”的约束限制。 安装并使用XGPU，增加GPU_POLICY、GPU_CONTAINER_PRIORITY、max_inst、priority参数及相关内容；算力隔离的策略由0~1优化至0~4；增加“通过xgpu-smi工具监控容器”内容。 增加 制作Docker镜像并启动容器 配置文件 XGPU算力调度示例 2023-03-30 第四次正式发布。 增加 Pod带宽管理工具 内核功能与接口 内核memory的OOM进程控制策略 内核memory的多级内存回收策略 内核cpu cgroup的多级混部调度 XGPU共享技术 XGPU共享技术概述 安装并使用XGPU 修改 冲突包列表，补充CentOS 8.4/8.5的冲突包列表。 约束限制，补充约束限制。 准备工作、/etc/osmt/osmt.conf配置文件说明，增加preinstalled_only、recover_service参数，更新osmt.conf配置文件内容。 OSMT命令帮助信息，增加-V, --verbose、-o, --preinstalled-only、-t, --retry、-c, --cancel参数。 静态加速，更新操作步骤。 删除 应用加速工具中的“常见问题”章节 perf工具 2023-01-17 第三次正式发布。 增加 约束限制 升级后续操作 工具类 修改 冲突包列表，增加CentOS 8.3冲突包列表。 使用dnf或yum命令升级，更新dnf list updates命令，补充操作步骤3。 约束限制，补充约束限制。 版本升级和回退，优化操作步骤。 准备工作，更新osmt.conf配置，补充参数项及描述。 osmt update命令更新，优化操作步骤。 osmt-agent服务自动更新，优化操作步骤。 回退RPM包，补充回退说明。 2022-10-20 第二次正式发布。 增加 x2hce-ca应用兼容性评估章节。 将操作系统迁移至HCE OS 1.1章节。 升级概述章节。 使用OSMT工具升级章节 附录章节。 对HCE OS进行安全更新章节。 修改 迁移操作，适配HCE OS 2.0能力，修改迁移操作。 冲突包列表，增加HCE OS、EulerOS冲突包列表。 使用dnf或yum命令升级，对内容适配，支持HCE OS 1.1版本的RPM升级。 2022-07-15 第一次正式发布。

操作步骤 执行以下命令，下载lnmp2.0，并解压进入目录。 wget http://soft.vpser.net/lnmp/lnmp2.0.tar.gz -O lnmp2.0.tar.gz && tar zxf lnmp2.0.tar.gz && cd lnmp2.0 执行以下命令修改main.sh文件。 vim include/main.sh 在Get_Dist_Name函数中添加一个elif判断。 elif grep -Eqi "Huawei Cloud EulerOS" /etc/issue || grep -Eq "Huawei Cloud EulerOS" /etc/*-release; then DISTRO='HCE' PM='yum' 执行以下命令修改init.sh文件。 vim include/init.sh 在Install_Freetype函数的if判断中添加如下代码。 echo "${HCE_Version}" | grep -Eqi "^2\.[0-9]" || 执行以下命令开始安装。 ./install.sh lnmp 当出现如下回显，则安装成功。

操作步骤 执行以下命令下载qperf 0.4.11源码文件。 wget https://github.com/linux-rdma/qperf/archive/refs/tags/v0.4.11.tar.gz 执行以下命令解压下载文件。 tar -xf v0.4.11.tar.gz 解压后得到目录qperf-0.4.11。 执行以下命令安装依赖。 dnf install gcc make automake 进入qperf-0.4.11目录，依次执行以下命令进行编译。 ./cleanup ./autogen.sh ./configure make 验证编译结果。 编译得到的二进制在qperf-0.4.11/src目录下，进入该目录后执行./qperf –version，得到类似如下回显，表示编译成功：

请求示例 切换云服务器操作系统，切换后采用密码方式登录鉴权，建议将密码在配置文件或者环境变量中密文存放，使用时解密，确保安全。 POST https://{endpoint}/v2/{project_id}/cloudservers/{server_id}/changeos { "os-change": { "adminpass": "$ADMIN_PASS", "userid": "7e25b1da389f4697a79df3a0e5bd494e", "imageid": "e215580f-73ad-429d-b6f2-5433947433b0", "mode": "withStopServer" } } 切换云服务器操作系统，切换后采用密钥方式登录鉴权。 POST https://{endpoint}/v2/{project_id}/cloudservers/{server_id}/changeos { "os-change": { "keyname": "KeyPair-350b", "userid": "7e25b1da389f4697a79df3a0e5bd494e", "imageid": "e215580f-73ad-429d-b6f2-5433947433b0" } } 使用系统盘加密的整机镜像切换云服务器的操作系统，切换后使用密码方式登录鉴权，建议将密码在配置文件或者环境变量中密文存放，使用时解密，确保安全。 POST https://{endpoint}/v2/{project_id}/cloudservers/{server_id}/changeos { "os-change": { "adminpass": "$ADMIN_PASS", "userid": "7e25b1da389f4697a79df3a0e5bd494e", "imageid": "e215580f-73ad-429d-b6f2-5433947433b0", "metadata": { "__system__encrypted": "1", "__system__cmkid": "83cdb52d-9ebf-4469-9cfa-e7b5b80da846" } } }

功能介绍 切换弹性云服务器操作系统。支持弹性云服务器数据盘不变的情况下，使用新镜像重装系统盘。 本接口为异步接口，当前切换弹性云服务器操作系统请求下发成功后会返回job_id，此时切换弹性云服务器操作系统并没有立即完成，需要通过调用查询任务的执行状态查询job状态，当Job状态为 SUCCESS 时代表云服务器操作系统切换成功。 调用该接口后，系统将卸载系统盘，然后使用新镜像重新创建系统盘，并挂载至弹性云服务器，实现切换操作系统功能。

请求消息 请求参数如表2所示。 表2 请求参数 参数 是否必选 参数类型 描述 os-change 是 Object 切换弹性云服务器操作系统，详情参见 表3。 表3 os-change字段数据结构说明 参数 是否必选 参数类型 描述 adminpass 否 String 云服务器管理员账户的初始登录密码。 其中，Windows管理员账户的用户名为Administrator，Linux管理员账户的用户名为root。 建议密码复杂度如下： 长度为8-26位。 密码至少必须包含大写字母、小写字母、数字和特殊字符（!@$%^-_=+[{}]:,./?~#*）中的三种。 说明： Windows云服务器仅支持密码方式，且密码不能包含用户名或用户名的逆序，不能包含用户名中超过两个连续字符的部分。 adminpass和keyname不能同时为空。 adminpass和keyname不能同时有值。 keyname 否 String 密钥名称。 密钥可以通过密钥创建接口进行创建 创建和导入SSH密钥（请参见），或使用SSH密钥查询接口查询已有的密钥（请参见查询SSH密钥列表 ）。 userid 否 String 用户ID。当传入keyname参数时，优先使用本参数设置的userid，若userid为空，默认使用当前token中的userid。 查看用户ID方法： 登录管理控制台。 单击用户名，在下拉列表中单击“我的凭证”。在该页面查看IAM用户ID。 imageid 是 String 切换系统所使用的新镜像的ID，格式为UUID。 镜像的ID可以从控制台或者参考《镜像服务API参考》的“查询镜像列表”的章节获取。 isAutoPay 否 String 下单订购后，是否自动从客户的账户中支付，而不需要客户手动去进行支付。 “true”：是（自动支付） “false”：否（需要客户手动支付） 说明： 适用于包年/包月虚拟机费用发生变化时，不传该字段时默认为客户手动支付。 metadata 否 Object 切换云服务器的元数据。 更多信息，请参见表4。 mode 否 String 取值为withStopServer ，支持开机状态下切换弹性云服务器操作系统。 mode取值为withStopServer时，对开机状态的 弹性云服务器执行切换操作系统操作，系统自动对云服务器先执行关机，再切换操作系统。 表4 metadata字段数据结构说明 参数 是否必选 参数类型 描述 __system__encrypted 否 String metadata中的表示加密功能的字段，0代表不加密，1代表加密。 该字段不存在时，系统盘默认为不加密。 __system__cmkid 否 String 用户主密钥ID，是metadata中的表示加密功能的字段，与__system__encrypted配合使用。 说明： 请参考查询密钥列表，通过HTTPS请求获取密钥ID。

功能介绍 切换弹性云服务器操作系统。 本接口为异步接口，当前切换弹性云服务器操作系统请求下发成功后会返回job_id，此时切换弹性云服务器操作系统并没有立即完成，需要通过调用查询任务的执行状态查询job状态，当Job状态为 SUCCESS 时代表云服务器操作系统切换成功。 调用该接口后，系统将卸载系统盘，然后使用新镜像重新创建系统盘，并挂载至弹性云服务器，实现切换操作系统功能。 该接口支持未安装Cloud-init或Cloudbase-init的镜像使用，如果镜像安装了Cloud-init或者Cloudbase-init，请使用 切换弹性云服务器操作系统（安装Cloud-init）接口。

请求示例 切换云服务器操作系统，切换后采用密钥方式登录鉴权。 POST https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/changeos { "os-change": { "keyname": "KeyPair-350b", "userid": "7e25b1da389f4697a79df3a0e5bd494e", "imageid": "e215580f-73ad-429d-b6f2-5433947433b0", "metadata": { "__system__encrypted": "1", "__system__cmkid": "83cdb52d-9ebf-4469-9cfa-e7b5b80da846" }, "mode": "withStopServer" } }

缓存刷新和缓存预热提示用户权限不足 如果您在进行缓存刷新和缓存预热操作时提示权限不足，可参照以下方法排查： 如果您使用的是IAM子账号登录，请先确认您的IAM子账号是否具有刷新预热的操作权限：CDN RefreshAndPreheatAccess。子账号的操作权限可向主账号管理员申请开通。 如果您的账号具有刷新预热的操作权限但仍提示用户权限不足，请查看您的域名是否已停用，账户欠费会导致您的域名停用，请检查账户余额。 父主题： 刷新预热

CDN受到恶意攻击会计费吗？ 遭受攻击消耗的流量或带宽会按CDN的计费规则计费。 当域名遭受攻击影响到CDN其他用户或者CDN自身安全时，CDN封禁加速域名，最终域名状态调整为“停用”，停止CDN加速服务。域名停用后将无法正常访问，但域名配置信息仍会保留，待攻击停止后可联系客服申请解除封禁。 应对办法 应对办法 说明 配置访问控制 给域名配置访问控制功能（包括Referer防盗链、IP黑白名单、URL鉴权等），以避免产生不必要的流量带宽消耗。详细设置请参见访问控制。 配置CDN联动CES 配置CDN联动CES功能，通过对接CES（云监控服务）实现实时查看账号下加速域名的基础数据（流量、带宽、状态码等）、设置告警等功能，当监控指标触发您设置的告警条件时，会以邮箱、短信等方式发送告警，方便您及时发现潜在的风险。 配置用量封顶 配置用量封顶功能，当用户的访问带宽达到设置的值后，CDN会停用您的加速域名，以免产生过高的账单。 配置请求限速 配置请求限速功能，当单个请求达到限速条件后终端用户的访问速度会被限制，一定程度上减少突发高带宽风险。 配置费用预警 开通费用预警功能，当账户可用额度低于一定金额时，系统会发送短信提醒。 为了确保统计数据的完整性和账单的准确性，CDN产品账单生成时间会存在延时，因此实际计费时间晚于对应的CDN资源消耗时间，无法通过账单来实时反馈资源消费情况，这是由于CDN产品自身的分布式节点特性导致，也是业界通用的处理方法。 父主题： 购买计费

什么是配额？ 为防止资源滥用，平台限定了各服务资源的配额，对用户的资源数量和容量做了限制。CDN对用户添加的加速域名数量、URL刷新条数、目录刷新条数、URL预热条数做了如表1所示的限制。 表1 配额一览表 类别 描述 总配额 域名数 每个账号最多支持添加的加速域名数量。 100 URL刷新条数/天 每个账号每天最多支持的URL缓存刷新条数。 2000 目录刷新条数/天 每个账号每天最多支持的目录缓存刷新条数。 100 URL预热条数/天 每个账号每天最多支持的URL缓存预热条数。 1000 如果当前资源配额限制无法满足使用需要，您可以提交工单申请扩大配额。 父主题： 配额相关

使用OBS私有桶做源站，创建授权委托失败 创建委托授权失败有可能是以下两种原因： IAM的授权委托配额已用完：您可以在配额管理页面确认是否还有IAM的授权委托配额，如果已使用完，请在IAM控制台将不需要的授权委托删除或者提交工单调整配额。 IAM子账户权限不足：请查看IAM子账号是否有Security Administrator权限，如果无此权限则无法创建授权委托，开通Security Administrator权限请参考给IAM用户授权。 父主题： 故障相关

如何开通CDN服务？ 如果您需要购买并使用CDN，请参考以下流程： 您需要注册华为账号，完成实名认证（国际站用户加速范围为中国大陆境外的无需实名认证）。 开通CDN需要您账户有一定余额（余额超过999元），您可以去费用中心完成充值。 进入费用中心，单击“充值”，根据界面提示对账户信息进行充值。 如果您准备选流量计费方式，也可以根据界面提示购买CDN流量套餐包进行抵扣。 充值或者购买流量包后开通CDN服务，完成各项配置，即可使用CDN加速。 父主题： 使用咨询

因欠费导致CDN服务不可用的情况排查 以下原因可能会导致您的账号因欠费而无法使用CDN服务： CDN按需计费，账户余额耗尽而欠费。 您使用了华为云其它服务，导致账户余额耗尽而欠费，此时如果您有需要扣除账户余额的CDN业务（按需计费无流量包、全站加速请求数计费等），也将因欠费而无法使用CDN。 欠费影响 当您的账户欠费后，华为云将根据您的客户等级来定义云服务资源保留期时长，更多欠费停服处理规则请参见保留期。 宽限期内CDN业务不会停止，但是不能新增加速域名。 应对措施 建议您设置余额预警，当账户余额小于一定额度时，CDN会通知您，详见如何设置余额预警阈值。 如果您购买了流量包，建议您开通流量包剩余使用量预警，当您的流量包余额到达预警阈值时，系统会发送短信、邮件提醒。 核销欠款 您可以在费用中心查看账户的欠费信息，并通过充值来核销欠款。 父主题： 购买计费

提高缓存命中率、优化加速效果 使用场景 配置项 说明 缓存命中率低、加速效果不明显 配置缓存规则 合理配置不同资源的缓存过期时间和优先级，能有效提升缓存命中率，降低回源率，减轻源站压力。 注意事项： 注意设置缓存优先级，优先级取值为1~100之间的整数，数值越大优先级越高。 如果您修改或新增了缓存规则，请刷新对应资源的缓存。 请将动态资源的缓存过期时间设置为“0”，即不缓存，否则将导致访问异常。 检查源站资源cache-control配置，如果设置为不缓存（no-cache、private、no-store），同时在CDN侧开启了“缓存遵循源站”功能，则CDN节点无法缓存，用户每次访问这个资源都需要回源，无法达到加速的目的。 Range回源 如果您的资源内容较大，希望CDN回源时只返回指定范围的内容，以便缩短大文件的分发时间，提升回源效率，减少回源消耗，您需要设置Range回源。 文件下载加速默认开启Range回源。 确认源站是否支持Range。 智能压缩 如果您想要压缩您网站的静态资源，缩小传输文件的大小，提升传输效率，减少带宽消耗，您需要开启智能压缩。 智能压缩包含Gzip压缩和Brotli压缩，Brotli压缩的性能比Gzip压缩提升约15%~25%。 开启智能压缩功能时，CDN会自动压缩静态文件（.js、.html、.css、.xml、.json、.shtml、.htm）。 URL参数 如果您需要CDN节点在缓存资源忽略或保留“?”之后参数，提高缓存命中率，提升分发效率，您需要开启URL参数。 URL参数变化，资源不变，可以配置忽略参数。 URL参数变化，资源变化，不可配置忽略参数。

域名准入要求 接入CDN做加速的域名必须满足如表1的要求。 表1 域名准入基础要求 加速范围 域名准入基础要求 中国大陆 华为账号已完成实名认证。 域名已在工信部备案，且当前备案信息正常可用。 加速域名接入时需通过内容审核。 中国大陆境外 加速域名接入时需通过内容审核。 全球 华为账号已完成实名认证。 域名已在工信部备案，且当前备案信息正常可用。 加速域名接入时需通过内容审核。 中国大陆境外包括：中国香港、中国澳门、中国台湾、其他国家及地区。 CDN不支持接入违反相关法律法规的域名，包括但不限于： 涉黄、涉赌、涉毒、涉诈、侵权内容的网站 游戏私服类网站 盗版游戏 / 软件 / 盗版视频网站 P2P类金融网站 彩票类网站 违规医院和药品类网站 网站无法正常访问或内容不含有任何实质信息 如果您的加速域名含有以上违规的内容，您将自行承担相关风险。 如果发现涉黄、涉赌、涉毒、涉诈等违规行为，CDN将执行域名封禁策略（删除相关加速域名且不允许再次接入，与违规域名使用相同源站的加速域名同样执行域名封禁策略），账号加速域名配额降为0。 域名是否需要备案与域名提供商地域、网站服务器所处地域无关，与您加速域名的CDN加速服务范围有关。只要您的加速服务范围为中国大陆或全球，该域名就必须在工信部备案后才能接入CDN。 加速域名对域名服务商没有要求。 根域名和普通域名需要分别在控制台添加加速域名。