Update documentation for rax module

Only list the services supported
Don't put in unncessary required: false
Use better formatting for the example
reviewable/pr18780/r1
Jesse Keating 12 years ago
parent 7238fcb522
commit 4c0f37afe3

29
rax

@ -17,42 +17,36 @@
DOCUMENTATION = '''
---
module: rax
short_description: create an instance in Rackspace Public Cloud, return instanceid
short_description: create / delete an instance in Rackspace Public Cloud
description:
- creates Rackspace Public Cloud instances and optionally waits for it to be 'running'.
- creates / deletes Rackspace Public Cloud instances and optionally waits for it to be 'running'.
version_added: "1.2"
options:
service:
description:
- Cloud service to interact with
required: false
choices: ['cloudservers', 'cloudfiles', 'cloud_databases', 'cloud_loadbalancers']
choices: ['cloudservers']
default: cloudservers
state:
description:
- Indicate desired state of the resource
required: false
choices: ['present', 'active', 'absent', 'deleted']
default: present
creds_file:
description:
- File to find the Rackspace Public Cloud credentials in
required: false
default: null
name:
description:
- Name to give the instance
required: false
default: null
flavor:
description:
- flavor to use for the instance
required: false
default: null
image:
description:
- image to use for the instance
required: false
default: null
meta:
description:
@ -61,7 +55,6 @@ options:
key_name:
description:
- key pair to use on the instance
required: false
default: null
aliases: ['keypair']
files:
@ -71,12 +64,10 @@ options:
region:
description:
- Region to create an instance in
required: false
default: null
wait:
description:
- wait for the instance to be in state 'running' before returning
required: false
default: "no"
choices: [ "yes", "no" ]
wait_timeout:
@ -84,8 +75,18 @@ options:
- how long before wait gives up, in seconds
default: 300
examples:
- code: 'local_action: rax creds_file=~/.raxpub service=cloudservers name=rax-test1 flavor=5 image=b11d9567-e412-4255-96b9-bd63ab23bcfe wait=yes state=present'
description: "Examples from Ansible Playbooks"
- code: |
- name: Create a server
local_action:
module: rax
creds_file: ~/.raxpub
service: cloudservers
name: rax-test1
flavor: 5
image: b11d9567-e412-4255-96b9-bd63ab23bcfe
wait: yes
state: present
description: "Example from Ansible Playbooks"
requirements: [ "pyrax" ]
author: Jesse Keating
notes:

Loading…
Cancel
Save