Documentation

quantum_network - Creates/Removes networks from OpenStack

New in version 1.4.

DEPRECATED

Deprecated in 2.0. Use os_network instead.

Synopsis

  • Add or Remove network from OpenStack.

Requirements (on host that executes module)

  • python >= 2.6
  • python-neutronclient or python-quantumclient
  • python-keystoneclient

Options

parameter required default choices comments
admin_state_up
no True
Whether the state should be marked as up or down
auth_url
no http://127.0.0.1:35357/v2.0/
The keystone url for authentication
login_password
yes yes
Password of login user
login_tenant_name
yes yes
The tenant name of the login user
login_username
yes admin
login username to authenticate to keystone
name
yes None
Name to be assigned to the network
provider_network_type
no None
The type of the network to be created, gre, vlan, local. Available types depend on the plugin. The Quantum service decides if not specified.
provider_physical_network
no None
The physical network which would realize the virtual network for flat and vlan networks.
provider_segmentation_id
no None
The id that has to be assigned to the network, in case of vlan networks that would be vlan id and for gre the tunnel id
region_name
no None
Name of the region
router_external
no
If 'yes', specifies that the virtual network is a external network (public).
shared
no
Whether this network is shared or not
state
no present
  • present
  • absent
Indicate desired state of the resource
tenant_name
no None
The name of the tenant for whom the network is created

Examples

- name: Create a GRE backed Quantum network with tunnel id 1 for tenant1
  quantum_network:
    name: t1network
    tenant_name: tenant1
    state: present
    provider_network_type: gre
    provider_segmentation_id: 1
    login_username: admin
    login_password: admin
    login_tenant_name: admin

- name: Create an external network
  quantum_network:
    name: external_network
    state: present
    provider_network_type: local
    router_external: yes
    login_username: admin
    login_password: admin
    login_tenant_name: admin

For help in developing on modules, should you be so inclined, please read Community Information & Contributing, Helping Testing PRs and Developing Modules.