Command Reference¶
List of released CLI commands available in openstack client. These commands
can be referenced by executing openstack help share.
shares¶
share create¶
Create new share
share create
[-f {json,shell,table,value,yaml}]
[-c COLUMN]
[--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty]
[--name <name>]
[--snapshot-id <snapshot-id>]
[--property <key=value>]
[--share-network <network-info>]
[--description <description>]
[--public <public>]
[--share-type <share-type>]
[--availability-zone <availability-zone>]
[--share-group <share-group>]
[--wait]
[--scheduler-hint <key=value>]
<share_protocol>
<size>
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ 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.
-
--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)
-
share_protocol¶ Share protocol (NFS, CIFS, CephFS, GlusterFS or HDFS)
-
size¶ Share size in GiB.
share list¶
List shares
share list
[-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]
[--name <share-name>]
[--status <share-status>]
[--snapshot <share-network-id>]
[--export-location <export-location>]
[--soft-deleted]
[--public]
[--share-network <share-network-name-or-id>]
[--share-type <share-type-name-or-id>]
[--share-group <share-group-name-or-id>]
[--host <share-host>]
[--share-server <share-server-id>]
[--project <project>]
[--project-domain <project-domain>]
[--user <user>]
[--user-domain <user-domain>]
[--all-projects]
[--property <key=value>]
[--extra-spec <key=value>]
[--long]
[--sort <key>[:<direction>]]
[--limit <num-shares>]
[--marker <share>]
[--name~ <name~>]
[--description~ <description~>]
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ specify the column(s) to include, can be repeated to show multiple columns
-
--quote<QUOTE_MODE>¶ 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.
-
--sort-columnSORT_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
-
--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.
share show¶
Display share details
share show
[-f {json,shell,table,value,yaml}]
[-c COLUMN]
[--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty]
<share>
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ 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 to display (name or ID)
share delete¶
Delete a share
share delete
[--share-group <share-group>]
[--force]
[--wait]
[--soft]
<share>
[<share> ...]
-
--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¶ Share(s) to delete (name or ID)
share set¶
Set share properties
share set
[--property <key=value>]
[--name <name>]
[--description <description>]
[--public <public>]
[--status <status>]
[--task-state <task-state>]
<share>
-
--property<key=value>¶ Set a property to this share (repeat option to set multiple properties)
-
--name<name>¶ New share name. (Default=None)
-
--description<description>¶ New share description. (Default=None)
-
--public<public>¶ Level of visibility for share. Defines whether other tenants are able to see it or not.
-
--status<status>¶ Explicitly update the status of a share (Admin only). Examples include: available, error, creating, deleting, error_deleting.
-
--task-state<task-state>¶ Indicate which task state to assign the share. Options include migration_starting, migration_in_progress, migration_completing, migration_success, migration_error, migration_cancelled, migration_driver_in_progress, migration_driver_phase1_done, data_copying_starting, data_copying_in_progress, data_copying_completing, data_copying_completed, data_copying_cancelled, data_copying_error.
-
share¶ Share to modify (name or ID)
share unset¶
Unset share properties
share unset [--property <key>] [--name] [--description] <share>
-
--property<key>¶ Remove a property from share (repeat option to remove multiple properties)
-
--name¶ Unset share name.
-
--description¶ Unset share description.
-
share¶ Share to modify (name or ID)
share properties show¶
Show share properties
share properties show
[-f {json,shell,table,value,yaml}]
[-c COLUMN]
[--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty]
<share>
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ 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
share resize¶
Resize a share
share resize [--wait] [--force] <share> <new-size>
-
--wait¶ Wait for share resize
-
--force¶ Only applicable when increasing the size of the share,only available with microversion 2.64 and higher. (admin only)
-
share¶ Name or ID of share to resize
-
new-size¶ New size of share, in GiBs
share adopt¶
Adopt a share
share adopt
[-f {json,shell,table,value,yaml}]
[-c COLUMN]
[--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty]
[--name <name>]
[--description <description>]
[--share-type <share-type>]
[--driver-options [<key=value> ...]]
[--public]
[--share-server-id <share-server-id>]
[--wait]
<service-host>
<protocol>
<export-path>
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ 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.
-
--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
-
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.1example_cifs_share.
share abandon¶
Abandon a share
share abandon [--wait] <share> [<share> ...]
-
--wait¶ Wait until share is abandoned
-
share¶ Name or ID of the share(s)
share export location show¶
Show export location of a share
share export location show
[-f {json,shell,table,value,yaml}]
[-c COLUMN]
[--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty]
<share>
<export-location>
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ 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
-
export-location¶ ID of the share export location
share export location list¶
List export location of a share
share export location list
[-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]
<share>
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ specify the column(s) to include, can be repeated to show multiple columns
-
--quote<QUOTE_MODE>¶ 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.
-
--sort-columnSORT_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
-
share¶ Name or ID of share
share instances¶
share instance delete¶
Forces the deletion of a share instance
share instance delete [--wait] <instance> [<instance> ...]
-
--wait¶ Wait for share instance deletion.
-
instance¶ ID of the share instance to delete.
share instance list¶
List share instances
share instance list
[-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]
[--share <share>]
[--export-location <export-location>]
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ specify the column(s) to include, can be repeated to show multiple columns
-
--quote<QUOTE_MODE>¶ 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.
-
--sort-columnSORT_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
-
--share<share>¶ Name or ID of the share to list instances for.
-
--export-location<export-location>¶ Export location to list instances for.
share instance set¶
Explicitly reset share instance status
share instance set [--status <status>] <instance>
-
--status<status>¶ Indicate which state to assign the instance. Options are: available, error, creating, deleting,error_deleting, migrating, migrating_to, server_migrating.
-
instance¶ Instance to be modified.
share instance show¶
Show share instance
share instance show
[-f {json,shell,table,value,yaml}]
[-c COLUMN]
[--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty]
<instance>
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ 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.
-
instance¶ ID of the share instance.
share access rules¶
share access create¶
Create new share access rule
share access create
[-f {json,shell,table,value,yaml}]
[-c COLUMN]
[--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty]
[--properties [<key=value> ...]]
[--access-level <access_level>]
[--wait]
<share>
<access_type>
<access_to>
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ 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.
-
--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.
-
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.
share access delete¶
Delete a share access rule
share access delete [--wait] <share> <id>
-
--wait¶ Wait for share access rule deletion
-
share¶ Name or ID of the NAS share to modify.
-
id¶ ID of the access rule to be deleted.
share access list¶
List share access rule
share access list
[-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]
[--properties [<key=value> ...]]
<share>
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ specify the column(s) to include, can be repeated to show multiple columns
-
--quote<QUOTE_MODE>¶ 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.
-
--sort-columnSORT_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
-
--properties<key=value>¶ Filters results by properties (key=value). OPTIONAL: Default=None. Available only for API microversion >= 2.45
-
share¶ Name or ID of the share.
share access set¶
Set properties to share access rule. Available for API microversion 2.45 and higher
share access set [--property <key=value>] <access_id>
-
--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.
share access show¶
Display a share access rule. Available for API microversion 2.45 and higher
share access show
[-f {json,shell,table,value,yaml}]
[-c COLUMN]
[--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty]
<access_id>
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ 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.
share access unset¶
Unset properties of share access rule. Available for API microversion 2.45 and higher
share access unset [--property <key>] <access_id>
-
--property<key>¶ Remove property from share access rule. (Repeat option to remove multiple properties) Available only for API microversion >= 2.45.
-
access_id¶ ID of the NAS share access rule.
share migration¶
share migration start¶
Migrates share to a new host.
share migration start
[--force-host-assisted-migration <force-host-assisted-migration>]
--preserve-metadata <preserve-metadata>
--preserve-snapshots <preserve-snapshots>
--writable <writable>
--nondisruptive <nondisruptive>
[--new-share-network <new_share_network>]
[--new-share-type <new-share-type>]
<share>
<host>
-
--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.
-
share¶ Name or ID of share to migrate.
-
host¶ Destination host where share will be migrated to. Use the format ‘host@backend#pool’.
share migration cancel¶
Cancels migration of a given share when copying
share migration cancel <share>
-
share¶ Name or ID of share to migrate.
share migration complete¶
Completes migration for a given share
share migration complete <share>
-
share¶ Name or ID of share to migrate.
share migration show¶
Gets migration progress of a given share when copying
share migration show
[-f {json,shell,table,value,yaml}]
[-c COLUMN]
[--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty]
<share>
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ 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 share to get share migration progress information.
share networks¶
share network create¶
Create a share network
share network create
[-f {json,shell,table,value,yaml}]
[-c COLUMN]
[--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty]
[--name <share-network>]
[--description <description>]
[--neutron-net-id <neutron-net-id>]
[--neutron-subnet-id <neutron-subnet-id>]
[--availability-zone <availability-zone>]
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ 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.
-
--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.
share network delete¶
Delete one or more share networks
share network delete [--wait] <share-network> [<share-network> ...]
-
--wait¶ Wait for the share network(s) to be deleted
-
share-network¶ Name or ID of the share network(s) to delete
share network list¶
List share networks
share network list
[-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]
[--name <share-network>]
[--name~ <share-network-name-pattern>]
[--description <share-network-description>]
[--description~ <share-network-description-pattern>]
[--all-projects]
[--project <project>]
[--project-domain <project-domain>]
[--created-since <yyyy-mm-dd>]
[--created-before <yyyy-mm-dd>]
[--security-service <security-service>]
[--neutron-net-id <neutron-net-id>]
[--neutron-subnet-id <neutron-subnet-id>]
[--network-type <network-type>]
[--segmentation-id <segmentation-id>]
[--cidr <X.X.X.X/X>]
[--ip-version 4/6]
[--detail]
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ specify the column(s) to include, can be repeated to show multiple columns
-
--quote<QUOTE_MODE>¶ 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.
-
--sort-columnSORT_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
-
--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-version4/6¶ Filter share networks by the IP Version of the network, either 4 or 6.
-
--detail¶ List share networks with details
share network unset¶
Unset a share network property
share network unset
[--name]
[--description]
[--security-service <security-service>]
<share-network>
-
--name¶ Unset share network name.
-
--description¶ Unset share network description.
-
--security-service<security-service>¶ Disassociate a security service from the share network. This is only possible with unused share networks.
-
share-network¶ Name or ID of the share network to unset a property of
share network show¶
Show details about a share network
share network show
[-f {json,shell,table,value,yaml}]
[-c COLUMN]
[--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty]
<share-network>
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ 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 to display
share network set¶
Set share network properties
share network set
[--name <name>]
[--description <description>]
[--status <status>]
[--neutron-net-id <neutron-net-id>]
[--neutron-subnet-id <neutron-subnet-id>]
[--current-security-service <security-service>]
[--new-security-service <security-service>]
[--check-only]
[--restart-check]
<share-network>
-
--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 set a property for
share network subnets¶
share network subnet create¶
Create a share network subnet
share network subnet create
[-f {json,shell,table,value,yaml}]
[-c COLUMN]
[--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty]
[--neutron-net-id <neutron-net-id>]
[--neutron-subnet-id <neutron-subnet-id>]
[--availability-zone <availability-zone>]
[--check-only]
[--restart-check]
<share-network>
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ 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.
-
--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.
-
share-network¶ Share network name or ID.
share network subnet delete¶
Delete a share network subnet
share network subnet delete
<share-network>
<share-network-subnet>
[<share-network-subnet> ...]
-
share-network¶ Share network name or ID.
-
share-network-subnet¶ ID(s) of share network subnet(s) to be deleted.
share network subnet show¶
Show share network subnet
share network subnet show
[-f {json,shell,table,value,yaml}]
[-c COLUMN]
[--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty]
<share-network>
<share-network-subnet>
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ 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 of share network subnet to show.
share types¶
share type access create¶
Add access for share type
share type access create <share_type> <project_id>
-
share_type¶ Share type name or ID to add access to
-
project_id¶ Project ID to add share type access for
share type access delete¶
Delete access from share type
share type access delete <share_type> <project_id>
-
share_type¶ Share type name or ID to delete access from
-
project_id¶ Project ID to delete share type access for
share type access list¶
Get access list for share type
share type access list
[-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]
<share_type>
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ specify the column(s) to include, can be repeated to show multiple columns
-
--quote<QUOTE_MODE>¶ 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.
-
--sort-columnSORT_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
-
share_type¶ Share type name or ID to get access list for
share type create¶
Create new share type
share type create
[-f {json,shell,table,value,yaml}]
[-c COLUMN]
[--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty]
[--description <description>]
[--snapshot-support <snapshot_support>]
[--create-share-from-snapshot-support <create_share_from_snapshot_support>]
[--revert-to-snapshot-support <revert_to_snapshot_support>]
[--mount-snapshot-support <mount_snapshot_support>]
[--extra-specs [<key=value> ...]]
[--public <public>]
<name>
<spec_driver_handles_share_servers>
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ 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.
-
--description<description>¶ Share type description. Available only for microversion >= 2.41.
-
--snapshot-support<snapshot_support>¶ Boolean extra spec used for filtering of back ends by their capability to create share snapshots.
-
--create-share-from-snapshot-support<create_share_from_snapshot_support>¶ Boolean extra spec used for filtering of back ends by their capability to create shares from snapshots.
-
--revert-to-snapshot-support<revert_to_snapshot_support>¶ Boolean extra spec used for filtering of back ends by their capability to revert shares to snapshots. (Default is False).
-
--mount-snapshot-support<mount_snapshot_support>¶ Boolean extra spec used for filtering of back ends by their capability to mount share snapshots. (Default is False).
-
--extra-specs<key=value>¶ Extra specs key and value of share type that will be used for share type creation. OPTIONAL: Default=None. example –extra-specs thin_provisioning=’<is> True’, replication_type=readable.
-
--public<public>¶ Make type accessible to the public (default true).
-
name¶ Share type name
-
spec_driver_handles_share_servers¶ Required extra specification. Valid values are ‘true’ and ‘false’
share type delete¶
Delete a share type
share type delete <share_types> [<share_types> ...]
-
share_types¶ Name or ID of the share type(s) to delete
share type list¶
List share types
share type list
[-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]
[--all]
[--extra-specs [<key=value> ...]]
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ specify the column(s) to include, can be repeated to show multiple columns
-
--quote<QUOTE_MODE>¶ 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.
-
--sort-columnSORT_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
-
--all¶ Display all share types whatever public or private. Default=False. (Admin only)
-
--extra-specs<key=value>¶ Filter share types with extra specs (key=value). Available only for API microversion >= 2.43. OPTIONAL: Default=None.
share type set¶
Set share type properties
share type set
[--extra-specs [<key=value> ...]]
[--public <public>]
[--description <description>]
[--name <name>]
<share_type>
-
--extra-specs<key=value>¶ Extra specs key and value of share type that will be used for share type creation. OPTIONAL: Default=None. example –extra-specs thin_provisioning=’<is> True’, replication_type=readable.
-
--public<public>¶ New visibility of the share type. If set to True, share type will be available to all projects in the cloud. Available only for microversion >= 2.50
-
--description<description>¶ New description of share type. Available only for microversion >= 2.50
-
--name<name>¶ New name of share type. Available only for microversion >= 2.50
-
share_type¶ Name or ID of the share type to modify
share type show¶
Display share type details
share type show
[-f {json,shell,table,value,yaml}]
[-c COLUMN]
[--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty]
<share_type>
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ 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_type¶ Share type to display (name or ID)
share quotas¶
share quota delete¶
Delete Quota
share quota delete
[--user <user> | --share-type <share-type>]
<project>
-
--user<user>¶ Name or ID of user to delete the quotas for. Optional. Mutually exclusive with ‘–share-type’.
-
--share-type<share-type>¶ Name or ID of a share type to delete the quotas for. Optional. Mutually exclusive with ‘–user’. Available only for microversion >= 2.39
-
project¶ Name or ID of the project to delete quotas for.
share quota set¶
Set Quota for a project, or project/user or project/share-type or a class.
share quota set
[--class | --user <user> | --share-type <share-type>]
[--shares <shares>]
[--snapshots <snapshots>]
[--gigabytes <gigabytes>]
[--snapshot-gigabytes <snapshot-gigabytes>]
[--share-networks <share-networks>]
[--share-groups <share-groups>]
[--share-group-snapshots <share-group-snapshots>]
[--share-replicas <share-replicas>]
[--replica-gigabytes <replica-gigabytes>]
[--per-share-gigabytes <per-share-gigabytes>]
[--force]
<project/class>
-
--class¶ Update class quota to all projects. Mutually exclusive with ‘–user’ and ‘–share-type’.
-
--user<user>¶ Name or ID of a user to set the quotas for. Mutually exclusive with ‘–share-type’ and ‘–class’.
-
--share-type<share-type>¶ Name or ID of a share type to set the quotas for. Mutually exclusive with ‘–user’ and ‘–class’. Available only for microversion >= 2.39
-
--shares<shares>¶ New value for the “shares” quota.
-
--snapshots<snapshots>¶ New value for the “snapshots” quota.
-
--gigabytes<gigabytes>¶ New value for the “gigabytes” quota.
-
--snapshot-gigabytes<snapshot-gigabytes>¶ New value for the “snapshot-gigabytes” quota.
-
--share-networks<share-networks>¶ New value for the “share-networks” quota.
-
--share-groups<share-groups>¶ New value for the “share-groups” quota. Available only for microversion >= 2.40
-
--share-group-snapshots<share-group-snapshots>¶ New value for the “share-group-snapshots” quota. Available only for microversion >= 2.40
-
--share-replicas<share-replicas>¶ Number of share replicas. Available only for microversion >= 2.53
-
--replica-gigabytes<replica-gigabytes>¶ Capacity of share replicas in total. Available only for microversion >= 2.53
-
--per-share-gigabytes<per-share-gigabytes>¶ New value for the ‘per-share-gigabytes’ quota.Available only for microversion >= 2.62
-
--force¶ Force update the quota. Not applicable for class update.
-
project/class¶ A project (name/ID) or a class (e.g.: default).
share quota show¶
Show Quota
share quota show
[-f {json,shell,table,value,yaml}]
[-c COLUMN]
[--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty]
[--user <user> | --share-type <share-type>]
[--detail]
[--defaults]
<project>
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ 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.
-
--user<user>¶ Name or ID of user to list the quotas for. Optional. Mutually exclusive with ‘–share-type’.
-
--share-type<share-type>¶ Name or ID of a share type to list the quotas for. Optional. Mutually exclusive with ‘–user’. Available only for microversion >= 2.39
-
--detail¶ Optional flag to indicate whether to show quota in detail. Default false, available only for microversion >= 2.25.
-
--defaults¶ Show the default quotas for the project.
-
project¶ Name or ID of the project to list quotas for.
share snapshots¶
share snapshot abandon¶
Abandon share snapshot(s)
share snapshot abandon [--wait] <snapshot> [<snapshot> ...]
-
--wait¶ Wait until share snapshot is abandoned
-
snapshot¶ Name or ID of the snapshot(s) to be abandoned.
share snapshot access create¶
Allow access to a snapshot
share snapshot access create
[-f {json,shell,table,value,yaml}]
[-c COLUMN]
[--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty]
<snapshot>
<access_type>
<access_to>
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ 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.
-
snapshot¶ Name or ID of the snapshot
-
access_type¶ Access rule type (only “ip”, “user” (user or group), “cert” or “cephx” are supported).
-
access_to¶ Value that defines access.
share snapshot access delete¶
Delete access to a snapshot
share snapshot access delete <snapshot> <id> [<id> ...]
-
snapshot¶ Name or ID of the share snapshot to deny access to.
-
id¶ ID(s) of the access rule(s) to be deleted.
share snapshot access list¶
Show access list for a snapshot
share snapshot access list
[-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]
<snapshot>
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ specify the column(s) to include, can be repeated to show multiple columns
-
--quote<QUOTE_MODE>¶ 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.
-
--sort-columnSORT_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
-
snapshot¶ Name or ID of the share snapshot to show access list for.
share snapshot adopt¶
Adopt a share snapshot
share snapshot adopt
[-f {json,shell,table,value,yaml}]
[-c COLUMN]
[--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty]
[--name <name>]
[--description <description>]
[--driver-option <key=value>]
[--wait]
<share>
<provider-location>
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ 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.
-
--name<name>¶ Optional snapshot name (Default=None).
-
--description<description>¶ Optional snapshot description (Default=None).
-
--driver-option<key=value>¶ Set driver options as key=value pairs.(repeat option to set multiple key=value pairs)
-
--wait¶ Wait until share snapshot is adopted
-
share¶ Name or ID of the share that owns the snapshot to be adopted.
-
provider-location¶ Provider location of the snapshot on the backend.
share snapshot create¶
Create a snapshot of the given share
share snapshot create
[-f {json,shell,table,value,yaml}]
[-c COLUMN]
[--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty]
[--force]
[--name <name>]
[--description <description>]
[--wait]
[--property <key=value>]
<share>
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ 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.
-
--force¶ Optional flag to indicate whether to snapshot a share even if it’s busy. (Default=False)
-
--name<name>¶ Add a name to the snapshot (Optional).
-
--description<description>¶ Add a description to the snapshot (Optional).
-
--wait¶ Wait for share snapshot creation
-
--property<key=value>¶ Set a property to this snapshot (repeat option to set multiple properties).Available only for microversion >= 2.73
-
share¶ Name or ID of the share to create snapshot of
share snapshot delete¶
Delete one or more share snapshots
share snapshot delete [--force] [--wait] <snapshot> [<snapshot> ...]
-
--force¶ Delete the snapshot(s) ignoring the current state.
-
--wait¶ Wait for share snapshot deletion
-
snapshot¶ Name or ID of the snapshot(s) to delete
share snapshot export location list¶
List export locations of a given snapshot
share snapshot export location list
[-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]
<snapshot>
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ specify the column(s) to include, can be repeated to show multiple columns
-
--quote<QUOTE_MODE>¶ 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.
-
--sort-columnSORT_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
-
snapshot¶ Name or ID of the share snapshot.
share snapshot export location show¶
Show export location of the share snapshot
share snapshot export location show
[-f {json,shell,table,value,yaml}]
[-c COLUMN]
[--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty]
<snapshot>
<export-location>
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ 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.
-
snapshot¶ Name or ID of the share snapshot.
-
export-location¶ ID of the share snapshot export location.
share snapshot list¶
List snapshots
share snapshot list
[-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]
[--all-projects]
[--name <name>]
[--description <description>]
[--status <status>]
[--share <share>]
[--usage <usage>]
[--limit <num-snapshots>]
[--marker <snapshot>]
[--sort <key>[:<direction>]]
[--name~ <name~>]
[--description~ <description~>]
[--detail]
[--property <key=value>]
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ specify the column(s) to include, can be repeated to show multiple columns
-
--quote<QUOTE_MODE>¶ 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.
-
--sort-columnSORT_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
-
--all-projects¶ Display snapshots 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<share>¶ Name or ID of a share to filter results by.
-
--usage<usage>¶ Option to filter snapshots by usage.
-
--limit<num-snapshots>¶ Limit the number of snapshots returned
-
--marker<snapshot>¶ The last share 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 snapshot name pattern. Available only for microversion >= 2.36.
-
--description~<description~>¶ Filter results matching a share snapshot description pattern. Available only for microversion >= 2.36.
-
--detail¶ List share snapshots with details
-
--property<key=value>¶ Filter snapshots having a given metadata key=value property. (repeat option to filter by multiple properties)
share snapshot set¶
Set share snapshot properties
share snapshot set
[--name <name>]
[--description <description>]
[--status <status>]
[--property <key=value>]
<snapshot>
-
--name<name>¶ Set a name to the snapshot.
-
--description<description>¶ Set a description to the snapshot.
-
--status<status>¶ Assign a status to the snapshot (Admin only). Options include : available, error, creating, deleting, manage_starting, manage_error, unmanage_starting, unmanage_error, error_deleting.
-
--property<key=value>¶ Set a property to this snapshot (repeat option to set multiple properties)
-
snapshot¶ Name or ID of the snapshot to set a property for
share snapshot show¶
Show details about a share snapshot
share snapshot show
[-f {json,shell,table,value,yaml}]
[-c COLUMN]
[--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty]
<snapshot>
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ 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.
-
snapshot¶ Name or ID of the snapshot to display
share snapshot unset¶
Unset a share snapshot property
share snapshot unset
[--name]
[--description]
[--property <key>]
<snapshot>
-
--name¶ Unset snapshot name.
-
--description¶ Unset snapshot description.
-
--property<key>¶ Remove a property from snapshot (repeat option to remove multiple properties)
-
snapshot¶ Name or ID of the snapshot to set a property for
share snapshot instances¶
share snapshot instance export location list¶
List export locations from a share snapshot instance.
share snapshot instance export location list
[-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]
<instance>
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ specify the column(s) to include, can be repeated to show multiple columns
-
--quote<QUOTE_MODE>¶ 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.
-
--sort-columnSORT_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
-
instance¶ Name or ID of the share instance.
share snapshot instance export location show¶
Show export location of the share snapshot instance.
share snapshot instance export location show
[-f {json,shell,table,value,yaml}]
[-c COLUMN]
[--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty]
<snapshot_instance>
<export_location>
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ 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.
-
snapshot_instance¶ ID of the share snapshot instance.
-
export_location¶ ID of the share snapshot instance export location.
share snapshot instance list¶
List all share snapshot instances
share snapshot instance list
[-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]
[--snapshot <snapshot>]
[--detailed]
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ specify the column(s) to include, can be repeated to show multiple columns
-
--quote<QUOTE_MODE>¶ 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.
-
--sort-columnSORT_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
-
--snapshot<snapshot>¶ Filter results by share snapshot ID.
-
--detailed¶ Show detailed information about snapshot instances.
share snapshot instance set¶
Explicitly update the state of a share snapshot instance.
share snapshot instance set [--status <status>] <snapshot_instance>
-
--status<status>¶ Indicate state to update the snapshot instance to. Default is available.
-
snapshot_instance¶ ID of the share snapshot instance to update.
share snapshot instance show¶
Show details about a share snapshot instance.
share snapshot instance show
[-f {json,shell,table,value,yaml}]
[-c COLUMN]
[--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty]
<snapshot_instance>
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ 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.
-
snapshot_instance¶ ID of the share snapshot instance.
user messages¶
share message delete¶
Remove one or more messages
share message delete <message> [<message> ...]
-
message¶ ID of the message(s).
share message list¶
Lists all messages
share message list
[-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]
[--resource-id <resource-id>]
[--resource-type <resource-type>]
[--action-id <action-id>]
[--detail-id <detail-id>]
[--request-id <request-id>]
[--message-level <message-level>]
[--limit <limit>]
[--since <since>]
[--before <before>]
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ specify the column(s) to include, can be repeated to show multiple columns
-
--quote<QUOTE_MODE>¶ 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.
-
--sort-columnSORT_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
-
--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.
share message show¶
Show details about a message
share message show
[-f {json,shell,table,value,yaml}]
[-c COLUMN]
[--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty]
<message>
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ 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.
-
message¶ ID of the message.
share replicas¶
share replica create¶
Create a replica of the given share
share replica create
[-f {json,shell,table,value,yaml}]
[-c COLUMN]
[--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty]
[--availability-zone <availability-zone>]
[--wait]
[--scheduler-hint <key=value>]
[--share-network <share-network-name-or-id>]
<share>
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ 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.
-
--availability-zone<availability-zone>¶ Availability zone in which the replica should be created.
-
--wait¶ Wait for replica creation
-
--scheduler-hint<key=value>¶ Scheduler hint for the share replica as key=value pairs, Supported key is only_host. Available for microversion >= 2.67.
-
--share-network<share-network-name-or-id>¶ Optional network info ID or name. Available for microversion >= 2.72
-
share¶ Name or ID of the share to replicate.
share replica delete¶
Delete one or more share replicas
share replica delete [--force] [--wait] <replica> [<replica> ...]
-
--force¶ Attempt to force delete a replica on its backend. Using this option will purge the replica from Manila even if it is not cleaned up on the backend.
-
--wait¶ Wait for share replica deletion
-
replica¶ Name or ID of the replica(s) to delete
share replica export location list¶
List export locations of a share replica.
share replica export location list
[-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]
<replica>
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ specify the column(s) to include, can be repeated to show multiple columns
-
--quote<QUOTE_MODE>¶ 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.
-
--sort-columnSORT_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
-
replica¶ ID of the share replica.
share replica export location show¶
Show details of a share replica’s export location.
share replica export location show
[-f {json,shell,table,value,yaml}]
[-c COLUMN]
[--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty]
<replica>
<export-location>
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ 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.
-
replica¶ ID of the share replica.
-
export-location¶ ID of the share replica export location.
share replica list¶
List share replicas
share replica list
[-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]
[--share <share>]
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ specify the column(s) to include, can be repeated to show multiple columns
-
--quote<QUOTE_MODE>¶ 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.
-
--sort-columnSORT_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
-
--share<share>¶ Name or ID of the share to list replicas for.
share replica promote¶
Promote specified replica to ‘active’ replica_state.
share replica promote
[--quiesce-wait-time <quiesce-wait-time>]
<replica>
-
--quiesce-wait-time<quiesce-wait-time>¶ Quiesce wait time in seconds. Available for microversion >= 2.75
-
replica¶ ID of the share replica.
share replica resync¶
Attempt to update the share replica with its ‘active’ mirror.
share replica resync <replica>
-
replica¶ ID of the share replica to resync.
share replica set¶
Explicitly set share replica status and/or replica-state
share replica set
[--replica-state <replica-state>]
[--status <status>]
<replica>
-
--replica-state<replica-state>¶ Indicate which replica_state to assign the replica. Options include in_sync, out_of_sync, active and error.
-
--status<status>¶ Indicate which status to assign the replica. Options include available, error, creating, deleting and error_deleting.
-
replica¶ ID of the share replica to modify.
share replica show¶
Show details about a replica
share replica show
[-f {json,shell,table,value,yaml}]
[-c COLUMN]
[--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty]
<replica>
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ 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.
-
replica¶ ID of the share replica. Available only for microversion >= 2.47.
share availability zones¶
share availability zone list¶
List all availability zones
share availability zone list
[-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]
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ specify the column(s) to include, can be repeated to show multiple columns
-
--quote<QUOTE_MODE>¶ 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.
-
--sort-columnSORT_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
share services¶
share service list¶
List share services (Admin only).
share service list
[-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]
[--host <host>]
[--binary <binary>]
[--status <status>]
[--state <state>]
[--zone <zone>]
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ specify the column(s) to include, can be repeated to show multiple columns
-
--quote<QUOTE_MODE>¶ 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.
-
--sort-columnSORT_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
-
--host<host>¶ Filter services by name of the host.
-
--binary<binary>¶ Filter services by the name of the service.
-
--status<status>¶ Filter results by status.
-
--state<state>¶ Filter results by state.
-
--zone<zone>¶ Filter services by their availability zone.
share service set¶
Enable/Disable share service (Admin only).
share service set [--enable | --disable] <host> <binary>
-
--enable¶ Enable share service
-
--disable¶ Disable share service
-
host¶ Host name as ‘example_host@example_backend’.
-
binary¶ Service binary, could be ‘manila-share’, ‘manila-scheduler’ or ‘manila-data’
share security services¶
share security service create¶
Create security service used by project.
share security service create
[-f {json,shell,table,value,yaml}]
[-c COLUMN]
[--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty]
[--dns-ip <dns-ip>]
[--ou <ou>]
[--server <server>]
[--domain <domain>]
[--user <user]
[--password <password>]
[--name <name>]
[--description <description>]
<type>
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ 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.
-
--dns-ip<dns-ip>¶ DNS IP address of the security service used inside project’s network.
-
--ou<ou>¶ Security service OU (Organizational Unit). Available only for microversion >= 2.44.
-
--server<server>¶ Security service IP address or hostname.
-
--domain<domain>¶ Security service domain.
-
--user<user¶ Security service user or group used by project.
-
--password<password>¶ Password used by user.
-
--name<name>¶ Security service name.
-
--description<description>¶ Security service description.
-
type¶ Security service type. Possible options are: ‘ldap’, ‘kerberos’, ‘active_directory’.
share security service delete¶
Delete one or more security services.
share security service delete
<security-service>
[<security-service> ...]
-
security-service¶ Name or ID of the security service(s) to delete.
share security service list¶
List security services.
share security service list
[-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]
[--all-projects]
[--share-network <share-network>]
[--status <status>]
[--name <name>]
[--type <type>]
[--user <user]
[--dns-ip <dns-ip>]
[--ou <ou>]
[--server <server>]
[--domain <domain>]
[--detail]
[--limit <num-security-services>]
[--marker <security-service>]
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ specify the column(s) to include, can be repeated to show multiple columns
-
--quote<QUOTE_MODE>¶ 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.
-
--sort-columnSORT_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
-
--all-projects¶ Display information from all projects (Admin only).
-
--share-network<share-network>¶ Filter results by share network name or ID.
-
--status<status>¶ Filter results by status.
-
--name<name>¶ Filter results by security service name.
-
--type<type>¶ Filter results by security service type.
-
--user<user¶ Filter results by security service user or group used by project.
-
--dns-ip<dns-ip>¶ Filter results by DNS IP address used inside project’s network.
-
--ou<ou>¶ Filter results by security service OU (Organizational Unit). Available only for microversion >= 2.44.
-
--server<server>¶ Filter results by security service IP address or hostname.
-
--domain<domain>¶ Filter results by security service domain.
-
--detail¶ Show detailed information about filtered security services.
-
--limit<num-security-services>¶ Limit the number of security services returned
-
--marker<security-service>¶ The last security service ID of the previous page
share security service set¶
Set security service.
share security service set
[--dns-ip <dns-ip>]
[--ou <ou>]
[--server <server>]
[--domain <domain>]
[--user <user]
[--password <password>]
[--name <name>]
[--description <description>]
<security-service>
-
--dns-ip<dns-ip>¶ Set DNS IP address used inside project’s network.
-
--ou<ou>¶ Set security service OU (Organizational Unit). Available only for microversion >= 2.44.
-
--server<server>¶ Set security service IP address or hostname.
-
--domain<domain>¶ Set security service domain.
-
--user<user¶ Set security service user or group used by project.
-
--password<password>¶ Set password used by user.
-
--name<name>¶ Set security service name.
-
--description<description>¶ Set security service description.
-
security-service¶ Security service name or ID.
share security service show¶
Show security service.
share security service show
[-f {json,shell,table,value,yaml}]
[-c COLUMN]
[--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty]
<security-service>
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ 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.
-
security-service¶ Security service name or ID to show.
share security service unset¶
Unset security service.
share security service unset
[--dns-ip]
[--ou]
[--server]
[--domain]
[--user]
[--password]
[--name]
[--description]
<security-service>
-
--dns-ip¶ Unset DNS IP address used inside project’s network.
-
--ou¶ Unset security service OU (Organizational Unit). Available only for microversion >= 2.44.
-
--server¶ Unset security service IP address or hostname.
-
--domain¶ Unset security service domain.
-
--user¶ Unset security service user or group used by project.
-
--password¶ Unset password used by user.
-
--name¶ Unset security service name.
-
--description¶ Unset security service description.
-
security-service¶ Security service name or ID.
share pools¶
share pool list¶
List all backend storage pools known to the scheduler (Admin only).
share pool list
[-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]
[--host <host>]
[--backend <backend>]
[--pool <pool>]
[--detail]
[--share-type <share-type>]
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ specify the column(s) to include, can be repeated to show multiple columns
-
--quote<QUOTE_MODE>¶ 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.
-
--sort-columnSORT_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
-
--host<host>¶ Filter results by host name. Regular expressions are supported.
-
--backend<backend>¶ Filter results by backend name. Regular expressions are supported.
-
--pool<pool>¶ Filter results by pool name. Regular expressions are supported.
-
--detail¶ Show detailed information about pools.
-
--share-type<share-type>¶ Filter results by share type name or ID. Available only for microversion >= 2.23
share limits¶
share limits show¶
Show a list of share limits for a user.
share limits show
[-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]
(--absolute | --rate)
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ specify the column(s) to include, can be repeated to show multiple columns
-
--quote<QUOTE_MODE>¶ 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.
-
--sort-columnSORT_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
-
--absolute¶ Get the absolute limits for the user
-
--rate¶ Get the API rate limits for the user
share instance export location¶
share instance export location list¶
List share instance export locations
share instance export location list
[-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]
<instance>
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ specify the column(s) to include, can be repeated to show multiple columns
-
--quote<QUOTE_MODE>¶ 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.
-
--sort-columnSORT_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
-
instance¶ ID of the share instance.
share instance export location show¶
Show export location for a share instance.
share instance export location show
[-f {json,shell,table,value,yaml}]
[-c COLUMN]
[--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty]
<instance>
<export_location>
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ 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.
-
instance¶ Name or ID of the share instance
-
export_location¶ ID of the share instance export location.
share groups¶
share group create¶
Create new share group
share group create
[-f {json,shell,table,value,yaml}]
[-c COLUMN]
[--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty]
[--name <name>]
[--description <description>]
[--share-types <share-types> [<share-types> ...]]
[--share-group-type <share-group-type>]
[--share-network <share-network>]
[--source-share-group-snapshot <source-share-group-snapshot>]
[--availability-zone <availability-zone>]
[--wait]
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ 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.
-
--name<name>¶ Share group name
-
--description<description>¶ Share group description.
-
--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
share group delete¶
Delete one or more share groups
share group delete [--force] [--wait] <share_group> [<share_group> ...]
-
--force¶ Attempt to force delete the share group (Default=False) (Admin only).
-
--wait¶ Wait for share group to delete
-
share_group¶ Name or ID of the share group(s) to delete
share group list¶
List share groups
share group list
[-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]
[--all-projects]
[--name <name>]
[--description <description>]
[--status <status>]
[--share-server <share-server-id>]
[--share-group-type <share-group-type>]
[--snapshot <snapshot>]
[--host <host>]
[--share-network <share-network>]
[--project <project>]
[--project-domain <project-domain>]
[--limit <limit>]
[--marker <marker>]
[--sort <key>[:<direction>]]
[--name~ <name~>]
[--description~ <description~>]
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ specify the column(s) to include, can be repeated to show multiple columns
-
--quote<QUOTE_MODE>¶ 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.
-
--sort-columnSORT_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
-
--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.
share group unset¶
Unset a share group property
share group unset [--name] [--description] <share-group>
-
--name¶ Unset share group name.
-
--description¶ Unset share group description.
-
share-group¶ Name or ID of the share group to set a property for.
share group set¶
Explicitly set share group status
share group set
[--name <name>]
[--description <description>]
[--status <status>]
<share-group>
-
--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 to update.
share group types¶
share group type access create¶
Allow a project to access a share group type (Admin only).
share group type access create
[--project-domain <project-domain>]
<share-group-type>
<project>
[<project> ...]
-
--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 allow access to.
-
project¶ Project Name or ID to add share group type access for.
share group type access delete¶
Deny a project to access a share group type (Admin only).
share group type access delete
[--project-domain <project-domain>]
<share-group-type>
<project>
[<project> ...]
-
--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.
share group type access list¶
Get access list for share group type (Admin only).
share group type access list
[-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]
<share-group-type>
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ specify the column(s) to include, can be repeated to show multiple columns
-
--quote<QUOTE_MODE>¶ 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.
-
--sort-columnSORT_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
-
share-group-type¶ Filter results by share group type name or ID.
share group type create¶
Create new share group type
share group type create
[-f {json,shell,table,value,yaml}]
[-c COLUMN]
[--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty]
[--group-specs [<key=value> ...]]
[--public <public>]
<name>
<share-types>
[<share-types> ...]
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ 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.
-
--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).
-
name¶ Share group type name
-
share-types¶ List of share type names or IDs. Example: my-share-type-1 my-share-type-2
share group type delete¶
Delete a share group type
share group type delete <share-group-types> [<share-group-types> ...]
-
share-group-types¶ Name or ID of the share group type(s) to delete
share group type list¶
List share types
share group type list
[-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]
[--all]
[--group-specs [<key=value> ...]]
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ specify the column(s) to include, can be repeated to show multiple columns
-
--quote<QUOTE_MODE>¶ 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.
-
--sort-columnSORT_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
-
--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).
share group type set¶
Set share group type properties
share group type set
[--group-specs [<key=value> ...]]
<share-group-type>
-
--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 modify
share group type show¶
Show share group types
share group type show
[-f {json,shell,table,value,yaml}]
[-c COLUMN]
[--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty]
<share-group-type>
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ 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 group type to show
share group snapshots¶
share group snapshot create¶
Create a share group snapshot of the given share group
share group snapshot create [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--name <name>] [--description <description>] [--wait] <share-group>
-f<FORMATTER>,--format<FORMATTER>¶the output format, defaults to table
-cCOLUMN,--columnCOLUMN¶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.
--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
share-group¶Name or ID of the share group.
share group snapshot delete¶
Delete one or more share group snapshot
share group snapshot delete [--force] [--wait] <share-group-snapshot> [<share-group-snapshot> ...]
--force¶Attempt to force delete the share group snapshot(s) (Default=False) (Admin only).
--wait¶Wait for share group snapshot deletion
share-group-snapshot¶Name or ID of the group snapshot(s) to delete
share group snapshot list¶
List share group snapshots
share group snapshot list [-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] [--all-projects] [--name <name>] [--status <status>] [--share-group <share-group>] [--limit <limit>] [--marker <marker>] [--sort <key>[:<direction>]] [--detailed]
-f<FORMATTER>,--format<FORMATTER>¶the output format, defaults to table
-cCOLUMN,--columnCOLUMN¶specify the column(s) to include, can be repeated to show multiple columns
--quote<QUOTE_MODE>¶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.
--sort-columnSORT_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
--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.
share group snapshot members list¶
List members of share group snapshot
share group snapshot members list [-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] <share-group-snapshot>
-f<FORMATTER>,--format<FORMATTER>¶the output format, defaults to table
-cCOLUMN,--columnCOLUMN¶specify the column(s) to include, can be repeated to show multiple columns
--quote<QUOTE_MODE>¶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.
--sort-columnSORT_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
share-group-snapshot¶Name or ID of the group snapshot to list members for
share group snapshot set¶
Set share group snapshot properties
share group snapshot set [--name <name>] [--description <description>] [--status <status>] <share-group-snapshot>
--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 snapshot to set a property for
share group snapshot show¶
Show details about a share group snapshot
share group snapshot show [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <share-group-snapshot>
-f<FORMATTER>,--format<FORMATTER>¶the output format, defaults to table
-cCOLUMN,--columnCOLUMN¶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 share group snapshot to display
share group snapshot unset¶
Unset a share group snapshot property
share group snapshot unset [--name] [--description] <share-group-snapshot>
--name¶Unset share group snapshot name.
--description¶Unset share group snapshot description.
share-group-snapshot¶Name or ID of the group snapshot to unset a property of
share servers¶
share server abandon¶
Remove one or more share server(s) (Admin only).
share server abandon
[--force]
[--wait]
<share-server>
[<share-server> ...]
-
--force¶ Enforces the unmanage share server operation, even if the backend driver does not support it.
-
--wait¶ Wait until share server is abandoned
-
share-server¶ ID of the server(s) to be abandoned.
share server adopt¶
Adopt share server not handled by Manila (Admin only).
share server adopt
[-f {json,shell,table,value,yaml}]
[-c COLUMN]
[--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty]
[--driver-options <key=value>]
[--share-network-subnet <share-network-subnet>]
[--wait]
<host>
<share-network>
<identifier>
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ 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.
-
--driver-options<key=value>¶ One or more driver-specific key=value pairs that may be necessary to manage the share server (Optional, Default=None).
-
--share-network-subnet<share-network-subnet>¶ Share network subnet where share server has network allocations in.The default subnet will be used if it’s not specified. Available for microversion >= 2.51 (Optional, Default=None).
-
--wait¶ Wait until share server is adopted
-
host¶ Backend name as “<node_hostname>@<backend_name>”.
-
share-network¶ Share network where share server has network allocations in.
-
identifier¶ A driver-specific share server identifier required by the driver to manage the share server.
share server delete¶
Delete one or more share servers
share server delete [--wait] <share-server> [<share-server> ...]
-
--wait¶ Wait for share server deletion.
-
share-server¶ ID(s) of the server(s) to delete
share server list¶
List all share servers (Admin only).
share server list
[-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]
[--host <hostname>]
[--status <status>]
[--share-network <share-network>]
[--project <project>]
[--share-network-subnet <share-network-subnet>]
[--project-domain <project-domain>]
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ specify the column(s) to include, can be repeated to show multiple columns
-
--quote<QUOTE_MODE>¶ 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.
-
--sort-columnSORT_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
-
--host<hostname>¶ Filter results by name of host.
-
--status<status>¶ Filter results by status.
-
--share-network<share-network>¶ Filter results by share network name or ID.
-
--project<project>¶ Filter results by project name or ID.
-
--share-network-subnet<share-network-subnet>¶ Filter results by share network subnet that the share server’s network allocation exists within. Available for microversion >= 2.51 (Optional, Default=None)
-
--project-domain<project-domain>¶ Domain the project belongs to (name or ID). This can be used in case collisions between project names exist.
share server migration cancel¶
Cancels migration of a given share server when copying
share server migration cancel <share_server>
-
share_server¶ ID of share server to cancel migration.
share server migration complete¶
Completes migration for a given share server
share server migration complete <share_server>
-
share_server¶ ID of share server to complete migration.
share server migration show¶
Gets migration progress of a given share server when copying
share server migration show
[-f {json,shell,table,value,yaml}]
[-c COLUMN]
[--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty]
<share_server>
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ 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_server¶ ID of share server to show migration progress for.
share server migration start¶
Migrates share server to a new host.
share server migration start
[-f {json,shell,table,value,yaml}]
[-c COLUMN]
[--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty]
--preserve-snapshots <True
|False>
--writable <True
|False>
--nondisruptive <True
|False>
[--new-share-network <new_share_network>]
[--check-only]
<share_server>
<host@backend>
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ 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.
-
--preserve-snapshots<True|False>¶ Set to True if snapshots must be preserved at the migration destination.
-
--writable<True|False>¶ Enforces migration to keep all its shares writable while contents are being moved.
-
--nondisruptive<True|False>¶ Enforces migration to be nondisruptive.
-
--new-share-network<new_share_network>¶ Specify a new share network for the share server. Do not specify this parameter if the migrating share server has to be retained within its current share network.
-
--check-only¶ Run a dry-run of the share server migration.
-
share_server¶ ID of share server to start migration.
-
host@backend¶ Destination to migrate the share server to. Use the format ‘<node_hostname>@<backend_name>’.
share server set¶
Set share server properties (Admin only).
share server set
[--status <status>]
[--task-state <task-state>]
<share-server>
-
--status<status>¶ Assign a status to the share server. Options include: unmanage_starting, server_migrating_to, error, unmanage_error, manage_error, inactive, active, server_migrating, manage_starting, deleting, network_change. If no state is provided, active will be used.
-
--task-state<task-state>¶ Indicate which task state to assign the share server. Options include migration_starting, migration_in_progress, migration_completing, migration_success, migration_error, migration_cancelled, migration_driver_in_progress, migration_driver_phase1_done, data_copying_starting, data_copying_in_progress, data_copying_completing, data_copying_completed, data_copying_cancelled, data_copying_error.
-
share-server¶ ID of the share server to modify.
share server show¶
Show details about a share server (Admin only).
share server show
[-f {json,shell,table,value,yaml}]
[-c COLUMN]
[--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty]
<share-server>
-
-f<FORMATTER>,--format<FORMATTER>¶ the output format, defaults to table
-
-cCOLUMN,--columnCOLUMN¶ 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-server¶ ID of share server.