Chapter 26. datastore

This chapter describes the commands under the datastore command.

26.1. datastore delete

Deletes a datastore

Usage:

openstack datastore delete [-h] <datastore>

Table 26.1. Positional arguments

ValueSummary

<datastore>

Id or name of the datastore

Table 26.2. Command arguments

ValueSummary

-h, --help

Show this help message and exit

26.2. datastore list

List available datastores

Usage:

openstack datastore 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]
                                [--sort-ascending | --sort-descending]

Table 26.3. Command arguments

ValueSummary

-h, --help

Show this help message and exit

Table 26.4. Output formatter options

ValueSummary

-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 to show multiple columns

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

--sort-ascending

Sort the column(s) in ascending order

--sort-descending

Sort the column(s) in descending order

Table 26.5. CSV formatter options

ValueSummary

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

When to include quotes, defaults to nonnumeric

Table 26.6. JSON formatter options

ValueSummary

--noindent

Whether to disable indenting the json

Table 26.7. Table formatter options

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.

26.3. datastore show

Shows details of a datastore

Usage:

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

Table 26.8. Positional arguments

ValueSummary

<datastore>

Id of the datastore

Table 26.9. Command arguments

ValueSummary

-h, --help

Show this help message and exit

Table 26.10. Output formatter options

ValueSummary

-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 to show multiple columns

Table 26.11. JSON formatter options

ValueSummary

--noindent

Whether to disable indenting the json

Table 26.12. Shell formatter options

ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Table 26.13. Table formatter options

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.

26.4. datastore version create

Creates a datastore version.

Usage:

openstack datastore version create [-h] [--active]
                                          [--image-tags IMAGE_TAGS]
                                          [--default]
                                          [--version-number VERSION_NUMBER]
                                          version_name datastore_name
                                          datastore_manager image_id

Table 26.14. Positional arguments

ValueSummary

version_name

Datastore version name.

datastore_name

Datastore name. the datastore is created automatically if does not exist.

datastore_manager

Datastore manager, e.g. mysql

image_id

Id of the datastore image in glance. this can be empty string if --image-tags is specified.

Table 26.15. Command arguments

ValueSummary

-h, --help

Show this help message and exit

--active

Enable the datastore version.

--image-tags IMAGE_TAGS

List of image tags separated by comma, e.g. trove,mysql

--default

If set the datastore version as default.

--version-number VERSION_NUMBER

The version number for the database. if not specified, use the version name as the default value.

26.5. datastore version delete

Deletes a datastore version.

Usage:

openstack datastore version delete [-h] <datastore_version>

Table 26.16. Positional arguments

ValueSummary

<datastore_version>

Id of the datastore version.

Table 26.17. Command arguments

ValueSummary

-h, --help

Show this help message and exit

26.6. datastore version list

Lists available versions for a datastore

Usage:

openstack datastore version 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]
                                        [--sort-ascending | --sort-descending]
                                        <datastore>

Table 26.18. Positional arguments

ValueSummary

<datastore>

Id or name of the datastore

Table 26.19. Command arguments

ValueSummary

-h, --help

Show this help message and exit

Table 26.20. Output formatter options

ValueSummary

-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 to show multiple columns

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

--sort-ascending

Sort the column(s) in ascending order

--sort-descending

Sort the column(s) in descending order

Table 26.21. CSV formatter options

ValueSummary

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

When to include quotes, defaults to nonnumeric

Table 26.22. JSON formatter options

ValueSummary

--noindent

Whether to disable indenting the json

Table 26.23. Table formatter options

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.

26.7. datastore version set

Updates a datastore version.

Usage:

openstack datastore version set [-h]
                                       [--datastore-manager DATASTORE_MANAGER]
                                       [--image IMAGE]
                                       [--image-tags IMAGE_TAGS]
                                       [--version-name VERSION_NAME]
                                       [--enable | --disable]
                                       [--default | --non-default]
                                       datastore_version_id

Table 26.24. Positional arguments

ValueSummary

datastore_version_id

Datastore version id.

Table 26.25. Command arguments

ValueSummary

-h, --help

Show this help message and exit

--datastore-manager DATASTORE_MANAGER

Datastore manager name.

--image IMAGE

Id of the datastore image in glance.

--image-tags IMAGE_TAGS

List of image tags separated by comma, e.g. trove,mysql

--version-name VERSION_NAME

New datastore version name.

--enable—​disable—​default—​non-default

None

26.8. datastore version show

Shows details of a datastore version.

Usage:

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

Table 26.26. Positional arguments

ValueSummary

<datastore_version>

Id or name of the datastore version.

Table 26.27. Command arguments

ValueSummary

-h, --help

Show this help message and exit

--datastore <datastore>

Id or name of the datastore. optional if the id ofthe datastore_version is provided.

Table 26.28. Output formatter options

ValueSummary

-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 to show multiple columns

Table 26.29. JSON formatter options

ValueSummary

--noindent

Whether to disable indenting the json

Table 26.30. Shell formatter options

ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Table 26.31. Table formatter options

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.