Zed 系列发布说明¶

9.1.1¶

错误修复¶

Bug #1995883：修复了客户端支持 mv 3.66 或更高版本，但 Block Storage API 支持低于 3.66 时，为 snapshot-create 操作生成的错误格式请求体。

9.0.0¶

升级说明¶

已停止对 Python 3.6 和 3.7 的支持。现在支持的 Python 最低版本是 Python 3.8。

8.3.0¶

序言¶

python-cinderclient 的 Yoga 版本支持 Block Storage API 第 3 版，直至微版本 3.68。（Yoga 版本中 Block Storage API 的最大微版本为 3.68。）

新特性¶

添加了一个新的 cinder reimage 命令和相关的 python API 绑定，允许用户使用 Image 服务 (Glance) 提供的指定镜像替换指定卷的当前内容。（请注意，这是一个破坏性操作，即卷重新镜像时，卷中当前的所有数据将被销毁。）此功能需要 Block Storage API 微版本 3.68 或更高版本。

8.1.0¶

序言¶

python-cinderclient 的 Xena 版本支持 Block Storage API 第 3 版，直至微版本 3.66。（Xena 版本中 Block Storage API 的最大微版本为 3.66。）

新特性¶

添加了对 Block Storage API 第 3.66 版本的支持，该版本取消了创建正在使用的卷的快照所需的 ‘force’ 标志。虽然 ‘force’ 标志对于 API 版本 3.66 及更高版本的 snapshot-create 调用无效，但为了保持向后兼容性，cinderclient 会像 Block Storage API 一样，在传递值为 True 的标志时，会默默地忽略该标志。

支持 Block Storage API 第 3.65 版本，该版本在卷和快照详细响应中显示一个布尔型 consumes_quota 字段，并允许使用标准 --filters [<key=value> [<key=value> ...]] 选项过滤卷和快照列表响应，该选项用于 cinder list 或 cinder snapshot-list 命令。

在云环境中可能无法始终对该字段进行过滤。使用 cinder list-filters 命令查看您正在使用的云环境中可用的过滤器。

升级说明¶

python-cinderclient 不再支持 Block Storage API 的第 2 版。支持该 API 的 python-cinderclient 的最后一个版本是 7.x 系列。

8.0.0¶

升级说明¶

此版本停止支持 Block Storage API v2。支持该 API 的 python-cinderclient 的最后一个版本是 7.x 系列。

错误修复¶

在连接到主机时，我们不需要服务器 ID，因此不应该强制要求在 attachment-create 操作中提供服务器 ID。server_id 参数变为可选，因此我们可以创建不传递它的附件。保持向后兼容性，如果需要，我们可以像当前那样传递它。

Bug #1915996：修复了对 mTLS 连接传递客户端证书的支持问题。

7.4.0¶

序言¶

python-cinderclient 的 Wallaby 版本支持 Block Storage API 第 2 版和 Block Storage API 第 3 版，直至微版本 3.64。（Wallaby 版本中 Block Storage API 的最大微版本为 3.64。）

新特性¶

增强了 backup-restore shell 命令，以支持恢复到使用特定卷类型和/或位于不同 AZ 中创建的新卷。新的 --volume-type 和 --availability-zone 参数与 cinder API 微版本 v3.47 及其更高版本兼容。

添加了对在卷详细输出中显示 volume_type_id 属性的支持，在使用 Block Storage API 微版本 3.63 及更高版本时。

添加了对在卷详细信息和备份详细信息输出中显示 encryption_key_id 属性的支持，在使用 Block Storage API 微版本 3.64 及更高版本时。

7.3.0¶

错误修复¶

Bug #1867061：修复了在使用 cinder 命令且传递了可选参数（例如 --os-volume-api-version）时出现的原始 Python 错误消息。

7.2.0¶

序言¶

python-cinderclient 的 Victoria 版本支持 Block Storage API 第 2 版和 Block Storage API 第 3 版，直至微版本 3.62。（Victoria 版本中 Block Storage API 的最大微版本为 3.62。）

新特性¶

添加了对使用 Block Storage API 第 3.62 版本及更高版本设置、获取和取消设置项目默认卷类型支持。

添加了对在 Block Storage API 第 3.61 版本及更高版本中，在卷详细输出中显示 cluster_name 属性的支持（仅限管理员用户）。

7.0.0¶

序言¶

