Jump to: navigation, search


Warning.svg Old Design Page

This page was used to help design a feature for a previous release of OpenStack. It may or may not have been implemented. As a result, this page is unlikely to be updated and could contain outdated information. It was last updated on 2014-12-17


This proposal aims to recover an image which is in 'pending-delete' state so as to provide the revert capability for the purposes of allowing emergency operational action to recover from an accidental delete

General Workflow

  1. The 'delayed_delete' config entry is enabled in glance-api.conf
  2. Delete the specific image
  3. List the images which are 'pending-delete'
  4. User PUT /v2/images/{image-uuid} on the requested image to recover it
  5. Eventually, the requested image should be in 'active' state after recovering successfully.

Design Details


Now in my PoC, I'm using 'PUT' as the REST API method. But TBO, I'm not sure if 'PUT' is a good condidate for image recover, given 'PUT' need to support **Idempotent**.

HTTP Request - PUT /v2/images/12345678-1234-1234-1234-123456789abc
Response: 200 OK

CLI (Glance client)

A new sub command 'image-recover' will be added to Glance python client. Then user can recover an 'pending_delete' image by issuing below command:

glance image-recover b55b5e54-b7d8-4629-847f-6f180313db88


1. List pending-delete image

   Current image-list should be extended to support listing the images which in 'pending_delete' status, so that user can get the iamge id to do image recover.

2. Only the image which in 'active' status can be updated to 'pending_delete'

   After investigated current code, this has been met. See https://review.openstack.org/#/c/53997/ as a reference.


blueprint: https://blueprints.launchpad.net/glance/+spec/image-recover