华为云用户手册

操作步骤 本操作以Windows Server 2019 标准版 64位操作系统、Pi2规格的GPU加速型实例为例，介绍单台E CS 安装新版支持GPU监控的 CES Agent的操作指导。 使用Administrator用户，远程登录弹性云服务器。 在浏览器地址栏输入地址，下载安装脚本。 以“华东-上海一”为例，安装脚本地址为： https://uniagent-cn-east-3.obs.cn-east-3.myhuaweicloud.com/package/install_amd64.exe 其余区域的安装脚本，请参见获取安装脚本。 （可选）在以下路径，卸载旧版本支持GPU监控的CES Agent。 C:\Program Files\uniagent\script\uninstall.bat 以管理员身份打开cmd命令窗口，在“install_amd64.exe”下载目录下，执行以下命令安装支持GPU监控的CES Agent安装脚本。 install_amd64.exe [-r RegionID] [-u UniagentVersion] [-t TelescopeVersion] [-d AgentApiDomain] 命令示例： install_amd64.exe -r cn-east-3 -u 0.1.5 -t 2.6.7.1 -d agent.ces.myhuaweicloud.com 其中， RegoinID：cn-east-3 UniagentVersion：0.1.5 TelescopeVersion：2.6.7.1 AgentApiDomain：agent.ces.myhuaweicloud.com 如果命令执行后出现“Access is denied”，可能是由于未以管理员身份打开cmd命令窗口导致，请切换为管理员身份重新执行命令。 当界面显示“Install service success”或“Install agent successfully”时，说明支持GPU监控的CES Agent安装成功并启动。 图1 支持GPU监控的CES Agent安装成功

操作场景 云平台支持弹性云服务器在专属主机与公共资源池之间迁移。 在控制台的“弹性云服务器”页面，您可以将公共资源池的弹性云服务器迁移至专属主机，成为专属主机上的弹性云服务器。 本章节介绍公共资源池的弹性云服务器迁移至专属主机的操作指导。 迁移云服务器需保证有可用的专属主机资源，否则无法进行迁移操作。 在控制台的“专属主机”页面还可以进行如下两个场景的迁移操作，具体请参见《专属主机用户指南》的“专属主机上云服务器迁移”章节： 创建在专属主机上的弹性云服务器迁移至其他专属主机。 创建在专属主机上的弹性云服务器迁移至公共资源池。

操作场景 按需计费：按需计费是后付费模式，按弹性云服务器的实际使用时长计费，可以随时开通/删除弹性云服务器。 包年/包月：包年/包月是预付费模式，按订单的购买周期计费，适用于可预估资源使用周期的场景，价格比按需计费模式更优惠。 如果您需要长期使用当前弹性云服务器，可以将按需购买的云服务器转为包年/包月计费模式，节省开支。按需转包年/包月的具体操作，请参见本节内容。 如果弹性云服务器的绑定资源（云硬盘等磁盘、弹性公网IP）支持转包年/包月，则随弹性云服务器同步转换计费模式。 如果弹性云服务器的绑定资源（云硬盘等磁盘、弹性公网IP）不支持转包年/包月，则保留原计费模式，详细内容，请参见绑定资源计费模式转换规则。

绑定资源计费模式转换规则 弹性云服务器的绑定资源主要包括各类磁盘和弹性公网IP，当按需计费的弹性云服务器转包年/包月时，绑定资源的计费模式转换规格如表1和表2所示。 表1 磁盘计费模式转换规则 磁盘类型 计费模式 是否共享 是否支持随ECS按需转包年/包月 处理措施 本地盘 不涉及 否 不涉及 无。 DSS/DESS下磁盘 包年/包月（存储池计费模式） 否 不涉及 无。 云硬盘 按需计费 否 是（极速型SSD V2类型磁盘不支持） 无。 云硬盘 按需计费 是 否 在控制台的云硬盘页面进行按需转包年/包月操作。 详细内容，请参见云硬盘计费说明。 云硬盘 包年/包月 否 否 已经是包年/包月计费模式，无需处理。 云硬盘 包年/包月 是 否 已经是包年/包月计费模式，无需处理。 表2 弹性公网IP计费模式转换规则 资源 计费模式 计费方式 带宽类型 是否支持随ECS按需转包年/包月 处理措施 弹性公网IP 按需计费 按带宽计费 独享带宽 是 无。 弹性公网IP 按需计费 按流量计费 独享带宽 否 在控制台的弹性公网IP页面，先将按需按流量计费转换为按需按带宽计费，再将按需计费转换为包年/包月。 详细内容，请参见变更弹性公网IP计费方式。 弹性公网IP 按需计费 按带宽计费 共享带宽 否 在控制台的弹性公网IP页面进行按需转包年/包月操作。 详细内容，请参见变更弹性公网IP计费方式。 弹性公网IP 包年/包月 按带宽计费 独享带宽/共享带宽 否 已经是包年/包月计费模式，无需处理。

