华为云用户手册

常用提取函数 域 描述 YEAR year() QUARTER quarter() MONTH month() WEEK week() DAY day() DAY_OF_MONTH day_of_month() DAY_OF_WEEK day_of_week() DOW day_of_week() DAY_OF_YEAR day_of_year() DOY day_of_year() YEAR_OF_WEEK year_of_week() YOW year_of_week() HOUR hour() MINUTE minute() SECOND second() TIMEZONE_HOUR timezone_hour() TIMEZONE_MINUTE timezone_minute() 例如： select second(timestamp '2020-02-12 15:32:33.215');-- 33 select timezone_hour(timestamp '2020-02-12 15:32:33.215');-- 8 MONTHNAME(date) 描述：获取月份名称。 SELECT monthname(timestamp '2019-09-09 12:12:12.000');-- SEPTEMBER SELECT monthname(date '2019-07-09');--JULY

Java 日期函数 在这一章节中使用的格式化字符串都是与Java的SimpleDateFormat样式兼容的。 format_datetime(timestamp, format) → varchar 使用format格式化timestamp parse_datetime(string, format) → timestamp with time zone 使用指定的格式，将字符串格式化为timestamp with time zone select parse_datetime('1960/01/22 03:04', 'yyyy/MM/dd HH:mm'); _col0 --------------------------------------- 1960-01-22 03:04:00.000 Asia/Shanghai (1 row)

日期时间运算符 运算符 示例 结果 + date '2012-08-08' + interval '2' day 2012-08-10 + time '01:00' + interval '3' hour 04:00:00.000 + timestamp '2012-08-08 01:00' + interval '29' hour 2012-08-09 06:00:00.000 + timestamp '2012-10-31 01:00' + interval '1' month 2012-11-30 01:00:00.000 + interval '2' day + interval '3' hour 2 03:00:00.000 + interval '3' year + interval '5' month 3-5 - date '2012-08-08' - interval '2' day 2012-08-06 - time '01:00' - interval '3' hour 22:00:00.000 - timestamp '2012-08-08 01:00' - interval '29' hour 2012-08-06 20:00:00.000 - timestamp '2012-10-31 01:00' - interval '1' month 2012-09-30 01:00:00.000 - interval '2' day - interval '3' hour 1 21:00:00.000 - interval '3' year - interval '5' month 2-7

语法 CREATE FUNCTION qualified_function_name ( parameter_name parameter_type [, ...] ) RETURNS return_type [ COMMENT function_description ] [ LANGUAGE [ JAVA ] ] [ SPECIFIC specificName ] [ DETERMINISTIC | NOT DETERMINISTIC ] [ RETURNS NULL ON NULL INPUT | CALLED ON NULL INPUT ] [ SYMBOL class_name ] [ URI hdfs_path_to_jar ]

示例 创建一个新的JAVA函数“example.default.add_two”（需要先构建和部署UDF） CREATE FUNCTION example.default.add_two ( num integer ) RETURNS integer LANGUAGE JAVA DETERMINISTIC SYMBOL "com.example.functions.AddTwo" URI "hdfs://hacluster/udfs/function-1.0.jar"; --执行函数 select hetu.default.add_two(2);

描述 通过给定的定义创建一个新的函数。 每一个函数都由其限定函数名称和参数类型列表唯一标识。“qualified_function_name”的格式需要为“catalog.schema.function_name”，函数命名空间（格式为“catalog.schema”）可以自行规划管理，与HetuEngine中的catalog、schema概念无关联；“parameter_type”需要为HetuEngine支持的数据类型。 “return_type”需要为HetuEngine支持的数据类型，要与函数的返回实际类型匹配，不做类型强制转换。 可以指定一组特征来修饰函数并指定其行为，每个特征最多只能指定一次，详情请参考表1。 表1 特征说明 特征 默认值 描述 Language clause - 定义函数的语言。目前支持JAVA语言。 JAVA函数：需要提供函数实现的JAR文件，并将JAR文件放入HetuEngine可以读取的HDFS中。 Deterministic characteristic NOT DETERMINISTIC 函数是否确定性。 DETERMINISTIC：如果函数在使用相同的输入集调用时总是返回相同的结果集，则该函数被视为确定性。 NOT DETERMINISTIC：如果函数在使用相同的输入集调用时不返回相同的结果集，则该函数将被视为非确定性。 Null-call clause CALLED ON NULL INPUT 函数的行为。 RETURNS NULL ON NULL INPUT：当“NULL”作为函数参数时，返回“NULL”。 CALLED ON NULL INPUT：当“NULL”作为函数参数时调用。 Symbol class_name - JAVA函数使用，指定函数实现的限定类名。 Uri hdfs_path_to_jar - JAVA函数使用，指定函数实现的JAR文件路径。

