Revision 823477e2 docs/examplesdir/imageregister.rst
| b/docs/examplesdir/imageregister.rst | ||
|---|---|---|
| 8 | 8 |
|
| 9 | 9 |
The image location format at user level:: |
| 10 | 10 |
|
| 11 |
<container>:<object path>
|
|
| 11 |
pithos://<user_uuid>/<container>/<object path>
|
|
| 12 | 12 |
|
| 13 |
e.g.,:
|
|
| 13 |
e.g., pithos://my-u53r-1d/images/debian_base3.diskdump
|
|
| 14 | 14 |
|
| 15 |
pithos:debian_base3.diskdump
|
|
| 15 |
In **file** and **container** contexts, users may also use the shortcut:
|
|
| 16 | 16 |
|
| 17 |
.. note:: The image API requires the image location in the form |
|
| 18 |
|
|
| 19 |
*pithos://<user uuid>/<container>/<object path>* |
|
| 20 |
|
|
| 21 |
The translation between the two formats is handled internally by kamaki. |
|
| 22 |
The latest format is still acceptable by kamaki due to backward |
|
| 23 |
compatibility but it is going to be deprecated from kamaki 0.12 and on. |
|
| 17 |
/<container>/<object path> |
|
| 24 | 18 |
|
| 19 |
e.g., /images/debian_base3.diskdump |
|
| 25 | 20 |
|
| 26 | 21 |
Register an image |
| 27 | 22 |
----------------- |
| 28 | 23 |
|
| 29 | 24 |
Let the image file `debian_base3.diskdump` be a debian image located at the |
| 30 |
current directory. |
|
| 25 |
current local directory.
|
|
| 31 | 26 |
|
| 32 | 27 |
Upload the image to container `pithos` |
| 33 | 28 |
|
| 34 | 29 |
.. code-block:: console |
| 35 | 30 |
|
| 36 |
[kamaki]: file upload debian_base3.diskdump pithos |
|
| 37 |
Uploading /home/someuser/debian_base3.diskdump --> pithos:debian_base3.diskdump |
|
| 38 |
Done |
|
| 39 |
[kamaki]: |
|
| 31 |
$ kamaki file upload debian_base3.diskdump pithos |
|
| 40 | 32 |
|
| 41 | 33 |
Register the image object with the name 'Debian Base Alpha' |
| 42 | 34 |
|
| 43 |
|
|
| 44 | 35 |
.. code-block:: console |
| 45 | 36 |
|
| 46 |
[kamaki]: image register 'Debian Base Alpha' pithos:debian_base3.diskdump
|
|
| 37 |
kamaki image register 'Debian Base Alpha' pithos:debian_base3.diskdump
|
|
| 47 | 38 |
checksum: 3cb03556ec971f...e8dd6190443b560cb7 |
| 48 | 39 |
container-format: bare |
| 49 | 40 |
created-at: 2013-06-19 08:00:22 |
Also available in: Unified diff