openstack.block_storage.v2.volume

Volume 类

Volume 类继承自 Resource。

class openstack.block_storage.v2.volume.Volume(_synchronized=False, connection=None, **attrs)

基础资源

参数：

  • _synchronized (bool) – 这不打算直接使用。请参阅 new() 和 existing()。

  • connection (openstack.connection.Connection) – 对正在使用的 Connection 的引用。默认为 None，允许在单元测试中等情况下使用不带活动 Connection 的 Resource 对象。Resource 代码中对 self._connection 的使用应使用 None 检查进行保护。

resource_key = 'volume'

资源的单数形式的键。

resources_key = 'volumes'

资源的复数形式的键。

base_path = '/volumes'

此资源的 URI 的基本部分。

allow_fetch = True

允许对此资源进行获取操作。

allow_create = True

允许对此资源进行创建操作。

allow_delete = True

允许对此资源进行删除操作。

allow_commit = True

允许对此资源进行更新操作。

allow_list = True

允许对此资源进行列表操作。

attachments

TODO(briancurtin): 此处 API 中未记录。

availability_zone

可用区。

consistency_group_id

一致性组的 ID。

created_at

此卷的创建时间戳。

description

卷描述。

extended_replication_status

此卷的扩展复制状态。

host

卷的当前后端。

image_id

要创建卷的镜像的 ID。创建可启动卷需要此项。

is_bootable

启用或禁用可启动属性。您可以从可启动卷启动实例。类型: bool

is_encrypted

True 如果此卷已加密，则为 False 如果未加密。类型: bool

is_multiattach

卷是否可共享。

migration_id

此卷的名称基于后端上的卷 ID。

migration_status

此卷的迁移状态（None 表示当前没有正在进行的迁移）。

project_id

与当前后端关联的项目 ID。

replication_driver_data

复制驱动程序设置的数据

replication_status

此卷的复制状态。

scheduler_hints

卷的调度器提示

size

卷的大小，以 GB 为单位。类型: int

snapshot_id

要从现有快照创建卷，请指定现有卷快照的 ID。如果指定，则卷将在与快照相同的可用区中创建，并且大小与快照相同。

source_volume_id

要从现有卷创建卷，请指定现有卷的 ID。如果指定，则卷将与源卷的大小相同。

status

以下值之一：creating、available、attaching、in-use deleting、error、error_deleting、backing-up、restoring-backup、error_restoring。有关这些状态的详细信息，请参阅块存储 API 文档。

updated_at

更新资源的时间和日期。

user_id

与卷关联的用户 ID

volume_image_metadata

关于镜像的一个或多个元数据键值对

volume_type

关联的卷类型名称。

extend(session, size)

扩展卷大小。

set_bootable_status(session, bootable=True)

设置卷可启动状态标志

set_readonly(session, readonly)

设置卷只读标志

set_image_metadata(session, metadata)

设置卷上的镜像元数据键值对

delete_image_metadata(session)

删除卷上的所有镜像元数据

delete_image_metadata_item(session, key)

删除卷上的单个镜像元数据

reset_status(session, status=None, attach_status=None, migration_status=None)

重置卷状态（管理员操作）

attach(session, mountpoint, instance)

将卷附加到服务器

detach(session, attachment, force=False)

将卷从服务器分离

unmanage(session)

取消管理卷

retype(session, new_type, migration_policy=None)

更改卷类型

migrate(session, host=None, force_host_copy=False, lock_volume=False)

迁移卷

complete_migration(session, new_volume_id, error=False)

完成卷迁移

force_delete(session)

强制删除卷