描述 列出catalogName为mv中的所有物化视图以及对应的数据表。如果希望只查看某个schema中的物化视图，可以使用子句[IN/FROM schema_name] 通过可选子句“LIKE”，筛选视图名满足规则运算表达式的视图，如果不使用这个子句，会列举所有视图。匹配的视图会按字母顺序排列。 目前规则运算表达式支持“*”或“%”用于匹配任何字符，下划线“_”用于匹配一个字符，或“|”用于条件连接两个或多个条件。

ORDER BY ORDER BY子句用于按一个或多个输出表达式对结果集排序。 ORDER BY expression [ ASC | DESC ] [ NULLS { FIRST | LAST } ] [, ...] 每个expression可以由输出列组成，也可以是按位置选择输出列的序号。 ORDER BY子句在GROUP BY或HAVING子句之后，在OFFSET、LIMIT或FETCH FIRST子句之前进行计算。 按照SQL规范，ORDER BY子句只影响包含该子句的查询结果的行顺序。HetuEngine遵循该规范，并删除该子句的冗余用法，以避免对性能造成负面影响。 例如在执行INSERT语句时，ORDER BY子句不会对插入的数据产生影响，是个冗余的操作，会对整个INSERT语句的整体性能产生负面影响，因此HetuEngine会跳过ORDER BY操作。 ORDER BY只作用于SELECT子句： INSERT INTO some_table SELECT * FROM another_table ORDER BY field; ORDER BY冗余的例子是嵌套查询，不影响整个语句的结果： SELECT * FROM some_table JOIN (SELECT * FROM another_table ORDER BY field) u ON some_table.key = u.key;

Data Size parse_presto_data_size函数支持以下单位： 单位 描述 值 B Bytes 1 kB Kilobytes 1024 MB Megabytes 10242 GB Gigabytes 10243 TB Terabytes 10244 PB Petabytes 10245 EB Exabytes 10246 ZB Zettabytes 10247 YB Yottabytes 10248 parse_presto_data_size(string) → decimal(38) 将带单位的格式化的值转为数字，值可以是小数，如下所示： SELECT parse_presto_data_size('1B'); -- 1 SELECT parse_presto_data_size('1kB'); -- 1024 SELECT parse_presto_data_size('1MB'); -- 1048576 SELECT parse_presto_data_size('2.3MB'); -- 2411724

Format format(format, args...) → varchar 描述：对一个字符串，按照格式字符串指定的方式进行格式化，并返回。 SELECT format('%s%%',123);-- '123%' SELECT format('%.5f',pi());-- '3.14159' SELECT format('%03d',8);-- '008' SELECT format('%,.2f',1234567.89);-- '1,234,567.89' SELECT format('%-7s,%7s','hello','world');-- 'hello , world' SELECT format('%2$s %3$s %1$s','a','b','c');-- 'b c a' SELECT format('%1$tA, %1$tB %1$te, %1$tY',date'2006-07-04');-- 'Tuesday, July 4, 2006

cast转换函数 HetuEngine会将数字和字符值隐式转换成正确的类型。HetuEngine不会把字符和数字类型相互转换。例如，一个查询期望得到一个varchar类型的值，HetuEngine不会自动将bigint类型的值转换为varchar类型。 如果有必要，可以将值显式转换为指定类型。 cast(value AS type) → type 显式转换一个值的类型。可以将varchar类型的值转为数字类型，反过来转换也可以。 select cast('186' as int ); select cast(186 as varchar); try_cast(value AS type) → type 与cast()相似，区别是转换失败返回null。 select try_cast(1860 as tinyint); _col0 ------- NULL (1 row) 当出现数字溢出，null值转换等情况，会返回NULL，但无法转换的情况，还是会报错。 例如：select try_cast(186 as date); Cannot cast integer to date

其他存储引擎 在MySQL 5.6及以上的版本中，不支持的存储引擎如表1所示： 表1 存储引擎约束限制 引擎 原因 MyISAM引擎 MyISAM引擎表不支持事务，仅支持表级别锁，导致读写操作相互冲突。 MyISAM对数据完整性的保护存在缺陷，且这些缺陷会导致数据库数据的损坏甚至丢失。 MyISAM在出现数据损害情况下，很多都需要手动修复，无法通过产品服务提供的恢复功能进行数据恢复。 MyISAM向InnoDB的迁移透明，大多数情况不需要改动建表的代码，云数据库自动转换InnoDB即可完成迁移。 FEDERATED引擎 主备实例支持FEDERATED引擎会导致在远端数据库上相同DML重复执行，导致数据错乱。 FEDERATED引擎会在时间点恢复场景，当全量恢复完成后，远端数据库上数据不会跟随全量备份恢复到全备时的数据状态，在增量恢复阶段再应用数据会导致FEDERATED表数据错乱。 Memory引擎 如果内存表隐式的变空，那在Open表的时候数据库就会自己产生一个DELETE event到binlog中。这样当HA集群使用了内存表，那么重启HA，备库（或者只读库）就会自己产生一个自己的GTID，导致主备不一致，进而引发备库重建，甚至导致备库会不停的重建。 使用Memory表，会存在OOM的风险，导致服务被终止。

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": "", }

