ANSIBLE.RAX_FACTS(3)            ANSIBLE MODULES           ANSIBLE.RAX_FACTS(3)



NAME
       rax_facts - Gather facts for Rackspace Cloud Servers

DESCRIPTION
       Gather facts for Rackspace Cloud Servers.

OPTIONS
       address
              Server IP address to retrieve facts for, will match any IP
              assigned to the server

       api_key
              Rackspace API key (overrides credentials)

       credentials
              File to find the Rackspace credentials in (ignored if api_key
              and username are provided)

       id     Server ID to retrieve facts for

       name   Server name to retrieve facts for

       region Region to retrieve facts for (default: DFW)

       username
              Rackspace username (overrides credentials).

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

       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

       RAX_USERNAME and RAX_API_KEY obviate the use of a credentials file

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

EXAMPLES
       - name: Gather info about servers
         hosts: all
         gather_facts: False
         tasks:
           - name: Get facts about servers
             local_action:
               module: rax_facts
               credentials: ~/.raxpub
               name: "{{ inventory_hostname }}"
               region: DFW
           - name: Map some facts
             set_fact:
               ansible_ssh_host: "{{ rax_accessipv4 }}"



AUTHOR
       Matt Martz

SEE ALSO
       ansible(1), http://ansible.github.com/modules.html#rax-facts



1.4.5                             2014-02-12              ANSIBLE.RAX_FACTS(3)
