修订记录 发布日期 修订记录 2024-05-13 新增 Windows无法打开开始菜单及搜索框 为什么Linux云服务器df和du统计磁盘空间的大小不一致？ NetworkManager服务无法启动，报错：Failed to restart NetuorkManager.service: Unit NetworkManager.service is masked 修改弹性云服务器的时间后，为什么IP地址丢失了？ SSH密钥无法登录，报错Authentication refused: bad ownership or modes for directory /root 如何解决Ubuntu 16.04云服务器可以通过SSH成功登录，但VNC界面无法到达登录界面的问题 2024-05-09 新增GPU实例故障自诊断。 2024-05-07 新增错误的系统配置导致启动或远程登录失败。 2024-04-29 修改怎样配置Linux分析工具：atop和kdump。 2024-03-27 新增SCSI磁盘IO压力大时，在线并发扩容失败怎么办？。 2023-10-27 新增扩容云硬盘后使用growpart扩容分区失败怎么办？。 2023-08-22 修改GPU设备显示异常。 2023-06-01 新增Linux实例执行命令或启动服务时出现错误：Cannot allocate memory。 2023-05-30 新增内核参数kernel.unknown_nmi_panic配置错误导致Linux ECS实例异常重启。 2023-04-20 新增Linux实例IP地址丢失怎么办？。 2022-12-14 修改Linux云服务器如何进入单用户模式重置root密码。 2022-09-30 修改 Windows云服务器卡顿怎么办？ Linux云服务器卡顿怎么办？ 2022-08-19 新增T4 GPU设备显示异常。 修改ping不通或丢包时如何进行链路测试？。 2021-11-12 修改ping不通或丢包时如何进行链路测试？。 2021-09-17 修改网站无法访问怎么办？。 2021-06-16 修改 弹性云服务器访问中国大陆外网站时加载缓慢怎么办？，修改DNS使用的IP地址。 2020-04-26 新增 GPU驱动异常怎么办？ GPU驱动不可用 GPU设备显示异常 修改 优化故障案例分类，新增GPU驱动故障、SSH连接、多用户登录。 2020-02-17 新增 Windows云服务器如何配置多用户登录？（Windows 2008） 2020-01-19 修改 Linux云服务器如何进入单用户模式重置root密码，补充 EulerOS进入内核编辑模式的说明。 怎样长时间保持SSH会话连接不断开？，修改示例。 2019-12-25 新增 开启UseDNS导致SSH连接缓慢怎么办？ CentOS 7中/etc/rc.local开机启动脚本不生效怎么办？ 2019-11-30 修改 防火墙设置 Linux云服务器怎样关闭防火墙、添加例外端口？ Ubuntu系列弹性云服务器如何安装图形化界面？ 2019-10-11 新增 为什么操作系统实际版本与购买时镜像版本不一致？ 云服务器新内核启动失败如何设置使用第二内核启动 CentOS 7中修改fstab无法挂载怎么办？ NetworkManager在运行docker容器时占用大量内存怎么办？ Linux操作系统云服务器中buffer和cache占用内存怎么办？ /etc/passwd文件损坏导致云服务器登录失败怎么办？ Linux系统ping域名失败，提示Name or service not known Linux操作系统执行passwd命令重置密码失败提示：Authentication token manipulation error 2019-09-27 下线 2.7-Windows弹性云服务器安装VPN 3.8-CentOS 7.3弹性云服务器搭建VPN服务端和客户端 修改 怎样长时间保持SSH会话连接不断开？ 2019-09-10 新增 ping不通或丢包时如何进行链路测试？ 云服务器端口不通怎样排查？ 访问ECS实例上运行的网站卡顿，如何定位问题？ 云服务器带宽占用高怎么办？ Windows云服务器如何保持会话连接长时间不断开？ Linux云服务器怎样关闭防火墙、添加例外端口？ Linux操作系统云服务器磁盘分区提示空间不足怎么办？ 修改/etc/security/limits.conf文件，重启后不生效怎么办？ 使用taskset命令让进程运行在指定CPU上 修改 Windows云服务器如何配置多用户登录？（Windows 2012） 申请多用户会话授权的license并激活云服务器 2019-08-16 新增 Inode节点耗尽导致无法创建新文件问题处理 Web访问超时系统日志打印：nf_conntrack:table full, dropping packet CentOS 7修改SSH默认端口后无法连接怎么办？ Linux云服务器VNC登录失败，提示信息：Permission denied Ubuntu操作系统如何设置默认启动内核 怎样配置Linux分析工具：atop和kdump Linux启动sshd服务出现/var/empty/sshd无法访问的解决方案 Linux文件系统提示：Read-only file system 文件已经删除，但空间未释放怎么办？ 如何查看Windows云服务器的登录日志？ 修改 弹性云服务器访问中国大陆外网站时加载缓慢怎么办？ 2019-07-26 修改 Windows云服务器如何配置多用户登录？（Windows 2012） 远程桌面连接Windows云服务器云主机报错：由于协议错误会话中断 远程桌面连接Windows云服务器云主机报错：无法验证此远程计算机的身份 远程桌面链接Windows云服务器云主机报错：两台计算机无法在分配的时间内连接 远程桌面链接Windows云服务器云主机报错：连接被拒绝未授权此用户 远程桌面链接Windows云服务器云主机报错：您的连接已丢失

处理方法 关闭AppX Deployment Service服务，操作步骤如下： 按“Win+R”键打开运行对话框，输入regedit并按回车键，打开注册表编辑器。 打开至注册表键值：“HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\AppXSvc”。 双击右侧子项中的“Start”，将“数值数据”中的“3”修改为“4”。 图1 修改数值数据 如果要启用AppX Deployment Service服务，将“数值数据”由“4”改回“3”即可。

