Chapter 69. share

<share>

Name or id of the share(s)

-h, --help

Show this help message and exit

--wait

Wait until share is abandoned

<share>

Name or id of the nas share to modify.

<access_type>

Access rule type (only "ip", "user" (user or group), "cert" or "cephx" are supported).

<access_to>

Value that defines access.

-h, --help

Show this help message and exit

--properties [<key=value> …​]

Space separated list of key=value pairs of properties. OPTIONAL: Default=None. Available only for API microversion >= 2.45.

--access-level <access_level>

Share access level ("rw" and "ro" access levels are supported). Defaults to rw.

--wait

Wait for share access rule creation.

-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

--noindent

Whether to disable indenting the json

--prefix PREFIX

Add a prefix to all variable names

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

<share>

Name or id of the nas share to modify.

<id>

Id of the access rule to be deleted.

-h, --help

Show this help message and exit

--wait

Wait for share access rule deletion

<share>

Name or id of the share.

-h, --help

Show this help message and exit

--properties [<key=value> …​]

Filters results by properties (key=value). optional: Default=None. Available only for API microversion >= 2.45

-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

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

When to include quotes, defaults to nonnumeric

--noindent

Whether to disable indenting the json

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

<access_id>

Id of the nas share access rule.

-h, --help

Show this help message and exit

--property <key=value>

Set a property to this share access rule. (repeat option to set multiple properties) Available only for API microversion >= 2.45.

<access_id>

Id of the nas share access rule.

-h, --help

Show this help message and exit

-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

--noindent

Whether to disable indenting the json

--prefix PREFIX

Add a prefix to all variable names

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

<access_id>

Id of the nas share access rule.

-h, --help

Show this help message and exit

--property <key>

Remove property from share access rule. (repeat option to remove multiple properties) Available only for API microversion >= 2.45.

<service-host>

Service host: some.host@driver#pool.

<protocol>

Protocol of the share to manage, such as nfs or cifs.

<export-path>

Share export path, nfs share such as: 10.0.0.1:/example_path, CIFS share such as: \\10.0.0.1\example_cifs_share.

-h, --help

Show this help message and exit

--name <name>

Optional share name. (default=none)

--description <description>

Optional share description. (default=none)

--share-type <share-type>

Optional share type assigned to share. (default=none)

--driver-options [<key=value> …​]

Optional driver options as key=value pairs (Default=None).

--public

Level of visibility for share. defines whether other projects are able to see it or not. Available only for microversion >= 2.8. (Default=False)

--share-server-id <share-server-id>

Share server associated with share when using a share type with "driver_handles_share_servers" extra_spec set to True. Available only for microversion >= 2.49. (Default=None)

--wait

Wait until share is adopted

-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

--noindent

Whether to disable indenting the json

--prefix PREFIX

Add a prefix to all variable names

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

-h, --help

Show this help message and exit

-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

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

When to include quotes, defaults to nonnumeric

--noindent

Whether to disable indenting the json

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

<share_protocol>

Share protocol (nfs, cifs, cephfs, glusterfs or hdfs)

<size>

Share size in gib.

-h, --help

Show this help message and exit

--name <name>

Optional share name. (default=none)

--snapshot-id <snapshot-id>

Optional snapshot id to create the share from. (Default=None)

--property <key=value>

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

--share-network <network-info>

Optional network info id or name.

--description <description>

Optional share description. (default=none)

--public <public>

Level of visibility for share. defines whether other tenants are able to see it or not. (Default = False)

--share-type <share-type>

The share type to create the share with. if not specified, unless creating from a snapshot, the default share type will be used.

--availability-zone <availability-zone>

Availability zone in which share should be created.

--share-group <share-group>

Optional share group name or id in which to create the share. (Default=None).

--wait

Wait for share creation

--scheduler-hint <key=value>

Set scheduler hints for the share as key=value pairs, possible keys are same_host, different_host.(repeat option to set multiple hints)

-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

--noindent

Whether to disable indenting the json

--prefix PREFIX

Add a prefix to all variable names

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

<share>

Share(s) to delete (name or id)

-h, --help

Show this help message and exit

--share-group <share-group>

Optional share group (name or id) which contains the share

--force

Attempt forced removal of share(s), regardless of state (defaults to False)

--wait

Wait for share deletion

--soft

Soft delete one or more shares.

<share>

Name or id of share

-h, --help

Show this help message and exit

-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

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

When to include quotes, defaults to nonnumeric

--noindent

Whether to disable indenting the json

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

<share>

Name or id of share

<export-location>

Id of the share export location

-h, --help

Show this help message and exit

-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

--noindent