python-cinderclient 的 Ussuri 版本支持 Block Storage API 第 2 版和 Block Storage API 第 3 版，直至微版本 3.60。（Ussuri 版本中 Block Storage API 的最大微版本为 3.60。）

除了下面描述的特性和错误修复之外，此版本还包括一些文档更新。

请注意，此版本对应于版本号的主要更新。有关详细信息，请参阅本文档的“升级说明”部分。

请记住，此版本支持的 Python 最低版本为 Python 3.6。

新特性¶

与 Block Storage API 第 3.60 版本及更高版本通信时，您可以对卷列表命令的 created_at 或 updated_at 字段应用时间比较过滤。时间必须以 ISO 8601 格式表示：CCYY-MM-DDThh:mm:ss±hh:mm。如果包含 ±hh:mm 值，则返回时区作为 UTC 的偏移量。

有关用法详细信息，请参阅 Block Storage 服务 (cinder) 命令行客户端文档。

为 transfer-list 命令添加了新的命令行选项 --filters，以支持过滤。当与 Block Storage API 第 3.52 版本及更高版本通信时，可以使用 transfer-list 命令进行过滤。

升级说明¶

命令行参数 --bypass-url 已在版本 2.10 中被弃用，并在版本 4.0.0 中被删除。它已被命令行参数 --os-endpoint 替换，以与其他 OpenStack 客户端保持一致。在本版本中，客户端对象的初始化函数不再将 bypass_url 识别为参数名称。而是使用 os_endpoint。这使 cinderclient 在内部和与其他 OpenStack 客户端方面保持一致。

错误修复¶

修复了一个问题，即 os_endpoint 没有作为 endpoint_override 参数传递给 keystone 会话。

6.0.0¶

升级说明¶

已停止对 Python 2.7 的支持。从版本 6.0.0 开始，python-cinderclient 支持的 Python 最低版本为 Python 3.6。python-cinderclient 支持 Python 2.7 的最后一个版本是 Train 版本的 5.x 系列。

5.0.0¶

序言¶

这是 python-cinderclient 的一个主要版本发布。一些长期弃用的向后兼容性已被删除，并且 Cinder v1 API 的支持已被删除。在升级到此版本之前，请确保需要管理的所有 Cinder 服务至少为 13.0.0 (Rocky) 或更高版本。

新特性¶

cinderclient CLI 的自动版本协商。如果未指定 API 版本，CLI 将使用客户端和目标 Block Storage API 端点支持的最新版本。如果请求的 API 版本高于目标支持的版本，CLI 将回退到目标支持的最新版本并发出警告消息。这不影响 cinderclient 库的使用。

从微版本 3.59 开始，cinder transfer-list 命令现在支持 --sort 参数来对返回的结果进行排序。该参数可以仅采用要排序的属性，也可以采用属性和排序方向。示例包括 cinder transfer-list --sort=id 和 cinder transfer-list --sort=name:asc。

升级说明¶

在 --filters 选项中添加了 is_public 支持，用于 type-list 和 group-type-list 命令。此选项用于根据可见性过滤卷类型和组类型。此选项有 3 个可能值：True、False、None，具体如下
- True：仅列出公共类型
- False：仅列出私有类型
- None：列出公共和私有类型

此版本的 python-cinderclient 不再支持 Cinder v1 API。确保在升级此客户端之前，所有管理的 Cinder 服务都至少具有 v2 API。

已弃用并已删除 cinder endpoints 命令。应使用 openstack catalog list 命令代替。

已弃用并已删除 cinder credentials 命令。应使用 openstack token issue 命令代替。

已弃用 --os_tenant_name、--os_tenant_id 以及环境变量 OS_TENANT_NAME 和 OS_TENANT_ID 几个版本，现在已删除。升级后，请使用等效的 --os_project_name、--os_project_id、OS_PROJECT_NAME 和 OS_PROJECT_ID。

已删除已弃用的卷创建选项 --allow-multiattach。多重附加功能现在由卷类型附加规格控制。

已删除对已弃用参数 --sort_key 和 --sort_dir 的支持。请使用受支持的 --sort 参数代替。

4.3.0¶

序言¶

Cinder 中的复制 v1 已被删除，命令行上的卷提升/重新启用复制已被删除。

新特性¶

从 API 微版本 3.56 开始，backup-list 和 backup-show 将包含 用户 ID，表明创建备份的用户。

错误修复¶

