Allow os_server_facts to filter results based on provided filters dictionary (#23638)

* add filters variable to allow servers to be selected based on arbitrary nova properties

* update docs to fix yaml

* add required info for filters variable in the docs

* bump version number

* clean up documentation
pull/47552/head
Dave Buckley 6 years ago committed by ansibot
parent 40e5d2c951
commit 2bdab94b0b

@ -37,6 +37,11 @@ options:
of additional API calls.
type: bool
default: 'no'
filters:
description:
- restrict results to servers matching a dictionary of
filters
version_added: "2.8"
availability_zone:
description:
- Ignored. Present for backwards compatibility
@ -44,10 +49,12 @@ extends_documentation_fragment: openstack
'''
EXAMPLES = '''
# Gather facts about all servers named <web*>:
# Gather facts about all servers named <web*> that are in an active state:
- os_server_facts:
cloud: rax-dfw
server: web*
filters:
vm_state: active
- debug:
var: openstack_servers
'''
@ -63,6 +70,7 @@ def main():
argument_spec = openstack_full_argument_spec(
server=dict(required=False),
detailed=dict(required=False, type='bool'),
filters=dict(required=False, type='dict', default=None)
)
module_kwargs = openstack_module_kwargs()
module = AnsibleModule(argument_spec, **module_kwargs)
@ -71,6 +79,8 @@ def main():
try:
openstack_servers = cloud.list_servers(
detailed=module.params['detailed'])
openstack_servers = cloud.search_servers(
detailed=module.params['detailed'], filters=module.params['filters'])
if module.params['server']:
# filter servers by name

Loading…
Cancel
Save