Whether to disable indenting the json

--prefix PREFIX

Add a prefix to all variable names

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

-h, --help

Show this help message and exit

--name <name>

Share group name

--description <description>

Share group description.

--share-types <share-types> [<share-types> …​]

Name or id of share type(s).

--share-group-type <share-group-type>

Share group type name or id of the share group to be created.

--share-network <share-network>

Specify share network name or id

--source-share-group-snapshot <source-share-group-snapshot>

Share group snapshot name or id to create the share group from.

--availability-zone <availability-zone>

Optional availability zone in which group should be created

--wait

Wait for share group creation

-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

--noindent

Whether to disable indenting the json

--prefix PREFIX

Add a prefix to all variable names

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

<share_group>

Name or id of the share group(s) to delete

-h, --help

Show this help message and exit

--force

Attempt to force delete the share group (default=false) (Admin only).

--wait

Wait for share group to delete

-h, --help

Show this help message and exit

--all-projects

Display share groups from all projects (admin only).

--name <name>

Filter results by name.

--description <description>

Filter results by description. available only for microversion >= 2.36.

--status <status>

Filter results by status.

--share-server <share-server-id>

Filter results by share server id.

--share-group-type <share-group-type>

Filter results by a share group type id or name that was used for share group creation.

--snapshot <snapshot>

Filter results by share group snapshot name or id that was used to create the share group.

--host <host>

Filter results by host.

--share-network <share-network>

Filter results by share-network name or id.

--project <project>

Filter results by project name or id. useful with set key --all-projects.

--project-domain <project-domain>

Domain the project belongs to (name or id). this can be used in case collisions between project names exist.

--limit <limit>

Limit the number of share groups returned

--marker <marker>

The last share group id of the previous page

--sort <key>[:<direction>]

Sort output by selected keys and directions(asc or desc) (default: name:asc), multiple keys and directions can be specified separated by comma

--name~ <name~>

Filter results matching a share group name pattern. Available only for microversion >= 2.36.

--description~ <description~>

Filter results matching a share group description pattern. Available only for microversion >= 2.36.

-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

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

When to include quotes, defaults to nonnumeric

--noindent

Whether to disable indenting the json

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

<share-group>

Name or id of the share group to update.

-h, --help

Show this help message and exit

--name <name>

New name for the share group. (default=none)

--description <description>

Share group description. (default=none)

--status <status>

Explicitly update the status of a share group (admin only). Examples include: available, error, creating, deleting, error_deleting.

<share-group>

Name or id of the share group.

-h, --help

Show this help message and exit

-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

--noindent

Whether to disable indenting the json

--prefix PREFIX

Add a prefix to all variable names

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

<share-group>

Name or id of the share group.

-h, --help

Show this help message and exit

--name <name>

Optional share group snapshot name. (default=none)

--description <description>

Optional share group snapshot description. (Default=None)

--wait

Wait for share group snapshot creation

-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

--noindent

Whether to disable indenting the json

--prefix PREFIX

Add a prefix to all variable names

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

<share-group-snapshot>

Name or id of the group snapshot(s) to delete

-h, --help

Show this help message and exit

--force

Attempt to force delete the share group snapshot(s) (Default=False) (Admin only).

--wait

Wait for share group snapshot deletion

-h, --help

Show this help message and exit

--all-projects

Display information from all projects (admin only).

--name <name>

Filter results by name.

--status <status>

Filter results by status.

--share-group <share-group>

Filter results by share group name or id.

--limit <limit>

Limit the number of share groups returned

--marker <marker>

The last share group snapshot id of the previous page

--sort <key>[:<direction>]

Sort output by selected keys and directions(asc or desc) (default: name:asc), multiple keys and directions can be specified separated by comma

--detailed

Show detailed information about share group snapshot.

-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

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

When to include quotes, defaults to nonnumeric

--noindent

Whether to disable indenting the json

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

<share-group-snapshot>

Name or id of the group snapshot to list members for

-h, --help

Show this help message and exit

-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

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

When to include quotes, defaults to nonnumeric

--noindent

Whether to disable indenting the json

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

<share-group-snapshot>

Name or id of the snapshot to set a property for

-h, --help

Show this help message and exit

--name <name>

Set a name to the snapshot.

--description <description>

Set a description to the snapshot.

--status <status>

Explicitly set the state of a share group snapshot(Admin only). Options include : available, error, creating, deleting, error_deleting.

<share-group-snapshot>

Name or id of the share group snapshot to display

-h, --help

Show this help message and exit

-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

--noindent

Whether to disable indenting the json

--prefix PREFIX

Add a prefix to all variable names

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

<share-group-snapshot>