网卡管理 权限 对应的API接口 授权项（Action） 依赖的授权项 IAM项目 (Project) 企业项目 (Enterprise Project) 实例授权 标签授权 云服务器网卡配置私有IP PUT /v1/{project_id}/cloudservers/nics/{nic_id} ecs:cloudServerNics:update - √ × × × 批量删除云服务器网卡 POST /v1/{project_id}/cloudservers/{server_id}/nics/delete ecs:cloudServerNics:delete - √ √ √ √ 批量添加云服务器网卡 POST /v1/{project_id}/cloudservers/{server_id}/nics ecs:cloudServers:addNics - √ √ √ √ 查询云服务器网卡信息 GET /v1/{project_id}/cloudservers/{server_id}/os-interface ecs:cloudServers:listServerInterfaces - √ √ √ √ 云服务器切换虚拟私有网络 POST /v1/{project_id}/cloudservers/{server_id}/changevpc ecs:cloudServers:changeVpc - √ √ √ √ 更新云服务器指定网卡属性 POST /v1/{project_id}/cloudservers/{server_id}/os-interface/{port_id}/change-network-interface ecs:cloudServers:changeNetworkInterface - √ √ √ √ 添加云服务器网卡（OpenStack原生） POST /v2.1/{project_id}/servers/{server_id}/os-interface ecs:serverInterfaces:use ecs:servers:get ecs:serverInterfaces:get vpc:networks:get vpc:networks:update vpc:subnets:get vpc:subnets:update vpc:ports:create vpc:ports:update vpc:ports:get vpc:networks:create vpc:subnets:create vpc:routers:get vpc:routers:update √ × × × 删除云服务器网卡（OpenStack原生） DELETE /v2.1/{project_id}/servers/{server_id}/os-interface/{id} ecs:serverInterfaces:use ecs:serverInterfaces:get ecs:servers:get vpc:networks:create vpc:subnets:create vpc:networks:get vpc:networks:update vpc:subnets:get vpc:subnets:update vpc:ports:delete vpc:ports:update vpc:ports:get vpc:routers:get vpc:routers:update √ × × × 查询云服务器网卡信息（OpenStack原生） GET /v2.1/{project_id}/servers/{server_id}/os-interface ecs:serverInterfaces:get vpc:ports:get √ × × × 查询指定云服务器网卡信息（OpenStack原生） GET /v2.1/{project_id}/servers/{server_id}/os-interface/{id} ecs:serverInterfaces:get vpc:ports:get √ × × × 父主题： 权限和授权项

响应示例 { "job_id": "ff808082739334d80173943ec9b42130", "order_id": "CS2007281506xxxxx", "serverIds": [ "fe0528f0-5b1c-4c8c-9adf-e5d5047b8c17", "679854ae-a50d-40c9-8132-b19bf3a306a1" ] } 或 { "error": { "code": "Ecs.0005", "message": "request body is illegal." } }

