Chapter 55. object

This chapter describes the commands under the object command.

55.1. object create

Upload object to container

Usage:

openstack object create [-h] [-f {csv,json,table,value,yaml}]
                               [-c COLUMN]
                               [--quote {all,minimal,none,nonnumeric}]
                               [--noindent] [--max-width <integer>]
                               [--fit-width] [--print-empty]
                               [--sort-column SORT_COLUMN] [--name <name>]
                               <container> <filename> [<filename> ...]

Table 55.1. Positional Arguments

ValueSummary

<container>

Container for new object

<filename>

Local filename(s) to upload

Table 55.2. Optional Arguments

ValueSummary

-h, --help

Show this help message and exit

--name <name>

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

Table 55.3. Output Formatters

ValueSummary

output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

The output format, defaults to table

-c COLUMN, --column COLUMN

Specify the column(s) to include, can be repeated

--sort-column SORT_COLUMN

Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

Table 55.4. CSV Formatter

ValueSummary

--quote {all,minimal,none,nonnumeric}

When to include quotes, defaults to nonnumeric

Table 55.5. JSON Formatter

ValueSummary

--noindent

Whether to disable indenting the json

Table 55.6. Table Formatter

ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

55.2. object delete

Delete object from container

Usage:

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

Table 55.7. Positional Arguments

ValueSummary

<container>

Delete object(s) from <container>

<object>

Object(s) to delete

Table 55.8. Optional Arguments

ValueSummary

-h, --help

Show this help message and exit

55.3. object list

List objects

Usage:

openstack object list [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN]
                             [--quote {all,minimal,none,nonnumeric}]
                             [--noindent] [--max-width <integer>]
                             [--fit-width] [--print-empty]
                             [--sort-column SORT_COLUMN] [--prefix <prefix>]
                             [--delimiter <delimiter>] [--marker <marker>]
                             [--end-marker <end-marker>]
                             [--limit <num-objects>] [--long] [--all]
                             <container>

Table 55.9. Positional Arguments

ValueSummary

<container>

Container to list

Table 55.10. Optional Arguments

ValueSummary

-h, --help

Show this help message and exit

--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 <num-objects>

Limit the number of objects returned

--long

List additional fields in output

--all

List all objects in container (default is 10000)

Table 55.11. Output Formatters

ValueSummary

output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

The output format, defaults to table

-c COLUMN, --column COLUMN

Specify the column(s) to include, can be repeated

--sort-column SORT_COLUMN

Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

Table 55.12. CSV Formatter

ValueSummary

--quote {all,minimal,none,nonnumeric}

When to include quotes, defaults to nonnumeric

Table 55.13. JSON Formatter

ValueSummary

--noindent

Whether to disable indenting the json

Table 55.14. Table Formatter

ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

55.4. object save

Save object locally

Usage:

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

Table 55.15. Positional Arguments

ValueSummary

<container>

Download <object> from <container>

<object>

Object to save

Table 55.16. Optional Arguments

ValueSummary

-h, --help

Show this help message and exit

--file <filename>

Destination filename (defaults to object name); using - as the filename will print the file to stdout

55.5. object set

Set object properties

Usage:

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

Table 55.17. Positional Arguments

ValueSummary

<container>

Modify <object> from <container>

<object>

Object to modify

Table 55.18. Optional Arguments

ValueSummary

-h, --help

Show this help message and exit

--property <key=value>

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

55.6. object show

Display object details

Usage:

openstack object show [-h] [-f {json,shell,table,value,yaml}]
                             [-c COLUMN] [--noindent] [--prefix PREFIX]
                             [--max-width <integer>] [--fit-width]
                             [--print-empty]
                             <container> <object>

Table 55.19. Positional Arguments

ValueSummary

<container>

Display <object> from <container>

<object>

Object to display

Table 55.20. Optional Arguments

ValueSummary

-h, --help

Show this help message and exit

Table 55.21. Output Formatters

ValueSummary

output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

The output format, defaults to table

-c COLUMN, --column COLUMN

Specify the column(s) to include, can be repeated

Table 55.22. JSON Formatter

ValueSummary

--noindent

Whether to disable indenting the json

Table 55.23. Shell Formatter

ValueSummary

a format a UNIX shell can parse (variable="value")--prefix PREFIX

Add a prefix to all variable names

Table 55.24. Table Formatter

ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

55.7. object store account set

Set account properties

Usage:

openstack object store account set [-h] --property <key=value>

Table 55.25. Optional Arguments

ValueSummary

-h, --help

Show this help message and exit

--property <key=value>

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

55.8. object store account show

Display account details

Usage:

openstack object store account show [-h]
                                           [-f {json,shell,table,value,yaml}]
                                           [-c COLUMN] [--noindent]
                                           [--prefix PREFIX]
                                           [--max-width <integer>]
                                           [--fit-width] [--print-empty]

Table 55.26. Optional Arguments

ValueSummary

-h, --help

Show this help message and exit

Table 55.27. Output Formatters

ValueSummary

output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

The output format, defaults to table

-c COLUMN, --column COLUMN

Specify the column(s) to include, can be repeated

Table 55.28. JSON Formatter

ValueSummary

--noindent

Whether to disable indenting the json

Table 55.29. Shell Formatter

ValueSummary

a format a UNIX shell can parse (variable="value")--prefix PREFIX

Add a prefix to all variable names

Table 55.30. Table Formatter

ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

55.9. object store account unset

Unset account properties

Usage:

openstack object store account unset [-h] --property <key>

Table 55.31. Optional Arguments

ValueSummary

-h, --help

Show this help message and exit

--property <key>

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

55.10. object unset

Unset object properties

Usage:

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

Table 55.32. Positional Arguments

ValueSummary

<container>

Modify <object> from <container>

<object>

Object to modify

Table 55.33. Optional Arguments

ValueSummary

-h, --help

Show this help message and exit

--property <key>

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