华为云用户手册

调用BSS接口状态码返回400 BadRequest 一般出现这种情况有两种可能： 合作伙伴调用接口时传入的请求参数有误。此时可以查看响应消息，一般会说明是哪个请求参数有误，请查看调用时是否遵循《API参考》中该请求参数的定义。 传入的请求消息不是JSON格式。请检查请求消息头参数中是否添加了“Content-Type":"application/json”字段，并确保传入的请求消息是JSON格式。若全是非必填参数，需传入"{}"。 父主题： 接口调用

手动备份DCS实例数据 登录分布式缓存服务管理控制台。 在管理控制台左上角单击，选择实例所在的区域。 单击左侧菜单栏的“缓存管理”，进入实例信息页面。 “缓存管理”支持通过筛选来查询对应的缓存实例。支持的筛选条件有“名称”、“规格”、“ID”、“IP地址”、“可用区”、“状态”、“实例类型”、“缓存类型”等。 在需要备份的DCS缓存实例左侧，单击实例名称，进入实例的基本信息页面。 单击“备份与恢复”页签，进入备份与恢复管理页面。 单击“手动备份”，弹出手动备份窗口。 选择备份格式，支持选择RDB格式或AOF格式。 Redis 4.0、5.0、6.0基础版和企业版高性能型实例支持选择RDB或AOF备份格式，企业版存储型实例仅支持RDB格式，Redis 3.0实例仅支持RDB格式。 AOF格式的备份会优先在从节点备份，从节点AOF会被重写。 单击“确定”，开始执行手工备份任务。 备注说明最长不能超过128个字节。 实例备份需耗时10~15分钟，备份期间发生的数据新增或修改记录，将不会保存到备份数据中。

备份方式 DCS缓存实例支持自动和手动两种备份方式。 自动备份 您可以通过管理控制台设置一个定时自动备份策略，在指定时间点将实例的缓存数据自动备份存储。 自动备份频率以天为单位，您根据需要，选择每周备份一次或多次。备份数据保留最多7天，过期后系统自动删除。 自动备份主要目的在于让实例始终拥有一个完整的数据副本，在必要时可以及时恢复实例数据，保证业务稳定，实例数据安全多一重保障。 手动备份 除了定时备份，DCS还支持由用户手动发起备份请求，将实例当前缓存数据进行备份，并存储到OBS服务中。 您在执行业务系统维护、升级等高危操作前，可以先行备份实例缓存数据。

备份的其他说明 支持备份的实例类型 Redis的“主备”、“Proxy集群”、“Cluster集群”和“读写分离”实例支持数据备份与恢复功能，“单机”实例暂不支持。单机实例若需要备份，可参考Redis单机实例使用Redis-cli工具备份，使用redis-cli工具导出RDB文件。 Memcached的“主备”实例支持数据备份与恢复功能，“单机”实例暂不支持。 备份原理 Redis 3.0实例采用的是AOF文件进行持久化，Redis 4.0及以上基础版实例，手动备份支持选择RDB格式和AOF格式进行持久化；自动备份仅支持RDB格式进行持久化。 如果需要导出Redis 3.0的RDB备份文件，可以通过redis-cli导出，使用命令：redis-cli -h {redis_address} -p 6379 -a {password} --rdb {output.rdb}。 DCS Redis 3.0已下线，暂停售卖，建议使用Redis 4.0及以上版本。 放通了SYNC命令的Redis 3.0单机实例可以通过执行此命令将RDB文件导出；Redis 3.0 proxy实例由于架构的原因，不支持放通SYNC命令，因此不能导出RDB文件。 备份任务在备节点执行，DCS通过将备节点的数据持久化文件压缩并转移到OBS服务中存储，从而实现实例数据备份。 DCS以小时为单位，定期检查所有实例的备份策略，对于需要执行备份的实例，启动备份任务。 备份过程对实例的影响 备份操作是在备节点执行，备份期间不影响实例正常对外提供服务。 在全量数据同步或者实例高负载的场景下，数据同步需要一定的时间，在数据同步没有完成的情况下开始备份，备份数据与主节点最新数据相比，有一定延迟。 由于备节点停止将发生的最新数据变化持久化到磁盘文件，备份期间主节点如有新的数据写入，备份文件也不会包含备份期间的数据变化。 备份时间点的选择 建议选择业务量少的时间段进行备份。 备份文件的存储 备份文件存储在对象存储服务（OBS）中。 自动备份异常的处理 自动备份任务触发后，如果实例当前正在进行重启、扩容等操作，则定时任务顺延到下一时间段处理。 实例备份失败或者因为其他任务正在进行而推迟备份，DCS会在下一时间段继续尝试备份，一天最多会尝试三次。 备份数据保存期限 自动备份产生的备份文件根据您设置的策略保留1-7天，超期由系统自动删除，但至少会保留最近一次的数据备份记录。 如果备份数量没有超出最大限制（24个），手动备份数据不会自动清除，您可根据需要手动删除备份数据。 自动和手动备份记录总数最多不超过24个，当备份记录超过24个时，自动删除最早的备份记录。 当删除实例时，备份数据会随实例删除，如果需要保存备份数据，请提前将备份数据下载保存。

