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

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