操作场景 购买ECS时，您可以通过共享VPC功能，使用其他账号共享的VPC和子网，以实现网络资源的共享和统一管理，提升资源管控效率、降低运维成本。 例如，为了规范管理网络资源，某企业使用账号A作为IT管理账号，用于管理基础公共资源，包括VPC、子网等。同时，账号A将多个子网共享给其他账号共同使用。 账号A：IT管理账号，作为资源所有者，创建VPC及子网，并将多个子网分别共享给其他账号使用。 账号B：业务账号，作为资源使用者，使用账号A共享的子网2创建ECS。 账号C：业务账号，作为资源使用者，使用账号A共享的子网3创建ECS。 图1 业务规划示意图 本章节介绍通过共享VPC购买ECS的操作指导。有关VPC子网共享的更多信息，请参见《虚拟私有云用户指南》的“共享VPC”相关内容。

适用包年/包月的资源 包年/包月的资源包括： ECS实例，包括vCPU和内存。 镜像，包括预付费的市场镜像。 购买云服务器 时同时购买的云硬盘价格，包括系统盘和数据盘。 购买云服务器时同时购买的带宽价格。 IP和固定带宽统一计费，不单独计费，计费标准参考按固定带宽计费。 如果您要创建一个包年/包月的弹性云服务器，配置费用即包括了以上几种资源的费用。 您可以使用ECS价格计算器快速了解弹性 云服务器配置 费用。

Windows操作系统云服务器安装Tesla驱动 以下操作以Windows Server 2016 Standard 64bit操作系统，GPU实例安装Tesla驱动为例。 登录云服务器。 下载NVIDIA驱动包。 单击NVIDIA驱动下载根据实例的类型，选择驱动版本。 图8 选择驱动类型（Windows） 根据需求选择驱动版本，本节操作以安装Tesla 425.25为例。 图9 选择驱动版本（Windows） 单击需要下载的驱动，进入“TESLA DRIVER FOR WINDOWS”界面，单击“DOWNLOAD”。 单击“Agree & Download”，下载安装包。 图10 下载NVIDIA驱动安装包 双击驱动安装驱动，单击“运行”。 图11 运行NVIDIA驱动安装程序 选择安装路径，单击“OK”。 图12 选择NVIDIA驱动安装路径 根据安装提示完成NVIDIA程序的安装。 图13 完成NVIDIA驱动的安装 重启云服务器。 检查驱动是否安装成功。 进入“设备管理器”，查看“显示适配器”。 图14 显示适配器 打开云服务器cmd窗口，执行以下命令： cd C:\Program Files\NVIDIA Corporation\NVSMI nvidia-smi 如果回显信息中包含了已安装的驱动版本，说明驱动安装成功。 图15 查看NVIDIA驱动安装版本

Windows操作系统安装CUDA工具包 以下操作以Windows Server 2016 Standard 64bit操作系统GPU实例安装CUDA 10.1为例。 登录云服务器。 在CUDA下载页面中，按照CUDA工具包下载地址中的对应的索引项在页面中进行选择。 图25 选择CUDA版本 选择完成后，页面会自动呈现出Windows Server 2016 Standard 64bit对应的CUDA 10.1的下载地址。 图26 Windows云服务器下载CUDA 单击“Download”下载CUDA工具包。 双击打开安装文件，单击“运行”安装CUDA工具包。 图27 Windows云服务器安装CUDA 选择安装地址，在“CUDA Setup Package”界面，单击“OK” 图28 选择CUDA安装路径 根据安装提示完成CUDA的安装。 图29 CUDA安装完成 检查CUDA是否安装成功。 打开cmd命令窗口，执行以下命令。 nvcc -V 如果回显信息中出现CUDA的版本信息，说明CUDA安装成功。 图30 CUDA安装成功

Linux操作系统安装CUDA工具包 以下操作以Ubuntu 16.04 64bit操作系统，GPU实例使用run包安装CUDA 10.1为例。 登录云服务器。 根据操作系统选择命令更新系统软件。 Ubuntu 更新软件安装源：apt-get -y update 安装必要程序：apt-get install gcc g++ make CentOS 更新软件安装源：yum -y update --exclude=kernel* --exclude=centos-release* --exclude=initscripts* 安装必要程序：yum install -y kernel-devel-`uname -r` gcc gcc-c++ 在CUDA下载页面中，按照Tesla驱动及CUDA工具包获取方式中的对应的索引项在页面中进行选择。 图16 选择CUDA的版本 选择完成后，页面会自动呈现出Ubuntu 16.04 64bit对应的CUDA 10.1的下载地址，复制下载地址。 图17 复制CUDA下载地址 在云服务器内部执行如下命令进行下载。 wget 复制的链接地址 例如：wget https://developer.nvidia.com/compute/cuda/10.1/Prod/local_installers/cuda_10.1.105_418.39_linux.run 图18 Linux云服务器下载CUDA CUDA工具包下载完成后，按照NVIDIA官网安装指引进行安装。 按照如下图的NVIDIA官网的Installation Instructions进行安装。 图19 Linux云服务器安装CUDA 执行以下命令安装CUDA。 sh cuda_10.1.243_418.87.00_linux.run 在安装界面输入“accept”，回车进入下一步。 图20 安装CUDA_1 选择“Install”，回车进入安装过程。 图21 安装CUDA_2 图22 安装CUDA完成 执行以下命令进入/usr/local/cuda-10.1/samples/1_Utilities/deviceQuery 目录下。 cd /usr/local/cuda-10.1/samples/1_Utilities/deviceQuery 执行make命令，自动编译deviceQuery程序。 执行以下命令查看CUDA是否安装成功。 ./deviceQuery 如回显信息中有CUDA的版本信息证明CUDA安装成功。 图23 deviceQuery回显信息 执行以下命令查看CUDA的版本。 /usr/local/cuda/bin/nvcc -V 图24 查看CUDA的版本 执行以下命令启动持久模式。 sudo nvidia-smi -pm 1 启用持久模式设置可以优化Linux实例上GPU设备的性能。