关于数据恢复 数据恢复流程 您通过控制台发起数据恢复请求。 DCS从对象存储服务（OBS）获取数据备份文件。 暂停实例数据读写服务。 替换主实例的持久化文件。 重新加载新的持久化文件。 完成数据恢复，对外提供数据读写服务。 数据恢复对业务系统的影响 恢复操作是将备份文件在主节点执行，实例数据恢复期间需暂停数据读写服务，直到主实例完成数据恢复。 数据恢复异常处理 数据恢复文件如果被损坏，DCS在恢复过程中会尝试修复。修复成功则继续进行数据恢复，修复失败，DCS主备实例会将实例还原到执行恢复前的状态。

请求示例 为云服务器切换VPC，添加网卡、安全组并指定IP地址。 POST https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/changevpc { "vpc_id": "d32019d3-bc6e-4319-9c1d-6722fc136a23", "nic": { "subnet_id": "d32019d3-bc6e-4319-9c1d-6722fc136a23", "security_groups": [ { "id": "f0ac4394-7e4a-4409-9701-ba8be283dbc3" } ], "ip_address": "192.168.255.1" } }

请求消息 请求参数如表2所示。 表2 请求参数 参数 是否必选 参数类型 描述 vpc_id 是 String 虚拟机私有云ID ，UUID格式。 nic 是 Object 需要添加的网卡参数列表，详情请参见表3。 表3 nic字段数据结构说明 参数 是否必选 参数类型 描述 port_id 否 String 网卡ID，UUID格式。 当该字段不为空时，表示挂载指定的网卡。 说明： port_id和subnet_id不能同时为空。 网卡ID可以通过虚拟私有云的“查询端口列表”接口查询。 约束： 网卡必须带有安全组。 网卡状态必须为DOWN。 网卡的vpcid必须和传入的vpcid一致。 当port_id和subnet_id同时存在的时候，优先使用port_id。 当选择port_id不为空时，代表此时使用的是弹性网卡，此时security_groups和ip_address等参数不生效。 subnet_id 否 String 云服务器添加网卡的信息。 需要指定云服务器所属虚拟私有云下已创建的网络（network）的ID，UUID格式。 security_groups 否 Array of objects 添加网卡的安全组信息，详情请参见表4。 ip_address 否 String IP地址，无该参数表示自动分配IP地址。 表4 security_groups字段数据结构说明 参数 是否必选 参数类型 描述 id 是 String 安全组ID。

功能介绍 云服务器切换虚拟私有云。 本接口为异步接口，当前云服务器切换虚拟私有云请求下发成功后会返回job_id，此时云服务器切换虚拟私有云并没有立即完成，需要通过调用查询任务的执行状态查询job状态，当Job状态为 SUCCESS 时代表云服务器虚拟私有云切换成功。 切换虚拟私有云会卸载当前主网卡，用新指定的虚拟私有云创建主网卡。 若原主网卡绑定有弹性IP，则会将弹性IP绑定到新创建的主网卡上。 切换虚拟私有云会导致云服务器网络中断，同时更改云服务器子网、IP地址、MAC地址。 虚拟私有云切换完成后，与网络配置相关的应用软件需要重新配置。与网络相关的服务也需要重新配置，例如ELB、VPN、NAT、DNS等。 切换虚拟私有云过程中，请勿操作云服务器的弹性IP，或对云服务器做其他操作。

请求消息 请求参数如表 请求参数所示。 表2 请求参数 参数 是否必选 参数类型 描述 subnet_id 否 String 子网ID ，UUID格式。更新IPv4地址时，必须指定该参数；更新IPv6地址时，该参数可以不填。 ip_address 否 String IPv4地址，为空字符串时表示随机更新网卡IPv4地址。 约束： 该参数和ipv6_address必须指定一个。 该参数和ipv6_address不能同时指定。 ipv6_address 否 String IPv6地址，为空字符串时表示随机更新网卡IPv6地址。 约束： 该参数和ip_address必须指定一个。 该参数和ip_address不能同时指定。

请求示例 更新云服务器网卡，并指定IPv4地址。 POST https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/os-interface/{port_id}/change-network-interface { "subnet_id": "7bf939cc-167f-49d5-a933-9cca504210ab"， "ip_address":"192.168.1.159" } 更新云服务器网卡，随机分配IPv4地址。 POST https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/os-interface/{port_id}/change-network-interface { "subnet_id": "7bf939cc-167f-49d5-a933-9cca504210ab"， "ip_address":"" } 更新云服务器网卡，并指定IPv6地址。 POST https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/os-interface/{port_id}/change-network-interface { "subnet_id": "7bf939cc-167f-49d5-a933-9cca504210ab"， "ipv6_address":"2001:db8:a583:578:2840:2d9f:27d4:2713" } 更新云服务器网卡，随机分配IPv6地址。 POST https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/os-interface/{port_id}/change-network-interface { "subnet_id": "7bf939cc-167f-49d5-a933-9cca504210ab"， "ipv6_address":"" }

