Mr.X

# -*- coding: utf-8 -*-
# Copyright: (c) 2018, Ansible Project
# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)

from __future__ import absolute_import, division, print_function
__metaclass__ = type


DOCUMENTATION = '''
---
module: iam_user_info
version_added: 5.0.0
short_description: Gather IAM user(s) facts in AWS
description:
  - This module can be used to gather IAM user(s) facts in AWS.
  - This module was originally added to C(community.aws) in release 1.0.0.
author:
  - Constantin Bugneac (@Constantin07)
  - Abhijeet Kasurde (@Akasurde)
options:
  name:
    description:
      - The name of the IAM user to look for.
    required: false
    type: str
  group:
    description:
      - The group name name of the IAM user to look for. Mutually exclusive with C(path).
    required: false
    type: str
  path:
    description:
      - The path to the IAM user. Mutually exclusive with C(group).
      - If specified, then would get all user names whose path starts with user provided value.
    required: false
    default: '/'
    type: str
extends_documentation_fragment:
  - amazon.aws.aws
  - amazon.aws.ec2
  - amazon.aws.boto3

'''

EXAMPLES = r'''
# Note: These examples do not set authentication details, see the AWS Guide for details.
# Gather facts about "test" user.
- name: Get IAM user info
  amazon.aws.iam_user_info:
    name: "test"

# Gather facts about all users in the "dev" group.
- name: Get IAM user info
  amazon.aws.iam_user_info:
    group: "dev"

# Gather facts about all users with "/division_abc/subdivision_xyz/" path.
- name: Get IAM user info
  amazon.aws.iam_user_info:
    path: "/division_abc/subdivision_xyz/"
'''

RETURN = r'''
iam_users:
    description: list of maching iam users
    returned: success
    type: complex
    contains:
        arn:
            description: the ARN of the user
            returned: if user exists
            type: str
            sample: "arn:aws:iam::123456789012:user/dev/test_user"
        create_date:
            description: the datetime user was created
            returned: if user exists
            type: str
            sample: "2016-05-24T12:24:59+00:00"
        password_last_used:
            description: the last datetime the password was used by user
            returned: if password was used at least once
            type: str
            sample: "2016-05-25T13:39:11+00:00"
        path:
            description: the path to user
            returned: if user exists
            type: str
            sample: "/dev/"
        user_id:
            description: the unique user id
            returned: if user exists
            type: str
            sample: "AIDUIOOCQKTUGI6QJLGH2"
        user_name:
            description: the user name
            returned: if user exists
            type: str
            sample: "test_user"
        tags:
            description: User tags.
            type: dict
            returned: if user exists
            sample: '{"Env": "Prod"}'
'''

try:
    from botocore.exceptions import BotoCoreError, ClientError
except ImportError:
    pass  # caught by AnsibleAWSModule

from ansible.module_utils.common.dict_transformations import camel_dict_to_snake_dict

from ansible_collections.amazon.aws.plugins.module_utils.core import AnsibleAWSModule
from ansible_collections.amazon.aws.plugins.module_utils.core import is_boto3_error_code
from ansible_collections.amazon.aws.plugins.module_utils.ec2 import AWSRetry
from ansible_collections.amazon.aws.plugins.module_utils.ec2 import boto3_tag_list_to_ansible_dict


@AWSRetry.exponential_backoff()
def list_iam_users_with_backoff(client, operation, **kwargs):
    paginator = client.get_paginator(operation)
    return paginator.paginate(**kwargs).build_full_result()


def describe_iam_user(user):
    tags = boto3_tag_list_to_ansible_dict(user.pop('Tags', []))
    user = camel_dict_to_snake_dict(user)
    user['tags'] = tags
    return user


def list_iam_users(connection, module):

    name = module.params.get('name')
    group = module.params.get('group')
    path = module.params.get('path')

    params = dict()
    iam_users = []

    if not group and not path:
        if name:
            params['UserName'] = name
        try:
            iam_users.append(connection.get_user(**params)['User'])
        except is_boto3_error_code('NoSuchEntity'):
            pass
        except (ClientError, BotoCoreError) as e:  # pylint: disable=duplicate-except
            module.fail_json_aws(e, msg="Couldn't get IAM user info for user %s" % name)

    if group:
        params['GroupName'] = group
        try:
            iam_users = list_iam_users_with_backoff(connection, 'get_group', **params)['Users']
        except is_boto3_error_code('NoSuchEntity'):
            pass
        except (ClientError, BotoCoreError) as e:  # pylint: disable=duplicate-except
            module.fail_json_aws(e, msg="Couldn't get IAM user info for group %s" % group)
        if name:
            iam_users = [user for user in iam_users if user['UserName'] == name]

    if path and not group:
        params['PathPrefix'] = path
        try:
            iam_users = list_iam_users_with_backoff(connection, 'list_users', **params)['Users']
        except is_boto3_error_code('NoSuchEntity'):
            pass
        except (ClientError, BotoCoreError) as e:  # pylint: disable=duplicate-except
            module.fail_json_aws(e, msg="Couldn't get IAM user info for path %s" % path)
        if name:
            iam_users = [user for user in iam_users if user['UserName'] == name]

    module.exit_json(iam_users=[describe_iam_user(user) for user in iam_users])


