Vh++dZdZdZddlmZddlmZddlmZddl m Z ddl m Z  dd l mZdd l mZd Zdd ZdZdZdZedk(rey y #e$rY%wxYw)a --- module: backup_vault version_added: 6.0.0 short_description: Manage AWS Backup Vaults description: - Creates, deletes, or lists Backup Vault configuration. author: - Gomathi Selvi Srinivasan (@GomathiselviS) options: state: description: - Add or remove Backup Vault configuration. type: str choices: ['present', 'absent'] default: present backup_vault_name: description: - Name for the Backup Vault. - Names are unique to the account used to create them and the Amazon Web Services Region where they are created. - They consist of letters, numbers, and hyphens. type: str required: true encryption_key_arn: description: - The server-side encryption key that is used to protect the backups. type: str creator_request_id: description: - A unique string that identifies the request and allows failed requests to be retried without the risk of running the operation twice. - If used, this parameter must contain 1 to 50 alphanumeric or "-_." characters. type: str extends_documentation_fragment: - amazon.aws.common.modules - amazon.aws.region.modules - amazon.aws.boto3 - amazon.aws.tags a  - name: create backup vault amazon.aws.backup_vault: state: present backup_vault_name: default-vault encryption_key_arn: arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab tags: environment: dev Name: default a exists: description: Whether the Backup Vault exists. returned: always type: bool sample: true vault: description: Backup Vault details. returned: always type: complex sample: hash/dictionary of values contains: backup_vault_name: description: The name of a logical container where backups are stored. returned: always type: str sample: default-name backup_vault_arn: description: An Amazon Resource Name (ARN) that uniquely identifies a backup vault. returned: always type: str sample: arn:aws:backup:us-east-1:123456789012:vault:aBackupVault creation_date: description: The date and time a backup vault is created, in Unix format and Coordinated Universal Time (UTC). returned: always type: str sample: "2024-05-21T13:21:10.062000-07:00" encryption_key_arn: description: The server-side encryption key that is used to protect your backups. returned: always type: str sample: "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab" locked: description: - A Boolean that indicates whether Backup Vault Lock is currently protecting the backup vault. - True means that Vault Lock causes delete or update operations on the recovery points stored in the vault to fail. returned: always type: bool sample: false number_of_recovery_points: description: The number of recovery points that are stored in a backup vault. returned: always type: int sample: 0 tags: description: Tags of the backup vault. returned: on create/update type: str sample: { "TagKey1": "TagValue1", "TagKey2": "TagValue2" } )camel_dict_to_snake_dict)get_backup_resource_tags)is_boto3_error_code)AnsibleAWSModule)compare_aws_tags) BotoCoreError) ClientErrorci}|jDcic] \}}| || }}} |jdi|}|Scc}}w#ttf$r}|j |dYd}~|Sd}~wwxYw)z Creates a Backup Vault module : AnsibleAWSModule object client : boto3 client connection object params : The parameters to create a backup vault NzFailed to create Backup Vaultmsg)itemscreate_backup_vaultrr fail_json_aws)moduleclientparamsrespkverrs k/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/amazon/aws/plugins/modules/backup_vault.pyrrs D%||~ ?tq!ad ?F ?G)v))3F3 K@  G S&EFF K Gs >>AA1A,,A1Ncr|y|xsi}t|||\}}|s|sy|jry|r |j|||r |j ||yy#ttf$r}|j |dYd}~?d}~wwxYw#ttf$r}|j |d Yd}~yd}~wwxYw) a Creates, updates, removes tags on a Backup Vault resource module : AnsibleAWSModule object client : boto3 client connection object tags : Dict of tags converted from ansible_dict to boto3 list of dicts vault_arn : The ARN of the Backup Vault to operate on curr_tags : Dict of the current tags on resource, if any purge_tags : true/false to determine if current tags will be retained or not NF) purge_tagsT) ResourceArn TagKeyListz$Failed to remove tags from the vaultr )rTagszFailed to add tags to Vault)r check_modeuntag_resourcerr r tag_resource) rrtags vault_arn curr_tagsr tags_to_addtags_to_removers r tag_vaultr&s |RI"29dz"ZK ~  R  ! !iN ! S I   IK  H {+ R  *P Q Q R {+ I  *G H H  Is/AB B*BB B6B11B6c8d} |j|}|r4|j dr!|j d}t||||d<|Sy#td$r|jdYXttf$r}|j |dYd}~~d}~wwxYw) z Describes existing vault in an account module : AnsibleAWSModule object client : boto3 client connection object vault_name : Name of the backup vault NBackupVaultNameAccessDeniedExceptionz-Access Denied trying to describe backup vaultzUnable to get vault factsr BackupVaultArnr!)describe_backup_vaultrwarnrr rgetr)rr vault_namerrresources rget_vault_factsr1s DC++J+G 88$ %xx 01H3FFHMDL  6 7E CD ; 'CS&ABBCsA B.B<BBc |j|y#ttf$r}|j|dYd}~yd}~wwxYw)z Delete a Backup Vault module : AnsibleAWSModule object client : boto3 client connection object vault_name : Backup Vault Name r(z!Failed to delete the Backup Vaultr N)delete_backup_vaultrr r)rrr/rs rr3r3sGK"":"> ; 'KS&IJJKsA<Ac ttdddgtddtddtd td d g tdd }dddgfdddgfg}t|d|}|jddvrd}n|jddvrd}|jd}|jd}t|jd|jd|jd|jd}|jd}tdd} t |||d}  d|d<dk(r9|dr4d|d <d|d<t|d!<|jst||| dn|dk(rq|dsld|d <d|d<|js$|r||d"<t|||t |||d} |jrut} | j|d#| d$<|| d<nO|dk(rJ|drEt|||| d%| d|&} | r,t} |s| d} | j|d|d <| | d<| rt| dg'|d(<|jd)i|y#t t f$r} |jd| Yd} ~ Yd} ~ wwxYw)*Npresentabsent)defaultchoicesTstr)requiredtypeF)r;no_log)r;dict resource_tags)r;aliasesbool)r7r;)statebackup_vault_nameencryption_key_arncreator_request_idr!rrArBenabled) argument_specsupports_check_mode required_if)r5rE)r6disabledr!rrCrD)r)BackupVaultTagsEncryptionKeyArnCreatorRequestIdbackup)changedexistsr)zUnable to get vault facts rOrN backupvaultrJrKr+)r!r"r#r) ignore_listvaultr )r=rrrr1rr debugrr3rupdater&r exit_json) rFrHrrAr!r ct_paramsrresultsrSr tags_changed updated_tagss rmainr[s9y(.CD59U59U+ v'8 962 M )123 )123K Mtal mF}}W!77 w #9 9 == D|,J &9: f-';<';< I]]8 $F5/G9 :K0LM    WX.! !!%   6G0H I ) GH$5!    /3 +,  :$FFI>O4PQE   FE LL #(*E$ % E&M )  1  ,-Fm!   6L$V}    %!%GI (E&M 3ExPFws ; '9 1#7889sIJ&JJ__main__)NT) DOCUMENTATIONEXAMPLESRETURN0ansible.module_utils.common.dict_transformationsr:ansible_collections.amazon.aws.plugins.module_utils.backuprris& P 4 nV_\XX 1/ ($N< K^ B zFY  s AAA