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

第一次正式发布。