操作场景 GPU加速型云服务器，需要安装Tesla驱动和CUDA工具包以实现计算加速功能。 使用公共镜像创建的计算加速型（P系列）实例默认已安装特定版本的Tesla驱动。 使用私有镜像创建的GPU加速型云服务器，需在创建完成后安装Tesla驱动，否则无法实现计算加速功能。 本节操作介绍 GPU云服务器 安装Tesla驱动及CUDA工具包的操作步骤。 当前已支持使用自动化脚本安装GPU驱动，建议优先使用自动安装方式，脚本获取以及安装指导请参考（推荐）自动安装GPU加速型ECS的GPU驱动（Linux）和（推荐）自动安装GPU加速型ECS的GPU驱动（Windows）。 GPU虚拟化型实例，需要严格按照表1选择合适的驱动版本下载使用。

安装须知 云服务器已绑定弹性公网IP。 云服务器未安装Tesla驱动以及CUDA工具包。 从NVIDIA官网下载CUDA工具包进行安装，通常会同时自动安装一个和CUDA版本匹配的Tesla驱动，免去用户单独安装Tesla驱动的步骤。但是对NVIDIA驱动版本有强制要求或依赖时，请务必先单独从NVIDIA官网下载并安装匹配的Tesla驱动，然后在再安装CUDA工具包。 如果云服务器已经安装了Tesla驱动，请检查当前驱动版本是否可用。如需安装新版本的驱动请卸载旧版本的Tesla驱动，避免因驱动程序冲突导致安装失败。 如果NVIDIA驱动版本与云服务器不兼容，会导致安装完成后驱动不显示，请参考T4 GPU设备显示异常进行处理。

Linux操作系统云服务器安装Tesla驱动 以下操作以Ubuntu 16.04 64bit操作系统，GPU实例安装CUDA 10.1对应的Tesla驱动为例。 Linux内核版本和驱动的版本存在兼容性关系。如果驱动安装失败，请检查驱动安装日志(安装日志通常位于/var/log/nvidia-installer.log)。 日志中如提示失败原因为驱动编译错误，例如 get_user_pages参数不匹配，说明当前内核版本与驱动版本不兼容，请选择合适的内核版本和驱动版本重新安装。建议内核版本与驱动版本发布时间不要相差过大。 登录云服务器。 根据操作系统选择命令更新系统软件。 Ubuntu 更新软件安装源：apt-get -y update 安装必要程序：apt-get install gcc g++ make CentOS 更新软件安装源：yum -y update --exclude=kernel* --exclude=centos-release* --exclude=initscripts* 安装必要程序：yum install -y kernel-devel-`uname -r` gcc gcc-c++ 下载NVIDIA驱动包。 单击NVIDIA驱动下载根据实例的类型，选择驱动版本。单击“SEARCH”。 图1 选择NVIDIA驱动 根据需求选择驱动版本，以下操作以选择Tesla 418.67为例。 图2 选择驱动版本 单击需要下载的驱动，进入“TESLA DRIVER FOR LINUX X64”界面，单击“DOWNLOAD”。 复制下载链接地址。 图3 复制下载链接地址 在云服务器内部执行如下命令进行下载。 wget 复制的链接地址 例如：wget http://us.download.nvidia.com/tesla/418.67/NVIDIA-Linux-x86_64-418.67.run 图4 获取安装包 执行以下命令安装驱动。 sh NVIDIA-Linux-x86_64-418.67.run （可选）如果执行驱动安装命令后出现如下提示信息，需要禁用nouveau驱动。 图5 禁用nouveau驱动 执行以下命令，查看是否安装Nouveau驱动。 lsmod | grep nouveau 如果回显信息中包含Nouveau驱动信息，说明Nouveau驱动已安装，则需要禁用Nouveau驱动，请执行步骤9.b。 如果回显信息没有Nouveau驱动信息，说明Nouveau驱动已被禁用，请执行步骤10。 执行如下命令编辑blacklist.conf文件。 如果没有“/etc/modprobe.d/blacklist.conf”文件，请新建一个。 vi /etc/modprobe.d/blacklist.conf 添加如下语句添加至文件结尾。 blacklist nouveau options nouveau modeset=0 执行以下命令，备份并新建一个initramfs。 Ubuntu系统： sudo update-initramfs -u CentOS系统： mv /boot/initramfs-$(uname -r).img /boot/initramfs-$(uname -r).img.bak dracut -v /boot/initramfs-$(uname -r).img $(uname -r) 执行以下命令，重启云服务器。 reboot 根据安装提示，连续三次选择“OK”。完成驱动的安装。 图6 NVIDIA驱动安装完成 执行命令设置systemd。 systemctl set-default multi-user.target 执行reboot，重启云服务器。 登录云服务器，执行nvidia-smi，如果回显信息中包含了已安装的驱动版本，说明驱动安装成功。 图7 查看NVIDIA驱动的版本

