Command Reference¶
List of released CLI commands available in openstack client. These commands
can be referenced by executing openstack help share.
shares¶
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.
This command is provided by the python-manilaclient plugin.
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
- -c COLUMN, --column COLUMN¶
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-column SORT_COLUMN¶
specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated
- --sort-ascending¶
sort the column(s) in ascending order
- --sort-descending¶
sort the column(s) in descending order
- --share <share>¶
Name or ID of the share to list instances for.
- --export-location <export-location>¶
Export location to list instances for.
This command is provided by the python-manilaclient plugin.
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.
This command is provided by the python-manilaclient plugin.
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
- -c COLUMN, --column COLUMN¶
specify the column(s) to include, can be repeated to show multiple columns
- --noindent¶
whether to disable indenting the JSON
- --prefix <PREFIX>¶
add a prefix to all variable names
- --max-width <integer>¶
Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.
- --fit-width¶
Fit the table to the display width. Implied if –max-width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable
- --print-empty¶
Print empty table if there is no data to show.
- instance¶
ID of the share instance.
This command is provided by the python-manilaclient plugin.
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]
[--lock-visibility]
[--lock-deletion]
[--lock-reason <lock_reason>]
<share>
<access_type>
<access_to>
- -f <FORMATTER>, --format <FORMATTER>¶
the output format, defaults to table
- -c COLUMN, --column COLUMN¶
specify the column(s) to include, can be repeated to show multiple columns
- --noindent¶
whether to disable indenting the JSON
- --prefix <PREFIX>¶
add a prefix to all variable names
- --max-width <integer>¶
Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.
- --fit-width¶
Fit the table to the display width. Implied if –max-width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable
- --print-empty¶
Print empty table if there is no data to show.
- --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.
- --lock-visibility¶
Whether the sensitive fields of the access rule redacted to other users. Only available with API version >= 2.82.
- --lock-deletion¶
When enabled, a ‘delete’ lock will be placed against the rule and the rule cannot be deleted while the lock exists. Only available with API version >= 2.82.
- --lock-reason <lock_reason>¶
Reason for locking the access rule. Should only be provided alongside a deletion or visibility lock. Only available with API version >= 2.82.
- 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.
This command is provided by the python-manilaclient plugin.
share access delete¶
Delete a share access rule
share access delete [--wait] [--unrestrict] <share> <id>
- --wait¶
Wait for share access rule deletion
- --unrestrict¶
Seek access rule deletion despite restrictions. Only available with API version >= 2.82.
- share¶
Name or ID of the NAS share to modify.
- id¶
ID of the access rule to be deleted.
This command is provided by the python-manilaclient plugin.
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> ...]]
[--access-type <access_type>]
[--access-key <access_key>]
[--access-to <access_to>]
[--access-level <access_level>]
<share>
- -f <FORMATTER>, --format <FORMATTER>¶
the output format, defaults to table
- -c COLUMN, --column COLUMN¶
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-column SORT_COLUMN¶
specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated
- --sort-ascending¶
sort the column(s) in ascending order
- --sort-descending¶
sort the column(s) in descending order
- --properties <key=value>¶
Filters results by properties (key=value). OPTIONAL: Default=None. Available only for API microversion >= 2.45
- --access-type <access_type>¶
Filter access rules by the access type.
- --access-key <access_key>¶
Filter access rules by the access key.
- --access-to <access_to>¶
Filter access rules by the access to field.
- --access-level <access_level>¶
Filter access rules by the access level.
- share¶
Name or ID of the share.
This command is provided by the python-manilaclient plugin.
share access set¶
Set properties to share access rule. Available for API microversion 2.45 and higher
share access set
[--property <key=value>]
[--access-level <access_level>]
<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-level <access_level>¶
Share access level (“rw” and “ro” access levels are supported) to set.
- access_id¶
ID of the NAS share access rule.
This command is provided by the python-manilaclient plugin.
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
- -c COLUMN, --column COLUMN¶
specify the column(s) to include, can be repeated to show multiple columns
- --noindent¶
whether to disable indenting the JSON
- --prefix <PREFIX>¶
add a prefix to all variable names
- --max-width <integer>¶
Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.
- --fit-width¶
Fit the table to the display width. Implied if –max-width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable
- --print-empty¶
Print empty table if there is no data to show.
- access_id¶
ID of the NAS share access rule.
This command is provided by the python-manilaclient plugin.
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.
This command is provided by the python-manilaclient plugin.
share migration¶
share networks¶
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]
[--property <key=value>]
<share-network>
- -f <FORMATTER>, --format <FORMATTER>¶
the output format, defaults to table
- -c COLUMN, --column COLUMN¶
specify the column(s) to include, can be repeated to show multiple columns
- --noindent¶
whether to disable indenting the JSON
- --prefix <PREFIX>¶
add a prefix to all variable names
- --max-width <integer>¶
Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.
- --fit-width¶
Fit the table to the display width. Implied if –max-width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable
- --print-empty¶
Print empty table if there is no data to show.
- --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.
- --property <key=value>¶
Set a property to this share network subnet (repeat option to set multiple properties). Available only for microversion >= 2.78.
- share-network¶
Share network name or ID.
This command is provided by the python-manilaclient plugin.
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.
This command is provided by the python-manilaclient plugin.
share network subnet set¶
Set share network subnet properties
share network subnet set
[--property <key=value>]
<share-network>
<share-network-subnet>
- --property <key=value>¶
Set a property to this share network subnet (repeat option to set multiple properties). Available only for microversion >= 2.78.
- share-network¶
Share network name or ID.
- share-network-subnet¶
ID of share network subnet to set a property.
This command is provided by the python-manilaclient plugin.
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
- -c COLUMN, --column COLUMN¶
specify the column(s) to include, can be repeated to show multiple columns
- --noindent¶
whether to disable indenting the JSON
- --prefix <PREFIX>¶
add a prefix to all variable names
- --max-width <integer>¶
Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.
- --fit-width¶
Fit the table to the display width. Implied if –max-width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable
- --print-empty¶
Print empty table if there is no data to show.
- share-network¶
Share network name or ID.
- share-network-subnet¶
ID of share network subnet to show.
This command is provided by the python-manilaclient plugin.
share network subnet unset¶
Unset a share network subnet property
share network subnet unset
[--property <key>]
<share-network>
<share-network-subnet>
- --property <key>¶
Remove a property from share network subnet (repeat option to remove multiple properties). Available only for microversion >= 2.78.
- share-network¶
Share network name or ID.
- share-network-subnet¶
ID of share network subnet to set a property.
This command is provided by the python-manilaclient plugin.
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
This command is provided by the python-manilaclient plugin.
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
This command is provided by the python-manilaclient plugin.
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
- -c COLUMN, --column COLUMN¶
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-column SORT_COLUMN¶
specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated
- --sort-ascending¶
sort the column(s) in ascending order
- --sort-descending¶
sort the column(s) in descending order
- share_type¶
Share type name or ID to get access list for
This command is provided by the python-manilaclient plugin.
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
- -c COLUMN, --column COLUMN¶
specify the column(s) to include, can be repeated to show multiple columns
- --noindent¶
whether to disable indenting the JSON
- --prefix <PREFIX>¶
add a prefix to all variable names
- --max-width <integer>¶
Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.
- --fit-width¶
Fit the table to the display width. Implied if –max-width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable
- --print-empty¶
Print empty table if there is no data to show.
- --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’
This command is provided by the python-manilaclient plugin.
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
This command is provided by the python-manilaclient plugin.
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
- -c COLUMN, --column COLUMN¶
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-column SORT_COLUMN¶
specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated
- --sort-ascending¶
sort the column(s) in ascending order
- --sort-descending¶
sort the column(s) in descending order
- --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.
This command is provided by the python-manilaclient plugin.
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
This command is provided by the python-manilaclient plugin.
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
- -c COLUMN, --column COLUMN¶
specify the column(s) to include, can be repeated to show multiple columns
- --noindent¶
whether to disable indenting the JSON
- --prefix <PREFIX>¶
add a prefix to all variable names
- --max-width <integer>¶
Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.
- --fit-width¶
Fit the table to the display width. Implied if –max-width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable
- --print-empty¶
Print empty table if there is no data to show.
- share_type¶
Share type to display (name or ID)
This command is provided by the python-manilaclient plugin.
share type unset¶
Unset share type extra specs
share type unset <share_type> <key> [<key> ...]
- share_type¶
Name or ID of the share type to modify
- key¶
Remove extra_specs from this share type
This command is provided by the python-manilaclient plugin.
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.
This command is provided by the python-manilaclient plugin.
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>]
[--encryption-keys <encryption-keys>]
[--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
- --encryption-keys <encryption-keys>¶
New value for the “encryption-keys” quota. Available only for microversion >= 2.90
- --force¶
Force update the quota. Not applicable for class update.
- project/class¶
A project (name/ID) or a class (e.g.: default).
This command is provided by the python-manilaclient plugin.
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
- -c COLUMN, --column COLUMN¶
specify the column(s) to include, can be repeated to show multiple columns
- --noindent¶
whether to disable indenting the JSON
- --prefix <PREFIX>¶
add a prefix to all variable names
- --max-width <integer>¶
Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.
- --fit-width¶
Fit the table to the display width. Implied if –max-width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable
- --print-empty¶
Print empty table if there is no data to show.
- --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.
This command is provided by the python-manilaclient plugin.
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.
This command is provided by the python-manilaclient plugin.
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
- -c COLUMN, --column COLUMN¶
specify the column(s) to include, can be repeated to show multiple columns
- --noindent¶
whether to disable indenting the JSON
- --prefix <PREFIX>¶
add a prefix to all variable names
- --max-width <integer>¶
Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.
- --fit-width¶
Fit the table to the display width. Implied if –max-width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable
- --print-empty¶
Print empty table if there is no data to show.
- 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.
This command is provided by the python-manilaclient plugin.
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.
This command is provided by the python-manilaclient plugin.
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
- -c COLUMN, --column COLUMN¶
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-column SORT_COLUMN¶
specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated
- --sort-ascending¶
sort the column(s) in ascending order
- --sort-descending¶
sort the column(s) in descending order
- snapshot¶
Name or ID of the share snapshot to show access list for.
This command is provided by the python-manilaclient plugin.
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
- -c COLUMN, --column COLUMN¶
specify the column(s) to include, can be repeated to show multiple columns
- --noindent¶
whether to disable indenting the JSON
- --prefix <PREFIX>¶
add a prefix to all variable names
- --max-width <integer>¶
Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.
- --fit-width¶
Fit the table to the display width. Implied if –max-width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable
- --print-empty¶
Print empty table if there is no data to show.
- --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.
This command is provided by the python-manilaclient plugin.
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
- -c COLUMN, --column COLUMN¶
specify the column(s) to include, can be repeated to show multiple columns
- --noindent¶
whether to disable indenting the JSON
- --prefix <PREFIX>¶
add a prefix to all variable names
- --max-width <integer>¶
Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.
- --fit-width¶
Fit the table to the display width. Implied if –max-width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable
- --print-empty¶
Print empty table if there is no data to show.
- --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
This command is provided by the python-manilaclient plugin.
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
This command is provided by the python-manilaclient plugin.
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
- -c COLUMN, --column COLUMN¶
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-column SORT_COLUMN¶
specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated
- --sort-ascending¶
sort the column(s) in ascending order
- --sort-descending¶
sort the column(s) in descending order
- snapshot¶
Name or ID of the share snapshot.
This command is provided by the python-manilaclient plugin.
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
- -c COLUMN, --column COLUMN¶
specify the column(s) to include, can be repeated to show multiple columns
- --noindent¶
whether to disable indenting the JSON
- --prefix <PREFIX>¶
add a prefix to all variable names
- --max-width <integer>¶
Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.
- --fit-width¶
Fit the table to the display width. Implied if –max-width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable
- --print-empty¶
Print empty table if there is no data to show.
- snapshot¶
Name or ID of the share snapshot.
- export-location¶
ID of the share snapshot export location.
This command is provided by the python-manilaclient plugin.
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>]
[--count]
- -f <FORMATTER>, --format <FORMATTER>¶
the output format, defaults to table
- -c COLUMN, --column COLUMN¶
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-column SORT_COLUMN¶
specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated
- --sort-ascending¶
sort the column(s) in ascending order
- --sort-descending¶
sort the column(s) in descending order
- --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)
- --count¶
The total count of share snapshots before pagination is applied. This parameter is useful when applying pagination parameters ‘–limit’ and ‘–offset’. Available only for microversion >= 2.79.
This command is provided by the python-manilaclient plugin.
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
This command is provided by the python-manilaclient plugin.
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
- -c COLUMN, --column COLUMN¶
specify the column(s) to include, can be repeated to show multiple columns
- --noindent¶
whether to disable indenting the JSON
- --prefix <PREFIX>¶
add a prefix to all variable names
- --max-width <integer>¶
Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.
- --fit-width¶
Fit the table to the display width. Implied if –max-width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable
- --print-empty¶
Print empty table if there is no data to show.
- snapshot¶
Name or ID of the snapshot to display
This command is provided by the python-manilaclient plugin.
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
This command is provided by the python-manilaclient plugin.
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
- -c COLUMN, --column COLUMN¶
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-column SORT_COLUMN¶
specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated
- --sort-ascending¶
sort the column(s) in ascending order
- --sort-descending¶
sort the column(s) in descending order
- instance¶
Name or ID of the share instance.
This command is provided by the python-manilaclient plugin.
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
- -c COLUMN, --column COLUMN¶
specify the column(s) to include, can be repeated to show multiple columns
- --noindent¶
whether to disable indenting the JSON
- --prefix <PREFIX>¶
add a prefix to all variable names
- --max-width <integer>¶
Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.
- --fit-width¶
Fit the table to the display width. Implied if –max-width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable
- --print-empty¶
Print empty table if there is no data to show.
- snapshot_instance¶
ID of the share snapshot instance.
- export_location¶
ID of the share snapshot instance export location.
This command is provided by the python-manilaclient plugin.
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
- -c COLUMN, --column COLUMN¶
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-column SORT_COLUMN¶
specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated
- --sort-ascending¶
sort the column(s) in ascending order
- --sort-descending¶
sort the column(s) in descending order
- --snapshot <snapshot>¶
Filter results by share snapshot ID.
- --detailed¶
Show detailed information about snapshot instances.
This command is provided by the python-manilaclient plugin.
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.
This command is provided by the python-manilaclient plugin.
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
- -c COLUMN, --column COLUMN¶
specify the column(s) to include, can be repeated to show multiple columns
- --noindent¶
whether to disable indenting the JSON
- --prefix <PREFIX>¶
add a prefix to all variable names
- --max-width <integer>¶
Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.
- --fit-width¶
Fit the table to the display width. Implied if –max-width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable
- --print-empty¶
Print empty table if there is no data to show.
- snapshot_instance¶
ID of the share snapshot instance.
This command is provided by the python-manilaclient plugin.
user messages¶
share message delete¶
Remove one or more messages
share message delete <message> [<message> ...]
- message¶
ID of the message(s).
This command is provided by the python-manilaclient plugin.
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
- -c COLUMN, --column COLUMN¶
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-column SORT_COLUMN¶
specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated
- --sort-ascending¶
sort the column(s) in ascending order
- --sort-descending¶
sort the column(s) in descending order
- --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.
This command is provided by the python-manilaclient plugin.
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
- -c COLUMN, --column COLUMN¶
specify the column(s) to include, can be repeated to show multiple columns
- --noindent¶
whether to disable indenting the JSON
- --prefix <PREFIX>¶
add a prefix to all variable names
- --max-width <integer>¶
Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.
- --fit-width¶
Fit the table to the display width. Implied if –max-width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable
- --print-empty¶
Print empty table if there is no data to show.
- message¶
ID of the message.
This command is provided by the python-manilaclient plugin.
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>]
[--property <key=value>]
<share>
- -f <FORMATTER>, --format <FORMATTER>¶
the output format, defaults to table
- -c COLUMN, --column COLUMN¶
specify the column(s) to include, can be repeated to show multiple columns
- --noindent¶
whether to disable indenting the JSON
- --prefix <PREFIX>¶
add a prefix to all variable names
- --max-width <integer>¶
Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.
- --fit-width¶
Fit the table to the display width. Implied if –max-width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable
- --print-empty¶
Print empty table if there is no data to show.
- --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
- --property <key=value>¶
Set a property to this replica (repeat option to set multiple properties). Available only for microversion >= 2.95
- share¶
Name or ID of the share to replicate.
This command is provided by the python-manilaclient plugin.
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
This command is provided by the python-manilaclient plugin.
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
- -c COLUMN, --column COLUMN¶
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-column SORT_COLUMN¶
specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated
- --sort-ascending¶
sort the column(s) in ascending order
- --sort-descending¶
sort the column(s) in descending order
- replica¶
ID of the share replica.
This command is provided by the python-manilaclient plugin.
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
- -c COLUMN, --column COLUMN¶
specify the column(s) to include, can be repeated to show multiple columns
- --noindent¶
whether to disable indenting the JSON
- --prefix <PREFIX>¶
add a prefix to all variable names
- --max-width <integer>¶
Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.
- --fit-width¶
Fit the table to the display width. Implied if –max-width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable
- --print-empty¶
Print empty table if there is no data to show.
- replica¶
ID of the share replica.
- export-location¶
ID of the share replica export location.
This command is provided by the python-manilaclient plugin.
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>]
[--property <key=value>]
- -f <FORMATTER>, --format <FORMATTER>¶
the output format, defaults to table
- -c COLUMN, --column COLUMN¶
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-column SORT_COLUMN¶
specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated
- --sort-ascending¶
sort the column(s) in ascending order
- --sort-descending¶
sort the column(s) in descending order
- --share <share>¶
Name or ID of the share to list replicas for.
- --property <key=value>¶
Filter replicas having a given metadata key=value property. (repeat option to filter by multiple properties)
This command is provided by the python-manilaclient plugin.
share replica promote¶
Promote specified replica to ‘active’ replica_state.
share replica promote
[--quiesce-wait-time <quiesce-wait-time>]
[--wait]
<replica>
- --quiesce-wait-time <quiesce-wait-time>¶
Quiesce wait time in seconds. Available for microversion >= 2.75
- --wait¶
Wait for share replica promotion
- replica¶
ID of the share replica.
This command is provided by the python-manilaclient plugin.
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.
This command is provided by the python-manilaclient plugin.
share replica set¶
Explicitly set share replica status and/or replica-state and/or property
share replica set
[--replica-state <replica-state>]
[--status <status>]
[--property <key=value>]
<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.
- --property <key=value>¶
Set a property to this replica (repeat option to set multiple properties). Available only for microversion >= 2.95
- replica¶
ID of the share replica to modify.
This command is provided by the python-manilaclient plugin.
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
- -c COLUMN, --column COLUMN¶
specify the column(s) to include, can be repeated to show multiple columns
- --noindent¶
whether to disable indenting the JSON
- --prefix <PREFIX>¶
add a prefix to all variable names
- --max-width <integer>¶
Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.
- --fit-width¶
Fit the table to the display width. Implied if –max-width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable
- --print-empty¶
Print empty table if there is no data to show.
- replica¶
ID of the share replica. Available only for microversion >= 2.47.
This command is provided by the python-manilaclient plugin.
share replica unset¶
Unset a share replica property
share replica unset [--property <key>] <replica>
- --property <key>¶
Remove a property from replica (repeat option to remove multiple properties)
- replica¶
ID of the share replica to unset property from
This command is provided by the python-manilaclient plugin.
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
- -c COLUMN, --column COLUMN¶
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-column SORT_COLUMN¶
specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated
- --sort-ascending¶
sort the column(s) in ascending order
- --sort-descending¶
sort the column(s) in descending order
This command is provided by the python-manilaclient plugin.
share services¶
share service ensure shares¶
Run ensure shares in a back end (Admin only).
share service ensure shares <host>
- host¶
Host to run ensure shares. ‘example_host@example_backend’.
This command is provided by the python-manilaclient plugin.
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>]
[--ensuring <ensuring>]
- -f <FORMATTER>, --format <FORMATTER>¶
the output format, defaults to table
- -c COLUMN, --column COLUMN¶
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-column SORT_COLUMN¶
specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated
- --sort-ascending¶
sort the column(s) in ascending order
- --sort-descending¶
sort the column(s) in descending order
- --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.
- --ensuring <ensuring>¶
Filter services running ensure shares or not.
This command is provided by the python-manilaclient plugin.
share service set¶
Enable/Disable share service (Admin only).
share service set
[--enable | --disable]
[--disable-reason <reason>]
<host>
<binary>
- --enable¶
Enable share service
- --disable¶
Disable share service
- --disable-reason <reason>¶
Reason for disabling the service (should be used with –disable option)
- host¶
Host name as ‘example_host@example_backend’.
- binary¶
Service binary, could be ‘manila-share’, ‘manila-scheduler’ or ‘manila-data’
This command is provided by the python-manilaclient plugin.
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>]
[--default-ad-site <default_ad_site>]
<type>
- -f <FORMATTER>, --format <FORMATTER>¶
the output format, defaults to table
- -c COLUMN, --column COLUMN¶
specify the column(s) to include, can be repeated to show multiple columns
- --noindent¶
whether to disable indenting the JSON
- --prefix <PREFIX>¶
add a prefix to all variable names
- --max-width <integer>¶
Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.
- --fit-width¶
Fit the table to the display width. Implied if –max-width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable
- --print-empty¶
Print empty table if there is no data to show.
- --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.
- --default-ad-site <default_ad_site>¶
Default AD site. Available only for microversion >= 2.76. Can be provided in the place of ‘–server’ but not along with it.
- type¶
Security service type. Possible options are: ‘ldap’, ‘kerberos’, ‘active_directory’.
This command is provided by the python-manilaclient plugin.
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.
This command is provided by the python-manilaclient plugin.
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>]
[--default-ad-site <default_ad_site>]
[--server <server>]
[--domain <domain>]
[--detail]
[--limit <num-security-services>]
[--marker <security-service>]
- -f <FORMATTER>, --format <FORMATTER>¶
the output format, defaults to table
- -c COLUMN, --column COLUMN¶
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-column SORT_COLUMN¶
specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated
- --sort-ascending¶
sort the column(s) in ascending order
- --sort-descending¶
sort the column(s) in descending order
- --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.
- --default-ad-site <default_ad_site>¶
Filter results by security service default_ad_site. Available only for microversion >= 2.76.
- --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
This command is provided by the python-manilaclient plugin.
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>]
[--default-ad-site <default_ad_site>]
<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.
- --default-ad-site <default_ad_site>¶
Default AD site. Available only for microversion >= 2.76.
- security-service¶
Security service name or ID.
This command is provided by the python-manilaclient plugin.
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
- -c COLUMN, --column COLUMN¶
specify the column(s) to include, can be repeated to show multiple columns
- --noindent¶
whether to disable indenting the JSON
- --prefix <PREFIX>¶
add a prefix to all variable names
- --max-width <integer>¶
Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.
- --fit-width¶
Fit the table to the display width. Implied if –max-width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable
- --print-empty¶
Print empty table if there is no data to show.
- security-service¶
Security service name or ID to show.
This command is provided by the python-manilaclient plugin.
share security service unset¶
Unset security service.
share security service unset
[--dns-ip]
[--ou]
[--server]
[--domain]
[--user]
[--password]
[--name]
[--description]
[--default-ad-site]
<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.
- --default-ad-site¶
Default AD site. Available only for microversion >= 2.76.
- security-service¶
Security service name or ID.
This command is provided by the python-manilaclient plugin.
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
- -c COLUMN, --column COLUMN¶
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-column SORT_COLUMN¶
specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated
- --sort-ascending¶
sort the column(s) in ascending order
- --sort-descending¶
sort the column(s) in descending order
- --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
This command is provided by the python-manilaclient plugin.
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
- -c COLUMN, --column COLUMN¶
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-column SORT_COLUMN¶
specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated
- --sort-ascending¶
sort the column(s) in ascending order
- --sort-descending¶
sort the column(s) in descending order
- --absolute¶
Get the absolute limits for the user
- --rate¶
Get the API rate limits for the user
This command is provided by the python-manilaclient plugin.
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
- -c COLUMN, --column COLUMN¶
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-column SORT_COLUMN¶
specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated
- --sort-ascending¶
sort the column(s) in ascending order
- --sort-descending¶
sort the column(s) in descending order
- instance¶
ID of the share instance.
This command is provided by the python-manilaclient plugin.
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
- -c COLUMN, --column COLUMN¶
specify the column(s) to include, can be repeated to show multiple columns
- --noindent¶
whether to disable indenting the JSON
- --prefix <PREFIX>¶
add a prefix to all variable names
- --max-width <integer>¶
Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.
- --fit-width¶
Fit the table to the display width. Implied if –max-width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable
- --print-empty¶
Print empty table if there is no data to show.
- instance¶
Name or ID of the share instance
- export_location¶
ID of the share instance export location.
This command is provided by the python-manilaclient plugin.
share groups¶
share group types¶
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
- -c COLUMN, --column COLUMN¶
specify the column(s) to include, can be repeated to show multiple columns
- --noindent¶
whether to disable indenting the JSON
- --prefix <PREFIX>¶
add a prefix to all variable names
- --max-width <integer>¶
Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.
- --fit-width¶
Fit the table to the display width. Implied if –max-width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable
- --print-empty¶
Print empty table if there is no data to show.
- --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
This command is provided by the python-manilaclient plugin.
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
This command is provided by the python-manilaclient plugin.
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
- -c COLUMN, --column COLUMN¶
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-column SORT_COLUMN¶
specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated
- --sort-ascending¶
sort the column(s) in ascending order
- --sort-descending¶
sort the column(s) in descending order
- --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).
This command is provided by the python-manilaclient plugin.
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
This command is provided by the python-manilaclient plugin.
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
- -c COLUMN, --column COLUMN¶
specify the column(s) to include, can be repeated to show multiple columns
- --noindent¶
whether to disable indenting the JSON
- --prefix <PREFIX>¶
add a prefix to all variable names
- --max-width <integer>¶
Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.
- --fit-width¶
Fit the table to the display width. Implied if –max-width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable
- --print-empty¶
Print empty table if there is no data to show.
- share-group-type¶
Name or ID of the share group type to show
This command is provided by the python-manilaclient plugin.
share group type unset¶
Unset share group type extra specs
share group type unset <share-group-type> <key> [<key> ...]
- share-group-type¶
Name or ID of the share grouptype to modify
- key¶
Remove group specs from this share group type
This command is provided by the python-manilaclient plugin.
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
- -c COLUMN, --column COLUMN¶
specify the column(s) to include, can be repeated to show multiple columns
- --noindent¶
whether to disable indenting the JSON
- --prefix <PREFIX>¶
add a prefix to all variable names
- --max-width <integer>¶
Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.
- --fit-width¶
Fit the table to the display width. Implied if –max-width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable
- --print-empty¶
Print empty table if there is no data to show.
- --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.
This command is provided by the python-manilaclient plugin.
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
This command is provided by the python-manilaclient plugin.
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
- -c COLUMN, --column COLUMN¶
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-column SORT_COLUMN¶
specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated
- --sort-ascending¶
sort the column(s) in ascending order
- --sort-descending¶
sort the column(s) in descending order
- --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.
This command is provided by the python-manilaclient plugin.
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
- -c COLUMN, --column COLUMN¶
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-column SORT_COLUMN¶
specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated
- --sort-ascending¶
sort the column(s) in ascending order
- --sort-descending¶
sort the column(s) in descending order
- share-group-snapshot¶
Name or ID of the group snapshot to list members for
This command is provided by the python-manilaclient plugin.
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
This command is provided by the python-manilaclient plugin.
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
- -c COLUMN, --column COLUMN¶
specify the column(s) to include, can be repeated to show multiple columns
- --noindent¶
whether to disable indenting the JSON
- --prefix <PREFIX>¶
add a prefix to all variable names
- --max-width <integer>¶
Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.
- --fit-width¶
Fit the table to the display width. Implied if –max-width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable
- --print-empty¶
Print empty table if there is no data to show.
- share-group-snapshot¶
Name or ID of the share group snapshot to display
This command is provided by the python-manilaclient plugin.
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
This command is provided by the python-manilaclient plugin.
share servers¶
resource locks¶
qos types¶
share qos type create¶
Create new qos type
share qos type create
[-f {json,shell,table,value,yaml}]
[-c COLUMN]
[--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty]
[--description <description>]
[--spec <key=value>]
<name>
- -f <FORMATTER>, --format <FORMATTER>¶
the output format, defaults to table
- -c COLUMN, --column COLUMN¶
specify the column(s) to include, can be repeated to show multiple columns
- --noindent¶
whether to disable indenting the JSON
- --prefix <PREFIX>¶
add a prefix to all variable names
- --max-width <integer>¶
Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.
- --fit-width¶
Fit the table to the display width. Implied if –max-width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable
- --print-empty¶
Print empty table if there is no data to show.
- --description <description>¶
QoS type description.
- --spec <key=value>¶
Spec key and value of QoS type that will be used for QoS type creation. OPTIONAL: Default=None. Example: –spec qos_type=’fixed’ –spec peak_iops=300.
- name¶
QoS type name. This must be unique.
This command is provided by the python-manilaclient plugin.
share qos type delete¶
Delete a qos type
share qos type delete <qos_types> [<qos_types> ...]
- qos_types¶
Name or ID of the qos type(s) to delete
This command is provided by the python-manilaclient plugin.
share qos type list¶
List qos types
share qos 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]
[--name <name>]
[--description <description>]
[--name~ <name~>]
[--description~ <description~>]
[--limit <num-qos-types>]
[--offset <offset>]
[--sort-key <sort_key>]
[--sort-dir <sort_dir>]
- -f <FORMATTER>, --format <FORMATTER>¶
the output format, defaults to table
- -c COLUMN, --column COLUMN¶
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-column SORT_COLUMN¶
specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated
- --sort-ascending¶
sort the column(s) in ascending order
- --sort-descending¶
sort the column(s) in descending order
- --name <name>¶
Filter results by name. Default=None.
- --description <description>¶
Filter results by description. Default=None.
- --name~ <name~>¶
Filter results matching a qos name pattern.
- --description~ <description~>¶
Filter results matching a qos description pattern.
- --limit <num-qos-types>¶
Limit the number of qos types returned. Default=None.
- --offset <offset>¶
Start position of qos type records listing.
- --sort-key <sort_key>, --sort_key <sort_key>¶
Key to be sorted with, available keys are (‘id’, ‘name’, ‘created_at’, ‘updated_at’). Default=None.
- --sort-dir <sort_dir>, --sort_dir <sort_dir>¶
Sort direction, available values are (‘asc’, ‘desc’). OPTIONAL: Default=None.
This command is provided by the python-manilaclient plugin.
share qos type set¶
Set qos type description or specs
share qos type set
[--description <description>]
[--spec <key=value>]
<qos_type>
- --description <description>¶
New description of qos type.
- --spec <key=value>¶
Spec key and value of qos type that will be used for QoS type. OPTIONAL: Default=None. For example –spec qos_type=’fixed’ –spec peak_iops=300
- qos_type¶
Name or ID of the qos type to modify
This command is provided by the python-manilaclient plugin.
share qos type show¶
Display qos type details
share qos type show
[-f {json,shell,table,value,yaml}]
[-c COLUMN]
[--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty]
<qos_type>
- -f <FORMATTER>, --format <FORMATTER>¶
the output format, defaults to table
- -c COLUMN, --column COLUMN¶
specify the column(s) to include, can be repeated to show multiple columns
- --noindent¶
whether to disable indenting the JSON
- --prefix <PREFIX>¶
add a prefix to all variable names
- --max-width <integer>¶
Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.
- --fit-width¶
Fit the table to the display width. Implied if –max-width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable
- --print-empty¶
Print empty table if there is no data to show.
- qos_type¶
Qos type to display (name or ID)
This command is provided by the python-manilaclient plugin.
share qos type unset¶
Unset qos type specs
share qos type unset [--description] [--spec <key>] <qos_type>
- --description¶
Unset qos type description.
- --spec <key>¶
Remove specified spec from this qos type
- qos_type¶
Name or ID of the qos type to modify
This command is provided by the python-manilaclient plugin.