请求示例 创建一台包年/包月云服务器，操作系统为CentOS 7.6 64bit，1U1G，绑定1M带宽的弹性公网IP，采用密钥方式登录鉴权。 POST https://{endpoint}/v1.1/{project_id}/cloudservers { "server": { "availability_zone":"az1-dc1", "name": "newserver", "imageRef": "67f433d8-ed0e-4321-a8a2-a71838539e09", "root_volume": { "volumetype": "SSD" }, "data_volumes": [ { "volumetype": "SSD", "size": 100 }, { "volumetype": "SSD", "size": 100, "multiattach": true, "hw:passthrough": true } ], "flavorRef": "s2.small.1", "vpcid": "2a6f4aa6-d93e-45f5-a8cb-b030dbf8cd68", "security_groups": [ { "id": "6242ef48-4d35-49c8-8711-a6e54902e44a" } ], "nics": [ { "subnet_id": "ef039b60-6a14-42d1-963b-687b627fea08" } ], "publicip": { "eip": { "iptype": "5_sbgp", "bandwidth": { "size": 1, "sharetype": "PER" } } }, "key_name": "id_rsa", "count": 1, "metadata": { "op_svc_userid": "f79791beca3c48159ac2553fff22e166" }, "extendparam": { "chargingMode": "prePaid", "periodType": "month", "periodNum": 1, "isAutoRenew": "true", "isAutoPay": "true", "enterprise_project_id": "f8e0ecc8-3825-4ee8-9596-fb4258ffdcbb" }, "os:scheduler_hints": { "group": "cdbbfffe-ef18-47b4-a5c8-f61a984c0ecc" } } } 创建一台包年/包月云服务器，操作系统为CentOS 7.6 64bit，1U1G，绑定1M带宽的弹性公网IP，采用密码方式登录鉴权请求中的密码，建议将密码在配置文件或者环境变量中密文存放，使用时解密，确保安全。 POST https://{endpoint}/v1.1/{project_id}/cloudservers { "server": { "availability_zone":"az1-dc1", "name": "newserver", "adminPass": "$ADMIN_PASS", "imageRef": "67f433d8-ed0e-4321-a8a2-a71838539e09", "root_volume": { "volumetype": "SSD" }, "data_volumes": [ { "volumetype": "SSD", "size": 100 }, { "volumetype": "SSD", "size": 100, "multiattach": true, "hw:passthrough": true } ], "flavorRef": "s2.small.1", "vpcid": "2a6f4aa6-d93e-45f5-a8cb-b030dbf8cd68", "security_groups": [ { "id": "6242ef48-4d35-49c8-8711-a6e54902e44a" } ], "nics": [ { "subnet_id": "ef039b60-6a14-42d1-963b-687b627fea08" } ], "publicip": { "eip": { "iptype": "5_sbgp", "bandwidth": { "size": 1, "sharetype": "PER" } } }, "key_name": "", "count": 1, "metadata": {}, "extendparam": { "chargingMode": "prePaid", "periodType": "month", "periodNum": 1, "isAutoRenew": "true", "isAutoPay": "true", "enterprise_project_id": "f8e0ecc8-3825-4ee8-9596-fb4258ffdcbb" }, "os:scheduler_hints": { "group": "cdbbfffe-ef18-47b4-a5c8-f61a984c0ecc" } } } 创建一台包年/包月云服务器，操作系统为CentOS 7.6 64bit，1U1G，绑定1M带宽的按需按流量计费的弹性公网IP，采用密钥方式登录鉴权。 POST https://{endpoint}/v1.1/{project_id}/cloudservers { "server": { "availability_zone":"az1-dc1", "name": "newserver", "imageRef": "67f433d8-ed0e-4321-a8a2-a71838539e09", "root_volume": { "volumetype": "SSD" }, "data_volumes": [ { "volumetype": "SSD", "size": 100 }, { "volumetype": "SSD", "size": 100, "multiattach": true, "hw:passthrough": true } ], "flavorRef": "s2.small.1", "vpcid": "2a6f4aa6-d93e-45f5-a8cb-b030dbf8cd68", "security_groups": [ { "id": "6242ef48-4d35-49c8-8711-a6e54902e44a" } ], "nics": [ { "subnet_id": "ef039b60-6a14-42d1-963b-687b627fea08" } ], "publicip": { "eip": { "iptype": "5_sbgp", "bandwidth": { "size": 1, "sharetype": "PER", "chargemode": "traffic" }, "extendparam": { "chargingMode": "postPaid" } } }, "key_name": "id_rsa", "count": 1, "metadata": { "op_svc_userid": "f79791beca3c48159ac2553fff22e166" }, "extendparam": { "chargingMode": "prePaid", "periodType": "month", "periodNum": 1, "isAutoRenew": "true", "isAutoPay": "true", "enterprise_project_id": "f8e0ecc8-3825-4ee8-9596-fb4258ffdcbb" }, "os:scheduler_hints": { "group": "cdbbfffe-ef18-47b4-a5c8-f61a984c0ecc" } } } 创建一台包年/包月云服务器，操作系统为CentOS 7.6 64bit，1U1G，绑定共享带宽的弹性公网IP，采用密钥方式登录鉴权。 POST https://{endpoint}/v1.1/{project_id}/cloudservers { "server": { "availability_zone":"az1-dc1", "name": "newserver", "imageRef": "67f433d8-ed0e-4321-a8a2-a71838539e09", "root_volume": { "volumetype": "SSD" }, "data_volumes": [ { "volumetype": "SSD", "size": 100 }, { "volumetype": "SSD", "size": 100, "multiattach": true, "hw:passthrough": true } ], "flavorRef": "s2.small.1", "vpcid": "2a6f4aa6-d93e-45f5-a8cb-b030dbf8cd68", "security_groups": [ { "id": "6242ef48-4d35-49c8-8711-a6e54902e44a" } ], "nics": [ { "subnet_id": "ef039b60-6a14-42d1-963b-687b627fea08" } ], "publicip": { "eip": { "iptype": "5_sbgp", "bandwidth": { "id": "a0d4b26f-699d-49a0-bcc8-6f707a925abf", "sharetype": "WHOLE" } } }, "key_name": "id_rsa", "count": 1, "metadata": { "op_svc_userid": "f79791beca3c48159ac2553fff22e166", "agency_name": "test" }, "extendparam": { "chargingMode": "prePaid", "periodType": "month", "periodNum": 1, "isAutoRenew": "true", "isAutoPay": "true", "enterprise_project_id": "f8e0ecc8-3825-4ee8-9596-fb4258ffdcbb" }, "os:scheduler_hints": { "group": "cdbbfffe-ef18-47b4-a5c8-f61a984c0ecc" } } }