背景知识 操作系统dump，即内核转储或崩溃转储，是当云服务器系统运行出现异常时，对操作系统内存数据的实时完整备份。 操作系统dump功能主要利用操作系统内核对硬件异常的处理能力。操作系统内核可以监测到硬件异常，并根据异常的类型来决定处理方式。当系统遇到无法处理的异常或错误时，系统的部分或全部运行状态信息将会转储到磁盘上，这些状态信息包括：CPU的寄存器、物理内存、进程状态、文件系统状态、硬件设备状态等。 操作系统dump可以由以下几种方式触发： 系统崩溃：当操作系统遇到无法处理的异常或错误时，例如非法的内存访问、内核panic等，系统会自动触发dump。 手动触发：系统管理员也可以通过一些命令或者操作手动触发系统dump，例如在Linux系统中可以通过向/proc/sysrq-trigger写入c字符来触发系统dump。 计划触发：某些情况下，系统管理员为了获取系统的某一时刻的运行状态信息，或者模拟系统崩溃的情况，也可以设置在某一特定的时间触发系统dump。 在多数情况下，为了准确获得系统dump，需要对系统进行相关的配置，例如在Linux系统中，需要配置kdump服务等。本文主要介绍手动触发dump的操作指导。

配置操作系统dump（Linux） 本文以CentOS 7.5版本操作系统为例进行介绍，更多版本的操作，请参考对应操作系统官网帮助文档。 远程登录云服务器。 执行以下命令，安装kexec-tools。 yum install kexec-tools 执行以下命令，查看crashkernel预留内存大小。 cat /etc/default/grub GRUB_TIMEOUT=5 GRUB_DISTRIBUTOR="$(sed 's, release .*$,,g' /etc/system-release)" GRUB_DEFAULT=saved GRUB_DISABLE_SUBMENU=true GRUB_TERMINAL_OUTPUT="console" GRUB_CM DLI NE_LINUX="net.ifnames=0 consoleblank=600 console=tty0 console=ttyS0,115200n8 spectre_v2=off nopti crashkernel=auto " GRUB_DISABLE_RECOVERY="true" 执行以下命令，设置crashkernel的大小。 vim /etc/default/grub 当前crashkernel预留内存大小为“auto”，您可以在“GRUB_CMDLINE_LINUX”字段，修改“crashkernel”的值，设置crashkernel的大小。 GRUB_TIMEOUT=5 GRUB_DISTRIBUTOR="$(sed 's, release .*$,,g' /etc/system-release)" GRUB_DEFAULT=saved GRUB_DISABLE_SUBMENU=true GRUB_TERMINAL_OUTPUT="console" GRUB_CMDLINE_LINUX="net.ifnames=0 consoleblank=600 console=tty0 console=ttyS0,115200n8 spectre_v2=off nopti crashkernel=256M" GRUB_DISABLE_RECOVERY="true" 您可以根据系统架构决定crashkernel预留内存大小，过小会导致生成coredump文件失败。 当前示例的系统内存是1GiB，预留内存设置为256M。 执行以下命令，重新生成grub配置文件。 grub2-mkconfig -o /boot/grub2/grub.cfg 执行以下命令，编辑内核参数文件/etc/sysctl.conf。 vim /etc/sysctl.conf 在/etc/sysctl.conf配置文件中增加以下参数，以便于在收到NMI时将操作系统切换到应急模式，并生成内存转储。 kernel.panic_on_unrecovered_nmi=1 kernel.unknown_nmi_panic=1 重启系统。 reboot 执行以下命令，修改kdump默认配置/etc/kdump.conf。 vim /etc/kdump.conf #指定coredump文件存储位置 path /var/crash #增加-c参数，代表压缩coredump文件 core_collector makedumpfile -c -l --message-level 1 -d 31 #生成coredump后，重启系统 default reboot 执行以下命令，开启kdump服务并设置开机自启动。 systemctl start kdump.service systemctl enable kdump.service 执行以下命令，检查kdump是否开启成功。 service kdump status Redirecting to /bin/systemctl status kdump.service ● kdump.service - Crash recovery kernel arming Loaded: loaded (/usr/lib/systemd/system/kdump.service; enabled; vendor preset: enabled) Active: active (exited) since Wed 2024-05-22 21:19:47 CST; 11min ago Main PID: 591 (code=exited, status=0/SUCCESS) CGroup: /system.slice/kdump.service systemctl is-active kdump.service active