配置kdump操作步骤 查看是否已经安装kexec-tools。 rpm -q kexec-tools 如果没有安装，则执行下面命令安装。 yum install -y kexec-tools 开启kdump默认启动。 systemctl enable kdump 设置craskkernel参数，设置这个参数的目的是预留内存给capture kernel。 首先查看参数是否已经设置。 grep crashkernel /proc/cmdline 如果有显示，则表示已经设置，如果没有显示，则需要重新设置。 设置crashkernel，编辑/etc/default/grub文件。 GRUB_TIMEOUT=5 GRUB_DEFAULT=saved GRUB_DISABLE_SUBMENU=true GRUB_TERMINAL_OUTPUT="console" GRUB_CMDLINE_LINUX="crashkernel=auto rd.lvm.lv=rhel00/root rd.lvm.lv=rhel00/swap rhgb quiet" GRUB_DISABLE_RECOVERY="true" 找到GRUB_CMDLINE_LINUX参数，添加crashkernel=auto，其他内容不变。 执行grub命令，使以上配置生效。 grub2-mkconfig -o /boot/grub2/grub.cfg 打开/etc/kdump.conf文件中找到“path”参数，添加以下内容。 path /var/crash 默认是保存在/var/crash目录下，如果要保存到其他目录，则改成对应的目录， 例如保存在/home/kdump下，则改成： path /home/kdump 要确保指定的路径有足够的空间保存vmcore，建议剩余空间不小于RAM大小；也可以保存在SAN，nfs等共享设备上。 设置转存vmcore级别。 修改/etc/kdump.conf文件，添加如下参数，如果存在则无需添加。 core_collector makedumpfile -d 31 -c -c表示压缩vmcore文件， -d表示过滤掉部分无效的内存数据，可以根据需要调整，一般31即可，31是由如下的值与计算而成。 zero pages = 1 cache pages = 2 cache private = 4 user pages = 8 free pages = 16 执行如下命令重启系统，使以上配置生效。 reboot

CentOS 6系列操作系统配置atop 执行以下命令，安装atop。 yum install -y atop 编辑配置文件，修改采样周期。 vi /etc/sysconfig/atop 修改如下配置参数，修改后保存并退出。 LOGINTERVAL默认是600，可以修改成15，单位秒。 LOGINTERVAL=15 vi /etc/logrotate.d/atop 修改如下配置参数，修改后保存并退出。 默认atop日志保存周期为40天，可以根据实际修改“-mtime”的值为3，单位为天。 postrotate /usr/bin/find /var/log/atop/ -maxdepth 1 -mount -name atop_\[0-9\]\[0-9\]\[0-9\]\[0-9\]\[0-9\]\[0-9\]\[0-9\]\[0-9\]\* -mtime +3 -exec /bin/rm {} \; endscript 启动atop服务。 service atop start 检查是否启动成功，is running 表示运行正常。 service atop status atop (pid 3170) is running

Ubuntu 20/22、Debian 10/11系列操作系统配置atop 执行以下命令，安装atop。 apt-get install -y atop 编辑配置文件，修改采样周期。 vi /etc/default/atop 修改如下配置参数，修改后保存并退出。 LOGINTERVAL默认是600，可以修改成15，单位秒。 默认atop日志保存周期为28天，可以根据实际修改LOGGENERATIONS的值为3，单位为天。 LOGINTERVAL=15 LOGGENERATIONS=3 启动atop服务。 systemctl start atop 检查是否启动成功，active(running) 表示运行正常。 systemctl status atop atop.service - Atop advanced performance monitor Loaded: loaded (/etc/init.d/atop; bad; vendor preset: disabled) Active: active (running) since Sat 2024-03-11 14:09:47 CST; 16s ago

Ubuntu 16系列操作系统配置atop 执行以下命令，安装atop。 apt-get install -y atop 编辑配置文件，修改采样周期。 vi /etc/default/atop 修改如下配置参数，修改后保存并退出。 LOGINTERVAL默认是600，可以修改成15，单位秒。 默认atop日志保存周期为28天，不支持修改。 LOGINTERVAL=15 启动atop服务。 systemctl start atop 检查是否启动成功，active(running) 表示运行正常。 systemctl status atop atop.service - LSB: Monitor for system resources and process activity Loaded: loaded (/etc/init.d/atop; bad; vendor preset: enabled) Active: active (running) since Mon 2024-04-29 19:33:22 CST; 38s ago

SUSE 15、SUSE 12系列操作系统配置atop 下载atop源码安装包。 wget https://www.atoptool.nl/download/atop-2.6.0-1.src.rpm 执行以下命令安装源码atop。 rpm -ivh atop-2.6.0-1.src.rpm 安装编译atop依赖软件包 zypper -n install rpm-build ncurses-devel zlib-devel 执行以下命令编译atop cd /usr/src/packages/SPECS rpmbuild -bb atop-2.6.0.spec 执行以下命令安装atop cd /usr/src/packages/RPMS/x86_64 rpm -ivh atop-2.6.0-1.x86_64.rpm 编辑配置文件，修改采样周期。 vi /etc/default/atop 修改如下配置参数，修改后保存并退出。 LOGINTERVAL默认是600，可以修改成15，单位秒。 默认atop日志保存周期为28天，可以根据实际修改LOGGENERATIONS的值为3，单位为天。 LOGINTERVAL=15 LOGGENERATIONS=3 重启atop服务。 systemctl restart atop 检查是否启动成功，active(running) 表示运行正常。 systemctl status atop atop.service - Atop advanced performance monitor Loaded: loaded (/usr/lib/systemd/system/atop.service; enabled; vendor preset: disabled) Active: active (running) since Sat 2021-06-19 16:50:01 CST; 6s ago