接口约束 创建包年/包月云服务器时，支持自动支付和手动支付。 如果将请求中的isAutoPay字段设置为true，表示采用自动支付方式，系统会自动匹配账户支持的付款方式进行扣费。 自动支付支持的付款方式和顺序如下： 折扣优惠（每次只能使用一项）→代金券（每次只能使用一张）→现金券或储值卡（每次可使用多张，可同时使用）→账户余额（先扣现金额度后扣信用额度）或月末结算 如果上述付款方式无法完成支付，系统会自动生成一个待支付订单，您可以手动在控制台上选择支付方式进行支付。 自动支付的更多内容请参见自动支付。 如果将请求中的isAutoPay字段设置为false，表示采用手动支付方式，系统会自动生成一个待支付订单，您可以手动在控制台上选择支付方式进行支付。 创建按需计费云服务器时，系统会自动匹配适用的代金券进行使用。 如果您需要退订该包年/包月资源，请参考“退订包年/包月资源”。

响应消息 表8 响应参数 参数 参数类型 描述 job_id String 提交任务成功后返回的任务ID，用户可以使用该ID对任务执行情况进行查询。如何根据job_id来查询Job的执行状态，请参考查询Job状态。 order_id String 订单号，创建包年包月的弹性云服务器时返回该参数。 说明： 创建包年/包月云服务器资源后，请参考“支付包年/包月产品订单”进行支付。 如果需要查询订单的资源开通详情，请参考“查询订单详情”。 如果需要退订该包年/包月资源，请参考“退订包年/包月资源”。 serverIds Array of strings 云服务器ID列表。 说明： 通过云服务器ID查询云服务器详情 ，若返回404 可能云服务器还在创建或者已经创建失败。 异常响应请参考响应（任务类），异常响应要素说明。

功能介绍 创建一台或多台云服务器。 V1.1版本创建云服务器的接口兼容了V1版本创建云服务器（按需）的功能，同时合入新功能，支持创建包年/包月的弹性云服务器。 本接口为异步接口，当前创建云服务器请求下发成功后会返回job_id，此时创建云服务器并没有立即完成，需要通过调用查询任务的执行状态查询job状态，当Job状态为 SUCCESS 时代表云服务器创建成功。 本接口支持在HTTP请求消息头中设置X-Client-Token请求头，保证请求幂等性。详细信息请参考请求幂等性说明。 弹性云服务器的登录鉴权方式包括两种：密钥对、密码。为安全起见，推荐使用密钥对方式。 密钥对 指使用密钥对作为弹性云服务器的鉴权方式。 接口调用方法：使用key_name字段，指定弹性云服务器登录时使用的密钥文件，key_name字段的使用方法请参见表2。 密码 指使用设置初始密码方式作为弹性云服务器的鉴权方式，此时，您可以通过用户名密码方式登录弹性云服务器，Linux操作系统时为root用户的初始密码，Windows操作系统时为Administrator用户的初始密码。 接口调用方法：使用adminPass字段，指定管理员账号的初始登录密码，adminPass字段的使用方法请参见表2。对于镜像已安装Cloud-init的Linux云服务器，如果需要使用密文密码，可以使用user_data字段进行密码注入，具体请参见表2。 对于安装Cloud-init镜像的Linux云服务器，若指定user_data字段，则adminPass字段无效。

响应示例 { "flavors": [ { "attachableQuantity": { "free_scsi": 60, "free_blk": 24, "free_disk": 60, "free_nic": 12 }, "id": "c3.2xlarge.2", "name": "c3.2xlarge.2", "vcpus": "8", "ram": 16384, "disk": "0", "swap": "", "links": [ { "rel": "self", "href": "https://ecs.region.xxx.com/v1.0/743b4c0428d94531b9f2add666642e6b/flavors/c3.2xlarge.2", "type": null }, { "rel": "bookmark", "href": "https://ecs.region.xxx.com/743b4c0428d94531b9f2add666642e6b/flavors/c3.2xlarge.2", "type": null } ], "OS-FLV-EXT-DATA:ephemeral": 0, "rxtx_factor": 1, "OS-FLV-DISABLED:disabled": false, "rxtx_quota": null, "rxtx_cap": null, "os-flavor-access:is_public": true, "os_extra_specs": { "ecs:virtualization_env_types": "CloudCompute", "ecs:generation": "c3", "ecs:instance_architecture":"arm64" , "ecs:performancetype": "computingv3", "resource_type": "IOoptimizedC3_2" } } ] }

