Synnefo » ./kamaki

Listing

=======

In this section we present the ways of kamaki for listing, an operation that is

common to most command groups.

The examples of this section run in a kamaki interactive shell.

.. code-block:: console

    $ kamaki

    kamaki v0.9 - Interactive Shell

    .

    /exit       terminate kamaki

    exit or ^D  exit context

    ? or help   available commands

    ?command    help on command

    !<command>  execute OS shell command

    .

    [kamaki]:

Simple listing

--------------

List configuration options, whether in the file or in memory

.. code-block:: console

    [kamaki]: config list

    cloud.default.url = https://astakos.example.com/identity/v2.0/

    cloud.default.token = my70k3n==

    global.default_cloud = default

    global.colors = on

    global.config_cli = config

    global.file_cli = pithos

    global.flavor_cli = cyclades

    global.history_cli = history

    global.history_file = /home/saxtouri/.kamaki.history

    global.image_cli = image

    global.log_file = /home/saxtouri/.kamaki.log

    global.log_token = one

    global.max_threads = 5

    global.network_cli = cyclades

    global.server_cli = cyclades

    global.user_cli = astakos

    [kamaki]:

List stored containers and then objects in container "pithos"

.. code-block:: console

    [kamaki]: file list

    pithos (36MB, 4 objects)

    trash (0B, 0 objects)

    [kamaki]: file list pithos

    . 2KB  info.txt

    . D    video/

    . 11MB video/tk1.mpg

    . 12MB video/tk2.mpg

    . 13MB video/tk3.mpg

    [kamaki]:

List virtual machines (servers)

.. code-block:: console

    [kamaki]: server list

    4201 example server 1

    4202 example server 2

List networks

.. code-block:: console

    [kamaki]: network list

    1 public_network

    42 my_private)network

    [kamaki]:

List flavors

.. code-block:: console

    [kamaki]: flavor list

    1 C1R1024D20drbd

    2 C1R1024D30drbd

    [kamaki]:

List images from Image API and from Compute APIs

.. code-block:: console

    [kamaki]: image list

    cde9858c-0656-4da1-8cbd-33481b29a8bd Debian Base

    .container_format: bare

    .disk_format:      diskdump

    .size:             474066944

    .status:           available

    a5ca5997-c580-4d62-b012-05c5329f8e2d Debian Base

    .container_format: bare

    .disk_format:      diskdump

    .size:             474066944

    .status:           available

    [kamaki]: image compute list

    a5ca5997-c580-4d62-b012-05c5329f8e2d Debian Base

    cde9858c-0656-4da1-8cbd-33481b29a8bd Debian Base

    [kamaki]:

Detailed pithos listing

-----------------------

List pithos containers with details

.. code-block:: console

    [kamaki]: file

    [file]: list -l

    pithos

    bytes:    0 (0B)

    count:    3

    modified: 2013-06-17T12:35:11.613124+00:00

    policy:  

    .       quota:      0

    .       versioning: auto

    trash

    bytes:    0 (0B)

    count:    0

    modified: 2013-06-06T14:24:23.675891+00:00

    policy:  

    .       quota:      0

    .       versioning: auto

    [file]:

Create some more pithos container to experiment with

.. code-block:: console

    [file]: create cont1

    [file]: create cont2

    [file]: create cont3

    [file]: create cont4

    [file]: list

    cont1 (0B, 0 objects)

    cont2 (0B, 0 objects)

    cont3 (0B, 0 objects)

    cont4 (0B, 0 objects)

    pithos (36B, 5 objects)

    trash (0B, 0 objects)

    [file]:

List only 3, then list three by three

.. code-block:: console

    [file]: list -n 3

    cont1 (0B, 0 objects)

    cont2 (0B, 0 objects)

    cont3 (0B, 0 objects)

    [file]: list -n 3 --more

    cont1 (0B, 0 objects)

    cont2 (0B, 0 objects)

    cont3 (0B, 0 objects)

    (3 listed - 3 more - "enter" to continue)

    <enter is pressed>

    cont4 (0B, 0 objects)

    pithos (36B, 4 objects)

    trash (0B, 0 objects)

    [file]: 

