← Back to team overview

yahoo-eng-team team mailing list archive

[Bug 1799495] [NEW] api-ref: createImage description does not mention volume-backed snapshots

 

Public bug reported:

The API reference for the createImage server action:

https://developer.openstack.org/api-ref/compute/?expanded=create-server-
back-up-createbackup-action-detail,create-image-createimage-action-
detail#create-image-createimage-action

Does not mention anything about volume-backed instance snapshots. There
are a few differences:

1. For preconditions, volume-backed server snapshot is only supported
for ACTIVE, SHUTOFF and SUSPENDED instances, not PAUSED like for image-
backed.

2. The project must have sufficient volume snapshot quota in the block
storage service.

3. Volume snapshots will be created for all volumes attached to the
server and then those will be represented with a "block_device_mapping"
image property in the resulting snapshot image in the image service
(glance). If that snapshot image is used later to create a new instance,
it will result in a volume-backed instance where the root volume is
created from the snapshot of the original root volume.

** Affects: nova
     Importance: Medium
         Status: Triaged


** Tags: api-ref docs low-hanging-fruit

** Tags added: low-hanging-fruit

-- 
You received this bug notification because you are a member of Yahoo!
Engineering Team, which is subscribed to OpenStack Compute (nova).
https://bugs.launchpad.net/bugs/1799495

Title:
  api-ref: createImage description does not mention volume-backed
  snapshots

Status in OpenStack Compute (nova):
  Triaged

Bug description:
  The API reference for the createImage server action:

  https://developer.openstack.org/api-ref/compute/?expanded=create-
  server-back-up-createbackup-action-detail,create-image-createimage-
  action-detail#create-image-createimage-action

  Does not mention anything about volume-backed instance snapshots.
  There are a few differences:

  1. For preconditions, volume-backed server snapshot is only supported
  for ACTIVE, SHUTOFF and SUSPENDED instances, not PAUSED like for
  image-backed.

  2. The project must have sufficient volume snapshot quota in the block
  storage service.

  3. Volume snapshots will be created for all volumes attached to the
  server and then those will be represented with a
  "block_device_mapping" image property in the resulting snapshot image
  in the image service (glance). If that snapshot image is used later to
  create a new instance, it will result in a volume-backed instance
  where the root volume is created from the snapshot of the original
  root volume.

To manage notifications about this bug go to:
https://bugs.launchpad.net/nova/+bug/1799495/+subscriptions


Follow ups