Name or id of the group snapshot to unset a property of

-h, --help

Show this help message and exit

--name

Unset share group snapshot name.

--description

Unset share group snapshot description.

<share-group-type>

Share group type name or id to allow access to.

<project>

Project name or id to add share group type access for.

-h, --help

Show this help message and exit

--project-domain <project-domain>

Domain the project belongs to (name or id). this can be used in case collisions between project names exist.

<share-group-type>

Share group type name or id to deny access from

<project>

Project name(s) or id(s) to deny share group type access for.

-h, --help

Show this help message and exit

--project-domain <project-domain>

Domain the project belongs to (name or id). this can be used in case collisions between project names exist.

<share-group-type>

Filter results by share group type name or id.

-h, --help

Show this help message and exit

-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

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

When to include quotes, defaults to nonnumeric

--noindent

Whether to disable indenting the json

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

<name>

Share group type name

<share-types>

List of share type names or ids. example: my-share- type-1 my-share-type-2

-h, --help

Show this help message and exit

--group-specs [<key=value> …​]

Share group type extra specs by key and value. OPTIONAL: Default=None. Example: --group-specs consistent_snapshot_support=host.

--public <public>

Make type accessible to the public (default true).

-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

--noindent

Whether to disable indenting the json

--prefix PREFIX

Add a prefix to all variable names

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

<share-group-types>

Name or id of the share group type(s) to delete

-h, --help

Show this help message and exit

-h, --help

Show this help message and exit

--all

Display all share group types whether public or private. Default=False. (Admin only)

--group-specs [<key=value> …​]

Filter share group types with group specs (key=value).

-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

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

When to include quotes, defaults to nonnumeric

--noindent

Whether to disable indenting the json

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

<share-group-type>

Name or id of the share group type to modify

-h, --help

Show this help message and exit

--group-specs [<key=value> …​]

Extra specs key and value of share group type that will be used for share type creation. OPTIONAL: Default=None. Example: --group-specs consistent- snapshot-support=True

<share-group-type>

Name or id of the share group type to show

-h, --help

Show this help message and exit

-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

--noindent

Whether to disable indenting the json

--prefix PREFIX

Add a prefix to all variable names

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

<share-group-type>

Name or id of the share grouptype to modify

<key>

Remove group specs from this share group type

-h, --help

Show this help message and exit

<share-group>

Name or id of the share group to set a property for.

-h, --help

Show this help message and exit

--name

Unset share group name.

--description

Unset share group description.

<instance>

Id of the share instance to delete.

-h, --help

Show this help message and exit

--wait

Wait for share instance deletion.

<instance>

Id of the share instance.

-h, --help

Show this help message and exit

-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

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

When to include quotes, defaults to nonnumeric

--noindent

Whether to disable indenting the json

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

<instance>

Name or id of the share instance

<export_location>

Id of the share instance export location.

-h, --help

Show this help message and exit

-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

--noindent

Whether to disable indenting the json

--prefix PREFIX

Add a prefix to all variable names

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

-h, --help

Show this help message and exit

--share <share>

Name or id of the share to list instances for.

--export-location <export-location>

Export location to list instances for.

-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

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

When to include quotes, defaults to nonnumeric

--noindent

Whether to disable indenting the json

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

<instance>

Instance to be modified.

-h, --help

Show this help message and exit

--status <status>

Indicate which state to assign the instance. options are: available, error, creating, deleting,error_deleting, migrating, migrating_to, server_migrating.

<instance>

Id of the share instance.

-h, --help

Show this help message and exit

-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

--noindent

Whether to disable indenting the json

--prefix PREFIX

Add a prefix to all variable names

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

-h, --help

Show this help message and exit

--absolute

Get the absolute limits for the user

--rate

Get the api rate limits for the user

-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

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

When to include quotes, defaults to nonnumeric

--noindent

Whether to disable indenting the json

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

-h, --help

Show this help message and exit

--name <share-name>

Filter shares by share name

--status <share-status>

Filter shares by status

--snapshot <share-network-id>

Filter shares by snapshot name or id.

--export-location <export-location>

Filter shares by export location id or path. available only for microversion >= 2.35

--soft-deleted

Get shares in recycle bin. if this parameter is set to True (Default=False), only shares in the recycle bin will be displayed. Available only for microversion >= 2.69.

--public

Include public shares

--share-network <share-network-name-or-id>

Filter shares exported on a given share network

--share-type <share-type-name-or-id>

Filter shares of a given share type

--share-group <share-group-name-or-id>

Filter shares belonging to a given share group

--host <share-host>

Filter shares belonging to a given host (admin only)