接口约束 关机状态的弹性云服务器才允许更新指定网卡属性。 当前只允许更新弹性云服务器主网卡属性。 只开通了IPv4协议的网卡，不支持修改网卡的IPv6地址。 只开通了IPv4协议的网卡，不支持跨VPC修改网卡的IPv4地址。 已开通IPv6协议的网卡，不支持跨子网修改网卡的IPv4地址和IPv6地址。 已开通IPv6协议的网卡，网卡上已绑定共享带宽或虚拟IP，不允许修改网卡的IPv4地址和IPv6地址。

响应示例 { "id": "6bcb3ac6-c5f7-45a8-b6df-aadc6839c2d9", "subnet_id": "7bf939cc-167f-49d5-a933-9cca504210ab", "ip_address": "192.168.1.159", "ipv6_address": "2001:db8:a583:578:192:168:1:159" }

URI POST /v1/{project_id}/cloudservers/{server_id}/os-interface/{port_id}/change-network-interface 参数说明请参见表 参数说明。 表1 参数说明 参数 是否必选 描述 project_id 是 项目ID。 获取方法请参见获取项目ID。 server_id 是 云服务器ID。 port_id 是 网卡ID。

什么是主机安全 主机安全服务（Host Security Service，HSS）是提升服务器整体安全性的服务，通过主机管理、风险防御、入侵检测、安全运营、网页防篡改功能，可全面识别并管理云服务器中的信息资产，实时监测云服务器中的风险，降低服务器被入侵的风险。 使用主机安全需要在云服务器中安装Agent。安装Agent后，您的云服务器将受到HSS云端防护中心全方位的安全保障，在安全控制台可视化界面上，您可以统一查看并管理同一区域内所有主机的防护状态和主机安全风险。

怎样使用主机安全服务 您在使用主机安全服务前，需要先在弹性云服务器上安装Agent。针对新创建的云服务器和已有的云服务器，提供不同的安装方式： 场景一：新创建云服务器 购买弹性云服务器，选择部分操作系统的公共镜像时，系统推荐您配套使用主机安全服务（Host Security Service, HSS）。 开启“主机安全”需要设置“安全防护”参数： 免费试用一个月主机安全基础防护：开启后，免费体验HSS基础版30天，为您的主机提供操作系统漏洞检测、弱口令检测、暴力破解检测等功能。 主机安全基础防护免费使用期限结束后，该防护配额将自动释放，停止相应的实时防护能力。 如您需要保留或升级原有安全防护能力，建议您购买高阶防护。详细情况，请参见主机安全的免费试用HSS基础版到期后怎么办？。 购买弹性云服务器时，默认设置该选项。 购买高阶防护：高阶防护支持基础版、企业版、旗舰版和网页防篡改版，需付费使用。 购买后您可以在主机安全服务控制台切换不同版本。各版本之间的差异请参考服务版本差异。 不使用安全防护：若您不需要进行安全防护，可选择此选项。 选择主机安全后系统自动安装主机安全Agent，开启账号防御，启用主机安全服务的功能。 若基础版或企业版不满足要求，您可以购买其他版本配额，在主机安全服务控制台切换不同版本，获取更高级的防护，且不需要重新安装Agent。 图1 开通主机安全 场景二：未配置主机安全的云服务器 对于已经创建完成的弹性云服务器，可能由于创建时尚未支持主机安全服务或未设置“安全防护”参数。如需使用主机安全，您需要手动安装Agent。 具体操作请参见手动安装Agent、手动开启防护。

操作场景 购买弹性云服务器时，您需要根据业务需求指定CPU、内存、规格、操作系统、登录鉴权方式等具体配置。华为云提供了多种实例类型供您选择，不同类型的实例提供不同的计算能力和存储能力。支持的实例类型，请参见实例类型。 弹性云服务器的“帮我选”功能，提供规格选型引导，针对不同业务场景和预期业务量，进行规格推荐，帮助您快速选择规格。 购买弹性云服务器的详细内容，请参见自定义购买弹性云服务器。本文介绍如何通过“帮我选”的规格选型引导进行规格筛选的操作指导。

操作步骤 登录控制台，进入购买弹性云服务器页面。 根据业务需要，完成区域、计费模式、可用区等基础配置的设置。 在“实例筛选”区域右上角，单击“帮我选”。 图1 帮我选 在“帮我选”页面根据业务场景进行设置。 选择“传统办公”业务场景。 图2 传统办公场景 设置业务预期用户数：根据登录或使用某软件系统的总用户数量的范围进行设置。 设置业务预期并发量：根据同一时间，每秒同时访问软件系统的用户数量的范围进行设置。 如果业务预期并发量达到200以上，请联系售前获取专业咨询服务。 单击“下一步”，在推荐规格中进行选择。 单击“确认选择”，完成规格设置。 如果您对推荐规格不满意，还可以在规格列表中直接选择其他规格。 选择“网站应用”业务场景。 图3 网站应用场景 根据业务需要，选择对应的网站类型。 （可选）设置业务预期用户数：根据登录或使用小程序的总用户数量的范围进行设置。 当“网站类型”选择“营销类小程序”时，该参数可见。 （可选）设置业务预期并发量：根据同一时间，每秒同时访问小程序的用户数量的范围进行设置。 当“网站类型”选择“营销类小程序”时，该参数可见。 如果业务预期并发量达到200以上，请联系售前获取专业咨询服务。 单击“下一步”，在推荐规格中进行选择。 单击“确认选择”，完成规格设置。 如果您对推荐规格不满意，还可以在规格列表中直接选择其他规格。 选择“电商”业务场景。 图4 电商场景 （可选）若有“秒杀/直播带货”需求，则勾选“是”。 设置业务预期日活跃用户数：根据日登录或使用电商平台的活跃用户数（去除重复登录的用户）的范围进行设置。 如果业务预期日活跃用户数达到5000以上，请联系售前获取专业咨询服务。 设置业务预期并发量：根据同一时间，每秒同时访问电商平台的用户数量的范围进行设置。 如果业务预期并发量达到200以上，请联系售前获取专业咨询服务。 单击“下一步”，在推荐规格中进行选择。 单击“确认选择”，完成规格设置。 如果您对推荐规格不满意，还可以在规格列表中直接选择其他规格。