GPU驱动概述 在使用GPU加速型实例前，请确保实例已安装GPU驱动以获得相应的GPU加速能力。 GPU加速型实例支持两种类型的驱动：GRID驱动和Tesla驱动。 当前已支持使用自动化脚本安装GPU驱动，建议优先使用自动安装方式，脚本获取以及安装指导请参考（推荐）自动安装GPU加速型ECS的GPU驱动（Linux）和（推荐）自动安装GPU加速型ECS的GPU驱动（Windows）。 GPU虚拟化型实例，需要严格按照表1选择合适的驱动版本下载使用。 如果需要使用OpenGL/DirectX/Vulkan等图形加速能力，则需要安装GRID驱动并自行购买和配置使用GRID License。此外，GRID驱动配合vDWS类型License，也支持CUDA，用来满足既需要计算加速也需要图形加速的场景。 使用公共镜像创建的图形加速型（G系列）实例默认已安装特定版本的GRID驱动，但GRID License需自行购买和配置使用，请提前确认GPU加速型实例是否已经预装或者预装版本是否符合需求。 使用私有镜像创建的GPU加速型实例，如需安装GRID驱动请参考手动安装GPU加速型ECS的GRID驱动。 如果需要实现计算加速能力，则需要安装Tesla驱动。 使用公共镜像创建的计算加速型（P系列）实例默认已安装特定版本的Tesla驱动。 使用私有镜像创建的GPU加速型实例，如需安装Tesla驱动请参考手动安装GPU加速型ECS的Tesla驱动。 表1 GPU驱动支持的加速能力 驱动类型 License CUDA OpenGL DirectX Vulkan 典型应用场景 说明 GRID驱动 需要 支持 支持 支持 支持 3D渲染、图形工作站、游戏加速 付费使用，需要购买License，满足图形图像类应用加速用途。 Tesla驱动 不需要 支持 不支持 不支持 不支持 科学计算、深度学习训练和推理 通常搭配使用NVIDIA CUDA SDK，可免费下载使用，满足通用计算类应用加速用途。

User data（EC2-兼容的API） 用于查询弹性云服务器的自定义。该值仅在创建弹性云服务器时指定，不支持修改。 URI /169.254.169.254/latest/user-data 方法 支持GET请求。 示例 Linux操作系统： curl http://169.254.169.254/latest/user-data Windows操作系统： Invoke-RestMethod http://169.254.169.254/latest/user-data ICAgICAgDQoiQSBjbG91ZCBkb2VzIG5vdCBrbm93IHdoeSBpdCBtb3ZlcyBpbiBqdXN0IHN1Y2ggYSBkaXJlY3Rpb24gYW5kIGF0IHN1Y2ggYSBzcGVlZC4uLkl0IGZlZWxzIGFuIGltcHVsc2lvbi4uLnRoaXMgaXMgdGhlIHBsYWNlIHRvIGdvIG5vdy4gQnV0IHRoZSBza3kga25vd3MgdGhlIHJlYXNvbnMgYW5kIHRoZSBwYXR0ZXJucyBiZWhpbmQgYWxsIGNsb3VkcywgYW5kIHlvdSB3aWxsIGtub3csIHRvbywgd2hlbiB5b3UgbGlmdCB5b3Vyc2VsZiBoaWdoIGVub3VnaCB0byBzZWUgYmV5b25kIGhvcml6b25zLiINCg0KLVJpY2hhcmQgQmFjaA==

Public Keys（EC2-兼容的API） 用于查询弹性云服务器的公钥。 URI /169.254.169.254/latest/meta-data/public-keys/0/openssh-key 方法 支持GET请求。 示例 Linux操作系统： curl http://169.254.169.254/latest/meta-data/public-keys/0/openssh-key Windows操作系统： Invoke-RestMethod http://169.254.169.254/latest/meta-data/public-keys/0/openssh-key ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDI5Fw5k8Fgzajn1zJwLoV3+wMP+6CyvsSiIc/hioggSnYu/AD0Yqm8vVO0kWlun1rFbdO+QUZKyVr/OPUjQSw4SRh4qsTKf/+eFoWTjplFvd1WCBZzS/WRenxIwR00KkczHSJro763+wYcwKieb4eKRxaQoQvoFgVjLBULXAjH4eKoKTVNtMXAvPP9aMy2SLgsJNtMb9ArfziAiblQynq7UIfLnN3VclzPeiWrqtzjyOp6CPUXnL0lVPTvbLe8sUteBsJZwlL6K4i+Y0lf3ryqnmQgC21yW4Dzu+kwk8FVT2MgWkCwiZd8gQ/+uJzrJFyMfUOBIklOBfuUENIJUhAB Generated-by-Nova

Hostname（EC2-兼容的API） 用于查询弹性云服务器的主机名称，后面会追加.novalocal后缀。 URI /169.254.169.254/latest/meta-data/hostname 方法 支持GET请求。 示例 Linux操作系统： curl http://169.254.169.254/latest/meta-data/hostname Windows操作系统： Invoke-RestMethod http://169.254.169.254/latest/meta-data/hostname vm-test.novalocal

Availability Zone（EC2-兼容的API） 用于查询弹性云服务器的AZ信息。 URI /169.254.169.254/latest/meta-data/placement/availability-zone 方法 支持GET请求。 示例 Linux操作系统： curl http://169.254.169.254/latest/meta-data/placement/availability-zone Windows操作系统： Invoke-RestMethod http://169.254.169.254/latest/meta-data/placement/availability-zone az1.dc1