--share-server <share-server-id>

Filter shares exported via a given share server (admin only)

--project <project>

Filter shares by project (name or id) (admin only)

--project-domain <project-domain>

Domain the project belongs to (name or id). this can be used in case collisions between project names exist.

--user <user>

Filter results by user (name or id) (admin only)

--user-domain <user-domain>

Domain the user belongs to (name or id). this can be used in case collisions between user names exist.

--all-projects

Include all projects (admin only)

--property <key=value>

Filter shares having a given metadata key=value property (repeat option to filter by multiple properties)

--extra-spec <key=value>

Filter shares with extra specs (key=value) of the share type that they belong to. (repeat option to filter by multiple extra specs)

--long

List additional fields in output

--sort <key>[:<direction>]

Sort output by selected keys and directions(asc or desc) (default: name:asc), multiple keys and directions can be specified separated by comma

--limit <num-shares>

Maximum number of shares to display

--marker <share>

The last share id of the previous page

--name~ <name~>

Filter results matching a share name pattern. Available only for microversion >= 2.36.

--description~ <description~>

Filter results matching a share description pattern.Available only for microversion >= 2.36.

-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

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

When to include quotes, defaults to nonnumeric

--noindent

Whether to disable indenting the json

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

<message>

Id of the message(s).

-h, --help

Show this help message and exit

-h, --help

Show this help message and exit

--resource-id <resource-id>

Filters results by a resource uuid. default=none.

--resource-type <resource-type>

Filters results by a resource type. default=none. Example: "openstack message list --resource-type share"

--action-id <action-id>

Filters results by action id. default=none.

--detail-id <detail-id>

Filters results by detail id. default=none.

--request-id <request-id>

Filters results by request id. default=none.

--message-level <message-level>

Filters results by the message level. default=none. Example: "openstack message list --message-level ERROR".

--limit <limit>

Maximum number of messages to return. (default=none)

--since <since>

Return only user messages created since given date. The date format must be conforming to ISO8601. Available only for microversion >= 2.52.

--before <before>

Return only user messages created before given date. The date format must be conforming to ISO8601. Available only for microversion >= 2.52.

-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

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

When to include quotes, defaults to nonnumeric

--noindent

Whether to disable indenting the json

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

<message>

Id of the message.

-h, --help

Show this help message and exit

-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

--noindent

Whether to disable indenting the json

--prefix PREFIX

Add a prefix to all variable names

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

<share>

Name or id of share to migrate.

-h, --help

Show this help message and exit

<share>

Name or id of share to migrate.

-h, --help

Show this help message and exit

<share>

Name or id of the share to get share migration progress information.

-h, --help

Show this help message and exit

-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

--noindent

Whether to disable indenting the json

--prefix PREFIX

Add a prefix to all variable names

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

<share>

Name or id of share to migrate.

<host>

Destination host where share will be migrated to. use the format host@backend#pool.

-h, --help

Show this help message and exit

--force-host-assisted-migration <force-host-assisted-migration>

Enforces the use of the host-assisted migration approach, which bypasses driver optimizations. Default=False.

--preserve-metadata <preserve-metadata>

Enforces migration to preserve all file metadata when moving its contents. If set to True, host- assistedmigration will not be attempted.

--preserve-snapshots <preserve-snapshots>

Enforces migration of the share snapshots to the destination. If set to True, host-assisted migrationwill not be attempted.

--writable <writable>

Enforces migration to keep the share writable while contents are being moved. If set to True, host- assistedmigration will not be attempted.

--nondisruptive <nondisruptive>

Enforces migration to be nondisruptive. if set to True, host-assisted migration will not be attempted.

--new-share-network <new_share_network>

Specify the new share network for the share. do not specify this parameter if the migrating share has to beretained within its current share network.

--new-share-type <new-share-type>

Specify the new share type for the share. do not specify this parameter if the migrating share has to be retained with its current share type.

-h, --help

Show this help message and exit

--name <share-network>

Add a name to the share network (optional)

--description <description>

Add a description to the share network (optional).

--neutron-net-id <neutron-net-id>

Id of the neutron network that must be associated with the share network (Optional). The network specified will be associated with the default share network subnet, unless availability-zone is also specified.

--neutron-subnet-id <neutron-subnet-id>

Id of the neutron sub-network that must be associated with the share network (Optional). The subnet specified will be associated with the default share network subnet, unless availability-zone is also specified.

--availability-zone <availability-zone>

Name or id of the avalilability zone to assign the specified network subnet parameters to. Must be used in conjunction with neutron-net-id and neutron- subnet-id. Do not specify this parameter if the network must be available across all availability zones (default share network subnet). Available only for microversion >= 2.51.

