rax_network - create / delete an isolated network in Rackspace Public Cloud

Author:Christopher H. Laco, Jesse Keating

Synopsis

New in version 1.4.

creates / deletes a Rackspace Public Cloud isolated network.

Options

parameter required default choices comments
api_key no
    Rackspace API key (overrides credentials)
    auth_endpoint no https://identity.api.rackspacecloud.com/v2.0/
      The URI of the authentication service (added in Ansible 1.5)
      cidr no
        cidr of the network being created
        credentials no
          File to find the Rackspace credentials in (ignored if api_key and username are provided)
          env no
            Environment as configured in ~/.pyrax.cfg, see https://github.com/rackspace/pyrax/blob/master/docs/getting_started.md#pyrax-configuration (added in Ansible 1.5)
            identity_type no rackspace
              Authentication machanism to use, such as rackspace or keystone (added in Ansible 1.5)
              label no
                Label (name) to give the network
                region no DFW
                  Region to create an instance in
                  state no present
                  • present
                  • absent
                  Indicate desired state of the resource
                  tenant_id no
                    The tenant ID used for authentication (added in Ansible 1.5)
                    tenant_name no
                      The tenant name used for authentication (added in Ansible 1.5)
                      username no
                        Rackspace username (overrides credentials)
                        verify_ssl no
                          Whether or not to require SSL validation of API endpoints (added in Ansible 1.5)

                          Note

                          Requires pyrax

                          Examples


                          - name: Build an Isolated Network
                            gather_facts: False
                          
                            tasks:
                              - name: Network create request
                                local_action:
                                  module: rax_network
                                  credentials: ~/.raxpub
                                  label: my-net
                                  cidr: 192.168.3.0/24
                                  state: present
                          

                          Note

                          The following environment variables can be used, RAX_USERNAME, RAX_API_KEY, RAX_CREDS_FILE, RAX_CREDENTIALS, RAX_REGION.

                          Note

                          RAX_CREDENTIALS and RAX_CREDS_FILE points to a credentials file appropriate for pyrax. See https://github.com/rackspace/pyrax/blob/master/docs/getting_started.md#authenticating

                          Note

                          RAX_USERNAME and RAX_API_KEY obviate the use of a credentials file

                          Note

                          RAX_REGION defines a Rackspace Public Cloud region (DFW, ORD, LON, ...)