1b38b7c500
With "extends_documentation_fragment: ['openstack.cloud.openstack']" it is not necessary to list required Python libraries in section 'requirements' of DOCUMENTATION docstring in modules. Ansible will merge requirements from doc fragments and DOCUMENTATION docstring which previously resulted in duplicates such as in server module [0]: * openstacksdk * openstacksdk >= 0.36, < 0.99.0 * python >= 3.6 When removing the 'requirements' section from server module, then Ansible will list openstacksdk once only: * openstacksdk >= 0.36, < 0.99.0 * python >= 3.6 To see what documentation Ansible will produce for server module run: ansible-doc --type module openstack.cloud.server [0] https://docs.ansible.com/ansible/latest/collections/openstack/\ cloud/server_module.html Change-Id: I727ed95ee480bb644b5a533f6a9526973677064c
166 lines
4.6 KiB
Python
166 lines
4.6 KiB
Python
#!/usr/bin/python
|
|
# -*- coding: utf-8 -*-
|
|
|
|
# Copyright (c) 2016 Hewlett-Packard Enterprise Corporation
|
|
# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
|
|
|
|
DOCUMENTATION = '''
|
|
---
|
|
module: identity_user_info
|
|
short_description: Retrieve information about one or more OpenStack users
|
|
author: OpenStack Ansible SIG
|
|
description:
|
|
- Retrieve information about a one or more OpenStack users
|
|
options:
|
|
name:
|
|
description:
|
|
- Name or ID of the user
|
|
type: str
|
|
domain:
|
|
description:
|
|
- Name or ID of the domain containing the user if the cloud supports domains
|
|
type: str
|
|
filters:
|
|
description:
|
|
- A dictionary of meta data to use for further filtering. Elements of
|
|
this dictionary may be additional dictionaries.
|
|
type: dict
|
|
default: {}
|
|
extends_documentation_fragment:
|
|
- openstack.cloud.openstack
|
|
'''
|
|
|
|
EXAMPLES = '''
|
|
# Gather information about previously created users
|
|
- openstack.cloud.identity_user_info:
|
|
cloud: awesomecloud
|
|
register: result
|
|
- debug:
|
|
msg: "{{ result.users }}"
|
|
|
|
# Gather information about a previously created user by name
|
|
- openstack.cloud.identity_user_info:
|
|
cloud: awesomecloud
|
|
name: demouser
|
|
register: result
|
|
- debug:
|
|
msg: "{{ result.users }}"
|
|
|
|
# Gather information about a previously created user in a specific domain
|
|
- openstack.cloud.identity_user_info:
|
|
cloud: awesomecloud
|
|
name: demouser
|
|
domain: admindomain
|
|
register: result
|
|
- debug:
|
|
msg: "{{ result.users }}"
|
|
|
|
# Gather information about a previously created user in a specific domain with filter
|
|
- openstack.cloud.identity_user_info:
|
|
cloud: awesomecloud
|
|
name: demouser
|
|
domain: admindomain
|
|
filters:
|
|
enabled: False
|
|
register: result
|
|
- debug:
|
|
msg: "{{ result.users }}"
|
|
'''
|
|
|
|
|
|
RETURN = '''
|
|
users:
|
|
description: has all the OpenStack information about users
|
|
returned: always
|
|
type: list
|
|
elements: dict
|
|
contains:
|
|
id:
|
|
description: Unique UUID.
|
|
returned: success
|
|
type: str
|
|
name:
|
|
description: Username of the user.
|
|
returned: success
|
|
type: str
|
|
default_project_id:
|
|
description: Default project ID of the user
|
|
returned: success
|
|
type: str
|
|
description:
|
|
description: The description of this user
|
|
returned: success
|
|
type: str
|
|
domain_id:
|
|
description: Domain ID containing the user
|
|
returned: success
|
|
type: str
|
|
email:
|
|
description: Email of the user
|
|
returned: success
|
|
type: str
|
|
is_enabled:
|
|
description: Flag to indicate if the user is enabled
|
|
returned: success
|
|
type: bool
|
|
links:
|
|
description: The links for the user resource
|
|
returned: success
|
|
type: complex
|
|
contains:
|
|
self:
|
|
description: Link to this user resource
|
|
returned: success
|
|
type: str
|
|
password:
|
|
description: The default form of credential used during authentication.
|
|
returned: success
|
|
type: str
|
|
password_expires_at:
|
|
description: The date and time when the password expires. The time zone is UTC. A Null value means the password never expires.
|
|
returned: success
|
|
type: str
|
|
username:
|
|
description: Username with Identity API v2 (OpenStack Pike or earlier) else Null
|
|
returned: success
|
|
type: str
|
|
'''
|
|
|
|
from ansible_collections.openstack.cloud.plugins.module_utils.openstack import OpenStackModule
|
|
|
|
|
|
class IdentityUserInfoModule(OpenStackModule):
|
|
argument_spec = dict(
|
|
name=dict(),
|
|
domain=dict(),
|
|
filters=dict(type='dict', default={}),
|
|
)
|
|
module_kwargs = dict(
|
|
supports_check_mode=True
|
|
)
|
|
|
|
def run(self):
|
|
name = self.params['name']
|
|
domain = self.params['domain']
|
|
filters = self.params['filters']
|
|
|
|
args = {}
|
|
if domain:
|
|
dom_obj = self.conn.identity.find_domain(domain)
|
|
if dom_obj is None:
|
|
self.fail_json(
|
|
msg="Domain name or ID '{0}' does not exist".format(domain))
|
|
args['domain_id'] = dom_obj.id
|
|
|
|
users = [user.to_dict(computed=False) for user in self.conn.search_users(name, filters, **args)]
|
|
self.exit_json(changed=False, users=users)
|
|
|
|
|
|
def main():
|
|
module = IdentityUserInfoModule()
|
|
module()
|
|
|
|
|
|
if __name__ == '__main__':
|
|
main()
|