Public IPv4（EC2-兼容的API） 用于查询弹性云服务器的弹性公网IP地址。多网卡情况下，只显示主网卡的弹性公网IP地址。 URI /169.254.169.254/latest/meta-data/public-ipv4 方法 支持GET请求。 示例 Linux操作系统： curl http://169.254.169.254/latest/meta-data/public-ipv4 Windows操作系统： Invoke-RestMethod http://169.254.169.254/latest/meta-data/public-ipv4 46.1.1.2

Local IPv4（EC2-兼容的API） 用于查询弹性云服务器的固定IP地址。多网卡情况下，只显示主网卡的地址。 URI /169.254.169.254/latest/meta-data/local-ipv4 方法 支持GET请求。 示例 Linux操作系统： curl http://169.254.169.254/latest/meta-data/local-ipv4 Windows操作系统： Invoke-RestMethod http://169.254.169.254/latest/meta-data/local-ipv4 192.1.1.2

Instance Type（EC2-兼容的API） 用于查询弹性云服务器的规格名称。 URI /169.254.169.254/latest/meta-data/instance-type 方法 支持GET请求。 示例 Linux操作系统： curl http://169.254.169.254/latest/meta-data/instance-type Windows操作系统： Invoke-RestMethod http://169.254.169.254/latest/meta-data/instance-type s3.medium.2

User data（OpenStack元数据API） 用于查询弹性云服务器的自定义数据。该值仅在创建弹性云服务器时指定，不支持修改。 URI /169.254.169.254/openstack/latest/user_data 方法 支持GET请求。 示例 Linux操作系统： curl http://169.254.169.254/openstack/latest/user_data Windows操作系统： Invoke-RestMethod http://169.254.169.254/openstack/latest/user_data ICAgICAgDQoiQSBjbG91ZCBkb2VzIG5vdCBrbm93IHdoeSBpdCBtb3ZlcyBpbiBqdXN0IHN1Y2ggYSBkaXJlY3Rpb24gYW5kIGF0IHN1Y2ggYSBzcGVlZC4uLkl0IGZlZWxzIGFuIGltcHVsc2lvbi4uLnRoaXMgaXMgdGhlIHBsYWNlIHRvIGdvIG5vdy4gQnV0IHRoZSBza3kga25vd3MgdGhlIHJlYXNvbnMgYW5kIHRoZSBwYXR0ZXJucyBiZWhpbmQgYWxsIGNsb3VkcywgYW5kIHlvdSB3aWxsIGtub3csIHRvbywgd2hlbiB5b3UgbGlmdCB5b3Vyc2VsZiBoaWdoIGVub3VnaCB0byBzZWUgYmV5b25kIGhvcml6b25zLiINCg0KLVJpY2hhcmQgQmFjaA== 如果创建弹性云服务器时未注入自定义数据，此时，该接口的查询结果是404，如图1所示。 图1 404 Not Found

Network data（OpenStack元数据API） 查询弹性云服务器的网络信息，支持查询云服务器挂载的全部网卡的信息，包括网卡所在子网的 DNS地址 、网络带宽、网卡ID、网卡私有IP地址、网卡弹性公网IP地址、网卡的MAC地址。 URI /openstack/latest/network_data.json 方法 支持GET请求 示例 instance_max_bandwidth、instance_min_bandwidth的单位是Mbps，如果取值为-1，说明对带宽大小无限制。 Linux操作系统： curl http://169.254.169.254/openstack/latest/network_data.json Windows操作系统： Invoke-RestMethod http://169.254.169.254/openstack/latest/network_data.json | ConvertTo-Json { "services": [{ "type": "dns", "address": "xxx.xx.x.x" }, { "type": "dns", "address": "100.125.21.250" }], "qos":{ "instance_min_bandwidth": 100, "instance_max_bandwidth": 500 }, "networks": [{ "network_id": "67dc10ce-441f-4592-9a80-cc709f6436e7", "type": "ipv4_dhcp", "link": "tap68a9272d-71", "id": "network0" }], "links": [{ "vif_id": "68a9272d-7152-4ae7-a138-3ef53af669e7", "public_ipv4": "100.100.xx.xx", "ethernet_mac_address": "fa:16:3e:f7:c1:47", "mtu": null, "local_ipv4": "192.169.10.10", "type": "cascading", "id": "tap68a9272d-71" }] }