分析atop日志 atop启动后，会将采集记录存放在/var/log/atop目录下的日志文件中。 执行如下命令，查看日志文件。 atop -r /var/log/atop/atop_2024XXXX atop常用命令 打开日志文件后，您可以使用以下命令筛选数据。 c：按照进程CPU使用率进行降序筛选。 m：按照进程内存使用率进行降序筛选。 d：按照进程磁盘使用率进行降序筛选。 a：按照进程资源综合使用率进行降序筛选。 n：按照进程网络使用率进行降序筛选。 t：跳转到下一个监控采集点。 T：跳转到上一个监控采集点。 b：指定时间点，格式为YYYYMMDDhhmm。 系统资源监控字段含义 下图为部分监控字段以及数值，具体数值根据采样周期和atop版本有所不同。下图仅供参考，具体数据以您实际数据为准。 图1 系统资源监控字段 主要参数说明如下： ATOP 行：主机名、信息采样日期和时间点。 PRC 行：进程整体运行情况。 #sys 及 user：内核态和用户态所占 CPU 的时间值。 #proc：进程总数。 #zombie：僵死进程的数量。 #exit：采样周期期间退出的进程数量。 CPU 行：CPU 整体（即多核 CPU 作为一个整体 CPU 资源）的使用情况。CPU 行的各字段数值相加结果为 N*100%，N 为 CPU 核数。 #sys 及 user：内核态和用户态所占 CPU 的时间比例。 #irq：CPU 被用于处理中断的时间比例。 #idle：CPU 处在完全空闲状态的时间比例。 #wait：CPU 处在进程等待磁盘 IO ，导致 CPU 空闲状态的时间比例。 CPL 行：CPU 负载情况。 #avg1、avg5 和 avg15：过去1分钟、5分钟和15分钟内运行队列中的平均进程数量。 #csw：指示上下文交换次数。 #intr：指示中断发生次数。 MEM 行：内存的使用情况。 #tot：物理内存大小。 #free：空闲的物理内存大小 #cache ：用于页缓存的内存大小。 #buff：用于文件缓存的内存大小。 #slab：系统内核占用的内存大小。 SWP 行：交换空间的使用情况。 #tot：交换区总量。 #free：空闲交换空间大小。 DSK 行：磁盘使用情况，每一个磁盘设备对应一列。如果有 sdb 设备，那么增加一行 DSK 信息。 #sda：磁盘设备标识。 #busy：磁盘忙时比例。 #read 及 write：读、写请求数量。 NET 行：多列 NET 展示了网络状况，包括传输层（TCP 和 UDP）、IP 层以及各活动的网口信息。 #xxxxxi：各层或活动网口收包数目。 #xxxxxo：各层或活动网口发包数目。 停止 atop atop运行会占用额外的系统和磁盘资源，不建议在业务环境下长期运行，您可在问题排查完成后，执行以下命令停止atop。 systemctl stop atop CentOS 6执行以下命令停止atop。 service atop stop

CentOS 7/8、AlmaLinux、 Rocky Linux系列操作系统配置atop 执行以下命令，安装atop。 yum install -y atop 编辑配置文件，修改采样周期。 vi /etc/sysconfig/atop 修改如下配置参数，修改后保存并退出。 LOGINTERVAL默认是600，可以修改成15，单位秒。 默认atop日志保存周期为28天，可以根据实际修改LOGGENERATIONS的值为3，单位为天。 LOGINTERVAL=15 LOGGENERATIONS=3 启动atop服务。 systemctl start atop 检查是否启动成功，active(running) 表示运行正常。 systemctl status atop atop.service - Atop advanced performance monitor Loaded: loaded (/usr/lib/systemd/system/atop.service; enabled; vendor preset: disabled) Active: active (running) since Sat 2024-03-6 11:49:47 CST; 2h 27min ago

Ubuntu 18、Debian 8/9系列操作系统配置atop 执行以下命令，安装atop。 apt-get install -y atop 编辑配置文件，修改采样周期。 vi /usr/share/atop/atop.daily 修改如下配置参数，修改后保存并退出。 LOGINTERVAL默认是600，可以修改成15，单位秒。 默认atop日志保存周期为28天，可以根据实际修改“-mtime”的值为3，单位为天。 LOGINTERVAL=15 …… ( (sleep 3; find $LOGPATH -name 'atop_*' -mtime +3 -exec rm {} \;)& ) 启动atop服务。 systemctl start atop 检查是否启动成功，active(running) 表示运行正常。 systemctl status atop atop.service - Atop advanced performance monitor Loaded: loaded (/etc/init.d/atop; bad; vendor preset: disabled) Active: active (running) since Sat 2024-03-6 14:09:47 CST; 15s ago

操作场景 本节操作介绍atop和kdump的配置方法。 不同的Linux版本使用的atop工具版本不同，因此配置方法稍微有所不同。 配置atop： atop简介 atop安装前准备 CentOS 7/8、AlmaLinux、 Rocky Linux系列操作系统配置atop CentOS 6系列操作系统配置atop Ubuntu 20/22、Debian 10/11系列操作系统配置atop Ubuntu 18、Debian 8/9系列操作系统配置atop Ubuntu 16系列操作系统配置atop SUSE 15、SUSE 12系列操作系统配置atop 使用源码方式安装（适用于CentOS Stream 9、openEuler、EulerOS等系列操作系统） 分析atop日志 配置kdump： 配置kdump使用须知 kdump简介 配置kdump操作步骤 检查kdump配置是否生效