在 cinderclient.api_versions 模块中的 discover_version 函数记录为返回客户端和目标 Block Storage API 端点都支持的最新 API 版本，但它没有考虑到客户端支持的最高 API 版本。其行为在本版本中已得到纠正。[Bug 1826286]

4.0.1¶

错误修复¶

发现了一个关于处理带有快照处理的新卷传输的 API 微版本的问题，该问题发生在微版本 3.55 中。此版本包含一个修复程序，以保持与早期版本的向后兼容性。有关更多详细信息，请参阅 bug #1784703。

4.0.0¶

新特性¶

从微版本 3.54 开始，添加了指定附件的读写或只读模式的能力。命令行用法是 cinder attachment-create –mode [rw|ro]。

从微版本 3.55 开始，卷转移命令现在具有在将卷转移到另一个项目时排除卷的快照的能力。新的命令格式是 cinder transfer-create –no-snapshots。

升级说明¶

以下 CLI 选项已弃用一个或多个版本，现在已被移除

--endpoint-type
此选项已被 --os-endpoint-type 替换。

--bypass-url
此选项已被 --os-endpoint 替换。

--os-auth-system
此选项已被 --os-auth-type 替换。

命令行上的卷创建参数 --source-replica 和使用 cinderclient 库的 create() 调用中的 source_replica kwarg 都是用于在 Mitaka 版本中移除的复制 v1 支持。这些选项现在已被移除。

3.6.0¶

新特性¶

支持跨可用区 (AZ) 备份创建，指定所需的备份服务 AZ（在微版本 v3.51 中添加）。

从 3.52 开始，为 type-list 命令添加了新的命令行选项 --filters，以支持过滤器类型，并且仅对管理员有效。

3.5.0¶

新特性¶

Cinder manageable-list 和 snapshot-manageable-list 命令现在接受 --cluster 参数，以指定要列出的后端，适用于微版本 3.17 及更高版本。此参数和位置参数 host 互斥。

新的 work-cleanup 命令，用于在微版本 3.24 及更高版本的 Active-Active 部署中触发其他节点内的服务器清理。

3.4.0¶

弃用说明¶

卷创建上的 --allow-multiattach 标志现在已被标记为已弃用，将在未来的版本中移除。

3.3.0¶

新特性¶

Cinder 迁移和管理命令现在接受 --cluster 参数，以定义 Active-Active 部署的目标，适用于微版本 3.16 及更高版本。此参数和位置参数 host 对于迁移命令是互斥的。

从 3.45 开始，在卷、快照和备份的列表命令中添加了 with_count 选项。

支持从备份创建卷，微版本 v3.47。

3.2.0¶

错误修复¶

显示卷信息时返回的卷中的 attachment_ids 不正确。它显示的是 volume_id，而不是 attachment_id。此修复更改了显示卷返回的 attachment_ids，以正确反映 attachment_id。[Bug 1713082]

3.1.0¶

新特性¶

支持等待卷创建完成。命令是：cinder create --poll <volume_size>

--profile 参数可以从 OS_PROFILE 环境变量加载，以避免在 openstack 命令中重复 --profile。

支持 V3.12 中的获取卷摘要命令。

3.0.0¶

新特性¶

添加了对复制组 API enable_replication、disable_replication、failover_replication 和 list_replication_targets 的支持。

添加了对 revert-to-snapshot 功能的支持。

支持微版本 3.32，允许使用 service-set-log 和 service-get-log 命令动态更改和查询 Cinder 服务的日志级别。

在这些列表命令中启用了 like 过滤器支持。- list - snapshot-list - backup-list - group-list - group-snapshot-list - attachment-list - message-list

支持使用 list-volume 参数显示组。命令是：cinder group-show {group_id} –list-volume

错误修复¶

修复了 bug 1705093，通过使 cinderclient.client.get_highest_client_server_version 方法返回字符串而不是浮点数。将浮点数结果转换为字符串时存在问题，例如，3.40 会变成“3.4”，这是错误的。

其他说明¶

无用的 consistencygroup quota 操作已被移除。

2.2.0¶

新特性¶

添加了新的命令 list-filters 以检索启用的资源过滤器，并添加了新的选项 --filters 到这些列表命令
- 列表
- snapshot-list
- backup-list
- group-list
- group-snapshot-list
- attachment-list
- message-list
- get-pools

2.1.0¶

新特性¶