-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

--noindent

Whether to disable indenting the json

--prefix PREFIX

Add a prefix to all variable names

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

<share-network>

Name or id of the share network(s) to delete

-h, --help

Show this help message and exit

--wait

Wait for the share network(s) to be deleted

-h, --help

Show this help message and exit

--name <share-network>

Filter share networks by name

--name~ <share-network-name-pattern>

Filter share networks by name-pattern. available only for microversion >= 2.36.

--description <share-network-description>

Filter share networks by description. available only for microversion >= 2.36

--description~ <share-network-description-pattern>

Filter share networks by description-pattern. Available only for microversion >= 2.36.

--all-projects

Include all projects (admin only)

--project <project>

Filter share networks by project (name or id) (admin only)

--project-domain <project-domain>

Domain the project belongs to (name or id). this can be used in case collisions between project names exist.

--created-since <yyyy-mm-dd>

Filter share networks by date they were created after. The date can be in the format yyyy-mm-dd.

--created-before <yyyy-mm-dd>

Filter share networks by date they were created before. The date can be in the format yyyy-mm-dd.

--security-service <security-service>

Filter share networks by the name or id of a security service attached to the network.

--neutron-net-id <neutron-net-id>

Filter share networks by the id of a neutron network.

--neutron-subnet-id <neutron-subnet-id>

Filter share networks by the id of a neutron sub network.

--network-type <network-type>

Filter share networks by the type of network. examples include "flat", "vlan", "vxlan", "geneve", etc.

--segmentation-id <segmentation-id>

Filter share networks by the segmentation id of network. Relevant only for segmented networks such as "vlan", "vxlan", "geneve", etc.

--cidr <X.X.X.X/X>

Filter share networks by the cidr of network.

--ip-version 4/6

Filter share networks by the ip version of the network, either 4 or 6.

--detail

List share networks with details

-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

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

When to include quotes, defaults to nonnumeric

--noindent

Whether to disable indenting the json

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

<share-network>

Name or id of the share network to set a property for

-h, --help

Show this help message and exit

--name <name>

Set a new name to the share network.

--description <description>

Set a new description to the share network.

--status <status>

Assign a status to the share network (admin only). Options include : active, error, network_change. Available only for microversion >= 2.63.

--neutron-net-id <neutron-net-id>

Update the neutron network associated with the default share network subnet. If a default share network subnet is not present or if the share network is in use, setting this will fail.

--neutron-subnet-id <neutron-subnet-id>

Update the neutron subnetwork associated with the default share network subnet. If a default share network subnet is not present or if the share network is in use, setting this will fail.

--current-security-service <security-service>

Name or id of a security service that is currently associated with a share network that must be replaced. Replacing a security service is only available for microversions >= 2.63.

--new-security-service <security-service>

Name or id of a security service that must be associated with the share network. When replacing a security service, the current security service must also be provided with the --current-security-service option. Replacing a security service is only available for microversions >= 2.63.

--check-only

Run a dry-run of a security service replacement. Available only for microversion >=2.63

--restart-check

Restart a dry-run of a security service replacement. Helpful when check results are stale. Available only for microversion >=2.63.

<share-network>

Name or id of the share network to display

-h, --help

Show this help message and exit

-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

--noindent

Whether to disable indenting the json

--prefix PREFIX

Add a prefix to all variable names

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

<share-network>

Share network name or id.

-h, --help

Show this help message and exit

--neutron-net-id <neutron-net-id>

Neutron network id. used to set up network for share servers (optional). Should be defined together with ' --neutron-subnet-id'.

--neutron-subnet-id <neutron-subnet-id>

Neutron subnet id. used to set up network for share servers (optional). Should be defined together with ' --neutron-net-id' to which this subnet belongs to.

--availability-zone <availability-zone>

Optional availability zone that the subnet is available within (Default=None). If None, the subnet will be considered as being available across all availability zones.

--check-only

Run a dry-run of a share network subnet create. Available only for microversion >= 2.70.

--restart-check

Restart a dry-run of a share network subnet create. Helpful when check results are stale. Available only for microversion >= 2.70.

-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

--noindent

Whether to disable indenting the json

--prefix PREFIX

Add a prefix to all variable names

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

<share-network>

Share network name or id.

<share-network-subnet>

Id(s) of share network subnet(s) to be deleted.

-h, --help

Show this help message and exit

<share-network>

Share network name or id.

<share-network-subnet>

Id of share network subnet to show.

-h, --help

Show this help message and exit

-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

--noindent

Whether to disable indenting the json

--prefix PREFIX

Add a prefix to all variable names

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