os_extra_specs（flavor）字段数据结构说明 该字段被如下接口使用： 查询规格详情和规格扩展信息列表 /v1/{project_id}/cloudservers/flavors 查询云服务器规格扩展字段详情 /v1/{project_id}/flavors/{flavor_id}/os-extra_specs 表1 os_extra_specs数据结构说明（仅列举常用参数） 参数 参数类型 描述 ecs:performancetype String 云服务器规格的分类： normal：通用计算型 entry：通用入门型 cpuv1：计算I型 cpuv2：计算II型 computingv3：通用计算增强型 kunpeng_computing：鲲鹏通用计算增强型 kunpeng_highmem：鲲鹏内存优化型 kunpeng_highio：鲲鹏超高I/O型 highmem：内存优化型 saphana：超大内存型 diskintensive：磁盘增强型 highio：超高I/O型 ultracpu：超高性能计算型 gpu：GPU加速型 fpga：FPGA加速型 ascend：AI加速型 说明： 早期注册的规格该字段为hws:performancetype。 XEN实例不支持该参数。 hw:numa_nodes String 主机的物理cpu数量。（该字段是否返回根据云服务器规格而定） resource_type String 资源类型。resource_type是为了区分云服务器的物理主机类型。 hpet_support String 云服务器高精度时钟是否开启，开启为true，否则为false。（该字段是否返回根据云服务器规格而定） instance_vnic:type String 网卡类型，值固定为“enhanced”，表示使用增强型网络的资源创建云服务器。 instance_vnic:instance_bandwidth String 最大带宽，单位Mbps，最大值为10000。 instance_vnic:max_count String 最大网卡个数，最大为4。 quota:local_disk String 值格式为{type}:{count}:{size}:{safeFormat}，其中： type指磁盘类型，当前只支持hdd。 count指本地磁盘数量，目前支持： d1类型：3/6/12/24 d2类型：2/4/8/12/16/24 d3类型：2/4/8/12/16/24/28。 size指单个磁盘容量，单位GB，目前只支持1675（实际磁盘大小为1800，格式化后可用大小为1675）。 safeFormat指云服务器本地磁盘是否安全格式化，目前仅支持： d1类型：FALSE d2/d3类型：True。 说明： 磁盘增强型特有字段。 quota:nvme_ssd String 值格式为{type}:{spec}:{num}:{size}:{safeFormat}:{挂载协议}，其中： type指主机上配备的nvme ssd的单卡容量大小，当前只支持1.6T/3.2T。 spec指nvme ssd的规格，包括large/small。large表示大规格，small表示小规格。 目前仅支持i3和ir3类型：large。 num指磁盘划分的分区个数。 size指guest使用的盘的容量大小，单位为GB。在spec值为large的情况下，此项即为host单卡大小。在spec值为small的情况下，此为1/4规格或者1/2规格。 safeFormat指云服务器本地磁盘是否安全格式化。 目前仅支持i3和ir3类型：True。 挂载协议 目前仅支持ir3类型：blk。 说明： 超高I/O型特有字段。 extra_spec:io:persistent_grant String 是否支持持久化，值为true。 代表云服务器访问存储的方式为持久化授权。 说明： 密集存储D1型特有字段。 ecs:generation String 弹性云服务器类型的代数。 示例：s3中的3表示通用型III代，详细的规格类型和代系请参考《弹性云服务器用户指南》的“实例规格清单”。 ecs:virtualization_env_types String 虚拟化类型。 如果值为“FusionCompute”，表示弹性云服务器使用基于XEN的虚拟化技术。 如果值为“CloudCompute”，表示弹性云服务器使用基于KVM的虚拟化技术。 说明： 可选字段。 pci_passthrough:enable_gpu String 显卡是否直通。 值为“true”，表示GPU直通。 pci_passthrough:gpu_specs String G1型和G2型云服务器应用的技术，包括GPU虚拟化和GPU直通。 如果该规格的云服务器使用GPU虚拟化技术，且GPU卡的型号为M60-1Q，参数值为“m60_1q:virt:1”。 如果该规格的云服务器使用GPU直通技术，且GPU卡的型号为M60，参数值为“m60:direct_graphics:1”。 pci_passthrough:alias String PCI直通设备信息，格式为PCI设备名称:数量。多个设备信息以逗号隔开。 例如nvidia-a30:1，表示携带一张A30的GPU。 cond:operation:status String 此参数是Region级配置，某个AZ没有在cond:operation:az参数中配置时默认使用此参数的取值。不配置或无此参数时等同于“normal”。取值范围： normal：正常商用 abandon：下线（即不显示） sellout：售罄 obt：公测 obt_sellout：公测售罄 promotion：推荐(等同normal，也是商用) cond:operation:az String 此参数是AZ级配置，某个AZ没有在此参数中配置时默认使用cond:operation:status参数的取值。此参数的配置格式“az(xx)”。()内为某个AZ的flavor状态，()内必须要填有状态，不填为无效配置。状态的取值范围与cond:operation:status参数相同。 例如：flavor在某个region的az0正常商用，az1售罄，az2公测，az3正常商用，其他az显示下线，可配置为： “cond:operation:status”设置为“abandon” “cond:operation:az”设置为“az0(normal), az1(sellout), az2(obt), az3(normal)” 说明： 如果flavor在某个AZ下的状态与cond:operation:status配置状态不同，必须配置该参数。 quota:max_rate String 最大带宽 单位Mbps，显示为Gbps时除以1000 quota:min_rate String 基准带宽 单位Mbps，显示为Gbps时除以1000 quota:max_pps String 内网最大收发包能力 单位个，显示为xx万时除以10000 cond:operation:charge:stop String 关机是否收费 关机是否计费，默认免费： charge free cond:operation:charge String 计费类型 计费场景，不配置时都支持 period，包年/包月 demand，按需 cond:spot:operation:az String spot售卖信息请使用 查询规格销售策略 接口查询。 Flavor在竞价销售模式下显示的AZ。 cond:operation:roles String 允许的角色 匹配的用户标签（roles的op_gatexxx标签）。不设置时所有用户可见 cond:spot:operation:status String spot售卖信息请使用 查询规格销售策略 接口查询。 Flavor在竞价销售模式下的状态 不配置时等同abandon normal，正常商用 abandon，下线 sellout，售罄 obt，公测，未申请时提示申请（暂不支持） private，私有，只给特定用户显示（暂不支持） test，试用/免费（暂不支持） promotion，推荐 cond:network String 网络约束 支持网络特性，不配置时以控制台默认配置为准。 cond:storage String 存储约束 支持磁盘特性，不配置时以控制台默认配置为准。 scsi，支持scsi localdisk，支持本地盘 ib，支持ib cond:storage:type String 支持的磁盘类型，不配置时以控制台默认配置为准。 SATA：普通IO云硬盘（已售罄） SAS：高IO云硬盘 GPSSD：通用型SSD云硬盘 SSD：超高IO云硬盘 ESSD：极速IO云硬盘 GPSSD2：通用型SSD V2云硬盘 ESSD2：极速型SSD V2云硬盘 cond:compute:live_resizable String 计算约束 true，支持在线扩容。 false或不存在该字段，不支持在线扩容。 cond:compute String 计算约束 autorecovery，自动恢复特性。 不存在该字段，不支持自动恢复。 ecs:instance_architecture String 该规格对应的CPU架构，且仅鲲鹏实例架构规格返回该字段。 取值为arm64表示CPU架构为鲲鹏计算。 info:gpu:name String GPU显卡数量和名称。 info:cpu:name String CPU名称。 quota:gpu String GPU显卡名称。 quota:vif_max_num String 云服务器最多支持绑定的弹性网卡个数。 quota:sub_network_interface_max_num String 云服务器最多支持绑定的辅助弹性网卡个数。 network_interface:traffic_mirroring_supported String 该规格是否支持流量镜像。 security:enclave_supported String 该规格是否支持QingTian Enclave。