计费规则 请认真阅读竞享计费型实例的计费规则，详情请参见“竞价计费（竞享模式）”。 计费价格：竞享实例根据购买时长实行分段收费，购买时长小于6小时与等于6小时情况下价格不一致，您可以参考价格详情。价格计算器上的金额如果遇小数点，则保留小数点后两位，第三位四舍五入。如遇四舍五入后不足￥0.01 元，则按￥0.01 元展示。 计费周期：实例创建成功后开始计费，精确到秒级计费，按用户使用时长计费，实例释放后出所有整点账单。且使用期间进行关机等操作，仍然计费。 关联服务：竞享实例模式仅适用于vCPU和内存价格，不适用于OS、系统盘、数据盘、网络带宽的价格。OS、系统盘、数据盘、网络带宽、IP按各自计费规则计费（与按需保持一致）。系统盘与实例一起创建，一起释放，但数据盘系统不会删除，需要用户自行删除。 代金券：除现金券、储值卡适用之外，其他折扣券、代金券等均不适用。

使用须知 竞享计费型实例目前支持通用计算增强型实例规格。 华为云尽可能保障竞享实例正常运行，但在系统资源不足等极端情况下会主动释放实例，请务必做好数据备份工作。 竞享计费型实例目前只支持部分区域及规格，请以购买页面显示的资源为准 竞享计费型实例保障周期不同价格不同。 竞享计费型实例不支持转换为按需和包年/包月实例。 竞享计费型实例不支持变更实例规格。 竞享计费型实例不支持变更操作系统。 竞享计费型实例不支持自动恢复功能。 竞享计费型实例不支持卸载系统盘。 竞享计费型实例在中断回收时： 不允许使用竞享实例制作系统盘镜像和整机镜像，但允许使用该云服务器的数据盘制作数据盘镜像。 不允许删除。 竞享计费型实例在中断回收时，数据盘和弹性公网IP默认不释放。请设置通知提醒，来决定是否释放关联的数据盘和弹性公网IP。具体方法，请参见“购买竞享计费型实例”。

计费样例 竞享实例精确到秒级计费，购买界面显示小时单价，将小时单价除以3600即可得到每秒的价格。 样例1：以C6.large.2规格为例，用户购买时长3小时，08:58:30开通实例 使用3小时后正常到期，11:58:30终止实例，终止实例后出整点话单 表1 话单样例1 账单周期 周期内使用时长（秒） 计费（元） 08:58:30-09:00:00 90 90/3600*0.07 09:00:00-10:00:00 3600 0.07 10:00:00-11:00:00 3600 0.07 11:00:00-11:58:30 3510 3510/3600*0.07 用户主动提前释放实例，10:28:30终止实例，终止实例后出整点话单 表2 话单样例2 账单周期 周期内使用时长（秒） 计费（元） 08:58:30-09:00:00 90 90/3600*0.07 09:00:00-10:00:00 3600 0.07 10:00:00-10:28:30 1710 1710/3600*0.07 系统提前释放实例，10:28:30终止实例，终止实例后出整点话单（免除） 表3 话单样例3 账单周期 周期内使用时长（秒） 计费（元） 08:58:30-09:00:00 90 0 09:00:00-10:00:00 3600 0 10:00:00-10:28:30 1710 0 样例2：以C6.large.2规格为例，用户购买时长6小时，08:58:30开通实例 使用6小时后正常到期，14:58:30终止实例，终止实例后出整点话单 表4 话单样例4 账单周期 周期内使用时长（秒） 计费（元） 08:58:30-09:00:00 90 90/3600*0.12 09:00:00-10:00:00 3600 0.12 10:00:00-11:00:00 3600 0.12 11:00:00-12:00:00 3600 0.12 12:00:00-13:00:00 3600 0.12 13:00:00-14:00:00 3600 0.12 14:00:00-14:58:30 3510 3510/3600*0.12 用户主动提前释放实例，13:28:30终止实例，终止实例后出整点话单 表5 话单样例5 账单周期 周期内使用时长（秒） 计费（元） 08:58:30-09:00:00 90 90/3600*0.12 09:00:00-10:00:00 3600 0.12 10:00:00-11:00:00 3600 0.12 11:00:00-12:00:00 3600 0.12 12:00:00-13:00:00 3600 0.12 13:00:00-13:28:30 1710 1710/3600*0.12 系统提前释放实例，13:28:30终止实例，终止实例后出整点话单（免除） 表6 话单样例6 账单周期 周期内使用时长（秒） 计费（元） 08:58:30-09:00:00 90 0 09:00:00-10:00:00 3600 0 10:00:00-11:00:00 3600 0 11:00:00-12:00:00 3600 0 12:00:00-13:00:00 3600 0 13:00:00-13:28:30 1710 0