弹性云服务器元数据类别支持列表 表1中不包含兼容EC2类型的ami-id、ami-launch-index、ami-manifest-path、block-device-mapping/、instance-action、instance-id、reservation-id、ramdisk-id、kernel-id元数据项，以上元数据项均无实际含义，不建议使用。 表1 弹性云服务器元数据类别支持列表 元数据类型 实例元数据项 约束说明 OpenStack类型 /meta_data.json 查询弹性云服务器的元数据信息。 元数据的关键字段请参见表2。 OpenStack类型 /password 查询弹性云服务器的密码。 Windows系统使用keypairs创建弹性云服务器初始化时cloudbase-init用于保存密文密码。 OpenStack类型 /user_data 查询弹性云服务器的自定义数据。 用户根据需要自行指定脚本和配置文件用于弹性云服务器初始化，详细操作请参考通过实例自定义数据配置ECS实例。 若linux虚拟化使用密码方式，则保存注入密码的脚本。 OpenStack类型 /network_data.json 查询弹性云服务器的网络信息。 OpenStack类型 /securitykey 获取临时的AK、SK。 对弹性云服务器获取临时的AK、SK，需要在 IAM 上对op_svc_ecs账户进行委托授权，并对相应的弹性云服务器资源进行授权委托管理。 说明： 委托的授权权限由用户自行设置，建议根据实际业务需要进行最小化授权。 ECS服务本身不会使用委托对资源进行操作。 OpenStack类型 /spot/instance-action 查询竞价实例关机提示。 兼容EC2类型 /meta-data/hostname 查询弹性云服务器的主机名称。 请参考以下链接为弹性云服务器去掉后缀.novalocal: 弹性云服务器的主机名带后缀.novalocal 兼容EC2类型 /meta-data/local-hostname 该字段含义同hostname一致。 兼容EC2类型 /meta-data/public-hostname 该字段含义同hostname一致。 兼容EC2类型 /meta-data/instance-type 查询弹性云服务器的规格名称。 兼容EC2类型 /meta-data/local-ipv4 查询弹性云服务器的固定IP地址。 多网卡情况下，只显示主网卡的地址。 兼容EC2类型 /meta-data/placement/availability-zone 查询弹性云服务器的AZ信息。 兼容EC2类型 /meta-data/public-ipv4 查询弹性云服务器的弹性公网IP地址。 多网卡情况下，只显示主网卡的弹性公网IP地址。 兼容EC2类型 /meta-data/public-keys/0/openssh-key 查询弹性云服务器的公钥。 兼容EC2类型 /user-data 查询弹性云服务器的自定义数据。 兼容EC2类型 /meta-data/security-groups 查询弹性云服务器所使用的安全组名称。 表2 metadata关键字段 参数 参数类型 描述 uuid String 弹性云服务器的ID。 availability_zone String 弹性云服务器所在可用区。 meta Dict 元数据信息，包括镜像名称、镜像ID、VPC ID等信息。 hostname String 弹性云服务器主机名。 请参考以下链接为弹性云服务器去掉后缀.novalocal: 弹性云服务器的主机名带后缀.novalocal enterprise_project_id String 查询弹性云服务器的企业项目ID信息。

Instance Action（OpenStack元数据API） 用于查询竞价实例关机提示。 如果您的竞价实例即将被中断，该接口会返回预计关机的时间。 URI /openstack/latest/spot/instance-action 方法 支持GET请求。 示例 Linux操作系统： curl http://169.254.169.254/openstack/latest/spot/instance-action Windows操作系统： Invoke-RestMethod http://169.254.169.254/openstack/latest/spot/instance-action {"action":"terminate","timestamp":"2023-06-01 09:15:00"}

Metadata（OpenStack元数据API） 用于查询弹性云服务器的元数据。 URI /169.254.169.254/openstack/latest/meta_data.json 方法 支持GET请求。 示例： Linux操作系统：以使用cURL工具为例，介绍查询弹性云服务器元数据的方法。 curl http://169.254.169.254/openstack/latest/meta_data.json Windows操作系统：以使用Invoke-RestMethod工具为例，介绍查询弹性云服务器元数据的方法。 Invoke-RestMethod http://169.254.169.254/openstack/latest/meta_data.json | ConvertTo-Json { "random_seed": "rEocCViRS+dNwlYdGIxJHUp+00poeUsAdBFkbPbYQTmpNwpoEb43k9z+96TyrekNKS+iLYDdRNy4kKGoNPEVBCc05Hg1TcDblAPfJwgJS1okqEtlcofUhKmL3K0fto+5KXEDU3GNuGwyZXjdVb9HQWU+E1jztAJjjqsahnU+g/tawABTVySLBKlAT8fMGax1mTGgArucn/WzDcy19DGioKPE7F8ILtSQ4Ww3VClK5VYB/h0x+4r7IVHrPmYX/bi1Yhm3Dc4rRYNaTjdOV5gUOsbO3oAeQkmKwQ/NO0N8qw5Ya4l8ZUW4tMav4mOsRySOOB35v0bvaJc6p+50DTbWNeX5A2MLiEhTP3vsPrmvk4LRF7CLz2J2TGIM14OoVBw7LARwmv9cz532zHki/c8tlhRzLmOTXh/wL36zFW10DeuReUGmxth7IGNmRMQKV6+miI78jm/KMPpgAdK3vwYF/GcelOFJD2HghMUUCeMbwYnvijLTejuBpwhJMNiHA/NvlEsxJDxqBCoss/Jfe+yCmUFyxovJ+L8oNkTzkmtCNzw3Ra0hiKchGhqK3BIeToV/kVx5DdF081xrEA+qyoM6CVyfJtEoz1zlRRyoo9bJ65Eg6JJd8dj1UCVsDqRY1pIjgzE/Mzsw6AaaCVhaMJL7u7YMVdyKzA6z65Xtvujz0Vo=", "uuid": "ca9e8b7c-f2be-4b6d-a639-f10b4d994d04", "availability_zone": "lt-test-1c", "enterprise_project_id" : "0", "hostname": "ecs-ddd4.novalocal", "launch_index": 0, "instance_type": "s3.medium.2", "meta": { "metering.image_id": "3a64bd37-955e-40cd-ab9e-129db56bc05d", "metering.imagetype": "gold", "metering.resourcespeccode": "s3.medium.2.linux", "admin_pass": "", "metering.cloudServiceType": "hws.service.type.ec2", "image_name": "CentOS 7.6 64bit", "metering.resourcetype": "1", "vpc_id": "3b6c201f-aeb3-4bce-b841-64756e66cb49", "os_bit": "64", "cascaded.instance_extrainfo": "pcibridge:1", "os_type": "Linux", "charging_mode": "0" "__support_agent_list": "hss,ces" }, "region_id": "xxx", "project_id": "6e8b0c94265645f39c5abbe63c4113c6", "name": "ecs-ddd4" }

