python-openstackclient/doc/source/command-objects/object.rst
Kevin_Zheng 847da51dea change os in command example to openstack(2)
In the current doc, the command examples are like
"os server create" but the acutal command should
be started with "openstack" instead of "os", it
is misleading to first time users.

Change-Id: I80c96f0938cec382f2f714a500138bd5a2c81aa0
2016-12-20 09:18:55 +08:00

3.0 KiB

object

Object Storage v1

object create

Upload object to container

object create

openstack object create
    [--name <name>]
    <container>
    <filename> [<filename> ...]

--name <name>

Upload a file and rename it. Can only be used when uploading a single object

<container>

Container for new object

<filename>

Local filename(s) to upload

object delete

Delete object from container

object delete

openstack object delete
    <container>
    <object> [<object> ...]

<container>

Delete object(s) from <container>

<object>

Object(s) to delete

object list

List objects

openstack object list
    [--prefix <prefix>]
    [--delimiter <delimiter>]
    [--marker <marker>]
    [--end-marker <end-marker>]
    [--limit <limit>]
    [--long]
    [--all]
    <container>

--prefix <prefix>

Filter list using <prefix>

--delimiter <delimiter>

Roll up items with <delimiter>

--marker <marker>

Anchor for paging

--end-marker <end-marker>

End anchor for paging

--limit <limit>

Limit number of objects returned

--long

List additional fields in output

--all

List all objects in <container> (default is 10000)

<container>

Container to list

object save

Save object locally

object save

openstack object save
    [--file <filename>]
    <container>
    <object>

--file <filename>

Destination filename (defaults to object name)

<container>

Download <object> from <container>

<object>

Object to save

object set

Set object properties

object set

openstack object set
    [--property <key=value> [...] ]
    <container>
    <object>

--property <key=value>

Set a property on this object (repeat option to set multiple properties)

<container>

Modify <object> from <container>

<object>

Object to modify

object show

Display object details

object show

openstack object show
    <container>
    <object>

<container>

Display <object> from <container>

<object>

Object to display

object unset

Unset object properties

object unset

openstack object unset
    [--property <key>]
    <container>
    <object>

--property <key>

Property to remove from object (repeat option to remove multiple properties)

<container>

Modify <object> from <container>

<object>

Object to modify