工作原理 购买竞享实例时，需要选择保障周期（1-6小时），保障周期不同价格不同。保障周期是购买竞享实例的最小单位时间。在保障周期内由云平台中断竞享实例，当前周期不计费。在保障周期内用户删除竞享实例，当前周期按使用时长计费。 竞享实例购买成功后，当达到用户购买时长或库存资源不足时，实例将会进入“中断回收中”状态，随后释放。用户可以根据业务需要随时主动释放实例，实例释放后按用户实际使用时长收费。 华为云会尽可能保障竞享实例正常运行，但在极端情况下会中断释放该类实例，实例被中断时会秒级释放，请在使用竞享实例时做好备份策略。 在保障周期内由云平台中断竞享实例，当前周期不计费。在保障周期内用户主动释放实例，当前周期按使用时长计费。 一般情况下，竞享实例回收会优先选择使用时长较短的实例中断回收，尽可能降低对用户的业务损伤，但仍然建议您优化应用设计，保证在竞享实例被中断回收的情况下业务也可以正常工作。您可以尝试主动释放竞享实例，检测在竞享实例被中断回收的情况下应用工作是否正常。 图1 竞享实例的生命周期 在保障周期内由云平台中断竞享实例，当前周期不计费。在保障周期内用户主动释放实例，当前周期按使用时长计费。

什么是竞享计费型实例？ 竞享实例是竞价计费的一种新型售卖模式，其最核心的特点是超低价格和系统抢占机制，即您可以以较低折扣购买实例，但同时在系统资源不足等极端情况下系统可能会自动回收这些实例。其适用于各种无状态、容错或者灵活的应用场景。 采用竞享模式购买的弹性云服务器，称之为“竞享计费型实例”，简称“竞享实例”。 竞享实例目前支持华为云通用计算增强型，目前已经上线C6机型的多个规格，C6s、C3机型会陆续上线。 在该计费模式下，您可以以折扣价购买并使用弹性云服务器，性能与常规云服务器无异。但是当库存资源不足，系统会自动释放您的云服务器资源，对这些折扣售卖的弹性云服务器进行中断回收。与“按需计费”和“包年/包月”方式购买的弹性云服务器相比，在提供同等性能的前提下，竞享实例可提供超低折扣，降低用云成本。

