A bgpvpn resource contains a set of parameters to define a BGP-based VPN. BGP-based IP VPNs networks are widely used in the industry especially for enterprises. The networking BGP VPN project aims at supporting inter-connection between L3VPNs and Neutron resources, i.e. Networks, Routers and Ports.
Network v2
Create BGP VPN resource
openstack bgpvpn create
[-f {json,shell,table,value,yaml}]
[-c COLUMN]
[--max-width <integer>]
[--fit-width]
[--print-empty]
[--noindent]
[--prefix PREFIX]
[--project <project>]
[--project-domain <project-domain>]
[--name <name>]
[--route-target <route-target>]
[--import-target <import-target>]
[--export-target <export-target>]
[--route-distinguisher <route-distinguisher>]
[--vni VNI]
[--local-pref LOCAL_PREF]
[--type {l2,l3}]
-f
<FORMATTER>
,
--format
<FORMATTER>
¶the output format, defaults to table
-c
COLUMN
,
--column
COLUMN
¶specify the column(s) to include, can be repeated
--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.
--noindent
¶whether to disable indenting the JSON
--prefix
<PREFIX>
¶add a prefix to all variable names
--project
<project>
¶Owner’s project (name or ID)
--project-domain
<project-domain>
¶Domain the project belongs to (name or ID). This can be used in case collisions between project names exist.
--name
<name>
¶Name of the BGP VPN
--route-target
<route-target>
¶Add Route Target to import/export list (repeat option for multiple Route Targets)
--import-target
<import-target>
¶Add Route Target to import list (repeat option for multiple Route Targets)
--export-target
<export-target>
¶Add Route Target to export list (repeat option for multiple Route Targets)
--route-distinguisher
<route-distinguisher>
¶Add Route Distinguisher to the list of Route Distinguishers from which a Route Distinguishers will be picked from to advertise a VPN route (repeat option for multiple Route Distinguishers)
--vni
<VNI>
¶VXLAN Network Identifier to be used for this BGPVPN when a VXLAN encapsulation is used
--local-pref
<LOCAL_PREF>
¶Default BGP LOCAL_PREF to use in route advertisementstowards this BGPVPN.
--type
<TYPE>
¶BGP VPN type selection between IP VPN (l3) and Ethernet VPN (l2) (default: l3)
This command is provided by the python-neutronclient plugin.
Delete BGP VPN resource(s)
openstack bgpvpn delete <bgpvpn> [<bgpvpn> ...]
bgpvpn
¶BGP VPN(s) to delete (name or ID)
This command is provided by the python-neutronclient plugin.
List BGP VPN resources
openstack bgpvpn list
[-f {csv,json,table,value,yaml}]
[-c COLUMN]
[--max-width <integer>]
[--fit-width]
[--print-empty]
[--noindent]
[--quote {all,minimal,none,nonnumeric}]
[--sort-column SORT_COLUMN]
[--project <project>]
[--project-domain <project-domain>]
[--long]
[--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
--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.
--noindent
¶whether to disable indenting the JSON
--quote
<QUOTE_MODE>
¶when to include quotes, defaults to nonnumeric
--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
--project
<project>
¶Owner’s project (name or ID)
--project-domain
<project-domain>
¶Domain the project belongs to (name or ID). This can be used in case collisions between project names exist.
--long
¶List additional fields in output
--property
<key=value>
¶Filter property to apply on returned BGP VPNs (repeat to filter on multiple properties)
This command is provided by the python-neutronclient plugin.
Set BGP VPN properties
openstack bgpvpn set
[--name <name>]
[--route-target <route-target>]
[--no-route-target]
[--import-target <import-target>]
[--no-import-target]
[--export-target <export-target>]
[--no-export-target]
[--route-distinguisher <route-distinguisher>]
[--no-route-distinguisher]
[--vni VNI]
[--local-pref LOCAL_PREF]
<bgpvpn>
--name
<name>
¶Name of the BGP VPN
--route-target
<route-target>
¶Add Route Target to import/export list (repeat option for multiple Route Targets)
--no-route-target
¶Empty route target list
--import-target
<import-target>
¶Add Route Target to import list (repeat option for multiple Route Targets)
--no-import-target
¶Empty import route target list
--export-target
<export-target>
¶Add Route Target to export list (repeat option for multiple Route Targets)
--no-export-target
¶Empty export route target list
--route-distinguisher
<route-distinguisher>
¶Add Route Distinguisher to the list of Route Distinguishers from which a Route Distinguishers will be picked from to advertise a VPN route (repeat option for multiple Route Distinguishers)
--no-route-distinguisher
¶Empty route distinguisher list
--vni
<VNI>
¶VXLAN Network Identifier to be used for this BGPVPN when a VXLAN encapsulation is used
--local-pref
<LOCAL_PREF>
¶Default BGP LOCAL_PREF to use in route advertisementstowards this BGPVPN.
bgpvpn
¶BGP VPN to update (name or ID)
This command is provided by the python-neutronclient plugin.
Show information of a given BGP VPN
openstack bgpvpn show
[-f {json,shell,table,value,yaml}]
[-c COLUMN]
[--max-width <integer>]
[--fit-width]
[--print-empty]
[--noindent]
[--prefix PREFIX]
<bgpvpn>
-f
<FORMATTER>
,
--format
<FORMATTER>
¶the output format, defaults to table
-c
COLUMN
,
--column
COLUMN
¶specify the column(s) to include, can be repeated
--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.
--noindent
¶whether to disable indenting the JSON
--prefix
<PREFIX>
¶add a prefix to all variable names
bgpvpn
¶BGP VPN to display (name or ID)
This command is provided by the python-neutronclient plugin.
Unset BGP VPN properties
openstack bgpvpn unset
[--route-target <route-target>]
[--all-route-target]
[--import-target <import-target>]
[--all-import-target]
[--export-target <export-target>]
[--all-export-target]
[--route-distinguisher <route-distinguisher>]
[--all-route-distinguisher]
[--vni VNI]
[--local-pref LOCAL_PREF]
<bgpvpn>
--route-target
<route-target>
¶Remove Route Target from import/export list (repeat option for multiple Route Targets)
--all-route-target
¶Empty route target list
--import-target
<import-target>
¶Remove Route Target from import list (repeat option for multiple Route Targets)
--all-import-target
¶Empty import route target list
--export-target
<export-target>
¶Remove Route Target from export list (repeat option for multiple Route Targets)
--all-export-target
¶Empty export route target list
--route-distinguisher
<route-distinguisher>
¶Remove Route Distinguisher from the list of Route Distinguishers from which a Route Distinguishers will be picked from to advertise a VPN route (repeat option for multiple Route Distinguishers)
--all-route-distinguisher
¶Empty route distinguisher list
--vni
<VNI>
¶VXLAN Network Identifier to be used for this BGPVPN when a VXLAN encapsulation is used
--local-pref
<LOCAL_PREF>
¶Default BGP LOCAL_PREF to use in route advertisementstowards this BGPVPN.
bgpvpn
¶BGP VPN to update (name or ID)
This command is provided by the python-neutronclient plugin.
Create a BGP VPN network association
openstack bgpvpn network association create
[-f {json,shell,table,value,yaml}]
[-c COLUMN]
[--max-width <integer>]
[--fit-width]
[--print-empty]
[--noindent]
[--prefix PREFIX]
[--project <project>]
[--project-domain <project-domain>]
<bgpvpn>
<network>
-f
<FORMATTER>
,
--format
<FORMATTER>
¶the output format, defaults to table
-c
COLUMN
,
--column
COLUMN
¶specify the column(s) to include, can be repeated
--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.
--noindent
¶whether to disable indenting the JSON
--prefix
<PREFIX>
¶add a prefix to all variable names
--project
<project>
¶Owner’s project (name or ID)
--project-domain
<project-domain>
¶Domain the project belongs to (name or ID). This can be used in case collisions between project names exist.
bgpvpn
¶BGP VPN to apply the network association (name or ID)
network
¶Network to associate the BGP VPN (name or ID)
This command is provided by the python-neutronclient plugin.
Delete a BGP VPN network association(s) for a given BGP VPN
openstack bgpvpn network association delete
<network
association
ID>
[<network association ID> ...]
<bgpvpn>
network
association ID
¶Network association ID(s) to remove
bgpvpn
¶BGP VPN the network association belongs to (name or ID)
This command is provided by the python-neutronclient plugin.
List BGP VPN network associations for a given BGP VPN
openstack bgpvpn network association list
[-f {csv,json,table,value,yaml}]
[-c COLUMN]
[--max-width <integer>]
[--fit-width]
[--print-empty]
[--noindent]
[--quote {all,minimal,none,nonnumeric}]
[--sort-column SORT_COLUMN]
[--long]
[--property <key=value>]
<bgpvpn>
-f
<FORMATTER>
,
--format
<FORMATTER>
¶the output format, defaults to table
-c
COLUMN
,
--column
COLUMN
¶specify the column(s) to include, can be repeated
--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.
--noindent
¶whether to disable indenting the JSON
--quote
<QUOTE_MODE>
¶when to include quotes, defaults to nonnumeric
--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
--long
¶List additional fields in output
--property
<key=value>
¶Filter property to apply on returned BGP VPNs (repeat to filter on multiple properties)
bgpvpn
¶BGP VPN listed associations belong to (name or ID)
This command is provided by the python-neutronclient plugin.
Show information of a given BGP VPN network association
openstack bgpvpn network association show
[-f {json,shell,table,value,yaml}]
[-c COLUMN]
[--max-width <integer>]
[--fit-width]
[--print-empty]
[--noindent]
[--prefix PREFIX]
<network
association
ID>
<bgpvpn>
-f
<FORMATTER>
,
--format
<FORMATTER>
¶the output format, defaults to table
-c
COLUMN
,
--column
COLUMN
¶specify the column(s) to include, can be repeated
--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.
--noindent
¶whether to disable indenting the JSON
--prefix
<PREFIX>
¶add a prefix to all variable names
network
association ID
¶Network association ID to look up
bgpvpn
¶BGP VPN the association belongs to (name or ID)
This command is provided by the python-neutronclient plugin.
Create a BGP VPN router association
openstack bgpvpn router association create
[-f {json,shell,table,value,yaml}]
[-c COLUMN]
[--max-width <integer>]
[--fit-width]
[--print-empty]
[--noindent]
[--prefix PREFIX]
[--project <project>]
[--project-domain <project-domain>]
<bgpvpn>
<router>
-f
<FORMATTER>
,
--format
<FORMATTER>
¶the output format, defaults to table
-c
COLUMN
,
--column
COLUMN
¶specify the column(s) to include, can be repeated
--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.
--noindent
¶whether to disable indenting the JSON
--prefix
<PREFIX>
¶add a prefix to all variable names
--project
<project>
¶Owner’s project (name or ID)
--project-domain
<project-domain>
¶Domain the project belongs to (name or ID). This can be used in case collisions between project names exist.
bgpvpn
¶BGP VPN to apply the router association (name or ID)
router
¶Router to associate the BGP VPN (name or ID)
This command is provided by the python-neutronclient plugin.
Delete a BGP VPN router association(s) for a given BGP VPN
openstack bgpvpn router association delete
<router
association
ID>
[<router association ID> ...]
<bgpvpn>
router
association ID
¶Router association ID(s) to remove
bgpvpn
¶BGP VPN the router association belongs to (name or ID)
This command is provided by the python-neutronclient plugin.
List BGP VPN router associations for a given BGP VPN
openstack bgpvpn router association list
[-f {csv,json,table,value,yaml}]
[-c COLUMN]
[--max-width <integer>]
[--fit-width]
[--print-empty]
[--noindent]
[--quote {all,minimal,none,nonnumeric}]
[--sort-column SORT_COLUMN]
[--long]
[--property <key=value>]
<bgpvpn>
-f
<FORMATTER>
,
--format
<FORMATTER>
¶the output format, defaults to table
-c
COLUMN
,
--column
COLUMN
¶specify the column(s) to include, can be repeated
--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.
--noindent
¶whether to disable indenting the JSON
--quote
<QUOTE_MODE>
¶when to include quotes, defaults to nonnumeric
--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
--long
¶List additional fields in output
--property
<key=value>
¶Filter property to apply on returned BGP VPNs (repeat to filter on multiple properties)
bgpvpn
¶BGP VPN listed associations belong to (name or ID)
This command is provided by the python-neutronclient plugin.
Show information of a given BGP VPN router association
openstack bgpvpn router association show
[-f {json,shell,table,value,yaml}]
[-c COLUMN]
[--max-width <integer>]
[--fit-width]
[--print-empty]
[--noindent]
[--prefix PREFIX]
<router
association
ID>
<bgpvpn>
-f
<FORMATTER>
,
--format
<FORMATTER>
¶the output format, defaults to table
-c
COLUMN
,
--column
COLUMN
¶specify the column(s) to include, can be repeated
--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.
--noindent
¶whether to disable indenting the JSON
--prefix
<PREFIX>
¶add a prefix to all variable names
router
association ID
¶Router association ID to look up
bgpvpn
¶BGP VPN the association belongs to (name or ID)
This command is provided by the python-neutronclient plugin.
Create a BGP VPN port association
openstack bgpvpn port association create
[-f {json,shell,table,value,yaml}]
[-c COLUMN]
[--max-width <integer>]
[--fit-width]
[--print-empty]
[--noindent]
[--prefix PREFIX]
[--project <project>]
[--project-domain <project-domain>]
[--advertise-fixed-ips | --no-advertise-fixed-ips]
[--prefix-route prefix=<cidr>[,local_pref=<integer>]]
[--bgpvpn-route bgpvpn=<BGP VPN ID or name>[,local_pref=<integer>]]
<bgpvpn>
<port>
-f
<FORMATTER>
,
--format
<FORMATTER>
¶the output format, defaults to table
-c
COLUMN
,
--column
COLUMN
¶specify the column(s) to include, can be repeated
--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.
--noindent
¶whether to disable indenting the JSON
--prefix
<PREFIX>
¶add a prefix to all variable names
--project
<project>
¶Owner’s project (name or ID)
--project-domain
<project-domain>
¶Domain the project belongs to (name or ID). This can be used in case collisions between project names exist.
--advertise-fixed-ips
¶Fixed IPs of the port will be advertised to the BGP VPN (default)
--no-advertise-fixed-ips
¶Fixed IPs of the port will not be advertised to the BGP VPN
--prefix-route
prefix=<cidr>[,local_pref=<integer>]
¶Add prefix route in CIDR notation. Optionally, can control the value of the BGP LOCAL_PREF of the routes that will be advertised (repeat option for multiple prefix routes)
--bgpvpn-route
bgpvpn=<BGP VPN ID or name>[,local_pref=<integer>]
¶Add BGP VPN route for route leaking. Optionally, can control the value of the BGP LOCAL_PREF of the routes that will be advertised (repeat option for multiple BGP VPN routes)
bgpvpn
¶BGP VPN to apply the port association (name or ID)
port
¶Port to associate the BGP VPN (name or ID)
This command is provided by the python-neutronclient plugin.
Delete a BGP VPN port association(s) for a given BGP VPN
openstack bgpvpn port association delete
<port
association
ID>
[<port association ID> ...]
<bgpvpn>
port
association ID
¶Port association ID(s) to remove
bgpvpn
¶BGP VPN the port association belongs to (name or ID)
This command is provided by the python-neutronclient plugin.
List BGP VPN port associations for a given BGP VPN
openstack bgpvpn port association list
[-f {csv,json,table,value,yaml}]
[-c COLUMN]
[--max-width <integer>]
[--fit-width]
[--print-empty]
[--noindent]
[--quote {all,minimal,none,nonnumeric}]
[--sort-column SORT_COLUMN]
[--long]
[--property <key=value>]
<bgpvpn>
-f
<FORMATTER>
,
--format
<FORMATTER>
¶the output format, defaults to table
-c
COLUMN
,
--column
COLUMN
¶specify the column(s) to include, can be repeated
--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.
--noindent
¶whether to disable indenting the JSON
--quote
<QUOTE_MODE>
¶when to include quotes, defaults to nonnumeric
--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
--long
¶List additional fields in output
--property
<key=value>
¶Filter property to apply on returned BGP VPNs (repeat to filter on multiple properties)
bgpvpn
¶BGP VPN listed associations belong to (name or ID)
This command is provided by the python-neutronclient plugin.
Set BGP VPN port association properties
openstack bgpvpn port association set
[--advertise-fixed-ips | --no-advertise-fixed-ips]
[--prefix-route prefix=<cidr>[,local_pref=<integer>]]
[--bgpvpn-route bgpvpn=<BGP VPN ID or name>[,local_pref=<integer>]]
[--no-prefix-route]
[--no-bgpvpn-route]
<port
association
ID>
<bgpvpn>
--advertise-fixed-ips
¶Fixed IPs of the port will be advertised to the BGP VPN
--no-advertise-fixed-ips
¶Fixed IPs of the port will not be advertised to the BGP VPN
--prefix-route
prefix=<cidr>[,local_pref=<integer>]
¶Add prefix route in CIDR notation. Optionally, can control the value of the BGP LOCAL_PREF of the routes that will be advertised (repeat option for multiple prefix routes)
--bgpvpn-route
bgpvpn=<BGP VPN ID or name>[,local_pref=<integer>]
¶Add BGP VPN route for route leaking. Optionally, can control the value of the BGP LOCAL_PREF of the routes that will be advertised (repeat option for multiple BGP VPN routes)
--no-prefix-route
¶Empty prefix route list
--no-bgpvpn-route
¶Empty BGP VPN route list
port
association ID
¶Port association ID to update
bgpvpn
¶BGP VPN the port association belongs to (name or ID)
This command is provided by the python-neutronclient plugin.
Show information of a given BGP VPN port association
openstack bgpvpn port association show
[-f {json,shell,table,value,yaml}]
[-c COLUMN]
[--max-width <integer>]
[--fit-width]
[--print-empty]
[--noindent]
[--prefix PREFIX]
<port
association
ID>
<bgpvpn>
-f
<FORMATTER>
,
--format
<FORMATTER>
¶the output format, defaults to table
-c
COLUMN
,
--column
COLUMN
¶specify the column(s) to include, can be repeated
--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.
--noindent
¶whether to disable indenting the JSON
--prefix
<PREFIX>
¶add a prefix to all variable names
port
association ID
¶Port association ID to look up
bgpvpn
¶BGP VPN the association belongs to (name or ID)
This command is provided by the python-neutronclient plugin.
Unset BGP VPN port association properties
openstack bgpvpn port association unset
[--advertise-fixed-ips | --no-advertise-fixed-ips]
[--prefix-route <cidr>]
[--bgpvpn-route <BGP VPN ID or name>]
[--all-prefix-routes]
[--all-bgpvpn-routes]
<port
association
ID>
<bgpvpn>
--advertise-fixed-ips
¶Fixed IPs of the port will not be advertised to the BGP VPN
--no-advertise-fixed-ips
¶Fixed IPs of the port will be advertised to the BGP VPN
--prefix-route
<cidr>
¶Remove prefix route in CIDR notation (repeat option for multiple prefix routes)
--bgpvpn-route
<BGP VPN ID or name>
¶Remove BGP VPN route (repeat option for multiple BGP VPN routes)
--all-prefix-routes
¶Empty prefix route list
--all-bgpvpn-routes
¶Empty BGP VPN route list
port
association ID
¶Port association ID to update
bgpvpn
¶BGP VPN the port association belongs to (name or ID)
This command is provided by the python-neutronclient plugin.
Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.