通过智能购买组跨计费模式和可用区购买ECS 登录控制台，进入创建智能购买组页面。 设置智能购买组的名称、计费模式及目标容量。 图2 智能购买组 表1 参数设置说明 参数 示例 说明 智能购买组名称 alg-example 智能购买组的名称。 长度为2~64个字符，只能包含中文、字母、数字、下划线（_）和中划线（-）。 目标容量 实例个数，5 用于设置使用智能购买组购买的实例目标总容量。 您可以通过目标容量指定智能购买组交付的算力总和，支持设置为实例个数或vCPU数量。每个智能购买组的目标容量限制： 如果以实例个数为目标容量最多创建500台实例。 如果以vCPUs为目标容量最大创建40000vCPUs。 按需实例容量 3 仅当勾选“使用按需实例提供部分算力”时，会显示该参数。 用于设置按需实例的容量，取值小于等于“目标容量”。 设置启动模板、实例配置及实例分配策略。 图3 实例配置信息 表2 参数设置说明 参数 示例 说明 启动模板 alg-example 用于设置智能购买组在创建实例时，选择启动模板作为配置信息的来源。 通过“展开启动模板详情”可查看所选启动模板的具体配置信息。 实例配置 可用区1，s7.medium.2 用于在启动模板配置信息基础上自定义“指定可用区”和“规格”。 支持添加多个实例自定义配置，推荐您选择多个不同可用区和实例规格，提升资源交付的成功率。 实例分配策略 最低价格策略 用于设置实例分配遵循的策略。 最低价格策略：智能购买组购买的所有实例的价格总和最低。 多可用区均衡策略：智能购买组购买的实例在多个可用区之间均匀分配算力。 容量优化策略：智能购买组购买的实例按照大规格优先的原则进行购买。即目标容量为实例个数时智能购买组的vCPU容量最大；目标容量为vCPU大小时智能购买组的实例个数最小。 设置智能购买组类型、启动/结束时间等参数。 图4 智能购买组信息 表3 参数设置说明 参数 示例 说明 智能购买组类型 一次性交付 用于设置智能购买组的类型。 一次性交付：智能购买组仅在启动时尝试一次性创建目标容量的实例，即使未达到目标容量也不再重试。 持续保持：智能购买组实时监控当前集群的容量与目标容量，如未达到目标容量继续创建实例，直至满足目标容量。 启动时间 立即启动 用于设置智能购买组开始创建实例的时间。 立即启动：智能购买组创建成功后立即启动。 指定启动时间：自定义智能购买组的启动时间。 结束时间 无限期 与启动时间相结合，用于设置智能购买组的有效时间。 无限期：智能购买组长期有效。 指定结束时间：自定义智能购买组的过期时间。 全局竞价实例的价格上限 0.12 仅当勾选了“设 定价 格上限”时，会显示该参数。用于设置智能购买组内竞价实例的价格上限。 当智能购买组内某一竞价实例的市场价格高于该价格上限时，该竞价实例将被中断回收。如果同时设置了单个竞价实例的价格上限和全局竞价实例的价格上限，则以单个竞价实例的价格上限为准。 组内释放设置 智能购买组过期时释放 实例超过容量时释放实例 当设置了智能购买组的结束时间时，该参数有效。 智能购买组过期时释放：当智能购买组超过有效时间，即删除组内实例。 实例超过容量时释放实例：当智能购买组的实例个数/vCPU之和超过目标容量时，即删除超出容量的实例。 单击“立即创建”，开始创建实例。

通过启动模板快速购买ECS 在启动模板列表中，单击“操作”列的“购买云服务器”，进入“购买弹性云服务器”页面。 图1 启动模板列表 在“购买弹性云服务器”页面，以根据启动模板的配置信息，预设了购买ECS的参数，您可以根据业务需要进行修改。 例如，修改“登录凭证”方式为“密码”，并设置ECS的密码。 参数设置的详细内容，请参见自定义购买ECS。 在购买页右侧的“配置概要”中，确认配置信息。 确认无误后，勾选协议并单击“立即购买”。 ECS创建成功后会默认开机。

约束与限制 支持的区域包括：华北-乌兰察布一、华东-上海一、华东-上海二、华南-广州、西南-贵阳一。 仅支持跨可用区部署ECS实例，不支持跨区域部署ECS实例。 通过智能购买组部署ECS实例，其目标容量限制： 以实例个数为目标容量：最多创建500台实例。 以vCPUs为目标容量：最大创建40000vCPUs。 每个智能购买组最多指定一个启动模板。 智能购买组免费，但通过智能购买组创建的实例正常计费。