获取安装脚本 您可以通过执行以下命令，获取支持GPU监控和NPU监控的CES Agent的安装脚本。 表3 安装脚本的支持区域及获取方式 区域 安装脚本 华北-北京一 单台ECS安装： cd /usr/local && curl -k -O https://uniagent-cn-north-1.obs.cn-north-1.myhuaweicloud.com/package/agent_install.sh && bash agent_install.sh -r cn-north-1 -u 0.1.5 -t 2.6.7.1 -d agent.ces.myhuaweicloud.com 多台ECS批量安装： cd /usr/local && curl -k -O https://uniagent-cn-north-1.obs.cn-north-1.myhuaweicloud.com/package/batch_agent_install.sh && bash batch_agent_install.sh -r cn-north-1 -u 0.1.5 -t 2.6.7.1 -d agent.ces.myhuaweicloud.com 华北-北京四 单台ECS安装： cd /usr/local && curl -k -O https://uniagent-cn-north-4.obs.cn-north-4.myhuaweicloud.com/package/agent_install.sh && bash agent_install.sh -r cn-north-4 -u 0.1.5 -t 2.6.7.1 -d agent.ces.myhuaweicloud.com 多台ECS批量安装： cd /usr/local && curl -k -O https://uniagent-cn-north-4.obs.cn-north-4.myhuaweicloud.com/package/batch_agent_install.sh && bash batch_agent_install.sh -r cn-north-4 -u 0.1.5 -t 2.6.7.1 -d agent.ces.myhuaweicloud.com 华北-乌兰察布一 单台ECS安装： cd /usr/local && curl -k -O https://obs.cn-north-9.myhuaweicloud.com/uniagent-cn-north-9/package/agent_install.sh && bash agent_install.sh -r cn-north-9 -u 0.1.5 -t 2.6.7.1 -d agent.ces.myhuaweicloud.com 多台ECS批量安装： cd /usr/local && curl -k -O https://obs.cn-north-9.myhuaweicloud.com/uniagent-cn-north-9/package/batch_agent_install.sh && bash batch_agent_install.sh -r cn-north-9 -u 0.1.5 -t 2.6.7.1 -d agent.ces.myhuaweicloud.com 华南-广州 单台ECS安装： cd /usr/local && curl -k -O https://uniagent-cn-south-1.obs.cn-south-1.myhuaweicloud.com/package/agent_install.sh && bash agent_install.sh -r cn-south-1 -u 0.1.5 -t 2.6.7.1 -d agent.ces.myhuaweicloud.com 多台ECS批量安装： cd /usr/local && curl -k -O https://uniagent-cn-south-1.obs.cn-south-1.myhuaweicloud.com/package/batch_agent_install.sh && bash batch_agent_install.sh -r cn-south-1 -u 0.1.5 -t 2.6.7.1 -d agent.ces.myhuaweicloud.com 华东-上海一 单台ECS安装： cd /usr/local && curl -k -O https://uniagent-cn-east-3.obs.cn-east-3.myhuaweicloud.com/package/agent_install.sh && bash agent_install.sh -r cn-east-3 -u 0.1.5 -t 2.6.7.1 -d agent.ces.myhuaweicloud.com 多台ECS批量安装： cd /usr/local && curl -k -O https://uniagent-cn-east-3.obs.cn-east-3.myhuaweicloud.com/package/batch_agent_install.sh && bash batch_agent_install.sh -r cn-east-3 -u 0.1.5 -t 2.6.7.1 -d agent.ces.myhuaweicloud.com 华东-上海二 单台ECS安装： cd /usr/local && curl -k -O https://uniagent-cn-east-2.obs.cn-east-2.myhuaweicloud.com/package/agent_install.sh && bash agent_install.sh -r cn-east-2 -u 0.1.5 -t 2.6.7.1 -d agent.ces.myhuaweicloud.com 多台ECS批量安装： cd /usr/local && curl -k -O https://uniagent-cn-east-2.obs.cn-east-2.myhuaweicloud.com/package/batch_agent_install.sh && bash batch_agent_install.sh -r cn-east-2 -u 0.1.5 -t 2.6.7.1 -d agent.ces.myhuaweicloud.com 西南-贵阳一 单台ECS安装： cd /usr/local && curl -k -O https://uniagent-cn-southwest-2.obs.cn-southwest-2.myhuaweicloud.com/package/agent_install.sh && bash agent_install.sh -r cn-southwest-2 -u 0.1.5 -t 2.6.7.1 -d agent.ces.myhuaweicloud.com 多台ECS批量安装： cd /usr/local && curl -k -O https://uniagent-cn-southwest-2.obs.cn-southwest-2.myhuaweicloud.com/package/batch_agent_install.sh && bash batch_agent_install.sh -r cn-southwest-2 -u 0.1.5 -t 2.6.7.1 -d agent.ces.myhuaweicloud.com 中国-香港 单台ECS安装： cd /usr/local && curl -k -O https://uniagent-ap-southeast-1.obs.ap-southeast-1.myhuaweicloud.com/package/agent_install.sh && bash agent_install.sh -r ap-southeast-1 -u 0.1.5 -t 2.6.7.1 -d agent.ces.myhuaweicloud.com 多台ECS批量安装： cd /usr/local && curl -k -O https://uniagent-ap-southeast-1.obs.ap-southeast-1.myhuaweicloud.com/package/batch_agent_install.sh && bash batch_agent_install.sh -r ap-southeast-1 -u 0.1.5 -t 2.6.7.1 -d agent.ces.myhuaweicloud.com 亚太-曼谷 单台ECS安装： cd /usr/local && curl -k -O https://uniagent-ap-southeast-2.obs.ap-southeast-2.myhuaweicloud.com/package/agent_install.sh && bash agent_install.sh -r ap-southeast-2 -u 0.1.5 -t 2.6.7.1 -d agent.ces.myhuaweicloud.com 多台ECS批量安装： cd /usr/local && curl -k -O https://uniagent-ap-southeast-2.obs.ap-southeast-2.myhuaweicloud.com/package/batch_agent_install.sh && bash batch_agent_install.sh -r ap-southeast-2 -u 0.1.5 -t 2.6.7.1 -d agent.ces.myhuaweicloud.com 亚太-新加坡 单台ECS安装： cd /usr/local && curl -k -O https://uniagent-ap-southeast-3.obs.ap-southeast-3.myhuaweicloud.com/package/agent_install.sh && bash agent_install.sh -r ap-southeast-3 -u 0.1.5 -t 2.6.7.1 -d agent.ces.myhuaweicloud.com 多台ECS批量安装： cd /usr/local && curl -k -O https://uniagent-ap-southeast-3.obs.ap-southeast-3.myhuaweicloud.com/package/batch_agent_install.sh && bash batch_agent_install.sh -r ap-southeast-3 -u 0.1.5 -t 2.6.7.1 -d agent.ces.myhuaweicloud.com 亚太-雅加达 单台ECS安装： cd /usr/local && curl -k -O https://obs.ap-southeast-4.myhuaweicloud.com/uniagent-ap-southeast-4/package/agent_install.sh && bash agent_install.sh -r ap-southeast-4 -u 0.1.5 -t 2.6.7.1 -d agent.ces.myhuaweicloud.com 多台ECS批量安装： cd /usr/local && curl -k -O https://obs.ap-southeast-4.myhuaweicloud.com/uniagent-ap-southeast-4/package/batch_agent_install.sh && bash batch_agent_install.sh -r ap-southeast-3 -u 0.1.5 -t 2.6.7.1 -d agent.ces.myhuaweicloud.com 非洲-约翰内斯堡 单台ECS安装： cd /usr/local && curl -k -O https://uniagent-af-south-1.obs.af-south-1.myhuaweicloud.com/package/agent_install.sh && bash agent_install.sh -r af-south-1 -u 0.1.5 -t 2.6.7.1 -d agent.ces.myhuaweicloud.com 多台ECS批量安装： cd /usr/local && curl -k -O https://uniagent-af-south-1.obs.af-south-1.myhuaweicloud.com/package/batch_agent_install.sh && bash batch_agent_install.sh -r af-south-1 -u 0.1.5 -t 2.6.7.1 -d agent.ces.myhuaweicloud.com 拉美-墨西哥城二 单台ECS安装： cd /usr/local && curl -k -O https://uniagent-la-north-2.obs.la-north-2.myhuaweicloud.com/package/agent_install.sh && bash agent_install.sh -r la-north-2 -u 0.1.5 -t 2.6.7.1 -d agent.ces.myhuaweicloud.com 多台ECS批量安装： cd /usr/local && curl -k -O https://uniagent-la-north-2.obs.la-north-2.myhuaweicloud.com/package/batch_agent_install.sh && bash batch_agent_install.sh -r ap-southeast-3 -u 0.1.5 -t 2.6.7.1 -d agent.ces.myhuaweicloud.com 拉美-圣地亚哥 单台ECS安装： cd /usr/local && curl -k -O https://obs.la-south-2.myhuaweicloud.com/uniagent-la-south-2/package/agent_install.sh && bash agent_install.sh -r la-south-2 -u 0.1.5 -t 2.6.7.1 -d agent.ces.myhuaweicloud.com 多台ECS批量安装： cd /usr/local && curl -k -O https://obs.la-south-2.myhuaweicloud.com/uniagent-la-south-2/package/batch_agent_install.sh && bash batch_agent_install.sh -r ap-southeast-3 -u 0.1.5 -t 2.6.7.1 -d agent.ces.myhuaweicloud.com 中东-利雅得 单台ECS安装： cd /usr/local && curl -k -O https://uniagent-me-east-1.obs.me-east-1.myhuaweicloud.com/package/agent_install.sh && bash agent_install.sh -r me-east-1 -u 0.1.5 -t 2.6.7.1 -d agent.ces.myhuaweicloud.com 多台ECS批量安装： cd /usr/local && curl -k -O https://uniagent-me-east-1.obs.me-east-1.myhuaweicloud.com/package/batch_agent_install.sh && bash batch_agent_install.sh -r ap-southeast-3 -u 0.1.5 -t 2.6.7.1 -d agent.ces.myhuaweicloud.com