使用 ‘cinder reset-state’ 作为资源 ‘volume’、‘snapshot’、‘backup’ ‘group’ 和 ‘group-snapshot’ 的通用资源重置状态命令。同时，将卷的默认状态从 ‘available’ 更改为无状态，除非指定状态。

Cinderclient 现在支持使用 –os-auth-type noauth 参数的 noauth 模式。同时，python-cinderclient 现在支持 keystoneauth1 插件。

弃用说明¶

–bypass-url 参数现已弃用。请使用 –os-endpoint 代替。–os-auth-system 参数现已弃用。请使用 –os-auth-type 代替。

错误修复¶

列出附件时忽略了 ‘tenant’ 参数，现在已修复。[Bug 1675974]

创建附件时，‘server_id’ 现在是必需参数，这意味着我们应该使用类似于 ‘cinder attachment-create <volume> <server_id>’ 的命令创建附件。[Bug 1675975]

2.0.0¶

其他说明¶

cinder 凭据命令在几个版本中都没有工作。首选替代方案是使用 openstack token issue 命令，因此 cinder 凭据命令已被移除。

1.11.0¶

新特性¶

支持 httpClient 的 Keystone V3 身份验证。

1.9.0¶

新特性¶

服务列表将显示额外的“cluster”字段，当使用微版本 3.7 或更高版本时。

添加了集群服务命令以进行列表 - 摘要和详细 (cluster-list)、显示 (cluster-show) 和更新 (cluster-enable、cluster-disable)。列表支持按名称、二进制、禁用状态、主机数量、停机主机数量以及启动/停机状态进行过滤。这些命令需要 API 版本 3.7 或更高版本。

添加了支持记录每个 api 调用的 ‘x-openstack-request-id’。请参阅 https://blueprints.launchpad.net/python-cinderclient/+spec/log-request-id 以获取更多详细信息。

添加了对 /messages API 的支持

GET /messages
cinder –os-volume-api-version 3.3 message-list

GET /messages/{id}
cinder –os-volume-api-version 3.3 message-show {id}

DELETE /message/{id}
cinder –os-volume-api-version 3.3 message-delete {id}

错误修复¶

创建附件时忽略了 mountpoint 参数，现在已修复。[Bug 1675973]

1.7.0¶

新特性¶

支持 –os-key 选项和 OS_KEY 环境变量，允许单独提供客户端证书及其私钥。

错误修复¶

reset-state state 选项的默认值已从 available 更改为 None，因为在重置迁移状态时会发生意外的 state 重置。

1.6.0¶

新特性¶

添加了支持在 request_ids 属性中返回 “x-openstack-request-id” 标头，以便更好地跟踪。

例如

>>> from cinderclient import client
>>> cinder = client.Client('2', $OS_USER_NAME, $OS_PASSWORD, $OS_TENANT_NAME, $OS_AUTH_URL)
>>> res = cinder.volumes.list()
>>> res.request_ids

其他说明¶

开始使用 reno 来管理发布说明。

Zed 系列发行说明

Zed 系列发布说明¶

9.1.1¶

错误修复¶

9.0.0¶

升级说明¶

8.3.0¶

序言¶

新特性¶

8.1.0¶

序言¶

新特性¶

升级说明¶

8.0.0¶

升级说明¶

错误修复¶

7.4.0¶

序言¶

新特性¶

7.3.0¶

错误修复¶

7.2.0¶

序言¶

新特性¶

7.0.0¶

序言¶

新特性¶

升级说明¶

错误修复¶

6.0.0¶

升级说明¶

5.0.0¶

序言¶

新特性¶

升级说明¶

4.3.0¶

序言¶

新特性¶

错误修复¶

4.0.1¶

错误修复¶

4.0.0¶

新特性¶

升级说明¶

3.6.0¶

新特性¶

3.5.0¶

新特性¶

3.4.0¶

弃用说明¶

3.3.0¶

新特性¶

3.2.0¶

错误修复¶

3.1.0¶

新特性¶

3.0.0¶

新特性¶

错误修复¶

其他说明¶

2.2.0¶

新特性¶

2.1.0¶

新特性¶

弃用说明¶

错误修复¶

2.0.0¶

其他说明¶

1.11.0¶

新特性¶

1.9.0¶

新特性¶

错误修复¶

1.7.0¶

新特性¶

错误修复¶

1.6.0¶

新特性¶

其他说明¶

Cinder 客户端发布说明