def main():
    argument_spec = dict(
        name=dict(),
        group=dict(),
        path=dict(default='/')
    )

    module = AnsibleAWSModule(
        argument_spec=argument_spec,
        mutually_exclusive=[
            ['group', 'path']
        ],
        supports_check_mode=True
    )

    connection = module.client('iam')

    list_iam_users(connection, module)


if __name__ == '__main__':
    main()

Name	Type	Size	Permission
__pycache__	Folder		0755
autoscaling_group.py	File	82.17 KB	0644
autoscaling_group_info.py	File	16.46 KB	0644
aws_az_info.py	File	6.12 KB	0644
aws_caller_info.py	File	3.66 KB	0644
cloudformation.py	File	35.27 KB	0644
cloudformation_info.py	File	19.77 KB	0644
cloudtrail.py	File	24 KB	0644
cloudtrail_info.py	File	9.68 KB	0644
cloudwatch_metric_alarm.py	File	18.87 KB	0644
cloudwatch_metric_alarm_info.py	File	11.32 KB	0644
cloudwatchevent_rule.py	File	18.49 KB	0644
cloudwatchlogs_log_group.py	File	13.58 KB	0644
cloudwatchlogs_log_group_info.py	File	4.72 KB	0644
cloudwatchlogs_log_group_metric_filter.py	File	7.12 KB	0644
ec2_ami.py	File	31.7 KB	0644
ec2_ami_info.py	File	9.32 KB	0644
ec2_eip.py	File	24.46 KB	0644
ec2_eip_info.py	File	4.36 KB	0644
ec2_eni.py	File	33.18 KB	0644
ec2_eni_info.py	File	9.94 KB	0644
ec2_instance.py	File	87.54 KB	0644
ec2_instance_info.py	File	22.73 KB	0644
ec2_key.py	File	12.67 KB	0644
ec2_metadata_facts.py	File	29.53 KB	0644
ec2_security_group.py	File	62.18 KB	0644
ec2_security_group_info.py	File	10.7 KB	0644
ec2_snapshot.py	File	13.31 KB	0644
ec2_snapshot_info.py	File	10.67 KB	0644
ec2_spot_instance.py	File	24.21 KB	0644
ec2_spot_instance_info.py	File	10.6 KB	0644
ec2_tag.py	File	4.97 KB	0644
ec2_tag_info.py	File	1.78 KB	0644
ec2_vol.py	File	31.01 KB	0644
ec2_vol_info.py	File	6.89 KB	0644
ec2_vpc_dhcp_option.py	File	21.87 KB	0644
ec2_vpc_dhcp_option_info.py	File	7.19 KB	0644
ec2_vpc_endpoint.py	File	18.54 KB	0644
ec2_vpc_endpoint_info.py	File	9.74 KB	0644
ec2_vpc_endpoint_service_info.py	File	5.61 KB	0644
ec2_vpc_igw.py	File	8.65 KB	0644
ec2_vpc_igw_info.py	File	6 KB	0644
ec2_vpc_nat_gateway.py	File	31.08 KB	0644
ec2_vpc_nat_gateway_info.py	File	7.28 KB	0644
ec2_vpc_net.py	File	26.35 KB	0644
ec2_vpc_net_info.py	File	10.16 KB	0644
ec2_vpc_route_table.py	File	33.92 KB	0644
ec2_vpc_route_table_info.py	File	8.92 KB	0644
ec2_vpc_subnet.py	File	21.59 KB	0644
ec2_vpc_subnet_info.py	File	7.1 KB	0644
elb_application_lb.py	File	32.32 KB	0644
elb_application_lb_info.py	File	13.22 KB	0644
elb_classic_lb.py	File	78.43 KB	0644
iam_policy.py	File	10.46 KB	0644
iam_policy_info.py	File	5.9 KB	0644
iam_user.py	File	21.6 KB	0644
iam_user_info.py	File	5.96 KB	0644
kms_key.py	File	38.2 KB	0644
kms_key_info.py	File	18.46 KB	0644
lambda.py	File	33.54 KB	0644
lambda_alias.py	File	10.47 KB	0644
lambda_event.py	File	15.42 KB	0644
lambda_execute.py	File	10.08 KB	0644
lambda_info.py	File	20.06 KB	0644
lambda_layer.py	File	12.31 KB	0644
lambda_layer_info.py	File	7.39 KB	0644
lambda_policy.py	File	13.45 KB	0644
rds_cluster.py	File	46.03 KB	0644
rds_cluster_info.py	File	10.62 KB	0644
rds_cluster_snapshot.py	File	12.69 KB	0644
rds_instance.py	File	63.34 KB	0644
rds_instance_info.py	File	12.63 KB	0644
rds_instance_snapshot.py	File	12.26 KB	0644
rds_option_group.py	File	23.86 KB	0644
rds_option_group_info.py	File	12.56 KB	0644
rds_param_group.py	File	13.04 KB	0644
rds_snapshot_info.py	File	12.4 KB	0644
rds_subnet_group.py	File	13.05 KB	0644
route53.py	File	28.19 KB	0644
route53_health_check.py	File	24.4 KB	0644
route53_info.py	File	32.05 KB	0644
route53_zone.py	File	19.93 KB	0644
s3_bucket.py	File	52.93 KB	0644
s3_object.py	File	55.57 KB	0644
s3_object_info.py	File	32.55 KB	0644

Upload:

Command:

Filemanager

Server Info

System Info