Nova API microversion 变更记录 （持续更新）

Nova API 新增了 microversion 属性，每增加或改动一个API时都需要增加API microversion 版本， 并在 REST API 消息的头中增加 X-OpenStack-Nova-API-Version字段指定API microversion 版本:API microversion 的变更记录均在 nova/api/openstack/rest_api_version_history.rst中记录, 细节可查看附带的spec连接：

2.1
---

2.1 版本是初始版本，当前默认使用2.1版本

2.2
---

版本2.2：
为Keypair增加了Type属性.

用户可以在创建keypair的"os-keypair" request中指定keypaird的type，目前支持的有 ssh 和 x509；

如果没有提供该参数，则默认使用 ssh 类型。

这个版本的 API 还将 HTTP 响应的返回值做出了调整，将创建的返回值从200变为201，删除的返回值从202变为204.

SPEC: https://review.openstack.org/#/c/166663/1/specs/kilo/implemented/keypair-x509-certificates.rst

2.3 (Maximum in Kilo)
---------------------

版本2.3：（此版本为Kilo版发布前合入的最后一个版本）

通过"os-extended-server-attributes"接口对外暴露虚拟机的扩展属性，包括"reservation_id","launch_index","ramdisk_id",  "kernel_id", "hostname","root_device_name"以及"user_data".

对外暴露"os-extended-volumes"中"volumes_attached"的"delete_on_termination"属性。

此版本针对于 EC2 API

SPEC: https://review.openstack.org/#/c/166663/1/specs/kilo/implemented/ec2-api-required-additions.rst

2.4---版本2.4：

对外暴露FixedIP的预定状态(reserved).

"os-fixed-ips" API 对 "FixedIP" 对象提供了 "reserve/unreserve" 的操作，"FixedIP" 对象拥有

"reserved" 属性，用于表示这个FixedIP是否被预定。

SPEC: https://review.openstack.org/#/c/220338/2/specs/liberty/implemented/show-reserved-status-in-os-fixed-ips-api.rst

2.5---版本2.5：

2.5之前对于"nova list --ip6 xxx" 命令并不支持（会显示所有虚拟机），2.5版本使得ipv6的过滤条件生效。

  SPEC: https://review.openstack.org/#/c/220338/2/specs/liberty/implemented/allow-ip6-search-for-non-admin.rst2.6---版本2.6：

删除旧的获取remote console 的 API, 包括：

  'os-getVNCConsole', 'os-getSPICEConsole', 'os-getSerialConsole'and 'os-getRDPConsole' are removed.

  新增一个获取remote console的API: remote-consoles:POST /servers/<uuid>/remote-consoles{"remote_console": {"protocol": ["vnc"|"rdp"|"serial"|"spice"],"type": ["novnc"|"xpvnc"|"rdp-html5"|"spice-html5"|"serial"]}}Example response::{"remote_console": {"protocol": "vnc","type": "novnc","url": "http://example.com:6080/vnc_auto.html?token=XYZ"}}SPEC: https://review.openstack.org/#/c/220338/2/specs/liberty/implemented/consolidate-console-api.rst   

2.8---版本2.8：

在为某个project(tenant)添加某个flavor的访问权限前，先检查flavor的 "is_public" 属性；

使用 HTTPConfilct error来表示拒绝访问。

SPEC: https://review.openstack.org/#/c/220338/2/specs/liberty/implemented/check-flavor-type-before-add-tenant.rst

为remote console 中提供了两种新的协议支持：

mks、webmks

   SPEC: https://review.openstack.org/#/c/220338/2/specs/liberty/implemented/vmware-webmks-console.rst2.9---版本2.9：

在虚拟机进行detailed view时，增加 "locked" 属性，如果虚拟机被锁则显示为true，否则为false.

  SPEC: https://review.openstack.org/#/c/220338/2/specs/liberty/implemented/add-locking-information-in-server-get-response.rst2.10----版本2.10：为 "os-keypair" 增加新的属性 "user_id"， 管理员可以获取这些keypair的详细消息，为用户创建新的keypair等操作。  

SPEC： https://review.openstack.org/#/c/220338/2/specs/liberty/implemented/admin-query-any-keypair.rst

2.11----版本2.11：

暴露 "os-services" 的 "forced_down" 属性，用户可以使用update接口来变更这个属性。  

SPEC : https://review.openstack.org/#/c/220338/2/specs/liberty/implemented/mark-host-down.rst

2.12 (Maximum in Liberty)-------------------------版本2.12（此版本位Liberty发布前最后一个版本）：

通过"os-virtual_interfaces" 对外暴露 VIF 的 "net-id" 属性，用户可以使用该接口对获取VIF设备的"net-id"。

SPEC :　https://review.openstack.org/#/c/198622/6/specs/liberty/approved/add-vif-net-id-in-vif-list.rst

2.13----版本2.13： 在"os-server-groups" API 对外暴露server-groups所属的"project_id"以及"user_id"

SPEC: https://review.openstack.org/#/c/209917/23/specs/mitaka/approved/add-project-id-in-os-server-groups-api.rst

2.14----版本2.14：

在疏散虚拟机(evacuate)时不再需要提供"onSharedStorage"参数，Nova会自动判断这台虚拟机是否在共享存储上，用户密码(adminPass)从返回值中删除，用户通过 "os-server-password" 操作获取虚拟机密码。

SPEC : https://review.openstack.org/#/c/183033/13/specs/mitaka/approved/optional-shared-storage-flag-in-evacuate-api.rst

2.15---- 版本2.15：

用户可以为"server-groups"提供 "soft-affinity" 和 "soft-anti-affinity" 的功能，意为尽最大努力的(非)亲和性，若不满足条件，会尝试采用不满足条件的情况创建虚拟机。

SPEC: https://review.openstack.org/#/c/212504/6/specs/mitaka/approved/soft-affinity-for-server-group.rst

2.16----版本2.16：

在查询虚拟机列表（servers/detail and servers/{server_id}）时对外暴露虚拟机所在主机的状态。默认只对管理员生效。  

SPEC : https://review.openstack.org/#/c/192246/20/specs/mitaka/approved/get-valid-server-state.rst

2.17----版本2.17：

为虚拟机提供新的 crash dump (故障转储) 的 API， （虚拟机使用的）不同的系统可能需要修改相应的配置。

  SPEC: https://review.openstack.org/#/c/229255/11/specs/mitaka/approved/instance-crash-dump.rst2.18---- 

版本2.18：

提供不需要包含 project_id 的 API url 接口.

BP: https://blueprints.launchpad.net/nova/+spec/service-catalog-tng 

2.19----

版本2.19：

  为虚拟机增加新的 "description" 属性，用于描述这台虚拟机，用户可以在创建，更新，重建时更新这个属性。SPEC: https://review.openstack.org/#/c/228908/13/specs/mitaka/approved/user-settable-server-description.rst