summaryrefslogtreecommitdiff
path: root/doc/source/command-objects/subnet-pool.rst
blob: 005b83579bd2c8fd2b7f1a5c46fa192de91be420 (plain)
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
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
===========
subnet pool
===========

A **subnet pool** contains a collection of prefixes in CIDR notation
that are available for IP address allocation.

Network v2

subnet pool create
------------------

Create subnet pool

.. program:: subnet pool create
.. code:: bash

    os subnet pool create
        [--default-prefix-length <default-prefix-length>]
        [--min-prefix-length <min-prefix-length>]
        [--max-prefix-length <max-prefix-length>]
        [--project <project> [--project-domain <project-domain>]]
        [--address-scope <address-scope>]
        [--default | --no-default]
        [--share | --no-share]
        --pool-prefix <pool-prefix> [...]
        <name>

.. option:: --default-prefix-length <default-prefix-length>

    Set subnet pool default prefix length

.. option:: --min-prefix-length <min-prefix-length>

    Set subnet pool minimum prefix length

.. option:: --max-prefix-length <max-prefix-length>

    Set subnet pool maximum prefix length

.. option:: --project <project>

    Owner's project (name or ID)

.. option:: --project-domain <project-domain>

    Domain the project belongs to (name or ID). This can be used in case
    collisions between project names exist.

.. option:: --address-scope <address-scope>

    Set address scope associated with the subnet pool (name or ID),
    prefixes must be unique across address scopes

.. option:: --default

    Set this as a default subnet pool

.. option:: --no-default

    Set this as a non-default subnet pool

.. option:: --share

    Set this subnet pool as shared

.. option:: --no-share

    Set this subnet pool as not shared

.. describe:: --pool-prefix <pool-prefix>

    Set subnet pool prefixes (in CIDR notation)
    (repeat option to set multiple prefixes)

.. _subnet_pool_create-name:
.. describe:: <name>

    Name of the new subnet pool

subnet pool delete
------------------

Delete subnet pool(s)

.. program:: subnet pool delete
.. code:: bash

    os subnet pool delete
        <subnet-pool> [<subnet-pool> ...]

.. _subnet_pool_delete-subnet-pool:
.. describe:: <subnet-pool>

    Subnet pool(s) to delete (name or ID)

subnet pool list
----------------

List subnet pools

.. program:: subnet pool list
.. code:: bash

    os subnet pool list
        [--long]

.. option:: --long

    List additional fields in output

subnet pool set
---------------

Set subnet pool properties

.. program:: subnet pool set
.. code:: bash

    os subnet pool set
        [--name <name>]
        [--pool-prefix <pool-prefix> [...]]
        [--default-prefix-length <default-prefix-length>]
        [--min-prefix-length <min-prefix-length>]
        [--max-prefix-length <max-prefix-length>]
        [--address-scope <address-scope> | --no-address-scope]
        [--default | --no-default]
        <subnet-pool>

.. option:: --name <name>

    Set subnet pool name

.. option:: --pool-prefix <pool-prefix>

    Set subnet pool prefixes (in CIDR notation)
    (repeat option to set multiple prefixes)

.. option:: --default-prefix-length <default-prefix-length>

    Set subnet pool default prefix length

.. option:: --min-prefix-length <min-prefix-length>

    Set subnet pool minimum prefix length

.. option:: --max-prefix-length <max-prefix-length>

    Set subnet pool maximum prefix length

.. option:: --address-scope <address-scope>

    Set address scope associated with the subnet pool (name or ID),
    prefixes must be unique across address scopes

.. option:: --no-address-scope

    Remove address scope associated with the subnet pool

.. option:: --default

    Set this as a default subnet pool

.. option:: --no-default

    Set this as a non-default subnet pool

.. _subnet_pool_set-subnet-pool:
.. describe:: <subnet-pool>

    Subnet pool to modify (name or ID)

subnet pool show
----------------

Display subnet pool details

.. program:: subnet pool show
.. code:: bash

    os subnet pool show
        <subnet-pool>

.. _subnet_pool_show-subnet-pool:
.. describe:: <subnet-pool>

    Subnet pool to display (name or ID)

subnet pool unset
-----------------

Unset subnet pool properties

.. program:: subnet pool unset
.. code:: bash

    os subnet pool unset
        [--pool-prefix <pool-prefix> [...]]
        <subnet-pool>

.. option:: --pool-prefix <pool-prefix>

    Remove subnet pool prefixes (in CIDR notation).
    (repeat option to unset multiple prefixes).

.. _subnet_pool_unset-subnet-pool:
.. describe:: <subnet-pool>

    Subnet pool to modify (name or ID)