（可选）安装lspci工具 登录弹性云服务器。 更新镜像源，获取安装依赖。 wget http://mirrors.myhuaweicloud.com/repo/mirrors_source.sh && bash mirrors_source.sh 更多内容，请参见如何使用自动化工具配置华为云镜像源(x86_64和ARM)？ 执行以下命令，安装lspci工具。 CentOS系统： yum install pciutils Ubuntu系统： apt install pciutils 执行以下命令，查看安装结果。 lspci -d 10de: 图3 安装结果

操作步骤（多台ECS批量安装） 本操作以Ubuntu 18.04 64bit操作系统、Pi2规格的GPU加速型实例为例，介绍多台ECS批量安装支持GPU监控的CES Agent的操作指导。 批量安装的多台ECS需要归属于同一个VPC。 使用root用户，远程登录其中一台弹性云服务器。 执行以下命令，为这一台ECS安装支持GPU监控的CES Agent。 以“华北-北京四”为例，其余区域的安装脚本，请参见获取安装脚本。 cd /usr/local && curl -k -O https://uniagent-cn-north-4.obs.cn-north-4.myhuaweicloud.com/package/agent_install.sh && bash agent_install.sh -r cn-north-4 -u 0.1.5 -t 2.6.7.1 -d agent.ces.myhuaweicloud.com 其中，“cn-north-4”表示区域ID，“0.1.5”是uniagent版本号，“2.6.7.1”是telescope版本号。 当支持GPU监控的CES Agent安装成功，且数据采集正常时，可以将此ECS作为跳板机，通过批量安装脚本依次为其他ECS批量安装支持GPU监控的CES Agent。 收集需要批量安装支持GPU监控的CES Agent的所有ECS的IP地址和root用户密码，以iplist.txt格式整理，并上传到ECS跳板机的/usr/local目录下。 iplist.txt格式为“IP地址,root用户密码”，每个记录一行。 示例如下所示（示例中abcd为root用户密码，请按实际值填写）： 192.168.1.1,abcd 192.168.1.2,abcd 执行以下命令，为多台ECS批量安装支持GPU监控的CES Agent。 以“华北-北京四”为例，其余区域的批量安装脚本，请参见获取安装脚本。 cd /usr/local && curl -k -O https://uniagent-cn-north-4.obs.cn-north-4.myhuaweicloud.com/package/batch_agent_install.sh && bash batch_agent_install.sh -r cn-north-4 -u 0.1.5 -t 2.6.7.1 -d agent.ces.myhuaweicloud.com 其中，cn-north-4是RegoinID，0.1.5是uniagent版本号，2.6.7.1是telescope版本号。 当显示如下内容，表示支持GPU监控的CES Agent安装成功。 图2 支持GPU监控的CES Agent安装成功

