Chapter 13. Shared File Systems Service Command-line Client
1.11.0.
$manilahelpCOMMAND
13.1. manila Usage
usage: manila [--version] [-d] [--os-cache] [--os-reset-cache]
[--os-user-id <auth-user-id>] [--os-username <auth-user-name>]
[--os-password <auth-password>]
[--os-tenant-name <auth-tenant-name>]
[--os-project-name <auth-project-name>]
[--os-tenant-id <auth-tenant-id>]
[--os-project-id <auth-project-id>]
[--os-user-domain-id <auth-user-domain-id>]
[--os-user-domain-name <auth-user-domain-name>]
[--os-project-domain-id <auth-project-domain-id>]
[--os-project-domain-name <auth-project-domain-name>]
[--os-auth-url <auth-url>] [--os-region-name <region-name>]
[--os-token <token>] [--bypass-url <bypass-url>]
[--service-type <service-type>] [--service-name <service-name>]
[--share-service-name <share-service-name>]
[--endpoint-type <endpoint-type>]
[--os-share-api-version <share-api-ver>]
[--os-cacert <ca-certificate>] [--retries <retries>]
[--os-cert <certificate>]
<subcommand> ...Subcommands
- absolute-limits
Print a list of absolute limits for a user.
- access-allow
Allow access to the share.
- access-deny
Deny access to a share.
- access-list
Show access list for share.
- api-version
Display the API version information.
- cg-create
Creates a new consistency group (Experimental).
- cg-delete
Remove one or more consistency groups (Experimental).
- cg-list
List consistency groups with filters (Experimental).
- cg-reset-state
Explicitly update the state of a consistency group
(Admin only, Experimental).
- cg-show
Show details about a consistency group (Experimental).
- cg-snapshot-create
Creates a new consistency group snapshot
(Experimental).
- cg-snapshot-delete
Remove one or more consistency group snapshots
(Experimental).
- cg-snapshot-list
List consistency group snapshots with filters
(Experimental).
- cg-snapshot-members
Get member details for a consistency group snapshot
(Experimental).
- cg-snapshot-reset-state
Explicitly update the state of a consistency group
(Admin only, Experimental).
- cg-snapshot-show
Show details about a consistency group snapshot
(Experimental).
- cg-snapshot-update
Update a consistency group snapshot (Experimental).
- cg-update
Update a consistency group (Experimental).
- create
Creates a new share (NFS, CIFS, CephFS, GlusterFS or
HDFS).
- credentials
Show user credentials returned from auth.
- delete
Remove one or more shares.
- endpoints
Discover endpoints that get returned from the
authenticate services.
- extend
Increases the size of an existing share.
- extra-specs-list
Print a list of current 'share types and extra specs'
(Admin Only).
- force-delete
Attempt force-delete of share, regardless of state
(Admin only).
- list
List NAS shares with filters.
- manage
Manage share not handled by Manila (Admin only).
- metadata
Set or delete metadata on a share.
- metadata-show
Show metadata of given share.
- metadata-update-all
Update all metadata of a share.
- migration-cancel
Cancels migration of a given share when copying (Admin
only, Experimental).
- migration-complete
Completes migration for a given share (Admin only,
Experimental).
- migration-get-progress
Gets migration progress of a given share when copying
(Admin only, Experimental).
- migration-start
Migrates share to a new host (Admin only,
Experimental).
- pool-list
List all backend storage pools known to the scheduler
(Admin only).
- quota-class-show
List the quotas for a quota class.
- quota-class-update
Update the quotas for a quota class (Admin only).
- quota-defaults
List the default quotas for a tenant.
- quota-delete
Delete quota for a tenant/user. The quota will revert
back to default (Admin only).
- quota-show
List the quotas for a tenant/user.
- quota-update
Update the quotas for a tenant/user (Admin only).
- rate-limits
Print a list of rate limits for a user.
- reset-state
Explicitly update the state of a share (Admin only).
- reset-task-state
Explicitly update the task state of a share (Admin
only, Experimental).
- security-service-create
Create security service used by tenant.
- security-service-delete
Delete security service.
- security-service-list
Get a list of security services.
- security-service-show
Show security service.
- security-service-update
Update security service.
- service-disable
Disables 'manila-share' or 'manila-scheduler' services
(Admin only).
- service-enable
Enables 'manila-share' or 'manila-scheduler' services
(Admin only).
- service-list
List all services (Admin only).
- share-export-location-list
List export locations of a given share.
- share-export-location-show
Show export location of the share.
- share-instance-export-location-list
List export locations of a given share instance.
- share-instance-export-location-show
Show export location for the share instance.
- share-instance-force-delete
Force-delete the share instance, regardless of state
(Admin only).
- share-instance-list
List share instances (Admin only).
- share-instance-reset-state
Explicitly update the state of a share instance (Admin
only).
- share-instance-show
Show details about a share instance (Admin only).
- share-network-create
Create description for network used by the tenant.
- share-network-delete
Delete share network.
- share-network-list
Get a list of network info.
- share-network-security-service-add
Associate security service with share network.
- share-network-security-service-list
Get list of security services associated with a given
share network.
- share-network-security-service-remove
Dissociate security service from share network.
- share-network-show
Get a description for network used by the tenant.
- share-network-update
Update share network data.
- share-replica-create
Create a share replica (Experimental).
- share-replica-delete
Remove one or more share replicas (Experimental).
- share-replica-list
List share replicas (Experimental).
- share-replica-promote
Promote specified replica to 'active' replica_state
(Experimental).
- share-replica-reset-replica-state
Explicitly update the 'replica_state' of a share
replica (Experimental).
- share-replica-reset-state
Explicitly update the 'status' of a share replica
(Experimental).
- share-replica-resync
Attempt to update the share replica with its 'active'
mirror (Experimental).
- share-replica-show
Show details about a replica (Experimental).
- share-server-delete
Delete share server (Admin only).
- share-server-details
Show share server details (Admin only).
- share-server-list
List all share servers (Admin only).
- share-server-show
Show share server info (Admin only).
- show
Show details about a NAS share.
- shrink
Decreases the size of an existing share.
- snapshot-create
Add a new snapshot.
- snapshot-delete
Remove a snapshot.
- snapshot-force-delete
Attempt force-delete of snapshot, regardless of state
(Admin only).
- snapshot-instance-list
List share snapshot instances.
- snapshot-instance-reset-state
Explicitly update the state of a share snapshot
instance.
- snapshot-instance-show
Show details about a share snapshot instance.
- snapshot-list
List all the snapshots.
- snapshot-manage
Manage share snapshot not handled by Manila (Admin
only).
- snapshot-rename
Rename a snapshot.
- snapshot-reset-state
Explicitly update the state of a snapshot (Admin
only).
- snapshot-show
Show details about a snapshot.
- snapshot-unmanage
Unmanage one or more share snapshots (Admin only).
- type-access-add
Adds share type access for the given project (Admin
only).
- type-access-list
Print access information about the given share type
(Admin only).
- type-access-remove
Removes share type access for the given project (Admin
only).
- type-create
Create a new share type (Admin only).
- type-delete
Delete a specific share type (Admin only).
- type-key
Set or unset extra_spec for a share type (Admin only).
- type-list
Print a list of available 'share types'.
- unmanage
Unmanage share (Admin only).
- update
Rename a share.
- bash-completion
Print arguments for bash_completion. Prints all of the
commands and options to stdout so that the
manila.bash_completion script doesn't have to hard
code them.
- help
Display help about this program or one of its
subcommands.
- list-extensions
List all the os-api extensions that are available.
13.2. manila Optional Arguments
- --version
show program's version number and exit
- -d, --debug
Print debugging output.
- --os-cache
Use the auth token cache. Defaults toenv[OS_CACHE].
- --os-reset-cache
Delete cached password and auth token.
- --os-user-id <auth-user-id>
Defaults to env [OS_USER_ID].
- --os-username <auth-user-name>
Defaults toenv[OS_USERNAME].
- --os-password <auth-password>
Defaults toenv[OS_PASSWORD].
- --os-tenant-name <auth-tenant-name>
Defaults toenv[OS_TENANT_NAME].
- --os-project-name <auth-project-name>
Another way to specify tenant name. This option is
mutually exclusive with --os-tenant-name. Defaults to
env[OS_PROJECT_NAME].
- --os-tenant-id <auth-tenant-id>
Defaults toenv[OS_TENANT_ID].
- --os-project-id <auth-project-id>
Another way to specify tenant ID. This option is
mutually exclusive with --os-tenant-id. Defaults to
env[OS_PROJECT_ID].
- --os-user-domain-id <auth-user-domain-id>
OpenStack user domain ID. Defaults to
env[OS_USER_DOMAIN_ID].
- --os-user-domain-name <auth-user-domain-name>
OpenStack user domain name. Defaults to
env[OS_USER_DOMAIN_NAME].
- --os-project-domain-id <auth-project-domain-id>
Defaults toenv[OS_PROJECT_DOMAIN_ID].
- --os-project-domain-name <auth-project-domain-name>
Defaults toenv[OS_PROJECT_DOMAIN_NAME].
- --os-auth-url <auth-url>
Defaults toenv[OS_AUTH_URL].
- --os-region-name <region-name>
Defaults toenv[OS_REGION_NAME].
- --os-token <token>
Defaults toenv[OS_TOKEN].
- --bypass-url <bypass-url>
Use this API endpoint instead of the Service Catalog.
Defaults toenv[OS_MANILA_BYPASS_URL].
- --service-type <service-type>
Defaults to compute for most actions.
- --service-name <service-name>
Defaults toenv[OS_MANILA_SERVICE_NAME].
- --share-service-name <share-service-name>
Defaults toenv[OS_MANILA_SHARE_SERVICE_NAME].
- --endpoint-type <endpoint-type>
Defaults toenv[OS_MANILA_ENDPOINT_TYPE]or publicURL.
- --os-share-api-version <share-api-ver>
Accepts 1.x to override default to
env[OS_SHARE_API_VERSION].
- --os-cacert <ca-certificate>
Specify a CA bundle file to use in verifying a TLS
(https) server certificate. Defaults to
env[OS_CACERT].
- --retries <retries>
Number of retries.
- --os-cert <certificate>
Defaults toenv[OS_CERT].
13.3. manila absolute-limits
usage: manila absolute-limits
13.4. manila access-allow
usage: manila access-allow [--access-level <access_level>]
<share> <access_type> <access_to>Positional arguments
- <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.
Optional arguments
- --access-level <access_level>, --access_level <access_level>
Share access level ("rw" and "ro" access levels are
supported). Defaults to rw.
13.5. manila access-deny
usage: manila access-deny <share> <id>
Positional arguments
- <share>
Name or ID of the NAS share to modify.
- <id>
ID of the access rule to be deleted.
13.6. manila access-list
usage: manila access-list [--columns <columns>] <share>
Positional arguments
- <share>
Name or ID of the share.
Optional arguments
- --columns <columns>
Comma separated list of columns to be displayed e.g.
--columns "access_type,access_to"
13.7. manila api-version
usage: manila api-version
13.8. manila cg-create
usage: manila cg-create [--name <name>] [--description <description>]
[--share-types <share_types>]
[--share-network <share_network>]
[--source-cgsnapshot-id <source_cgsnapshot_id>]Optional arguments
- --name <name>
Optional consistency group name. (Default=None)
- --description <description>
Optional consistency group description. (Default=None)
- --share-types <share_types>, --share_types <share_types>
Optional list of share types. (Default=None)
- --share-network <share_network>, --share_network <share_network>
Specify share-network name or id.
- --source-cgsnapshot-id <source_cgsnapshot_id>, --source_cgsnapshot_id <source_cgsnapshot_id>
Optional snapshot ID to create the share from.
(Default=None)
13.9. manila cg-delete
usage: manila cg-delete [--force]
<consistency_group> [<consistency_group> ...]Positional arguments
- <consistency_group>
Name or ID of the consistency group(s).
Optional arguments
- --force
Attempt to force delete the consistency group
(Default=False) (Admin only).
13.10. manila cg-list
usage: manila cg-list [--all-tenants [<0|1>]] [--limit <limit>]
[--offset <offset>] [--columns <columns>]Optional arguments
- --all-tenants [<0|1>]
Display information from all tenants (Admin only).
- --limit <limit>
Maximum number of consistency groups to return.
(Default=None)
- --offset <offset>
Start position of consistency group listing.
- --columns <columns>
Comma separated list of columns to be displayed e.g.
--columns "id,name"
13.11. manila cg-reset-state
usage: manila cg-reset-state [--state <state>] <consistency_group>
Positional arguments
- <consistency_group>
Name or ID of the consistency group state to modify.
Optional arguments
- --state <state>
Indicate which state to assign the consistency group.
Options include available, error, creating, deleting,
error_deleting. If no state is provided, available will
be used.
13.12. manila cg-show
usage: manila cg-show <consistency_group>
Positional arguments
- <consistency_group>
Name or ID of the consistency group.
13.13. manila cg-snapshot-create
usage: manila cg-snapshot-create [--name <name>] [--description <description>]
<consistency_group>Positional arguments
- <consistency_group>
Name or ID of the consistency group.
Optional arguments
- --name <name>
Optional consistency group snapshot name.
(Default=None)
- --description <description>
Optional consistency group snapshot description.
(Default=None)
13.14. manila cg-snapshot-delete
usage: manila cg-snapshot-delete [--force] <cg_snapshot> [<cg_snapshot> ...]
Positional arguments
- <cg_snapshot>
Name or ID of the consistency group snapshot.
Optional arguments
- --force
Attempt to force delete the cg snapshot(s) (Default=False)
(Admin only).
13.15. manila cg-snapshot-list
usage: manila cg-snapshot-list [--all-tenants [<0|1>]] [--limit <limit>]
[--offset <offset>] [--detailed DETAILED]
[--columns <columns>]Optional arguments
- --all-tenants [<0|1>]
Display information from all tenants (Admin only).
- --limit <limit>
Maximum number of consistency group snapshots to
return.(Default=None)
- --offset <offset>
Start position of consistency group snapshot listing.
- --detailed DETAILED
Show detailed information about snapshots.
- --columns <columns>
Comma separated list of columns to be displayed e.g.
--columns "id,name"
13.16. manila cg-snapshot-members
usage: manila cg-snapshot-members [--limit <limit>] [--offset <offset>]
<cg_snapshot>Positional arguments
- <cg_snapshot>
Name or ID of the consistency group snapshot.
Optional arguments
- --limit <limit>
Maximum number of shares to return. (Default=None)
- --offset <offset>
Start position of security services listing.
13.17. manila cg-snapshot-reset-state
usage: manila cg-snapshot-reset-state [--state <state>] <cg_snapshot>
Positional arguments
- <cg_snapshot>
Name or ID of the consistency group snapshot.
Optional arguments
- --state <state>
Indicate which state to assign the consistency group.
Options include available, error, creating, deleting,
error_deleting. If no state is provided, available will be
used.
13.18. manila cg-snapshot-show
usage: manila cg-snapshot-show <cg_snapshot>
Positional arguments
- <cg_snapshot>
Name or ID of the consistency group snapshot.
13.19. manila cg-snapshot-update
usage: manila cg-snapshot-update [--name <name>] [--description <description>]
<cg_snapshot>Positional arguments
- <cg_snapshot>
Name or ID of the cg snapshot to update.
Optional arguments
- --name <name>
Optional new name for the cg snapshot. (Default=None
- --description <description>
Optional cg snapshot description. (Default=None)
13.20. manila cg-update
usage: manila cg-update [--name <name>] [--description <description>]
<consistency_group>Positional arguments
- <consistency_group>
Name or ID of the consistency group to update.
Optional arguments
- --name <name>
Optional new name for the consistency group.
(Default=None)
- --description <description>
Optional consistency group description. (Default=None)
13.21. manila create
usage: manila create [--snapshot-id <snapshot-id>] [--name <name>]
[--metadata [<key=value> [<key=value> ...]]]
[--share-network <network-info>]
[--description <description>] [--share-type <share-type>]
[--public] [--availability-zone <availability-zone>]
[--consistency-group <consistency-group>]
<share_protocol> <size>Positional arguments
- <share_protocol>
Share type (NFS, CIFS, CephFS, GlusterFS or HDFS).
- <size>
Share size in GiB.
Optional arguments
- --snapshot-id <snapshot-id>, --snapshot_id <snapshot-id>
Optional snapshot ID to create the share from.
(Default=None)
- --name <name>
Optional share name. (Default=None)
- --metadata [<key=value> [<key=value> ...]]
Metadata key=value pairs (Optional, Default=None).
- --share-network <network-info>, --share_network <network-info>
Optional network info ID or name.
- --description <description>
Optional share description. (Default=None)
- --share-type <share-type>, --share_type <share-type>, --volume-type <share-type>, --volume_type <share-type>
Optional share type. Use of optional volume type is
deprecated(Default=None)
- --public
Level of visibility for share. Defines whether other
tenants are able to see it or not.
- --availability-zone <availability-zone>, --availability_zone <availability-zone>, --az <availability-zone>
Availability zone in which share should be created.
- --consistency-group <consistency-group>, --consistency_group <consistency-group>, --cg <consistency-group>
Optional consistency group name or ID in which to
create the share (Experimental, Default=None).
13.22. manila credentials
usage: manila credentials
13.23. manila delete
usage: manila delete [--consistency-group <consistency-group>]
<share> [<share> ...]Positional arguments
- <share>
Name or ID of the share(s).
Optional arguments
- --consistency-group <consistency-group>, --consistency_group <consistency-group>, --cg <consistency-group>
Optional consistency group name or ID which contains
the share (Experimental, Default=None).
13.24. manila endpoints
usage: manila endpoints
13.25. manila extend
usage: manila extend <share> <new_size>
Positional arguments
- <share>
Name or ID of share to extend.
- <new_size>
New size of share, in GiBs.
13.26. manila extra-specs-list
usage: manila extra-specs-list [--columns <columns>]
Optional arguments
- --columns <columns>
Comma separated list of columns to be displayed e.g.
--columns "id,name"
13.27. manila force-delete
usage: manila force-delete <share> [<share> ...]
Positional arguments
- <share>
Name or ID of the share(s) to force delete.
13.28. manila list
usage: manila list [--all-tenants [<0|1>]] [--name <name>] [--status <status>]
[--share-server-id <share_server_id>]
[--metadata [<key=value> [<key=value> ...]]]
[--extra-specs [<key=value> [<key=value> ...]]]
[--share-type <share_type>] [--limit <limit>]
[--offset <offset>] [--sort-key <sort_key>]
[--sort-dir <sort_dir>] [--snapshot <snapshot>]
[--host <host>] [--share-network <share_network>]
[--project-id <project_id>] [--public]
[--consistency-group <consistency_group>]
[--columns <columns>]Optional arguments
- --all-tenants [<0|1>]
Display information from all tenants (Admin only).
- --name <name>
Filter results by name.
- --status <status>
Filter results by status.
- --share-server-id <share_server_id>, --share-server_id <share_server_id>, --share_server-id <share_server_id>, --share_server_id <share_server_id>
Filter results by share server ID (Admin only).
- --metadata [<key=value> [<key=value> ...]]
Filters results by a metadata key and value. OPTIONAL:
Default=None
- --extra-specs [<key=value> [<key=value> ...]], --extra_specs [<key=value> [<key=value> ...]]
Filters results by a extra specs key and value of
share type that was used for share creation. OPTIONAL:
Default=None
- --share-type <share_type>, --volume-type <share_type>, --share_type <share_type>, --share-type-id <share_type>, --volume-type-id <share_type>, --share-type_id <share_type>, --share_type-id <share_type>, --share_type_id <share_type>, --volume_type <share_type>, --volume_type_id <share_type>
Filter results by a share type id or name that was
used for share creation.
- --limit <limit>
Maximum number of shares to return. OPTIONAL:
Default=None.
- --offset <offset>
Set offset to define start point of share listing.
OPTIONAL: Default=None.
- --sort-key <sort_key>, --sort_key <sort_key>
Key to be sorted, available keys are ('id', 'status',
'size', 'host', 'share_proto', 'export_location',
'availability_zone', 'user_id', 'project_id',
'created_at', 'updated_at', 'display_name', 'name',
'share_type_id', 'share_type', 'share_network_id',
'share_network', 'snapshot_id', 'snapshot'). OPTIONAL:
Default=None.
- --sort-dir <sort_dir>, --sort_dir <sort_dir>
Sort direction, available values are ('asc', 'desc').
OPTIONAL: Default=None.
- --snapshot <snapshot>
Filer results by snapshot name or id, that was used
for share.
- --host <host>
Filter results by host.
- --share-network <share_network>, --share_network <share_network>
Filter results by share-network name or id.
- --project-id <project_id>, --project_id <project_id>
Filter results by project id. Useful with set key
'--all-tenants'.
- --public
Add public shares from all tenants to result.
- --consistency-group <consistency_group>, --consistency_group <consistency_group>, --cg <consistency_group>
Filter results by consistency group name or ID
(Experimental, Default=None).
- --columns <columns>
Comma separated list of columns to be displayed e.g.
--columns "export_location,is public"
13.29. manila list-extensions
usage: manila list-extensions
13.30. manila manage
usage: manila manage [--name <name>] [--description <description>]
[--share_type <share-type>]
[--driver_options [<key=value> [<key=value> ...]]]
[--public]
<service_host> <protocol> <export_path>Positional arguments
- <service_host>
manage-share service host: some.host@driver#pool
- <protocol>
Protocol of the share to manage, such as NFS or CIFS.
- <export_path>
Share export path, NFS share such as:
10.0.0.1:/example_path, CIFS share such as:
\\10.0.0.1\example_cifs_share
Optional arguments
- --name <name>
Optional share name. (Default=None)
- --description <description>
Optional share description. (Default=None)
- --share_type <share-type>, --share-type <share-type>
Optional share type assigned to share. (Default=None)
- --driver_options [<key=value> [<key=value> ...]], --driver-options [<key=value> [<key=value> ...]]
Driver option key=value pairs (Optional,
Default=None).
- --public
Level of visibility for share. Defines whether other
tenants are able to see it or not. Available only for
microversion >= 2.8
13.31. manila metadata
usage: manila metadata <share> <action> <key=value> [<key=value> ...]
Positional arguments
- <share>
Name or ID of the share to update metadata on.
- <action>
Actions: 'set' or 'unset'.
- <key=value>
Metadata to set or unset (key is only necessary on unset).
13.32. manila metadata-show
usage: manila metadata-show <share>
Positional arguments
- <share>
Name or ID of the share.
13.33. manila metadata-update-all
usage: manila metadata-update-all <share> <key=value> [<key=value> ...]
Positional arguments
- <share>
Name or ID of the share to update metadata on.
- <key=value>
Metadata entry or entries to update.
13.34. manila migration-cancel
usage: manila migration-cancel <share>
Positional arguments
- <share>
Name or ID of share to cancel migration.
13.35. manila migration-complete
usage: manila migration-complete <share>
Positional arguments
- <share>
Name or ID of share to complete migration.
13.36. manila migration-get-progress
usage: manila migration-get-progress <share>
Positional arguments
- <share>
Name or ID of the share to get share migration progress
information.
13.37. manila migration-start
usage: manila migration-start [--force_host_assisted_migration <True|False>]
[--preserve-metadata <True|False>]
[--writable <True|False>]
[--non-disruptive <True|False>]
[--new_share_network <new_share_network>]
[--new_share_type <new_share_type>]
<share> <host@backend#pool>Positional arguments
- <share>
Name or ID of share to migrate.
- <host@backend#pool>
Destination host, backend and pool in format
'host@backend#pool'.
Optional arguments
- --force_host_assisted_migration <True|False>, --force-host-assisted-migration <True|False>
Enables or disables generic host-based force-
migration, which bypasses driver optimizations.
Default=False. Renamed from "force_host_copy" in
version 2.22.
- --preserve-metadata <True|False>, --preserve_metadata <True|False>
Chooses whether migration should be forced to preserve
all file metadata when moving its contents.
Default=True. Introduced in version 2.22.
- --writable <True|False>
Chooses whether migration should be forced to remain
writable while contents are being moved. Default=True.
Introduced in version 2.22.
- --non-disruptive <True|False>, --non_disruptive <True|False>
Chooses whether migration should only be performed if
it is not disruptive. Default=False. Introduced in
version 2.22.
- --new_share_network <new_share_network>, --new-share-network <new_share_network>
Specifies a new share network if desired to change.
Default=None. Introduced in version 2.22.
- --new_share_type <new_share_type>, --new-share-type <new_share_type>
Specifies a new share type if desired to change.
Default=None. Introduced in version 2.22.
13.38. manila pool-list
usage: manila pool-list [--host <host>] [--backend <backend>] [--pool <pool>]
[--columns <columns>]Optional arguments
- --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.
- --columns <columns>
Comma separated list of columns to be displayed e.g.
--columns "name,host"
13.39. manila quota-class-show
usage: manila quota-class-show <class>
Positional arguments
- <class>
Name of quota class to list the quotas for.
13.40. manila quota-class-update
usage: manila quota-class-update [--shares <shares>] [--snapshots <snapshots>]
[--gigabytes <gigabytes>]
[--snapshot-gigabytes <snapshot_gigabytes>]
[--share-networks <share-networks>]
<class-name>Positional arguments
- <class-name>
Name of quota class to set the quotas for.
Optional arguments
- --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>, --snapshot_gigabytes <snapshot_gigabytes>
New value for the "snapshot_gigabytes" quota.
- --share-networks <share-networks>, --share_networks <share-networks>
New value for the "share_networks" quota.
13.41. manila quota-defaults
usage: manila quota-defaults [--tenant <tenant-id>]
Optional arguments
- --tenant <tenant-id> ID
of tenant to list the default quotas for.
13.42. manila quota-delete
usage: manila quota-delete [--tenant <tenant-id>] [--user <user-id>]
Optional arguments
- --tenant <tenant-id> ID
of tenant to delete quota for.
- --user <user-id> ID
of user to delete quota for.
13.43. manila quota-show
usage: manila quota-show [--tenant <tenant-id>] [--user <user-id>]
Optional arguments
- --tenant <tenant-id> ID
of tenant to list the quotas for.
- --user <user-id> ID
of user to list the quotas for.
13.44. manila quota-update
usage: manila quota-update [--user <user-id>] [--shares <shares>]
[--snapshots <snapshots>] [--gigabytes <gigabytes>]
[--snapshot-gigabytes <snapshot_gigabytes>]
[--share-networks <share-networks>] [--force]
<tenant_id>Positional arguments
- <tenant_id>
UUID of tenant to set the quotas for.
Optional arguments
- --user <user-id> ID
of user to set the quotas for.
- --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>, --snapshot_gigabytes <snapshot_gigabytes>
New value for the "snapshot_gigabytes" quota.
- --share-networks <share-networks>, --share_networks <share-networks>
New value for the "share_networks" quota.
- --force
Whether force update the quota even if the already
used and reserved exceeds the new quota.
13.45. manila rate-limits
usage: manila rate-limits [--columns <columns>]
Optional arguments
- --columns <columns>
Comma separated list of columns to be displayed e.g.
--columns "verb,uri,value"
13.46. manila reset-state
usage: manila reset-state [--state <state>] <share>
Positional arguments
- <share>
Name or ID of the share to modify.
Optional arguments
- --state <state>
Indicate which state to assign the share. Options include
available, error, creating, deleting, error_deleting. If no
state is provided, available will be used.
13.47. manila reset-task-state
usage: manila reset-task-state [--task-state <task_state>] <share>
Positional arguments
- <share>
Name or ID of the share to modify.
Optional arguments
- --task-state <task_state>, --task_state <task_state>, --state <task_state>
Indicate which task state to assign the share. Options
include migration_starting, migration_in_progress,
migration_completing, migration_success,
migration_error, migration_cancelled,
migration_driver_in_progress,
migration_driver_phase1_done, data_copying_starting,
data_copying_in_progress, data_copying_completing,
data_copying_completed, data_copying_cancelled,
data_copying_error. If no value is provided, None will
be used.
13.48. manila security-service-create
usage: manila security-service-create [--dns-ip <dns_ip>] [--server <server>]
[--domain <domain>] [--user <user>]
[--password <password>] [--name <name>]
[--description <description>]
<type>Positional arguments
- <type>
Security service type: 'ldap', 'kerberos' or
'active_directory'.
Optional arguments
- --dns-ip <dns_ip> DNS IP
address used inside tenant's network.
- --server <server>
Security service IP address or hostname.
- --domain <domain>
Security service domain.
- --user <user>
Security service user or group used by tenant.
- --password <password>
Password used by user.
- --name <name>
Security service name.
- --description <description>
Security service description.
13.49. manila security-service-delete
usage: manila security-service-delete <security-service>
Positional arguments
- <security-service>
Security service name or ID to delete.
13.50. manila security-service-list
usage: manila security-service-list [--all-tenants [<0|1>]]
[--share-network <share_network>]
[--status <status>] [--name <name>]
[--type <type>] [--user <user>]
[--dns-ip <dns_ip>] [--server <server>]
[--domain <domain>] [--detailed [<0|1>]]
[--offset <offset>] [--limit <limit>]
[--columns <columns>]Optional arguments
- --all-tenants [<0|1>]
Display information from all tenants (Admin only).
- --share-network <share_network>, --share_network <share_network>
Filter results by share network id or name.
- --status <status>
Filter results by status.
- --name <name>
Filter results by name.
- --type <type>
Filter results by type.
- --user <user>
Filter results by user or group used by tenant.
- --dns-ip <dns_ip>, --dns_ip <dns_ip>
Filter results by DNS IP address used inside tenant's
network.
- --server <server>
Filter results by security service IP address or
hostname.
- --domain <domain>
Filter results by domain.
- --detailed [<0|1>]
Show detailed information about filtered security
services.
- --offset <offset>
Start position of security services listing.
- --limit <limit>
Number of security services to return per request.
- --columns <columns>
Comma separated list of columns to be displayed e.g.
--columns "name,type"
13.51. manila security-service-show
usage: manila security-service-show <security-service>
Positional arguments
- <security-service>
Security service name or ID to show.
13.52. manila security-service-update
usage: manila security-service-update [--dns-ip <dns-ip>] [--server <server>]
[--domain <domain>] [--user <user>]
[--password <password>] [--name <name>]
[--description <description>]
<security-service>Positional arguments
- <security-service>
Security service name or ID to update.
Optional arguments
- --dns-ip <dns-ip> DNS IP
address used inside tenant's network.
- --server <server>
Security service IP address or hostname.
- --domain <domain>
Security service domain.
- --user <user>
Security service user or group used by tenant.
- --password <password>
Password used by user.
- --name <name>
Security service name.
- --description <description>
Security service description.
13.53. manila service-disable
usage: manila service-disable <hostname> <binary>
Positional arguments
- <hostname>
Host name as 'example_host@example_backend'.
- <binary>
Service binary, could be 'manila-share' or 'manila-scheduler'.
13.54. manila service-enable
usage: manila service-enable <hostname> <binary>
Positional arguments
- <hostname>
Host name as 'example_host@example_backend'.
- <binary>
Service binary, could be 'manila-share' or 'manila-scheduler'.
13.55. manila service-list
usage: manila service-list [--host <hostname>] [--binary <binary>]
[--status <status>] [--state <state>]
[--zone <zone>] [--columns <columns>]Optional arguments
- --host <hostname>
Name of host.
- --binary <binary>
Service binary.
- --status <status>
Filter results by status.
- --state <state>
Filter results by state.
- --zone <zone>
Availability zone.
- --columns <columns>
Comma separated list of columns to be displayed e.g.
--columns "id,host"
13.84. manila show
usage: manila show <share>
Positional arguments
- <share>
Name or ID of the NAS share.
13.85. manila shrink
usage: manila shrink <share> <new_size>
Positional arguments
- <share>
Name or ID of share to shrink.
- <new_size>
New size of share, in GiBs.
13.86. manila snapshot-create
usage: manila snapshot-create [--force <True|False>] [--name <name>]
[--description <description>]
<share>Positional arguments
- <share>
Name or ID of the share to snapshot.
Optional arguments
- --force <True|False>
Optional flag to indicate whether to snapshot a share
even if it's busy. (Default=False)
- --name <name>
Optional snapshot name. (Default=None)
- --description <description>
Optional snapshot description. (Default=None)
13.87. manila snapshot-delete
usage: manila snapshot-delete <snapshot>
Positional arguments
- <snapshot>
Name or ID of the snapshot to delete.
13.88. manila snapshot-force-delete
usage: manila snapshot-force-delete <snapshot>
Positional arguments
- <snapshot>
Name or ID of the snapshot to force delete.
13.89. manila snapshot-instance-list
usage: manila snapshot-instance-list [--snapshot <snapshot>]
[--columns <columns>]
[--detailed <detailed>]Optional arguments
- --snapshot <snapshot>
Filter results by share snapshot ID.
- --columns <columns>
Comma separated list of columns to be displayed e.g.
--columns "id"
- --detailed <detailed>
Show detailed information about snapshot instances.
(Default=False)
13.90. manila snapshot-instance-reset-state
usage: manila snapshot-instance-reset-state [--state <state>]
<snapshot_instance>Positional arguments
- <snapshot_instance>
ID of the snapshot instance to modify.
Optional arguments
- --state <state>
Indicate which state to assign the snapshot instance.
Options include available, error, creating, deleting,
error_deleting. If no state is provided, available will
be used.
13.91. manila snapshot-instance-show
usage: manila snapshot-instance-show <snapshot_instance>
Positional arguments
- <snapshot_instance>
ID of the share snapshot instance.
13.92. manila snapshot-list
usage: manila snapshot-list [--all-tenants [<0|1>]] [--name <name>]
[--status <status>] [--share-id <share_id>]
[--usage [any|used|unused]] [--limit <limit>]
[--offset <offset>] [--sort-key <sort_key>]
[--sort-dir <sort_dir>] [--columns <columns>]Optional arguments
- --all-tenants [<0|1>]
Display information from all tenants (Admin only).
- --name <name>
Filter results by name.
- --status <status>
Filter results by status.
- --share-id <share_id>, --share_id <share_id>
Filter results by source share ID.
- --usage [any|used|unused]
Either filter or not snapshots by its usage. OPTIONAL:
Default=any.
- --limit <limit>
Maximum number of share snapshots to return. OPTIONAL:
Default=None.
- --offset <offset>
Set offset to define start point of share snapshots
listing. OPTIONAL: Default=None.
- --sort-key <sort_key>, --sort_key <sort_key>
Key to be sorted, available keys are ('id', 'status',
'size', 'share_id', 'user_id', 'project_id',
'progress', 'name', 'display_name'). Default=None.
- --sort-dir <sort_dir>, --sort_dir <sort_dir>
Sort direction, available values are ('asc', 'desc').
OPTIONAL: Default=None.
- --columns <columns>
Comma separated list of columns to be displayed e.g.
--columns "id,name"
13.93. manila snapshot-manage
usage: manila snapshot-manage [--name <name>] [--description <description>]
[--driver_options [<key=value> [<key=value> ...]]]
<share> <provider_location>Positional arguments
- <share>
Name or ID of the share.
- <provider_location>
Provider location of the snapshot on the backend.
Optional arguments
- --name <name>
Optional snapshot name (Default=None).
- --description <description>
Optional snapshot description (Default=None).
- --driver_options [<key=value> [<key=value> ...]], --driver-options [<key=value> [<key=value> ...]]
Optional driver options as key=value pairs
(Default=None).
13.94. manila snapshot-rename
usage: manila snapshot-rename [--description <description>]
<snapshot> [<name>]Positional arguments
- <snapshot>
Name or ID of the snapshot to rename.
- <name>
New name for the snapshot.
Optional arguments
- --description <description>
Optional snapshot description. (Default=None)
13.95. manila snapshot-reset-state
usage: manila snapshot-reset-state [--state <state>] <snapshot>
Positional arguments
- <snapshot>
Name or ID of the snapshot to modify.
Optional arguments
- --state <state>
Indicate which state to assign the snapshot. Options
include available, error, creating, deleting,
error_deleting. If no state is provided, available will be
used.
13.96. manila snapshot-show
usage: manila snapshot-show <snapshot>
Positional arguments
- <snapshot>
Name or ID of the snapshot.
13.97. manila snapshot-unmanage
usage: manila snapshot-unmanage <snapshot> [<snapshot> ...]
Positional arguments
- <snapshot>
Name or ID of the snapshot(s).
13.98. manila type-access-add
usage: manila type-access-add <share_type> <project_id>
Positional arguments
- <share_type>
Share type name or ID to add access for the given project.
- <project_id>
Project ID to add share type access for.
13.99. manila type-access-list
usage: manila type-access-list <share_type>
Positional arguments
- <share_type>
Filter results by share type name or ID.
13.100. manila type-access-remove
usage: manila type-access-remove <share_type> <project_id>
Positional arguments
- <share_type>
Share type name or ID to remove access for the given project.
- <project_id>
Project ID to remove share type access for.
13.101. manila type-create
usage: manila type-create [--snapshot_support <snapshot_support>]
[--is_public <is_public>]
<name> <spec_driver_handles_share_servers>Positional arguments
- <name>
Name of the new share type.
- <spec_driver_handles_share_servers>
Required extra specification. Valid values are
'true'/'1' and 'false'/'0'
Optional arguments
- --snapshot_support <snapshot_support>, --snapshot-support <snapshot_support>
Boolean extra spec that used for filtering of back
ends by their capability to create share snapshots.
(Default is True).
- --is_public <is_public>, --is-public <is_public>
Make type accessible to the public (default true).
13.102. manila type-delete
usage: manila type-delete <id>
Positional arguments
- <id>
Name or ID of the share type to delete.
13.103. manila type-key
usage: manila type-key <stype> <action> [<key=value> [<key=value> ...]]
Positional arguments
- <stype>
Name or ID of the share type.
- <action>
Actions: 'set' or 'unset'.
- <key=value>
Extra_specs to set or unset (key is only necessary on unset).
13.104. manila type-list
usage: manila type-list [--all] [--columns <columns>]
Optional arguments
- --all
Display all share types (Admin only).
- --columns <columns>
Comma separated list of columns to be displayed e.g.
--columns "id,name"
13.105. manila unmanage
usage: manila unmanage <share>
Positional arguments
- <share>
Name or ID of the share(s).
13.106. manila update
usage: manila update [--name <name>] [--description <description>]
[--is-public <is_public>]
<share>Positional arguments
- <share>
Name or ID of the share to rename.
Optional arguments
- --name <name>
New name for the share.
- --description <description>
Optional share description. (Default=None)
- --is-public <is_public>, --is_public <is_public>
Public share is visible for all tenants.
