2.0 系列发布说明¶
2.6.0¶
新特性¶
添加
server backup create命令
添加
network segment list和network segment show命令。这些是 beta 命令,可能会发生变化。使用全局选项--os-beta-command来启用这些命令。 [蓝图 routed-networks]
添加
volume transfer request list命令 [Bug 1554886]
添加
--project选项到flavor set命令,以设置风味的工程访问权限 [Bug 1575461]
添加
--project选项到flavor unset命令,以移除风味的工程访问权限 [Bug 1575461]
添加
image unset命令 [Bug 1582968]
添加
ip availability list和ip availability show命令 [蓝图 https://blueprints.launchpad.net/python-openstackclient/+spec/neutron-ip-capacity]
添加
--state选项到server set命令,以将服务器设置为 active 或 error 状态。 [蓝图 server-reset-state]
升级说明¶
address scope delete命令现在可以在单个命令中接受多个地址范围
compute agent delete命令现在支持在单个命令中删除多个代理
命令
service set在未指定任何内容时不会引发异常。相反,该服务默认情况下未启用。如果指定了--disable-resion但未指定--disable,则会引发异常。
错误修复¶
修复所有命令上的
--enable选项,将--enable-beta-commands全局选项更改为--os-beta-command。由于未使用旧名称,因此全局选项重命名不会产生升级影响。 [Bug 1588384]
2.5.0¶
新特性¶
为
quota set命令添加网络支持。添加的选项包括--networks --subnets --subnetpools --ports --routers --rbac-policies--vips --members --health-monitors。选项--floating-ips --secgroup-rules --secgroups现在支持网络和计算 API。 [Bug 1489441]
为 Network v2 添加
--icmp-type和--icmp-code选项到security group rule create命令。这些选项可用于为 ICMP IP 协议设置 ICMP 类型和代码。 [Bug 1519512]
以下 Network v2 IP 协议受
security group rule create命令的--protocol选项支持,ah,dccp,egp,esp,gre,igmp,ipv6-encap,ipv6-frag,ipv6-icmp,ipv6-nonxt,ipv6-opts,ipv6-route,ospf,pgm,rsvp,sctp,udplite,vrrp和整数表示 [0-255]。 [Bug 1519512]
安全组规则列表命令
security group rule list支持显示使用 ICMP IP 协议的安全组规则的 ICMP 类型和代码。 [Bug 1519512]
添加
server group create,server group delete,server group list,server group show命令。 [Bug 1542171] [蓝图 nova-server-group-support]
为
subnet pool create添加--share和--default选项,为subnet pool set添加--default选项 [Bug 1544586] [Bug 1544591]
为
network create和network set命令添加--transparent-vlan和--no-transparent-vlan选项,以添加/移除网络中的 VLAN 透明度属性。此选项仅在 Network V2 中可用。 [Bug 1545537]
添加
volume service list命令。 [Bug 1550999]
支持 OS_COMPUTE_API_VERSION 的 X.latest 格式,以便与最新的 nova 微版本 API 通信,这是一种非常有用的快捷方式,可以方便地使用新的 nova 侧功能。 [Bug 1561838]
添加
address scope create,address scope delete,address scope list,address scope set和address scope show命令。 [Bug 1566269]
为
subnet list命令添加--ip-version选项。这将根据 IP 版本过滤器输出子网。 [Bug 1581179]
升级说明¶
将
security group rule create命令的--proto选项更改为--protocol。使用--proto选项仍然受支持,但不再记录,并且可能在未来的版本中被弃用。 [Bug 1519512]
错误修复¶
为
snapshot set命令添加一个新的--state选项,该选项会更改快照的状态。 [Bug 1535239]
--pool-prefix选项对于subnet pool create来说是必需的 [Bug 1536479]
修复了
router set命令上的--route选项,该选项没有正确格式化要设置的新路由,导致Bad Request错误。此外,router create,router list和router show命令的路由输出已修复,以提高可读性并与router set命令上的--route选项对齐。 [Bug 1564460]
为
router set命令添加了--no-route。弃用了--clear-routes。 [Bug 1565034]
修复了
network create,network show和network list命令,以正确显示router:external和Router Type列中的路由器类型。 [Bug 1572228]
quota show命令的<project/class>参数现在是可选的。如果未指定,则使用用户的当前项目。这允许非管理员用户显示其当前项目的配额。 [Bug 1572733]
修复了
flavor show/delete/set/unset命令,以正确通过风味名称找到私有风味。 [Bug 1575478]
修复了
flavor set/unset命令,以正确通过风味 ID 找到要设置/取消设置的风味。 [Bug 1575624]
2.4.0¶
新特性¶
为
service set命令添加--disable-reason选项
添加
port create,port list和port set命令 [Bug 1519909]
添加
server restore命令
安全组创建、设置和显示命令现在在使用启用 Network v2 时使用 Network v2,从而为网络安全组规则提供更详细的输出。 [Bug 1519511]
为 Network v2 的
security group create命令添加--project和--project-domain选项。 [Bug 1519511]
仅为 Network v2 添加
--ingress,--egress,--ethertype,--project和--project-domain选项到security group rule create命令。这些选项可以启用egress和IPv6安全组规则以及设置项目。 [Bug 1519512]
安全组规则列表命令现在启用时使用 Network v2,从而显示出口安全组规则。还添加了 Network v2 的 `--long` 选项,以显示方向和 ethertype 信息。此外,当未指定 `group` 参数时(仅限管理员),将显示所有项目的安全组规则。默认情况下,在使用 Network v2 时执行此操作,但在使用 Compute v2 时需要新的 `--all-projects` 选项。 [Bug 1519512]
安全组规则创建命令现在支持 `--src-group` 选项的安全组名称。 [Bug 1540656]
添加 `subnet create` 命令。 [Bug 1542364]
为 `network create` 和 `network set` 命令添加提供商网络选项 `--provider-network-type`、`--provider-physical-network` 和 `--provider-segment`。这些选项仅适用于 NetworkV2。 [Bug 1545537]
为 `network create` 和 `network set` 命令添加外部网络选项 `--external|--internal` 和 `--external` 子选项 `--default|--no-default`。这些选项仅适用于 Network 版本 2。 [Bug 1545537]
为 `volume set` 和 `volume unset` 命令添加 `--image-property` 选项
当从镜像创建卷时,会复制镜像属性。镜像本身的属性是不可变的,但可以更新或从从该镜像创建的卷中删除。
为 `volume type set` 和 `volume type unset` 命令添加 `--project` 和 `--project-domain` 选项
使用 `--project` 选项将卷类型限制为特定项目。卷类型默认是公开的,受限制的卷类型应使用 `--private` 选项在 `volume create` 命令中设为私有。
添加 `host set` 命令 [Bug 1556929]
添加 `aggregate unset` 命令 [Bug 1559866]
添加全局选项 `os-cert` 和 `--os-key` 以支持客户端证书/密钥。环境变量 `OS_CERT` 和 `OS_KEY`,以及 clouds.yaml 中的 `cert` 和 `key` 值也可以使用 [Bug 1565112]
添加 `router add port` 命令 [Bug 1546849]
添加 `router remove port` 命令 [Bug 1546849]
添加 `router add subnet` 命令 [Bug 1546849]
添加 `router remove subnet` 命令 [Bug 1546849]
添加 `subnet set` 命令。 [Bug 1542363]
升级说明¶
`ip floating create` 命令现在启用时使用 Network v2 [Bug 1519502]
`security group rule create` 命令现在启用时使用 Network v2,从而为网络安全组规则提供更详细的输出,与 `security group rule show` 命令匹配。 [Bug 1519512]
弃用全局选项 `--profile`,推荐使用 `--os-profile`。
`--profile` 与具有相同名称的现有命令选项冲突。不幸的是,它出现在一个版本中,因此我们必须遵循弃用过程,并在一年后(2017 年 4 月)将其删除。
[Bug 1571812]
错误修复¶
`security group create` 命令现在启用时使用 Network v2,这允许使用空值创建安全组描述。此外,`tenant_id` 字段已更改为 `project_id`,以匹配 `security group show` 命令的输出。 [Bug 1519511]
`security group rule list` 命令不再忽略已设置为空值的 `group` 参数。 [Bug 1519512]
修复 `openstack command list` 以正确显示 [Bug 1545609]
修复了 Network v2 命令的 SSL/TLS 验证。 这些命令忽略了
--insecure和--os-cacert选项以及OS_CACERT环境变量,导致在使用 SSL/TLS 进行身份验证时出现An SSL error occurred.错误。 [Bug 1560157]
修复 `subnet pool list` 命令以正确显示 `Prefixes` 列的子网池前缀列表。此修复与 `subnet pool create` 和 `subnet pool show` 命令的输出一致。 [Bug 1569480]
使 `volume snapshot create` 和 `volume backup create` 命令中的 `--name` 选项可选。
2.2.0¶
新功能¶
添加了 OSprofiler 支持。要启动 OpenStack 请求跟踪,需要在 CLI 命令中添加 `--profile <HMAC_KEY>` 选项。此密钥需要是 OpenStack 项目配置文件中存在的其中一个密钥(如果希望生成跨项目跟踪,则所选密钥需要在所有这些配置文件中存在)。默认情况下,所有支持 OSprofiler 的 OpenStack 项目都使用 `SECRET_KEY` HMAC 密钥。
要使用跟踪功能,OSprofiler(及其存储后端)需要在环境中安装。如果是,您可以使用 `openstack –profile SECRET_KEY <operation>` 命令触发分析。在输出的末尾,将有一条带有 <trace_id> 的消息,并且可以使用以下命令绘制可读的 HTML 图表 - `osprofiler trace show <trace_id> --html --out result.html`。
允许自定义组件的日志记录 [Bug 1484660]
`ip floating delete` 命令现在适用于 neutron 网络。 [Bug 1519502]
`ip floating list` 命令现在适用于 neutron 网络。 [Bug 1519502]
添加 `ip floating show` 命令,适用于 neutron 和 nova 网络。 [Bug 1519502]
添加对 `security group rule show` 命令的支持。 [Bug 1519512]
添加对 `server dump create` 命令的支持 [Bug 1538372]
添加 `subnet show` 命令。 [Bug 1542359]
将 `subnet delete` 命令添加到 openstack-client。 [Bug 1542362]
添加 Identity v3 的 `token revoke` 命令 [Bug 1543226]
`network delete` 命令现在适用于 nova 网络。 [Bug 1543672]
`network list` 命令现在适用于 nova 网络。 [Bug 1543672]
`network show` 命令现在适用于 nova 网络。 [Bug 1543672]
`network create` 命令现在适用于 nova 网络。 [Bug 1543672]
添加对 `subnet pool delete` 命令的支持。 [Bug 1544587]
添加对 `subnet pool list` 命令的支持。 [Bug 1544589]
添加对 `
subnet pool show` 命令的支持。 [Bug 1544590]
[bug 1479569] 为 `role assignment list`` 命令添加一个可选的 `
--names` 参数。 这将输出用户、组、角色、项目和域的名称而不是 ID。
添加对递归容器删除的支持。 [Bug 1542718]
升级说明¶
nova network 的 `
ip floating list` 命令的输出已更改。 它与 neutron network 的输出不同。 [参考 https://docs.openstack.org/python-openstackclient/2025.2/cli/backwards-incompatible.html]
错误修复¶
由于安全组默认情况下将为所有项目(仅限管理员)显示,因此忽略 Network v2 中 `
security group list` 命令的 `--all-projects` 选项。 [Bug 1519511]
启用后,`
security group set` 命令现在使用 Network v2,这允许将安全组名称和描述设置为一个空值。 [Bug 1519511]
`
token issue` 现在可以返回一个未限定范围的令牌。 如果未指定 `project` 或 `domain` 目标范围,将返回一个未限定范围的令牌。 [Bug 1543214]
命令 `
flavor set/unset` 现在不输出任何内容。 [Bug 1546065]
命令 `
security group set` 现在不输出任何内容。 [Bug 1546065]
命令 `
compute agent set` 现在不输出任何内容。 [Bug 1546065]
命令 `
aggregate set` 现在不输出任何内容。 [Bug 1546065]
2.1.0¶
新特性¶
添加对 `
port delete` 命令的支持。 [Bug 1519909]
添加对 `
port show` 命令的支持。 [Bug 1519909]
添加对 `
subnet list` 命令的支持。 [Bug 1523258]
为 Identity v2 添加 `
project unset` 命令 [Bug 1486597]
为 Image v2 添加 `
image set --activate|--deactivate` 选项 [Bug 1516661]
为 Image v2 添加 `
--project-domain` 选项到 `image create` 和 `image set` 命令 [Bug 1517134]
添加 router 命令 `
create`、`delete`、`list`、`set`、`show` [Bug 1519503]
为 `
security group rule create` 添加 `--src-group` 选项,以包含一个“远程”安全组规则。 [Bug 1522969]
为 `
os availability zone list` 添加卷支持 [Bug 1532945]新的 `--compute` 选项,仅列出计算可用区。
新的 `--volume` 选项,仅列出卷可用区。
为 `
os availability zone list` 添加网络支持 [Bug 1534202]新的 `--network` 选项,仅列出网络可用区。
为 `
image list` 添加 `--limit` 选项,以限制输出中的镜像数量。 [Bug 1540988]
为 `
image list` 添加 `--marker` 选项,以处理分页请求。 [Bug 1540988]
错误修复¶
使 `
security group rule list` 的 group 参数可选,以列出所有安全组 [Bug 1519512]
将远程安全组添加到 `
os security group rule list` [Bug 1520003]
更改 `
server list --flavor` 现在接受 flavor ID 或名称 [Bug 1521492]
更改 `
server list --image` 现在接受 image ID 或名称 [Bug 1521492]
更改 `
project set --domain` 选项,以将参数用作查找非默认域中项目的查找依据。 [Bug 1524456]
修复显示对象存储属性时的区分大小写问题。 [Bug 1525805]
支持非交互式用户密码更新 [Bug 1531360]
其他说明¶
将 `
--owner` 选项更改为 `--project` 在 `image create` 和 `image set` 命令中。 `--owner` 已弃用且不再记录,但仍被接受;如果使用它,将显示警告消息。 [Bug 1527833]
2.0.0¶
升级说明¶
删除了弃用的命令 `
project usage list`,以支持 `usage list`
错误修复¶
某些计算配额未被设置 [Bug 1475831]
为 `snapshot list` 添加 `–all` [Bug 1517386]
为默认 `
image list` 输出(v1 和 v2)添加状态列 [Bug 1519181]
修复 `
--public|--private` 选项,用于 `volume type create` 命令,以正确地将隐私参数传递给客户端库 [Bug 1520115]
修复 `
volume delete` 命令,以删除所有指定的卷,而不是仅删除最后一个卷 [Bug 1520541]
其他说明¶
添加对 keystoneauth1 模块的依赖,以执行身份验证,代替 python-keystoneclient。
停止支持 Python 2.6 [Bug 1519510]
对 `
server` 资源命令的更改为 `
server list` 添加了 `--limit` 和 `--marker`添加了 `
server shelve`添加了 `
server unshelve``
server resume` 现在接受多个服务器参数`
server suspend` 现在接受多个服务器参数