VhIdZdZdZddlZ ddlZddlmZddlmZddl m Z ddl m Z dd l m Z dd lmZd Zd Zed k(reyy#e$rY?wxYw)a module: backup_selection short_description: Create, delete and modify AWS Backup selection version_added: 6.0.0 description: - Manages AWS Backup selections. - For more information see the AWS documentation for backup selections U(https://docs.aws.amazon.com/aws-backup/latest/devguide/assigning-resources.html). options: backup_plan_name: description: - Uniquely identifies the backup plan to be associated with the selection of resources. required: true type: str aliases: - plan_name backup_selection_name: description: - The display name of a resource selection document. Must contain 1 to 50 alphanumeric or '-_.' characters. required: true type: str aliases: - selection_name iam_role_arn: description: - The ARN of the IAM role that Backup uses to authenticate when backing up the target resource. type: str resources: description: - A list of Amazon Resource Names (ARNs) to assign to a backup plan. The maximum number of ARNs is 500 without wildcards, or 30 ARNs with wildcards. If you need to assign many resources to a backup plan, consider a different resource selection strategy, such as assigning all resources of a resource type or refining your resource selection using tags. type: list elements: str list_of_tags: description: - A list of conditions that you define to assign resources to your backup plans using tags. - Condition operators are case sensitive. - When you specify more than one condition in O(list_of_tags), you assign all resources that match AT LEAST ONE condition (using OR logic). type: list elements: dict suboptions: condition_type: description: - An operation applied to a key-value pair used to assign resources to your backup plan. - Condition only supports V(STRINGEQUALS). type: str condition_key: description: - The key in a key-value pair. type: str condition_value: description: - The value in a key-value pair. type: str not_resources: description: - A list of Amazon Resource Names (ARNs) to exclude from a backup plan. The maximum number of ARNs is 500 without wildcards, or 30 ARNs with wildcards. If you need to exclude many resources from a backup plan, consider a different resource selection strategy, such as assigning only one or a few resource types or refining your resource selection using tags. type: list elements: str conditions: description: - A list of conditions (expressed as a dict) that you define to assign resources to your backup plans using tags. - When you specify more than one condition in I(conditions), you only assign the resources that match ALL conditions (using AND logic). - O(conditions) supports V(string_equals), V(string_like), V(string_not_equals), and V(string_not_like). O(list_of_tags) only supports V(string_equals). type: dict suboptions: string_equals: description: - Filters the values of your tagged resources for only those resources that you tagged with the same value. type: list default: [] elements: dict suboptions: condition_key: description: - The key in a key-value pair. - O(conditions.string_equals.condition_key) in the O(conditions) option must use the AWS resource tag prefix, e.g. 'aws:ResourceTag/key-name' type: str condition_value: description: The value in a key-value pair. type: str string_like: description: - Filters the values of your tagged resources for matching tag values with the use of a wildcard character (*) anywhere in the string. For example, "prod*" or "*rod*" matches the tag value "production". type: list default: [] elements: dict suboptions: condition_key: description: - The key in a key-value pair. - O(conditions.string_like.condition_key) in the O(conditions) option must use the AWS resource tag prefix, e.g. 'aws:ResourceTag/key-name' type: str condition_value: description: The value in a key-value pair. type: str string_not_equals: description: - Filters the values of your tagged resources for only those resources that you tagged that do not have the same value. type: list default: [] elements: dict suboptions: condition_key: description: - The key in a key-value pair. - O(conditions.string_not_equals.condition_key) in the O(conditions) option must use the AWS resource tag prefix, e.g. 'aws:ResourceTag/key-name' type: str condition_value: description: The value in a key-value pair. type: str string_not_like: description: - Filters the values of your tagged resources for non-matching tag values with the use of a wildcard character (*) anywhere in the string. type: list default: [] elements: dict suboptions: condition_key: description: - The key in a key-value pair. - O(conditions.string_not_like.condition_key) in the O(conditions) option must use the AWS resource tag prefix, e.g. 'aws:ResourceTag/key-name' type: str condition_value: description: The value in a key-value pair. type: str state: description: - Create, delete a backup selection. default: present choices: ['present', 'absent'] type: str author: - Kristof Imre Szabo (@krisek) - Alina Buzachis (@alinabuzachis) extends_documentation_fragment: - amazon.aws.common.modules - amazon.aws.region.modules - amazon.aws.boto3 aW - name: Create backup selection amazon.aws.backup_selection: selection_name: elastic backup_plan_name: test-backup-plan iam_role_arn: arn:aws:iam::111122223333:role/system-backup resources: - arn:aws:elasticfilesystem:*:*:file-system/* - name: Create backup selection, assign resources using tags amazon.aws.backup_selection: selection_name: elastic backup_plan_name: test-backup-plan iam_role_arn: arn:aws:iam::111122223333:role/system-backup list_of_tags: - condition_type: STRINGEQUALS condition_key: Owner condition_value: Dev01 a backup_selection: description: Backup selection details. returned: always type: complex contains: backup_plan_id: description: ID of the backup plan. returned: always type: str sample: "1111f877-1ecf-4d79-9718-a861cd09df3b" creation_date: description: Creation date of the backup plan. returned: on create/update type: str sample: '2023-01-24T10:08:03.193000+01:00' iam_role_arn: description: The ARN of the IAM role that Backup uses to authenticate when backing up the target resource. returned: always type: str sample: "arn:aws:iam::111122223333:role/system-backup" selection_id: description: Backup selection id. returned: always type: str sample: "1111c217-5d71-4a55-8728-5fc4e63d437b" selection_name: description: The display name of a resource selection document. returned: always type: str sample: elastic conditions: description: A list of conditions that defines how resources are assigned to backup plans using tags. returned: always type: dict sample: { "string_equals": [], "string_like": [], "string_not_equals": [], "string_not_like": [] } contains: string_equals: description: Filters the values of tagged resources for only those resources that are tagged with the same value. returned: always type: list sample: [] string_like: description: Filters the values of tagged resources for matching tag values with the use of a wildcard character (*) anywhere in the string. returned: always type: list sample: [] string_not_equals: description: Filters the values of tagged resources for only those resources that are not tagged with the same value. returned: always type: list sample: [] string_not_like: description: Filters the values of tagged resources for non-matching tag values with the use of a wildcard character (*) anywhere in the string. returned: always type: list sample: [] list_of_tags: description: Conditions defined to assign resources to the backup plans using tags. returned: always type: list elements: dict sample: [ { "condition_key": "Environment", "condition_type": "STRINGEQUALS", "condition_value": "Dev" } ] contains: condition_key: description: The key in a key-value pair. returned: always type: str sample: "Environment" condition_type: description: An operation applied to a key-value pair used to assign resources to backup plan. returned: always type: str sample: "STRINGEQUALS" condition_value: description: The value in a key-value pair. returned: always type: str sample: "Dev" not_resources: description: List of Amazon Resource Names (ARNs) that are excluded from the backup plan. returned: always type: list sample: [] resources: description: List of Amazon Resource Names (ARNs) that are assigned to the backup plan. returned: always type: list sample: [] N)camel_dict_to_snake_dict)snake_dict_to_camel_dict)get_plan_details)get_selection_details)AnsibleAWSModule)AWSRetryc,d}|djdd|k7rd}gd}|D]n}tj|dj|gd}tj|j|gd}||k7sZ|dk7rd}b|dk(r|d k(rmd}p|S) NFr IamRoleArnT) Resources ListOfTags NotResources Conditions) sort_keysrzR{"StringEquals": [], "StringLike": [], "StringNotEquals": [], "StringNotLike": []}z[])getjsondumps)current_selectionbackup_selection_data iam_role_arn update_neededfields_to_check field_namefield_value_from_awsnew_field_values o/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/amazon/aws/plugins/modules/backup_selection.pycheck_for_updater%sM d3|C OO% % #zz*;A*>*B*B:r*R^bc**%:%>%>z2%NZ^_ 2 2\) $ $gh#t+ $  % c ttdddgtdddgtdtddtd ttdgd ttdd td  tdgd ttdd td  tdgd ttdd td  tdgd ttdd td  tddtdd ttdtdd tdtdddg}ddgdfddddgfg}t||d}|jjd}|jjd}|jjd}|jjd}|jjd}|jjd}|jjd} |jjd} |j d t j !} d d id$} t| ||}|| d%<|dk(rd }||d&}|r||d'<|rt|d(|d)<| r| |d*<| rt| d(|d+<|rdd| d,<t|||}|rI|jrd| d-<|j d:i| d.d/i | j#d|d0d1|d0d23n|sd| d,<|r|rSd| d-<d| d,<t%|| |}|jr|j d:i| d.d/i | j'||d0d56t|| ||}t)|| d8<nO|dk(rJ|rHd| d-<|jr|j d:i| d.d9i | j#d|d0d1|d0d23|j d:i| y#tjjtjjf$r} |j| d"#Yd} ~ d} ~ wwxYw#tjjtjjf$r} |j| d4#Yd} ~ {d} ~ wwxYw#tjjtjjf$r} |j| d7#Yd} ~ |d} ~ wwxYw#tjjtjjf$r} |j| d4#Yd} ~ kd} ~ wwxYw);NstrTselection_name)typerequiredaliases plan_name)r!list)r!elementsdictF)r!no_log) condition_keycondition_value)r!defaultr&options) string_equals string_likestring_not_equalsstring_not_like)r!r,)condition_typer)r*)r!r&r,presentabsent)r+choices)backup_selection_namebackup_plan_namer resources conditions not_resources list_of_tagsstater;)r5r6rr5r6) argument_spec required_ifsupports_check_moderr7r:r9r8backup)retry_decoratorzFailed to connect to AWS)msg)changedexistsbackup_selectionr) SelectionNamer r )capitalize_firstr r rrCrBrAz1Would have created selection if not in check moder SelectionId BackupPlanId) aws_retryrGrHzFailed to delete selectionbackup_plan_id)BackupSelectionrHzFailed to create selectionrDz8Would have deleted backup selection if not in check mode)r'rparamsrclientrjittered_backoffbotocore exceptions ClientError BotoCoreError fail_json_awsrrr check_mode exit_jsondelete_backup_selectionrcreate_backup_selectionr)r<r=moduler;r5r6rr7r:r9r8rNeresultsrrrplan new_selections rmainr^:s"GWFXY54+Ou%FU3"# &*e&D(,%(8 !# &*e&D(,%(8 #'# &*e&D(,%(8 #!%# &*e&D(,%(8 !9%( R7#/"e< $% 0 9y(.CDq9Mv )Z[ (46HIJKM{hl mF MM  g &E"MM--.>?}}(();<==$$^4L !!+.I==$$^4LMM%%o6M""<0J@x9R9R9TU 5bIG-ff>NPef#4G    2GWc d 1: !+ . 2J@UWcdM$$)-GI&$F$$hwh4ghN22"&$5a$8$G%6q%9.%I3#$(! M!%GI  $GH #FF4DED     d7d0cd J..$9QP`Ha/ .ff>NPef &> &N"# (  !%GI      k7k0jk J.." 1! 4] C!21!5n!E/FwO    + +X-@-@-N-N O@Q$>??@F!++779L9L9Z9Z[N((0L(MMN ''33X5H5H5V5VW J$$Q,H$II J"''33X5H5H5V5VW J$$Q,H$II Js`%P  Q!4R9 T 7QQQ!7R6R11R697T0T  T7U&U!!U&__main__) DOCUMENTATIONEXAMPLESRETURNrrP ImportError0ansible.module_utils.common.dict_transformationsrr:ansible_collections.amazon.aws.plugins.module_utils.backuprr8ansible_collections.amazon.aws.plugins.module_utils.corer7ansible_collections.amazon.aws.plugins.module_utils.ec2rrr^__name__rLrrrisuO d *d L  VUW\UL*R j zFm  sAAA