Jump to: navigation, search

Difference between revisions of "Glance-tasks-api-product"

m (OpenStack Announces Images Tasks API)
m (OpenStack Announces Images Tasks API)
Line 12: Line 12:
 
== Press Release ==
 
== Press Release ==
 
=== OpenStack Announces Images Tasks API ===
 
=== OpenStack Announces Images Tasks API ===
Available now with the Havana OpenStack release, the Images v2 Tasks API provides cloud users with a unified interface for performing image-related tasks.  Three tasks are currently available: '''import''', '''export''', and '''clone'''.  You simply make a post to /v2/tasks with specifics about the task in the request body, and receive a Location header with the URI of a task resource.  By polling the task resource, you'll be kept informed about the status of your task until it reaches its conclusion.  At that point, the task resource will contain information concerning the product of your task (e.g., the UUID of the image that was imported).  It will also have an expiration timestamp to indicate when the task resource itself will be deleted.
+
Available now with the Havana OpenStack release, the Images v2 Tasks API provides cloud users with a unified interface for performing image-related tasks.  Three tasks are currently available: '''import''', '''export''', and '''clone'''.  You simply make a post to /v2/tasks with specifics about the task in the request body, and receive a Location header with the URI of a task resource.  By polling the task resource, you'll be kept informed about the status of your task until it reaches its conclusion.  At that point, the task resource will contain information concerning the product of your task (e.g., the UUID of the image that was imported).  It will also have an expiration timestamp to indicate when the task resource itself will be deleted. (We don't want these things clogging up your tasks list!)
 +
 
 
==== The Import Task ====
 
==== The Import Task ====
 
The import task allows you to specify the location of the image you want to import into the cloud.  You make the request, Glance will retrieve the image, and pull it into the cloud, where you can use it to boot instances.  As part of this process, your image may undergo some transformation and validation before it becomes an active image.
 
The import task allows you to specify the location of the image you want to import into the cloud.  You make the request, Glance will retrieve the image, and pull it into the cloud, where you can use it to boot instances.  As part of this process, your image may undergo some transformation and validation before it becomes an active image.
Line 19: Line 20:
 
==== The Clone Task ====
 
==== The Clone Task ====
 
The clone task allows you to copy an image from region to region within a cloud.
 
The clone task allows you to copy an image from region to region within a cloud.
 +
 +
Create some tasks in a Glance located near you today!
  
 
== Tasks API FAQ ==
 
== Tasks API FAQ ==

Revision as of 14:37, 30 July 2013

This is a "product package" for:

  • Glance blueprints
    • "New Upload Workflow ("Import")" [1]
    • "New Download Workflow ("Export")" [2]
    • "Model for cloning image from one region to another" [3]
  • Full specifications
    • "Glance Tasks API" [4]
    • "Import Task" [5]
    • "Export Task" [6]
    • "Clone Task" [7]

Press Release

OpenStack Announces Images Tasks API

Available now with the Havana OpenStack release, the Images v2 Tasks API provides cloud users with a unified interface for performing image-related tasks. Three tasks are currently available: import, export, and clone. You simply make a post to /v2/tasks with specifics about the task in the request body, and receive a Location header with the URI of a task resource. By polling the task resource, you'll be kept informed about the status of your task until it reaches its conclusion. At that point, the task resource will contain information concerning the product of your task (e.g., the UUID of the image that was imported). It will also have an expiration timestamp to indicate when the task resource itself will be deleted. (We don't want these things clogging up your tasks list!)

The Import Task

The import task allows you to specify the location of the image you want to import into the cloud. You make the request, Glance will retrieve the image, and pull it into the cloud, where you can use it to boot instances. As part of this process, your image may undergo some transformation and validation before it becomes an active image.

The Export Task

The export task enables you to export an image you've created in some provider's cloud in the quasi-official qcow2 format.

The Clone Task

The clone task allows you to copy an image from region to region within a cloud.

Create some tasks in a Glance located near you today!

Tasks API FAQ

References

  1. https://blueprints.launchpad.net/glance/+spec/new-upload-workflow
  2. https://blueprints.launchpad.net/glance/+spec/new-download-workflow
  3. https://blueprints.launchpad.net/glance/+spec/clone-image-across-regions
  4. https://wiki.openstack.org/wiki/Glance-tasks-api
  5. https://wiki.openstack.org/wiki/Glance-tasks-import
  6. https://wiki.openstack.org/wiki/Glance-tasks-export
  7. https://wiki.openstack.org/wiki/Glance-tasks-clone