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.