List contents of container `pithos`

.. code-block:: console

    [file]: list -l pithos

    info.txt

    by:        s0m3-u53r-1d

    bytes:     2000 (2ΚB)

    hash:      427ae41e4649b934ca495991b7852b855e3b0c44298fc1c149afbf4c8996fb92

    modified:  2013-06-17T13:09:44.529579+00:00

    timestamp: 1371474584.5295789

    type:      plan-text/unicode

    uuid:      0493f1d9-9410-4f4b-a81f-fe42f9cefa70

    version:   1085

    .

    video

    by:        s0m3-u53r-1d

    bytes:     0

    hash:      e3b0c44298fc1c149afbf44ca495991b7852b855c8996fb92427ae41e4649b93

    modified:  2013-06-17T13:11:39.050090+00:00

    timestamp: 1371474699.0500901

    type:      application/directory

    uuid:      80e719f5-9d68-4333-9846-9943972ef1fd

    version:   1086

    .

    video/tk1.mpg

    by:        s0m3-u53r-1d

    bytes:     11000000 (11ΜΒB)

    hash:      fbf4c8996fb92427ae41e464e3b0c44298fc1c5991b7852b855149a9b934ca49

    modified:  2013-06-17T13:09:15.866515+00:00

    timestamp: 1371474555.8665149

    type:      video/mpeg

    uuid:      b0b46b39-c59a-4adc-a386-6a169cb9f8a5

    version:   1079

    .

    video/tk2.mpg

    by:        s0m3-u53r-1d

    bytes:     12000000 (12MB)

    hash:      44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b78e3b0c52b855

    modified:  2013-06-17T13:09:23.898652+00:00

    timestamp: 1371474563.8986521

    type:      video/mpeg

    uuid:      12a81309-db3c-4e30-ae9a-4ac2b8289def

    version:   1081

    .

    video/tk3.mpg

    by:        s0m3-u53r-1d

    bytes:     13000000 (13MB)

    hash:      1e4649b934ca495991b7852b855e3b0c44298fc1c149afbf4c8996fb92427ae4

    modified:  2013-06-17T13:09:28.222536+00:00

    timestamp: 1371474568.2225361

    type:      video/mpeg

    uuid:      4195e8c3-9b9a-4e97-8c20-fdfef34892fe

    version:   1083

    [kamaki]:

List only videos and exit "file" context

.. code-block:: console

    [file]: list -l pithos:video/

    video/tk1.mpg

    by:        s0m3-u53r-1d

    bytes:     11000000 (11ΜΒB)

    hash:      fbf4c8996fb92427ae41e464e3b0c44298fc1c5991b7852b855149a9b934ca49

    modified:  2013-06-17T13:09:15.866515+00:00

    timestamp: 1371474555.8665149

    type:      video/mpeg

    uuid:      b0b46b39-c59a-4adc-a386-6a169cb9f8a5

    version:   1079

    .

    video/tk2.mpg

    by:        s0m3-u53r-1d

    bytes:     12000000 (12MB)

    hash:      44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b78e3b0c52b855

    modified:  2013-06-17T13:09:23.898652+00:00

    timestamp: 1371474563.8986521

    type:      video/mpeg

    uuid:      12a81309-db3c-4e30-ae9a-4ac2b8289def

    version:   1081

    .

    video/tk3.mpg

    by:        s0m3-u53r-1d

    bytes:     13000000 (13MB)

    hash:      1e4649b934ca495991b7852b855e3b0c44298fc1c149afbf4c8996fb92427ae4

    modified:  2013-06-17T13:09:28.222536+00:00

    timestamp: 1371474568.2225361

    type:      video/mpeg

    uuid:      4195e8c3-9b9a-4e97-8c20-fdfef34892fe

    version:   1083

    [kamaki]: