The manila shell utility

The manila shell utility

The manila shell utility interacts with the OpenStack Manila API from the command line. It supports the entirety of the OpenStack Manila API.

You’ll need to provide manila with your OpenStack username and API key. You can do this with the –os-username, –os-password and –os-tenant-name options, but it’s easier to just set them as environment variables by setting two environment variables:

OS_USERNAME or MANILA_USERNAME

Your OpenStack Manila username.

OS_PASSWORD or MANILA_PASSWORD

Your password.

OS_TENANT_NAME or MANILA_PROJECT_ID

Project for work.

OS_AUTH_URL or MANILA_URL

The OpenStack API server URL.

OS_SHARE_API_VERSION

The OpenStack Shared Filesystems API version.

For example, in Bash you’d use:

export OS_USERNAME=foo
export OS_PASSWORD=bar
export OS_TENANT_NAME=foobarproject
export OS_AUTH_URL=http://...
export OS_SHARE_API_VERSION=2

From there, all shell commands take the form:

manila <command> [arguments...]

Run manila help to get a full list of all possible commands, and run manila help <command> to get detailed help for that command.

manila help:

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



Command-line interface to the OpenStack Manila API.



Positional arguments:

  <subcommand>

    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.

    availability-zone-list

                        List all availability zones.

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

    message-delete      Remove one or more messages.

    message-list        Lists all messages.

    message-show        Show details about a message.

    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 or tenant/share-type.

                        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 project/user and/or share type

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

    revert-to-snapshot  Revert a share to the specified snapshot.

    security-service-create

                        Create security service used by tenant.

    security-service-delete

                        Delete one or more security services.

    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-group-create  Creates a new share group (Experimental).

    share-group-delete  Remove one or more share groups (Experimental).

    share-group-list    List share groups with filters (Experimental).

    share-group-reset-state

                        Explicitly update the state of a share group (Admin

                        only, Experimental).

    share-group-show    Show details about a share group (Experimental).

    share-group-snapshot-create

                        Creates a new share group snapshot (Experimental).

    share-group-snapshot-delete

                        Remove one or more share group snapshots

                        (Experimental).

    share-group-snapshot-list

                        List share group snapshots with filters

                        (Experimental).

    share-group-snapshot-list-members

                        List members of a share group snapshot (Experimental).

    share-group-snapshot-reset-state

                        Explicitly update the state of a share group snapshot

                        (Admin only, Experimental).

    share-group-snapshot-show

                        Show details about a share group snapshot

                        (Experimental).

    share-group-snapshot-update

                        Update a share group snapshot (Experimental).

    share-group-type-access-add

                        Adds share group type access for the given project

                        (Admin only).

    share-group-type-access-list

                        Print access information about a share group type

                        (Admin only).

    share-group-type-access-remove

                        Removes share group type access for the given project

                        (Admin only).

    share-group-type-create

                        Create a new share group type (Admin only).

    share-group-type-delete

                        Delete a specific share group type (Admin only).

    share-group-type-key

                        Set or unset group_spec for a share group type (Admin

                        only).

    share-group-type-list

                        Print a list of available 'share group types'.

    share-group-type-specs-list

                        Print a list of 'share group types specs' (Admin

                        Only).

    share-group-update  Update a share group (Experimental).

    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 one or more share networks.

    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 one or more share servers (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-access-allow

                        Allow read only access to a snapshot.

    snapshot-access-deny

                        Deny access to a snapshot.

    snapshot-access-list

                        Show access list for a snapshot.

    snapshot-create     Add a new snapshot.

    snapshot-delete     Remove one or more snapshots.

    snapshot-export-location-list

                        List export locations of a given snapshot.

    snapshot-export-location-show

                        Show export location of the share snapshot.

    snapshot-force-delete

                        Attempt force-deletion of one or more snapshots.

                        Regardless of the state (Admin only).

    snapshot-instance-export-location-list

                        List export locations of a given snapshot instance.

    snapshot-instance-export-location-show

                        Show export location of the share instance snapshot.

    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 one or more specific share types (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.



Optional arguments:

  --version             show program's version number and exit

  -d, --debug           Print debugging output.

  --os-cache            Use the auth token cache. Defaults to env[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 to env[OS_USERNAME].

  --os-password <auth-password>

                        Defaults to env[OS_PASSWORD].

  --os-tenant-name <auth-tenant-name>

                        Defaults to env[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 to env[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 to env[OS_PROJECT_DOMAIN_ID].

  --os-project-domain-name <auth-project-domain-name>

                        Defaults to env[OS_PROJECT_DOMAIN_NAME].

  --os-auth-url <auth-url>

                        Defaults to env[OS_AUTH_URL].

  --os-region-name <region-name>

                        Defaults to env[OS_REGION_NAME].

  --os-token <token>    Defaults to env[OS_TOKEN].

  --bypass-url <bypass-url>

                        Use this API endpoint instead of the Service Catalog.

                        Defaults to env[OS_MANILA_BYPASS_URL].

  --service-type <service-type>

                        Defaults to compute for most actions.

  --service-name <service-name>

                        Defaults to env[OS_MANILA_SERVICE_NAME].

  --share-service-name <share-service-name>

                        Defaults to env[OS_MANILA_SHARE_SERVICE_NAME].

  --endpoint-type <endpoint-type>

                        Defaults to env[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 to env[OS_CERT].



See "manila help COMMAND" for help on a specific command.
Creative Commons Attribution 3.0 License

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.