文档修订记录 发布日期 修订记录 2024-06-12 第七十七次正式发布。 修改 查询规格详情和规格扩展信息列表，os_extra_specs字段数据结构新增参数“cond:storage:type”。 2024-05-30 第七十六次正式发布。 新增 更新云服务器指定网卡属性 2024-05-20 第七十五次正式发布。 新增 云服务器切换虚拟私有云 2024-05-14 第七十四次正式发布。 查询规格详情和规格扩展信息列表，os_extra_specs字段数据结构新增参数“network_interface:traffic_mirroring_supported”和“security:enclave_supported”。 错误码，新增错误码Ecs.0235。 2024-04-07 第七十三次正式发布。 新增参数“cpu_options”，涉及： 创建云服务器 创建云服务器（按需） 变更云服务器规格 变更云服务器规格（按需） 新增参数“isAutoPay”，涉及： 切换弹性云服务器操作系统（安装Cloud-init） 切换弹性云服务器操作系统（未安装Cloud-init） 2024-03-25 第七十二次正式发布。 修改参数“name”的取值范围，涉及： 创建云服务器 创建云服务器（按需） 修改云服务器 批量修改弹性云服务器 创建云服务器 修改云服务器 2024-01-15 第七十一次正式发布。 修改 修改云服务器，server字段新增参数“OS-EXT-SRV-ATTR:user_data”。 查询API版本信息列表，更新响应示例。 2023-10-13 第七十次正式发布。 修改 查询规格详情和规格扩展信息列表，os_extra_specs字段新增参数“quota:vif_max_num”和“quota:sub_network_interface_max_num”。 数据结构(查询云服务器详情)，address字段新增参数“primary”。 2023-09-12 第六十九次正式发布。 新增 修改云服务器定时删除时间。 修改 错误码，新增错误码Ecs.0090。 2023-08-18 第六十八次正式发布。 “volumetype”新增GPSSD2和ESSD2类型云硬盘，root_volume和data_volume字段数据结构说明新增参数“iops”和“throughput”，涉及： 创建云服务器 创建云服务器（按需） 2023-07-20 第六十七次正式发布。 异步接口增加说明，涉及： 删除云服务器 重装弹性云服务器操作系统（安装Cloud-init） 切换弹性云服务器操作系统（安装Cloud-init） 重装弹性云服务器操作系统（未安装Cloud-init） 切换弹性云服务器操作系统（未安装Cloud-init） 冷迁移云服务器 变更云服务器规格（按需） 批量启动云服务器 批量重启云服务器 批量关闭云服务器 批量挂载指定共享盘 批量添加云服务器网卡 批量删除云服务器网卡 弹性云服务器挂载磁盘 弹性云服务器卸载磁盘 2023-06-20 第六十六次正式发布。 修改接口约束，涉及： 创建云服务器 创建云服务器（按需） 2023-06-08 第六十五次正式发布。 新增 更换云服务器计费模式 修改 创建云服务器、创建云服务器（按需）：新增参数“allowed_address_pairs”、“metadata”。 查询云服务器详情列表，新增参数“ip_eq”。 2023-05-25 第六十四次正式发布。 新增 查询规格销售策略 智能购买组管理 规格推荐管理 修改 查询云服务器详情列表，修改参数status的描述。 2023-05-23 第六十三次正式发布。 修改 错误码，新增错误码Ecs.0089。 2023-05-19 第六十二次正式发布。 修改 查询云服务器详情，修改参数hw:cpu_threads的描述。 2023-05-12 第六十一次正式发布。 新增__system__encrypted、__system__cmkid参数，涉及： 重装弹性云服务器操作系统（安装Cloud-init） 切换弹性云服务器操作系统（安装Cloud-init） 重装弹性云服务器操作系统（未安装Cloud-init） 切换弹性云服务器操作系统（未安装Cloud-init） 新增错误码Ecs.0227。 2023-04-25 第六十次正式发布。 修改 获取VNC远程登录地址，修改参数url的描述。 2023-01-11 第五十九次正式发布。 修改 错误码，新增错误码Ecs.0066~Ecs.0071。 2022-12-09 第五十八次正式发布。 修改 查询云服务器详情列表，新增参数server_id。 2022-11-25 第五十七次正式发布。 新增 资源粒度授权 修改 权限及授权项说明，增加实例授权和标签授权的内容。 生命周期管理~FPGA逻辑文件管理，补充实例授权和标签授权列。 错误码，新增错误码Ecs.0812、Ecs.0813。 2022-08-19 第五十六次正式发布。 按标签查询云服务器列表（废弃），API废弃，移入“历史API”。 2022-07-29 第五十五次正式发布。 修改 错误码，新增错误码Ecs.0513。 2022-07-07 第五十四次正式发布。 新增 请求幂等性说明 修改 创建云服务器、创建云服务器（按需），补充支持请求幂等性的说明。 2022-06-20 第五十三次正式发布 修改 错误码，新增错误码Ecs.0706。 2022-05-20 第五十二次正式发布 修改 创建云服务器（按需），修改“hw:passthrough”参数说明。 2022-03-23 第五十一次正式发布 移动如下API至“历史API”： 查询云服务器是否配置了自动恢复动作（废弃） 管理云服务器自动恢复动作（废弃） 云服务器网卡配置虚拟IP地址（废弃） 云服务器网卡解绑虚拟IP地址（废弃） 数据结构(创建云服务器)，删除参数support_auto_recovery。 2022-03-17 第五十次正式发布 修改 通用请求返回值，增加通用请求返回值201。 2022-02-09 第四十九次正式发布 修改 移动废弃API至历史API。 2021-11-01 第四十八次正式发布 创建云服务器，修改请求参数metadata的参数类型。 创建云服务器（按需），修改请求参数metadata的参数类型。 2021-09-30 第四十七次正式发布 创建和导入SSH密钥，修改请求示例信息。 创建云服务器（按需），修改请求参数server_tags的参数类型。 2021-09-18 第四十六次正式发布 错误码，新增错误码Ecs.0016。 2021-08-27 第四十五次正式发布 创建云服务器、创建云服务器（按需）、创建云服务器新增auto_terminate_time字段。 查询云服务器网卡信息，新增attachableQuantity字段、interfaceAttachments补充delete_on_termination，driver_mode，min_rate，multiqueue_num，pci_address字段。 查询指定云服务器安全组列表，修改cidr字段为可选。 数据结构(创建云服务器)，bandwidth字段中修改size字段的取值说明。 2021-08-17 第四十四次正式发布 查询规格详情和规格扩展信息列表，响应参数os_extra_specs新增以下字段： flavors.extra_specs.hw:numa_nodes， flavors.extra_specs.hpet_support， flavors.extra_specs.instance_vnic:type， flavors.extra_specs.instance_vnic:instance_bandwidth， flavors.extra_specs.instance_vnic:max_count， flavors.extra_specs.extra_spec:io:persistent_grant， flavors.extra_specs.cond:operation:charge:stop， flavors.extra_specs.cond:spot:operation:az， flavors.extra_specs.cond:operation:roles， flavors.extra_specs.cond:spot:operation:status， flavors.extra_specs.cond:network， flavors.extra_specs.cond:storage， flavors.extra_specs.cond:compute:live_resizable， flavors.extra_specs.info:gpu:name， flavors.extra_specs.info:cpu:name， flavors.extra_specs.quota:gpu。 2021-06-24 第四十三次正式发布 新增 查询云服务器组列表，响应参数新增page_info字段。 修改 移动FPGA逻辑文件管理至“历史API”。 2021-05-27 第四十二次正式发布 新增 创建ECS高频场景示例 获取Token并检验Token的有效期 2021-05-10 第四十一次正式发布 修改 查询规格详情和规格扩展信息列表，新增字段ecs:instance_architecture。 2021-04-29 第四十次正式发布 修改 查询云服务器详情，status字段补充取值DELETED。 错误码，错误码Ecs.0003状态码修改为403。 2021-03-03 第三十九次正式发布 新增 数据结构(创建云服务器)，新增关于云备份策略和云备份存储库详情的字段CB_CSBS_BACKUP。 修改 查询云服务器详情列表，修改了sort_key的取值范围。 查询云服务器操作行为列表，新增字段changes-since。 2021-02-20 第三十八次正式发布。 新增 查询弹性云服务器关联的弹性公网IP。 修改 查询云服务器详情，新增os:scheduler_hints参数说明。 2021-01-29 第三十七次正式发布。 修改 查询云服务器组列表，新增page_info参数信息。 2020-11-30 第三十六次正式发布。 修改 查询云服务器组列表，新增字段limit、marker。 2020-10-10 第三十五次正式发布。 修改 创建云服务器、创建云服务器（按需），修改name字段描述，新增支持使用“正则排序”设置云服务器名称。 2020-09-22 第三十四次正式发布。 修改 创建云服务器、创建云服务器（按需），修改name取值范围描述。 2020-08-05 第三十三次正式发布。 新增 查询云服务器组列表 查询云服务器组详情 修改 移动废弃API至历史API。 创建云服务器、创建云服务器（按需），修改volumetype字段描述。 2020-07-16 第三十二次正式发布。 修改 查询云服务器详情、查询云服务器详情列表，修改status取值范围。 数据结构(查询云服务器详情)，补充metering.resourcetype的取值。 创建云服务器，修改请求示例中hw:passthrough的取值。 重装弹性云服务器操作系统（安装Cloud-init）、切换弹性云服务器操作系统（安装Cloud-init）、重装弹性云服务器操作系统（未安装Cloud-init）、切换弹性云服务器操作系统（未安装Cloud-init）补充响应示例的描述。 查询云服务器详情列表，补充说明ip字段的匹配规则为模糊匹配。 查询云服务器列表，补充说明ip字段的匹配规则为模糊匹配。 查询云服务器详情列表，补充说明ip字段的匹配规则为模糊匹配。 数据结构(创建云服务器)，补充spotPrice字段说明。 2020-06-20 第三十一次正式发布。 修改 一键重置弹性云服务器密码，新增字段is_check_password。 重装弹性云服务器操作系统（安装Cloud-init），新增mode字段，支持开机重装操作系统。 切换弹性云服务器操作系统（安装Cloud-init），新增mode字段，支持开机切换操作系统。 重装弹性云服务器操作系统（未安装Cloud-init），新增mode字段，支持开机重装操作系统。 切换弹性云服务器操作系统（未安装Cloud-init），新增mode字段，支持开机切换操作系统。 数据结构(创建云服务器)，创建云服务器的extendparam新增字段spot_duration_hours、spot_duration_count、interruption_policy。 2019-10-30 第三十次正式发布。 新增 添加云服务器组成员 删除云服务器组成员 修改 变更云服务器规格（按需）、变更云服务器规格，新增mode字段，支持开机变更规格。 删除“弹性云服务器监控指标说明”章节，移动至弹性云服务器用户指南中。 创建云服务器（按需），响应参数中新增details字段。 创建云服务器，响应参数中新增details字段。 响应（任务类），补充details数据结构。 生命周期管理修改查询云服务器详情列表（Openstack原生）的授权项，删除vpc:securityGroups:list。 生命周期管理修改查询云服务器详情（Openstack原生）的授权项，删除vpc:securityGroups:list。 查询云服务器列表、查询云服务器详情列表修改tag、not-tags字段说明，删除“受微版本2.26限制”说明。 查询云服务器详情列表、查询云服务器详情修改status取值范围，删除DELETED。 查询云服务器详情列表、查询云服务器详情补充host_status说明微版本2.16后支持。 查询规格详情和规格扩展信息列表新增响应参数attachableQuantity。 数据结构(查询规格详情)，cond:operation:status补充取值：obt_sellout：公测售罄。 修改云服务器，补充接口约束。 一键重置弹性云服务器密码，新增字段is_check_password、new_password。 2019-09-30 第二十九次正式发布。 修改 数据结构(创建云服务器)修改snapshotId字段说明。 数据结构(创建云服务器)新增字段__support_agent_list，云服务器支持主机安全服务、主机监控。 创建云服务器、修改云服务器、查询云服务器详情，补充响应参数server。 2019-09-12 第二十八次正式发布。 修改 变更云服务器规格（按需）功能介绍。 创建云服务器，支持创建按需和包年/包月弹性云服务器。 2019-08-23 第二十七次正式发布。 修改 新增查询弹性云服务器详情列表。 重装弹性云服务器操作系统（安装Cloud-init）删除v2.1URI。 切换弹性云服务器操作系统（安装Cloud-init）删除v2.1URI。 2019-07-30 第二十六次正式发布。 新增 API版本选择建议新增“版本选择”。 查询弹性云服务器单个磁盘信息 查询弹性云服务器挂载磁盘列表详情信息 查询弹性云服务器挂载磁盘列表信息 创建云服务器组 删除云服务器组 查询云服务器网卡信息 更新云服务器元数据 删除云服务器指定元数据 获取VNC远程登录地址 查询云服务器规格变更支持列表 查询项目标签 查询云服务器标签 批量添加云服务器标签 批量删除云服务器标签 冷迁移云服务器 一键重置弹性云服务器密码 获取云服务器密码 清除云服务器密码 修改云服务器 获取VNC远程登录地址（微版本2.6及以上） 重装弹性云服务器操作系统（安装Cloud-init）新增v2.1URI 切换弹性云服务器操作系统（安装Cloud-init）新增v2.1URI 查询云服务器标签（废弃） 变更弹性云服务器规格 弹性云服务器挂载磁盘 弹性云服务器挂载网卡 修改 创建云服务器（按需）、创建云服务器修改响应消息和响应示例，新增参数serverIds。 创建云服务器（按需）、创建云服务器修改subnet_id字段描述。 错误码新增Ecs.0802-Ecs.08010。 错误码新增Ecs.0046、Ecs.0048-Ecs.0053。 数据结构(创建云服务器)补充说明创建磁盘的metadata字段。 查询FPGA镜像详情列表、关联FPGA镜像与弹性云服务器镜像、解关联FPGA镜像与弹性云服务器镜像、查询关联列表、创建FPGA镜像修改请求参数的字段结构说明。 变更云服务器规格（按需），修改响应示例。 数据结构(创建云服务器)，v1.1接口补充enterprise_project_id字段。 查询云服务器详情列表，删除API接口未返回的参数evsOpts、hyperThreadAffinity、numaOpts、vcpuAffinity。 查询云服务器详情，删除API接口未返回的参数evsOpts、hyperThreadAffinity、numaOpts、vcpuAffinity。 查询云服务器详情列表，补充参数fault。 查询云服务器详情，补充参数fault。 查询租户配额下线limit_by_flavor字段。 生命周期管理修改查询云服务器详情（OpenStack原生）对应的授权项。 调整API授权列表结构。 2019-06-30 第二十五次正式发布。 新增 查询云服务器规格列表、查询云服务器规格详情列表新增响应参数flavors_links。 查询规格详情和规格扩展信息列表新增参数“quota:local_disk”和“quota:nvme_ssd”。 2019-05-30 第二十四次正式发布。 新增 API版本选择建议 数据结构(创建云服务器) 数据结构(查询规格详情) 数据结构(查询云服务器详情) 权限及授权项说明 云服务器状态 修改 调整文档结构。 将创建云服务器（按需）公共参数移动至数据结构(创建云服务器)。 将查询规格详情和规格扩展信息列表公共参数移动至数据结构(查询规格详情)。 将查询云服务器详情公共参数移动至数据结构(查询云服务器详情)。 批量重置弹性云服务器密码，修改接口约束：支持开机状态下批量重置云服务器密码。 一键重置云服务器密码（废弃），修改接口约束：支持开机状态下重置云服务器密码。 API（OpenStack Nova 原生）删除V2接口URI，推荐使用v2.1接口。 查询云服务器规格列表、查询云服务器规格详情列表新增响应参数flavors_links。 查询规格详情和规格扩展信息列表新增参数“quota:local_disk”和“quota:nvme_ssd”。 创建云服务器（按需）修改hw:passthrough字段描述。 数据结构(创建云服务器)新增数据结构导航。 删除“按标签查询云服务器列表”。 删除“按标签查询云服务器数量”。 查询规格详情和规格扩展信息列表修改disk、swap、OS-FLV-EXT-DATA:ephemeral、OS-FLV-DISABLED:disabled、rxtx_factor、rxtx_quota、rxtx_cap、os-flavor-access:is_public参数描述。 查询云服务器规格变更支持列表（废弃）修改rxtx_quota、rxtx_cap参数描述。 查询云服务器规格详情列表修改disk、swap、OS-FLV-EXT-DATA:ephemeral、OS-FLV-DISABLED:disabled参数描述。 查询云服务器规格详情修改disk、swap、OS-FLV-EXT-DATA:ephemeral、OS-FLV-DISABLED:disabled参数描述。 修改创建弹性云服务器。 2019-05-23 第二十三次正式发布。 新增 标签类型介绍 批量添加云服务器标签 批量删除云服务器标签 按标签查询云服务器列表 按标签查询云服务器数量 查询项目标签 查询云服务器标签 修改 API手册结构调整，优化使用前必读、如何调用API。 2019-04-30 第二十二次正式发布。 新增 创建FPGA镜像 修改 错误码，新增错误码Ecs.0119、Ecs.0027、Ecs.0028。 查询云服务器详情列表，修改offset参数描述。 2018-12-30 第二十一次正式发布。 新增创建云服务器 新增变更云服务器规格 修改删除云服务器 修改批量修改弹性云服务器 修改批量启动云服务器 修改批量重启云服务器 修改批量关闭云服务器 错误码，新增错误码。 修改权限和授权项，新增“授权项作用域”。 修改查询浮动IP资源池列表（废弃），修改接口约束。 2018-11-30 第二十次正式发布。 新增批量重置弹性云服务器密码 新增批量修改弹性云服务器 修改错误码，新增错误码。 修改查询FPGA镜像详情列表，URI中新增fpga_image_id查询参数。 修改查询FPGA镜像详情列表，新增log_directory字段。 修改查询关联列表，新增log_directory字段。 2018-11-19 第十九次正式发布。 支持竞价实例。涉及如下内容修改： 修改创建云服务器（按需），新增参数“marketType”和“spotPrice”。 修改查询租户配额，新增参数“maxTotalSpotInstances”、“maxTotalSpotCores”、“maxTotalSpotRAMSize”、“totalSpotInstancesUsed”、“totalSpotCoresUsed”和“totalSpotRAMUsed”，并修改响应样例。 修改错误码，新增错误码Ecs.0702、Ecs.0703、Ecs.0704、Ecs.0705。 2018-10-30 第十八次正式发布。 修改错误码，新增错误码Ecs.0018、Ecs.0019。 新增查询云服务器规格变更支持列表（废弃） 修改创建云服务器（按需）和创建云服务器的“description”字段，补充校验规则。 2018-09-25 第十七次正式发布。 本次变更说明如下：查询租户配额 新增查询云服务器详情 新增查询云服务器详情列表 2018-07-30 第十六次正式发布。 本次变更说明如下： 修改切换弹性云服务器操作系统（安装Cloud-init）和切换弹性云服务器操作系统（未安装Cloud-init），修改约束限制，重装操作系统失败后，支持切换操作系统。 优化文档大纲。 2018-07-04 第十五次正式发布。 本次变更说明如下： 修改创建云服务器（按需），修改字段adminPass的用法。 修改创建云服务器（按需），修改字段name的取值范围。 新增一键重置云服务器密码（废弃） 2018-05-25 第十四次正式发布。 本次变更说明如下： 新增权限和授权项，支持策略授权功能。 2018-04-30 第十三次正式发布。 本次变更说明如下： 支持v2.1版本的原生接口。 修改创建云服务器（按需），创建弹性云服务器时购买的弹性IP，该弹性IP支持使用共享带宽。 修改错误码，补充2个包年/包月错误码。 2018-03-30 第十二次正式发布。 本次变更说明如下： 新增查询弹性云服务器磁盘信息（废弃） 新增查询弹性云服务器单个磁盘信息（废弃） 修改弹性云服务器卸载磁盘，增加参数delete_flag，支持强制卸载数据盘。 修改创建云服务器（按需），增加参数isAutoRename，弹性云服务器的名称允许重名。 2018-03-03 第十一次正式发布。 本次变更说明如下： 修改重装弹性云服务器操作系统（安装Cloud-init）、切换弹性云服务器操作系统（安装Cloud-init）、重装弹性云服务器操作系统（未安装Cloud-init）和切换弹性云服务器操作系统（未安装Cloud-init）的adminpass字段描述。 2018-02-08 第十次正式发布。 本次变更说明如下： 修改创建云服务器（按需）的各字段描述。 修改创建云服务器（按需），新增字段snapshotId。 修改查询指定云服务器安全组列表 修改创建快照（废弃）的响应样例 修改查询快照（废弃）的响应样例 2017-10-18 第九次正式发布。 本次变更说明如下： 新增OpenStack原生接口。 新增重装弹性云服务器操作系统（未安装Cloud-init）。 新增切换弹性云服务器操作系统（未安装Cloud-init）。 新增云服务器网卡配置虚拟IP地址（废弃）。 新增云服务器网卡解绑虚拟IP地址（废弃）。 修改FPGA逻辑文件管理。 2017-08-14 第八次正式发布。 本次变更说明如下： 新增添加安全组。 新增移除安全组。 新增FPGA逻辑文件管理。 修改创建云服务器（按需）中“root_volume”字段数据结构说明，新增“size”字段。 修改查询云服务器详情列表中“security_groups”字段数据结构说明。 修改查询云服务器规格详情中“security_groups”字段数据结构说明。 修改创建和导入SSH密钥，修改private_key的字段说明，更新请求样例、响应样例。 2017-06-01 第七次正式发布。 本次变更说明如下： 修改创建云服务器（按需）的“data_volumes”字段说明：新增“shareable”字段、“multiattach”字段和“hw:passthrough”字段。 修改查询规格详情和规格扩展信息列表，新增字段“ecs:generation”和“ecs:virtualization_env_types”。 修改错误码，新增错误码“Ecs.0219 创建云服务器失败”。 2016-11-28 第六次正式发布。 本次变更说明如下： 修改创建云服务器（按需），新增“adminpass”的密码复杂度要求。 支持Cloudinit特性。 2016-09-12 第五次正式发布。 本次变更说明如下： 修改查询云服务器规格详情列表，新增查询云服务器规格时可选的查询检索参数。 修改添加云服务器网卡，新增“fixed_ips”字段。 修改查询租户配额，修改“maxSecurityGroups”和“maxSecurityGroupRules”的说明项。 2016-08-25 第四次正式发布。 本次变更说明如下： 修改弹性云服务器监控指标说明，新增“带外网络流入速率”和“带外网络流出速率”两个监控指标。 修改弹性云服务器监控指标说明，更新各监控指标的备注信息。 2016-07-10 第三次正式发布。 本次变更说明如下： 修改创建云服务器（按需）参数信息。 修改删除云服务器参数信息。 修改批量关闭云服务器os-stop字段信息。 修改查询规格详情和规格扩展信息列表参数信息。 修改查询任务的执行状态的“响应样例”。 修改错误码。 2016-01-26 第二次正式发布。 本次变更说明如下： 修改“请求签名流程”，更新了SDK jar包和签名过程。 修改“示例代码”，优化代码。 修改“公共请求消息头”，新增消息头，部分消息头更改为非必选。 新增“云服务器挂载磁盘”。 新增“云服务器卸载磁盘”。 新增“弹性云服务器监控指标说明”。 修改原生API URI中版本号为v2。 2015-10-15 第一次正式发布。

请求消息 表2 请求参数 参数 是否必选 参数类型 描述 auto_terminate_time 是 String 按需云服务器定时删除时间。 按照ISO8601标准表示，并使用UTC +0时间，格式为yyyy-MM-ddTHH:mm:ssZ。 如果秒（ss）取值不是 00，则自动取为当前分钟（mm）开始时。 最短定时删除时间为当前时间半小时之后。 最长定时删除时间不能超过当前时间三年。 如果参数auto_terminate_time为空字符串，表示不设置定时删除或取消定时删除。 示例：2020-09-25T12:05:00Z

请求示例 设置云服务器的定时删除时间为“2020-09-25T12:05:00Z”。 POST https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/actions/update-auto-terminate-time { "auto_terminate_time": "2020-09-25T12:05:00Z", } 取消云服务器的定时删除。 POST https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/actions/update-auto-terminate-time { "auto_terminate_time": "", }