操作步骤（单台ECS安装） 本操作以Ubuntu 18.04 64bit操作系统、Pi2规格的GPU加速型实例为例，介绍单台ECS安装支持GPU监控的CES Agent的操作指导。 使用root用户，远程登录弹性云服务器。 执行以下命令，为单台ECS安装支持GPU监控的CES Agent。 以“华北-北京四”为例，其余区域的安装脚本，请参见获取安装脚本。 cd /usr/local && curl -k -O https://uniagent-cn-north-4.obs.cn-north-4.myhuaweicloud.com/package/agent_install.sh && bash agent_install.sh -r cn-north-4 -u 0.1.5 -t 2.6.7.1 -d agent.ces.myhuaweicloud.com 其中，“cn-north-4”表示区域ID，“0.1.5”是uniagent版本号，“2.6.7.1”是telescope版本号。 当显示如下内容，表示支持GPU监控的CES Agent安装成功。 图1 支持GPU监控的CES Agent安装成功

操作场景 监控与告警是保证异构云服务器（GPU加速型实例、AI加速型实例）高可靠性、高可用性和高性能的重要功能。 通过在异构类（例如，GPU加速型实例、AI加速型实例）的Linux实例上安装支持对应监控的CES Agent，可以为用户提供系统级、主动式、细颗粒度的监控，包含相关异构指标收集和系统事件上报。 当前支持的异构加速卡及对应的监控指标种类如下： GPU监控指标，请参见操作系统监控指标：GPU。 NPU监控指标，请参见操作系统监控指标：NPU。 本章节介绍如何通过安装脚本为异构（GPU加速型、AI加速型）实例安装支持对应监控的CES Agent： 操作步骤（单台ECS安装） 操作步骤（多台ECS批量安装）

约束与限制 仅支持Linux操作系统。 使用私有镜像创建的云服务器需手动安装监控组件并安装驱动。 对于GPU监控： 支持GPU监控的Linux公共镜像如表1所示。 表1 支持GPU监控的Linux版本 类型 版本 CentOS（64bit） 7.6、7.9、8.2 Ubuntu（64bit） 16.04、18.04、20.04 Huawei Cloud Euler（64bit） 2.0 支持GPU监控的规格：G6v、G6、P2s、P2v、P2vs、G5、Pi2、Pi1、P1。 对于NPU监控： 支持NPU监控的Linux公共镜像如所表2示。 表2 支持NPU监控的Linux版本 类型 版本 CentOS（64bit） 7.6：Ai1s、Ai2、Kai1s、Kai2 7.7-7.9：Ai2、Kai2 Ubuntu（64bit） 18.04 支持NPU监控的规格：Ai1s, Ai2, Kai1s, Kai2。

前提条件 已配置DNS和安全组，配置方法参考如何配置DNS和安全组？。 已配置委托，配置方法参考如何配置委托？。 实例已安装对应驱动。 GPU加速型实例：已安装GPU驱动。 未安装GPU驱动的云服务器不支持采集GPU指标数据及上报事件。 如果您的弹性云服务器未安装GPU驱动，可参见（推荐）GPU加速型实例自动安装GPU驱动（Linux）。 AI加速型实例：已安装NPU驱动 未安装NPU驱动的云服务器不支持采集NPU指标数据及上报事件。 使用公共镜像创建的AI加速型实例默认已安装特定版本驱动，如果您使用私有镜像创建AI加速型实例，或者因其他原因需要安装驱动，请参考昇腾文档中心对应版本的《CANN软件安装指南》。 安装驱动需使用默认路径。 驱动安装完后，需重启实例，否则可能导致采集指标及上报事件失败。 驱动正常安装后，最多10分钟将在控制台看到采集到的指标数据。 已安装lspci工具，未安装lspci工具的云服务器影响GPU掉卡事件的上报。 安装lspci工具的方法，请参见（可选）安装lspci工具。 确保云服务器的安装目录都有读写权限，并且安装成功后的Telescope进程不会被其他软件关闭。

约束与限制 竞享计费型实例目前支持通用计算增强型实例规格。 华为云尽可能保障竞享实例正常运行，但在系统资源不足等极端情况下会主动释放实例，请务必做好数据备份工作。 竞享计费型实例目前只支持部分区域及规格，请以购买页面显示的资源为准 竞享计费型实例保障周期不同价格不同。 竞享计费型实例不支持转换为按需和包年/包月实例。 竞享计费型实例不支持变更实例规格。 竞享计费型实例不支持变更操作系统。 竞享计费型实例不支持自动恢复功能。 竞享计费型实例不支持卸载系统盘。 竞享计费型实例在中断回收时： 不允许使用竞享实例制作系统盘镜像和整机镜像，但允许使用该云服务器的数据盘制作数据盘镜像。 不允许删除。 竞享计费型实例在中断回收时，数据盘和弹性公网IP默认不释放。请设置通知提醒，来决定是否释放关联的数据盘和弹性公网IP。具体方法，请参见“购买竞享计费型实例”。