响应消息 响应参数如表3所示。 表3 响应参数 参数 参数类型 描述 flavors Array of objects 云服务器规格列表，详情请参见表4。 表4 flavors数据结构说明 参数 参数类型 描述 id String 云服务器规格的ID。 name String 云服务器规格的名称。 vcpus String 云服务器规格对应的CPU核数。 ram Integer 云服务器规格对应的内存大小，单位为MB。 disk String 云服务器规格对应要求系统盘大小。 当前未使用该参数，缺省值为0。 swap String 云服务器规格对应要求的交换分区大小。 当前未使用该参数，缺省值为""。 OS-FLV-EXT-DATA:ephemeral Integer 扩展属性，临时盘大小。 当前未使用该参数，缺省值为0。 OS-FLV-DISABLED:disabled Boolean 扩展属性，该云服务器规格是否禁用。 当前未使用该参数，缺省值为false。 rxtx_factor Float 云服务器可使用网络带宽与网络硬件带宽的比例。 当前未使用该参数，缺省值为1.0。 rxtx_quota String 云服务器可使用网络带宽的软限制。 当前未使用该参数，缺省值为null。 rxtx_cap String 云服务器可使用网络带宽的硬限制。 当前未使用该参数，缺省值为null。 os-flavor-access:is_public Boolean 扩展属性，flavor是否给所有租户使用。 true：表示给所有租户使用。 false：表示给指定租户使用。 缺省值为true。 links Array of objects 规格相关快捷链接地址，详情请参见表5。 os_extra_specs Object 云服务器规格的扩展字段，详情请参见表6。 attachableQuantity Object 云服务器可挂载网卡和卷数，详情参见表7。 表5 links字段数据结构说明 参数 参数类型 描述 rel String 快捷链接标记名称。 href String 对应快捷链接。 type String 快捷链接类型，当前接口未使用，缺省值为null。 表6 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。 表7 attachableQuantity字段数据结构说明 参数 参数类型 描述 free_scsi Integer 可挂载scsi卷数。 free_blk Integer 可挂载vbd卷数。 free_disk Integer 可挂载卷数。 free_nic Integer 可挂载网卡数。

响应示例 { "job_id": "ff808082739334d80173941567f21d4f", "serverIds": [ "118258c5-0c6a-4e73-8b51-8d1ea3272e1b", "e51b9e20-7088-4914-a4f3-6c76bcfed0be" ] } 或 { "error": { "code": "request body is illegal.", "message": "Ecs.0005" } } 或 { "error": { "message": "privateIp [%s] is not in this subnet [%s]", "code": "Ecs.0005", "details": [ { "code": "Ecs.0039" } ] } }

响应消息 参数 参数类型 描述 job_id String 提交任务成功后返回的任务ID，用户可以使用该ID对任务执行情况进行查询。如何根据job_id来查询Job的执行状态，请参考5.8 查询Job状态。 serverIds Array of strings 云服务器ID列表。 说明： 通过云服务器ID查询云服务器详情 ，若返回404 可能云服务器还在创建或者已经创建失败。 异常响应请参考响应（任务类），异常响应要素说明。

请求示例 创建一台按需计费云服务器，操作系统为CentOS 7.6 64bit，4U8G，磁盘类型为“SSD”，绑定10M的按带宽计费的弹性公网IP，采用密钥方式登录鉴权。 POST https://{endpoint}/v1/{project_id}/cloudservers { "server": { "availability_zone":"az1-dc1", "name": "newserver", "imageRef": "67f433d8-ed0e-4321-a8a2-a71838539e09", "root_volume": { "volumetype": "SSD" }, "data_volumes": [ { "volumetype": "SSD", "size": 100, "multiattach": true, "hw:passthrough": true } ], "flavorRef": "s3.xlarge.2", "vpcid": "0dae26c9-9a70-4392-93f3-87d53115d171", "security_groups": [ { "id": "507ca48f-814c-4293-8706-300564d54620" } ], "nics": [ { "subnet_id": "157ee789-03ea-45b1-a698-76c92660dd83" } ], "publicip": { "eip": { "iptype": "5_bgp", "bandwidth": { "size": 10, "sharetype": "PER" } } }, "key_name": "sshkey-123", "count": 1, "extendparam": { "enterprise_project_id": "f8e0ecc8-3825-4ee8-9596-fb4258ffdcbb" }, "server_tags": [ { "key": "key1", "value": "value1" } ], "metadata": { "op_svc_userid": "8ea65f4099ba412883e2a0da72b96873", "agency_name": "test" } } } 发送预校验请求，检查创建弹性云服务器的请求消息是否填写了必选参数，请求格式是否正确。 POST https://{endpoint}/v1/{project_id}/cloudservers { "dry_run": true, "server": { "availability_zone":"az1-dc1", "name": "newserver", "imageRef": "1189efbf-d48b-46ad-a823-94b942e2a000", "root_volume": { "volumetype": "SSD" }, "data_volumes": [ { "volumetype": "SSD", "size": 100, "multiattach": true, "hw:passthrough": true } ], "flavorRef": "s3.xlarge.2", "vpcid": "0dae26c9-9a70-4392-93f3-87d53115d171", "security_groups": [ { "id": "507ca48f-814c-4293-8706-300564d54620" } ], "nics": [ { "subnet_id": "157ee789-03ea-45b1-a698-76c92660dd83" } ], "key_name": "sshkey-123", "count": 1 } }

