File: osc_plugin_cli.rst

package info (click to toggle)
python-manilaclient 5.4.0-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 3,768 kB
  • sloc: python: 49,541; makefile: 99; sh: 2
file content (85 lines) | stat: -rw-r--r-- 1,696 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
================================================
``openstack share`` Command-Line Interface (CLI)
================================================

.. program:: openstack share

Synopsis
========

:program:`openstack [options] share` <command> [command-options]

:program:`openstack help share` <command>


Description
===========

The OpenStack Client plugin interacts with the Manila service
through the ``openstack share`` command line interface (CLI).

To use the CLI, you must provide your OpenStack username, password,
project, auth endpoint and the share API version.
You can use configuration options ``--os-username``,
``--os-password``, ``--os-project-name``, ``--os-auth-url``
and ``--os-share-api-version``, or set the corresponding
environment variables::

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


Getting help
============

To get a full list of all possible commands, run::

    $ openstack help share

To get detailed help for one command, run::

    $ openstack help share <command>


Examples
========

Get information about the openstack share create command::

    $ openstack help share create

Create one share::

    $ openstack share create NFS 1 --name "myshare"

List shares::

    $ openstack share list

Display a share::

    $ openstack share show myshare

Delete a share::

    $ openstack share delete myshare

Extend a 1gb share to 2gb::

    $ openstack share resize myshare 2

Shrink a 2gb share to 1gb::

    $ openstack share resize myshare 1


Command Reference
=================
.. toctree::
   :glob:
   :maxdepth: 3

   osc/v2/*