openstack.block_storage.v3.volume¶
The Volume Class¶
The Volume
class inherits from Resource
.
- class openstack.block_storage.v3.volume.Volume(_synchronized=False, connection=None, **attrs)¶
The base resource
- Parameters
_synchronized (bool) – This is not intended to be used directly. See
new()
andexisting()
.connection (openstack.connection.Connection) – Reference to the Connection being used. Defaults to None to allow Resource objects to be used without an active Connection, such as in unit tests. Use of
self._connection
in Resource code should protect itself with a check for None.
- attachments¶
TODO(briancurtin): This is currently undocumented in the API.
- availability_zone¶
The availability zone.
- consistency_group_id¶
ID of the consistency group.
- created_at¶
The timestamp of this volume creation.
- updated_at¶
The date and time when the resource was updated.
- description¶
The volume description.
- extended_replication_status¶
Extended replication status on this volume.
- group_id¶
The ID of the group that the volume belongs to.
- host¶
The volume’s current back-end.
- image_id¶
The ID of the image from which you want to create the volume. Required to create a bootable volume.
- is_bootable¶
Enables or disables the bootable attribute. You can boot an instance from a bootable volume. Type: bool
- is_encrypted¶
True
if this volume is encrypted,False
if not. Type: bool
- migration_id¶
The volume ID that this volume’s name on the back-end is based on.
- migration_status¶
The status of this volume’s migration (None means that a migration is not currently in progress).
- project_id¶
The project ID associated with current back-end.
- replication_driver_data¶
Data set by the replication driver
- replication_status¶
Status of replication on this volume.
- scheduler_hints¶
Scheduler hints for the volume
- size¶
The size of the volume, in GBs. Type: int
- snapshot_id¶
To create a volume from an existing snapshot, specify the ID of the existing volume snapshot. If specified, the volume is created in same availability zone and with same size of the snapshot.
- source_volume_id¶
To create a volume from an existing volume, specify the ID of the existing volume. If specified, the volume is created with same size of the source volume.
- status¶
One of the following values: creating, available, attaching, in-use deleting, error, error_deleting, backing-up, restoring-backup, error_restoring. For details on these statuses, see the Block Storage API documentation.
- user_id¶
The user ID associated with the volume
- volume_image_metadata¶
One or more metadata key and value pairs about image
- volume_type¶
The name of the associated volume type.
- extend(session, size)¶
Extend a volume size.
- set_bootable_status(session, bootable=True)¶
Set volume bootable status flag
- set_readonly(session, readonly)¶
Set volume readonly flag
- reset_status(session, status, attach_status, migration_status)¶
Reset volume statuses (admin operation)
- revert_to_snapshot(session, snapshot_id)¶
Revert volume to its snapshot
- attach(session, mountpoint, instance=None, host_name=None)¶
Attach volume to server
- detach(session, attachment, force=False, connector=None)¶
Detach volume from server
- unmanage(session)¶
Unmanage volume
- retype(session, new_type, migration_policy=None)¶
Change volume type
- migrate(session, host=None, force_host_copy=False, lock_volume=False, cluster=None)¶
Migrate volume
- complete_migration(session, new_volume_id, error=False)¶
Complete volume migration
- force_delete(session)¶
Force volume deletion
- upload_to_image(session, image_name, force=False, disk_format=None, container_format=None, visibility=None, protected=None)¶
Upload the volume to image service
- reserve(session)¶
Reserve volume
- unreserve(session)¶
Unreserve volume
- begin_detaching(session)¶
Update volume status to ‘detaching’
- abort_detaching(session)¶
Roll back volume status to ‘in-use’
- init_attachment(session, connector)¶
Initialize volume attachment
- terminate_attachment(session, connector)¶
Terminate volume attachment