修订记录 发布日期 修改说明 2024-04-12 第四十八次正式发布。 新增： 购买检查与加固。 2024-03-30 第四十七次正式发布。 下线DDoS攻击缓解助手功能及相关描述。 更新产品页面新风格。 2022-04-22 第四十六次正式发布。 等保安全和等保套餐服务类型已迁移至认证测试中心，刷新相关资料内容。 2022-04-09 第四十五次正式发布。 购买等保套餐增加表_等保套餐。 新增购买密评建设助手。 2022-03-30 第四十四次正式发布。 增加购买专项版。 删除以下章节： 查看总览界面。 更新截图，内容优化。 2021-12-22 第四十三次正式发布。 新增购买DDoS攻击缓解助手、验收管理检测与响应。 2021-07-19 第四十二次正式发布。 服务入口刷新。 2021-05-31 第四十一次正式发布。 购买等保安全，新增“系统类型”、“待测评系统等级”必填信息。 购买等保套餐，等保套餐方案新增“数据安全中心”服务。 2021-03-23 第四十次正式发布。 购买等保套餐，“SSL证书”、“专属加密”、“DDoS高防”变更购买方式。 2020-12-02 第三十九次正式发布。 管理检测与响应标准版功能下线。 2020-10-10 第三十八次正式发布。 全新企业版功能上线，购买企业版。 2020-09-16 第三十七次正式发布。 新增云审计服务。 2020-09-14 第三十六次正式发布。 新增购买等保建设助手。 2020-08-25 第三十五次正式发布。 购买等保套餐，新增套餐内容。 2020-07-30 第三十四次正式发布。 “安全专家服务”更名为“管理检测与响应”，并更新界面截图。 新增购买等保套餐。 下线“企业版”相关内容。 2020-06-22 第三十三次正式发布。 “申请交付标准版管理检测与响应服务”，新增“保存站点信息至后台”功能。 优化操作入口。 2020-04-01 第三十二次正式发布。 更新界面截图。 2020-02-17 第三十一次正式发布。 “购买标准版”，修改购买联系信息。 购买企业版，修改购买联系信息。 “补全标准版服务单信息”章节修改为“申请交付标准版安全专家服务”，同时更新申请交付服务单信息状态。 验收安全专家服务，新增验收说明。 2020-01-20 第三十次正式发布。 创建用户并授权使用MDR，优化相关内容描述。 删除以下章节： 权限管理基本概念 策略语法：RBAC 2020-01-03 第二十九次正式发布。 “补全标准版服务单信息”，优化相关内容描述。 更新界面截图。 2019-12-19 第二十八次正式发布。 创建用户并授权使用MDR，优化相关内容描述。 更新界面截图。 2019-12-10 第二十七次正式发布。 删除“审计”章节。 2019-11-29 第二十六次正式发布。 创建用户并授权使用MDR，更新界面截图和优化相关内容描述。 2019-11-12 第二十五次正式发布。 “补全标准版服务单信息”，优化相关内容描述。 2019-11-01 第二十四次正式发布。 “购买标准版”，更新后续管理说明。 “购买企业版”，更新后续管理说明。 2019-10-30 第二十三次正式发布。 “补全标准版服务单信息”，更新了界面截图以及相关内容描述。 下载管理检测与响应报告，更新了界面截图以及相关内容描述。 验收管理检测与响应，更新了界面截图以及相关内容描述。 评价管理检测与响应，更新了界面截图以及相关内容描述。 查看服务单信息，更新了界面截图以及相关内容描述。 2019-09-25 第二十二次正式发布。 查看服务单信息，更新了界面截图以及内容描述。 2019-09-06 第二十一次正式发布。 购买等保安全，优化相关内容描述。 2019-08-02 第二十次正式发布。 创建用户并授权使用MDR，修改了相关策略选择描述以及界面截图。 修改“策略语法：RBAC”章节，修改了相关策略语法描述。 “购买标准版”，更新了界面截图以及内容描述。 “购买企业版”，更新了界面截图以及内容描述。 购买等保安全，更新了界面截图以及内容描述。 2019-07-12 第十九次正式发布。 新增以下章节： “购买标准版” “购买企业版” 购买等保安全 2019-06-25 第十八次正式发布。 “补全标准版服务单信息”，更新界面截图以及内容优化。 2019-06-10 第十七次正式发布。 查看总览界面，优化相关内容描述。 “补全标准版服务单信息”，优化相关内容描述。 下载管理检测与响应报告，优化相关内容描述。 验收管理检测与响应，优化相关内容描述。 评价管理检测与响应，优化相关内容描述。 查看服务单信息，优化相关内容描述。 2019-05-22 第十六次正式发布。 新增创建用户并授权使用SES。 新增“策略语法：RBAC”。 2019-05-16 第十五次正式发布。 新增验收管理检测与响应。 查看总览界面，更新了界面截图。 “补全标准版服务单信息”，更新了界面截图以及内容描述。 下载管理检测与响应报告，更新了界面截图。 评价管理检测与响应，更新了界面截图。 查看服务单信息，更新了界面截图以及内容描述。 2018-08-30 第十四次正式发布。 “补全标准版服务单信息”，更新了界面截图以及内容描述。 查看服务单信息，更新了界面截图以及内容描述。 下载管理检测与响应报告，更新了界面截图以及内容描述。 评价管理检测与响应，更新了界面截图以及内容描述。 删除“修改服务单”、“取消服务单”和“删除服务单”章节。 2018-08-16 第十三次正式发布。 “补全标准版服务单信息”，更新了界面截图以及内容描述。 查看服务单信息，更新了界面截图以及内容描述。 删除“补全企业版服务单信息”章节。 删除“补全等保安全服务单信息”章节。 2018-07-27 第十二次正式发布。 修改“补全等保安全服务单信息”章节，更新了界面截图以及内容描述。 2018-07-19 第十一次正式发布。 “补全标准版服务单信息”，更新了界面截图以及内容描述。 修改“查看云审计日志”章节，更新了界面截图。 下载管理检测与响应报告，更新了界面截图。 评价管理检测与响应，更新了界面截图。 查看服务单信息，更新了界面截图以及内容描述。 修改“修改服务单”章节，更新了界面截图以及内容描述。 2018-06-06 第十次正式发布。 新增“补全标准版服务单信息”、“补全企业版服务单信息”和“补全等保安全服务单信息”章节。 查看总览界面、下载安全专家服务报告和“管理服务单”章节，更新了相关内容和截图。 2018-04-28 第九次正式发布。 更新了全文界面截图。 “安全体检服务”更名为“安全专家服务”。 2018-04-03 第八次正式发布。 查看服务单信息，更新界面截图和相关内容描述。 2018-03-28 第七次正式发布。 调整了文档大纲。 2018-03-08 第六次正式发布。 “专业安全评估”章节，优化了描述内容。 “咨询安全体检服务业务”章节，更新了界面截图。 2018-01-30 第五次正式发布。 新增“设置站点信息”。 修改查看服务单信息章节，优化了部分描述内容。 2017-12-28 第四次正式发布。 新增评价安全体检服务。 “管理”章节，修改了界面截图及相关内容描述。 2017-11-30 第三次正式发布。 新增下载安全体检报告。 2017-10-20 第二次正式发布。 修改“管理”章节，取消了服务单必须满足“期望启动时间未到”的限制条件。 2017-09-26 第一次正式发布。

购买须知 购买实例的账号需具有“SES Administrator”和“BSS Administrator”角色。 SES Administrator：管理检测与响应服务的管理员权限。 BSS Administrator：对账号中心、费用中心、资源中心中的所有菜单项执行任意操作。项目级策略，在同项目中勾选。 专项版价格与项目实际情况、IT系统所在地息息相关，MDR管理控制台上提供的费用仅做参考。 购买前，请拨打950808或直接联系您的客户经理，确定项目报价后再下单。 该订单服务周期为1年，订单下单后1年将自动失效；订单失效后将不再提供相关服务。

购买须知 购买实例的账号需具有“SES Administrator”和“BSS Administrator”角色。 SES Administrator：管理检测与响应服务的管理员权限。 BSS Administrator：对账号中心、费用中心、资源中心中的所有菜单项执行任意操作。项目级策略，在同项目中勾选。 检查与加固版价格与项目实际情况、IT系统所在地息息相关，费用仅做参考。 购买前，请拨打950808或直接联系您的客户经理，确定项目报价后再下单。 该订单服务周期为1年，订单下单后1年将自动失效；订单失效后将不再提供相关服务。