VhTdZdZdZ ddlZddlmZddlmZddl m Z ddl m Z dd l m Z dd l mZdd l mZdd l mZdd lmZddlmZej*ddZdZdZdZdZdZdZdZdZdZdZ dZ!dZ"dZ#dZ$d Z%d!Z&e'd"k(re&yy#e$rYwxYw)#a[K --- module: rds_cluster version_added: 5.0.0 short_description: rds_cluster module description: - Create, modify, and delete RDS clusters. - This module was originally added to C(community.aws) in release 3.2.0. extends_documentation_fragment: - amazon.aws.common.modules - amazon.aws.region.modules - amazon.aws.tags - amazon.aws.boto3 author: - Sloane Hertel (@s-hertel) - Alina Buzachis (@alinabuzachis) options: # General module options state: description: - Whether the snapshot should exist or not. - V(started) and V(stopped) can only be used with aurora clusters. - Support for V(started) and V(stopped) was added in release 6.3.0. choices: ['present', 'absent', 'started', 'stopped'] default: 'present' type: str creation_source: description: Which source to use if creating from a template (an existing cluster, S3 bucket, or snapshot). choices: ['snapshot', 's3', 'cluster'] type: str force_update_password: description: - Set to V(true) to update your cluster password with O(master_user_password). - Since comparing passwords to determine if it needs to be updated is not possible this is set to V(false) by default to allow idempotence. type: bool default: false promote: description: Set to V(true) to promote a read replica cluster. type: bool default: false purge_cloudwatch_logs_exports: description: - Whether or not to disable Cloudwatch logs enabled for the DB cluster that are not provided in O(enable_cloudwatch_logs_exports). Set O(enable_cloudwatch_logs_exports) to an empty list to disable all. type: bool default: true purge_security_groups: description: - Set to V(false) to retain any enabled security groups that aren't specified in the task and are associated with the cluster. - Can be applied to O(vpc_security_group_ids) type: bool default: true wait: description: Whether to wait for the cluster to be available or deleted. type: bool default: true # Options that have a corresponding boto3 parameter apply_immediately: description: - A value that specifies whether modifying a cluster with O(new_db_cluster_identifier) and O(master_user_password) should be applied as soon as possible, regardless of the O(preferred_maintenance_window) setting. If V(false), changes are applied during the next maintenance window. type: bool default: false availability_zones: description: - A list of EC2 Availability Zones that instances in the DB cluster can be created in. May be used when creating a cluster or when restoring from S3 or a snapshot. aliases: - zones - az type: list elements: str backtrack_to: description: - The timestamp of the time to backtrack the DB cluster to in ISO 8601 format, such as "2017-07-08T18:00Z". type: str backtrack_window: description: - The target backtrack window, in seconds. To disable backtracking, set this value to V(0). - If specified, this value must be set to a number from V(0) to V(259,200) (72 hours). type: int backup_retention_period: description: - The number of days for which automated backups are retained (must be within V(1) to V(35)). May be used when creating a new cluster, when restoring from S3, or when modifying a cluster. type: int default: 1 character_set_name: description: - The character set to associate with the DB cluster. type: str database_name: description: - The name for your database. If a name is not provided Amazon RDS will not create a database. aliases: - db_name type: str db_cluster_identifier: description: - The DB cluster (lowercase) identifier. The identifier must contain from 1 to 63 letters, numbers, or hyphens and the first character must be a letter and may not end in a hyphen or contain consecutive hyphens. aliases: - cluster_id - id - cluster_name type: str required: true db_cluster_parameter_group_name: description: - The name of the DB cluster parameter group to associate with this DB cluster. If this argument is omitted when creating a cluster, the default DB cluster parameter group for the specified DB engine and version is used. type: str db_subnet_group_name: description: - A DB subnet group to associate with this DB cluster if not using the default. type: str enable_cloudwatch_logs_exports: description: - A list of log types that need to be enabled for exporting to CloudWatch Logs. - Engine aurora-mysql supports V(audit), V(error), V(general) and V(slowquery). - Engine aurora-postgresql supports V(postgresql). type: list elements: str deletion_protection: description: - A value that indicates whether the DB cluster has deletion protection enabled. The database can't be deleted when deletion protection is enabled. By default, deletion protection is disabled. type: bool global_cluster_identifier: description: - The global cluster ID of an Aurora cluster that becomes the primary cluster in the new global database cluster. type: str enable_http_endpoint: description: - A value that indicates whether to enable the HTTP endpoint for an Aurora Serverless DB cluster. By default, the HTTP endpoint is disabled. type: bool copy_tags_to_snapshot: description: - Indicates whether to copy all tags from the DB cluster to snapshots of the DB cluster. The default is not to copy them. type: bool domain: description: - The Active Directory directory ID to create the DB cluster in. type: str domain_iam_role_name: description: - Specify the name of the IAM role to be used when making API calls to the Directory Service. type: str enable_global_write_forwarding: description: - A value that indicates whether to enable this DB cluster to forward write operations to the primary cluster of an Aurora global database. By default, write operations are not allowed on Aurora DB clusters that are secondary clusters in an Aurora global database. - This value can be only set on Aurora DB clusters that are members of an Aurora global database. type: bool db_cluster_instance_class: description: - The compute and memory capacity of each DB instance in the Multi-AZ DB cluster, for example V(db.m6gd.xlarge). - Not all DB instance classes are available in all Amazon Web Services Regions, or for all database engines. - For the full list of DB instance classes and availability for your engine visit U(https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.DBInstanceClass.html). - This setting is required to create a Multi-AZ DB cluster. type: str version_added: 5.5.0 enable_iam_database_authentication: description: - Enable mapping of AWS Identity and Access Management (IAM) accounts to database accounts. If this option is omitted when creating the cluster, Amazon RDS sets this to C(false). type: bool allocated_storage: description: - The amount of storage in gibibytes (GiB) to allocate to each DB instance in the Multi-AZ DB cluster. - This setting is required to create a Multi-AZ DB cluster. type: int version_added: 5.5.0 storage_type: description: - Specifies the storage type to be associated with the DB cluster. - This setting is required to create a Multi-AZ DB cluster. - For multi-AZ DB clusters, O(storage_type) defaults to V(io1) and a value for the O(iops) parameter is required. - For Aurora DB clusters, O(storage_type) defaults to V(aurora) standard. - For mysql and postgres DB clusters, O(storage_type) defaults to V(io1). - Support for V(aurora) and V(aurora-iopt1) was added in release 8.2.0. type: str choices: - io1 - aurora - aurora-iopt1 version_added: 5.5.0 iops: description: - The amount of Provisioned IOPS (input/output operations per second) to be initially allocated for each DB instance in the Multi-AZ DB cluster. - This setting is required to create a Multi-AZ DB cluster - Must be a multiple between .5 and 50 of the storage amount for the DB cluster. type: int version_added: 5.5.0 engine: description: - The name of the database engine to be used for this DB cluster. This is required to create a cluster. - The combinaison of I(engine) and I(engine_mode) may not be supported. - "See AWS documentation for details: L(Amazon RDS Documentation,https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBCluster.html)." - When O(engine=mysql), O(allocated_storage), O(iops) and O(db_cluster_instance_class) must also be specified. - When I(engine=postgres), O(allocated_storage), O(iops) and O(db_cluster_instance_class) must also be specified. - Support for V(postgres) and V(mysql) was added in amazon.aws 5.5.0. choices: - aurora - aurora-mysql - aurora-postgresql - mysql - postgres type: str engine_mode: description: - The DB engine mode of the DB cluster. The combination of O(engine) and O(engine_mode) may not be supported. - "See AWS documentation for details: L(Amazon RDS Documentation,https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBCluster.html)." choices: - provisioned - serverless - parallelquery - global - multimaster type: str version_added: 5.5.0 engine_version: description: - The version number of the database engine to use. - For Aurora MySQL that could be V(5.6.10a), V(5.7.12). - Aurora PostgreSQL example, V(9.6.3). type: str final_snapshot_identifier: description: - The DB cluster snapshot identifier of the new DB cluster snapshot created when O(skip_final_snapshot=false). type: str force_backtrack: description: - A boolean to indicate if the DB cluster should be forced to backtrack when binary logging is enabled. Otherwise, an error occurs when binary logging is enabled. type: bool kms_key_id: description: - The AWS KMS key identifier (the ARN, unless you are creating a cluster in the same account that owns the KMS key, in which case the KMS key alias may be used). - If O(replication_source_identifier) specifies an encrypted source Amazon RDS will use the key used toe encrypt the source. - If O(storage_encrypted=true) and and O(replication_source_identifier) is not provided, the default encryption key is used. type: str master_user_password: description: - An 8-41 character password for the master database user. - The password can contain any printable ASCII character except V(/), V("), or V(@). - To modify the password use O(force_update_password). Use O(apply_immediately) to change the password immediately, otherwise it is updated during the next maintenance window. aliases: - password type: str master_username: description: - The name of the master user for the DB cluster. Must be 1-16 letters or numbers and begin with a letter. aliases: - username type: str new_db_cluster_identifier: description: - The new DB cluster (lowercase) identifier for the DB cluster when renaming a DB cluster. - The identifier must contain from 1 to 63 letters, numbers, or hyphens and the first character must be a letter and may not end in a hyphen or contain consecutive hyphens. - Use O(apply_immediately) to rename immediately, otherwise it is updated during the next maintenance window. aliases: - new_cluster_id - new_id - new_cluster_name type: str option_group_name: description: - The option group to associate with the DB cluster. type: str port: description: - The port number on which the instances in the DB cluster accept connections. If not specified, Amazon RDS defaults this to V(3306) if the O(engine) is V(aurora) and V(5432) if the O(engine) is V(aurora-postgresql). type: int preferred_backup_window: description: - The daily time range (in UTC) of at least 30 minutes, during which automated backups are created if automated backups are enabled using O(backup_retention_period). The option must be in the format of "hh24:mi-hh24:mi" and not conflict with O(preferred_maintenance_window). aliases: - backup_window type: str preferred_maintenance_window: description: - The weekly time range (in UTC) of at least 30 minutes, during which system maintenance can occur. The option must be in the format "ddd:hh24:mi-ddd:hh24:mi" where ddd is one of Mon, Tue, Wed, Thu, Fri, Sat, Sun. aliases: - maintenance_window type: str remove_from_global_db: description: - If set to V(true), the cluster will be removed from global DB. - Parameters O(global_cluster_identifier), O(db_cluster_identifier) must be specified when O(remove_from_global_db=true). type: bool required: false version_added: 6.5.0 replication_source_identifier: description: - The Amazon Resource Name (ARN) of the source DB instance or DB cluster if this DB cluster is created as a Read Replica. aliases: - replication_src_id type: str restore_to_time: description: - The UTC date and time to restore the DB cluster to. Must be in the format "2015-03-07T23:45:00Z". - If this is not provided while restoring a cluster, O(use_latest_restorable_time) must be. May not be specified if O(restore_type) is copy-on-write. type: str restore_type: description: - The type of restore to be performed. If not provided, Amazon RDS uses full-copy. choices: - full-copy - copy-on-write type: str role_arn: description: - The Amazon Resource Name (ARN) of the IAM role to associate with the Aurora DB cluster, for example "arn:aws:iam::123456789012:role/AuroraAccessRole" type: str s3_bucket_name: description: - The name of the Amazon S3 bucket that contains the data used to create the Amazon Aurora DB cluster. type: str s3_ingestion_role_arn: description: - The Amazon Resource Name (ARN) of the AWS Identity and Access Management (IAM) role that authorizes Amazon RDS to access the Amazon S3 bucket on your behalf. type: str s3_prefix: description: - The prefix for all of the file names that contain the data used to create the Amazon Aurora DB cluster. - If you do not specify a SourceS3Prefix value, then the Amazon Aurora DB cluster is created by using all of the files in the Amazon S3 bucket. type: str serverless_v2_scaling_configuration: description: - Contains the scaling configuration of an Aurora Serverless v2 DB cluster. type: dict suboptions: min_capacity: description: - The minimum number of Aurora capacity units (ACUs) for a DB instance in an Aurora Serverless v2 cluster. - ACU values can be specified in in half-step increments, such as V(8), V(8.5), V(9), and so on. - The smallest possible value is V(0.5). type: float max_capacity: description: - The maximum number of Aurora capacity units (ACUs) for a DB instance in an Aurora Serverless v2 cluster. - ACU values can be specified in in half-step increments, such as V(40), V(40.5), V(41), and so on. - The largest possible value is V(128). type: float version_added: 7.3.0 skip_final_snapshot: description: - Whether a final DB cluster snapshot is created before the DB cluster is deleted. - If this is V(false), O(final_snapshot_identifier) must be provided. type: bool default: false snapshot_identifier: description: - The identifier for the DB snapshot or DB cluster snapshot to restore from. - You can use either the name or the ARN to specify a DB cluster snapshot. However, you can use only the ARN to specify a DB snapshot. type: str source_db_cluster_identifier: description: - The identifier of the source DB cluster from which to restore. type: str source_engine: description: - The identifier for the database engine that was backed up to create the files stored in the Amazon S3 bucket. choices: - mysql type: str source_engine_version: description: - The version of the database that the backup files were created from. type: str source_region: description: - The ID of the region that contains the source for the DB cluster. type: str storage_encrypted: description: - Whether the DB cluster is encrypted. type: bool use_earliest_time_on_point_in_time_unavailable: description: - If O(backtrack_to) is set to a timestamp earlier than the earliest backtrack time, this value backtracks the DB cluster to the earliest possible backtrack time. Otherwise, an error occurs. type: bool use_latest_restorable_time: description: - Whether to restore the DB cluster to the latest restorable backup time. Only one of O(use_latest_restorable_time) and O(restore_to_time) may be provided. type: bool vpc_security_group_ids: description: - A list of EC2 VPC security groups to associate with the DB cluster. type: list elements: str a8 # Note: These examples do not set authentication details, see the AWS Guide for details. - name: Create minimal Aurora cluster in default VPC and default subnet group amazon.aws.rds_cluster: cluster_id: "{{ cluster_id }}" engine: "aurora" password: "{{ password }}" username: "{{ username }}" - name: Add a new security group without purge amazon.aws.rds_cluster: id: "{{ cluster_id }}" state: present vpc_security_group_ids: - sg-0be17ba10c9286b0b purge_security_groups: false - name: Modify password amazon.aws.rds_cluster: id: "{{ cluster_id }}" state: present password: "{{ new_password }}" force_update_password: true apply_immediately: true - name: Rename the cluster amazon.aws.rds_cluster: engine: aurora password: "{{ password }}" username: "{{ username }}" cluster_id: "cluster-{{ resource_prefix }}" new_cluster_id: "cluster-{{ resource_prefix }}-renamed" apply_immediately: true - name: Delete Aurora cluster without creating a final snapshot amazon.aws.rds_cluster: engine: aurora password: "{{ password }}" username: "{{ username }}" cluster_id: "{{ cluster_id }}" skip_final_snapshot: true tags: Name: "cluster-{{ resource_prefix }}" Created_By: "Ansible_rds_cluster_integration_test" state: absent - name: Restore cluster from source snapshot amazon.aws.rds_cluster: engine: aurora password: "{{ password }}" username: "{{ username }}" cluster_id: "cluster-{{ resource_prefix }}-restored" snapshot_identifier: "cluster-{{ resource_prefix }}-snapshot" - name: Create an Aurora PostgreSQL cluster and attach an intance amazon.aws.rds_cluster: state: present engine: aurora-postgresql engine_mode: provisioned cluster_id: '{{ cluster_id }}' username: '{{ username }}' password: '{{ password }}' - name: Attach a new instance to the cluster amazon.aws.rds_instance: id: '{{ instance_id }}' cluster_id: '{{ cluster_id }}' engine: aurora-postgresql state: present db_instance_class: 'db.t3.medium' - name: Remove a cluster from global DB (do not delete) amazon.aws.rds_cluster: db_cluster_identifier: '{{ cluster_id }}' global_cluster_identifier: '{{ global_cluster_id }}' remove_from_global_db: true - name: Remove a cluster from global DB and Delete without creating a final snapshot amazon.aws.rds_cluster: engine: aurora password: "{{ password }}" username: "{{ username }}" cluster_id: "{{ cluster_id }}" skip_final_snapshot: true remove_from_global_db: true wait: true state: absent - name: Update cluster port and WAIT for remove secondary DB cluster from global DB to complete amazon.aws.rds_cluster: db_cluster_identifier: "{{ secondary_cluster_name }}" global_cluster_identifier: "{{ global_cluster_name }}" remove_from_global_db: true state: present port: 3389 region: "{{ secondary_cluster_region }}" - name: Update cluster port and DO NOT WAIT for remove secondary DB cluster from global DB to complete amazon.aws.rds_cluster: db_cluster_identifier: "{{ secondary_cluster_name }}" global_cluster_identifier: "{{ global_cluster_name }}" remove_from_global_db: true state: present port: 3389 region: "{{ secondary_cluster_region }}" wait: false a activity_stream_status: description: The status of the database activity stream. returned: always type: str sample: "stopped" allocated_storage: description: - The allocated storage size in gigabytes. Since aurora storage size is not fixed this is always 1 for aurora database engines. returned: always type: int sample: 1 associated_roles: description: - A list of dictionaries of the AWS Identity and Access Management (IAM) roles that are associated with the DB cluster. Each dictionary contains the role_arn and the status of the role. returned: always type: list sample: [] auto_minor_version_upgrade: description: Specifies whether minor engine upgrades are applied automatically to the DB cluster during the maintenance window. returned: always type: bool sample: true availability_zones: description: The list of availability zones that instances in the DB cluster can be created in. returned: always type: list sample: - us-east-1c - us-east-1a - us-east-1e backup_retention_period: description: The number of days for which automatic DB snapshots are retained. returned: always type: int sample: 1 changed: description: If the RDS cluster has changed. returned: always type: bool sample: true cluster_create_time: description: The time in UTC when the DB cluster was created. returned: always type: str sample: "2018-06-29T14:08:58.491000+00:00" copy_tags_to_snapshot: description: - Specifies whether tags are copied from the DB cluster to snapshots of the DB cluster. returned: always type: bool sample: false cross_account_clone: description: - Specifies whether the DB cluster is a clone of a DB cluster owned by a different Amazon Web Services account. returned: always type: bool sample: false db_cluster_arn: description: The Amazon Resource Name (ARN) for the DB cluster. returned: always type: str sample: arn:aws:rds:us-east-1:123456789012:cluster:rds-cluster-demo db_cluster_identifier: description: The lowercase user-supplied DB cluster identifier. returned: always type: str sample: "rds-cluster-demo" db_cluster_members: description: - A list of dictionaries containing information about the instances in the cluster. Each dictionary contains the db_instance_identifier, is_cluster_writer (bool), db_cluster_parameter_group_status, and promotion_tier (int). returned: always type: list sample: [] db_cluster_parameter_group: description: The parameter group associated with the DB cluster. returned: always type: str sample: "default.aurora5.6" db_cluster_resource_id: description: The AWS Region-unique, immutable identifier for the DB cluster. returned: always type: str sample: "cluster-D2MEQDN3BQNXDF74K6DQJTHASU" db_subnet_group: description: The name of the subnet group associated with the DB Cluster. returned: always type: str sample: "default" deletion_protection: description: - Indicates if the DB cluster has deletion protection enabled. The database can't be deleted when deletion protection is enabled. returned: always type: bool sample: false domain_memberships: description: - The Active Directory Domain membership records associated with the DB cluster. returned: always type: list sample: [] earliest_restorable_time: description: The earliest time to which a database can be restored with point-in-time restore. returned: always type: str sample: "2018-06-29T14:09:34.797000+00:00" endpoint: description: The connection endpoint for the primary instance of the DB cluster. returned: always type: str sample: "rds-cluster-demo.cluster-cvlrtwiennww.us-east-1.rds.amazonaws.com" engine: description: The database engine of the DB cluster. returned: always type: str sample: "aurora" engine_mode: description: The DB engine mode of the DB cluster. returned: always type: str sample: "provisioned" engine_version: description: The database engine version. returned: always type: str sample: "5.6.10a" hosted_zone_id: description: The ID that Amazon Route 53 assigns when you create a hosted zone. returned: always type: str sample: "Z2R2ITUGPM61AM" http_endpoint_enabled: description: - A value that indicates whether the HTTP endpoint for an Aurora Serverless DB cluster is enabled. returned: always type: bool sample: false iam_database_authentication_enabled: description: Whether IAM accounts may be mapped to database accounts. returned: always type: bool sample: false latest_restorable_time: description: The latest time to which a database can be restored with point-in-time restore. returned: always type: str sample: "2018-06-29T14:09:34.797000+00:00" master_username: description: The master username for the DB cluster. returned: always type: str sample: "username" multi_az: description: Whether the DB cluster has instances in multiple availability zones. returned: always type: bool sample: false port: description: The port that the database engine is listening on. returned: always type: int sample: 3306 preferred_backup_window: description: The UTC weekly time range during which system maintenance can occur. returned: always type: str sample: "10:18-10:48" preferred_maintenance_window: description: The UTC weekly time range during which system maintenance can occur. returned: always type: str sample: "tue:03:23-tue:03:53" read_replica_identifiers: description: A list of read replica ID strings associated with the DB cluster. returned: always type: list sample: [] reader_endpoint: description: The reader endpoint for the DB cluster. returned: always type: str sample: "rds-cluster-demo.cluster-ro-cvlrtwiennww.us-east-1.rds.amazonaws.com" serverless_v2_scaling_configuration: description: The scaling configuration for an Aurora Serverless v2 DB cluster. returned: when configured type: dict sample: { "max_capacity": 4.5, "min_capacity": 2.5 } version_added: 7.3.0 status: description: The status of the DB cluster. returned: always type: str sample: "available" storage_encrypted: description: Whether the DB cluster is storage encrypted. returned: always type: bool sample: false tag_list: description: A list of tags consisting of key-value pairs. returned: always type: list elements: dict sample: [ { "key": "Created_By", "value": "Ansible_rds_cluster_integration_test" } ] tags: description: A dictionary of key value pairs. returned: always type: dict sample: { "Name": "rds-cluster-demo" } vpc_security_groups: description: A list of the DB cluster's security groups and their status. returned: always type: complex contains: status: description: Status of the security group. returned: always type: str sample: "active" vpc_security_group_id: description: Security group of the cluster. returned: always type: str sample: "sg-12345678" N)camel_dict_to_snake_dict)is_boto3_error_code)AnsibleAWSModule)arg_spec_to_rds_params) call_method) ensure_tags)get_tags)wait_for_cluster_status)AWSRetry)ansible_dict_to_boto3_tag_list retriesc tjd}|jdi|jddS#t d$ricYSwxYw)Ndescribe_db_clusters DBClustersrDBClusterNotFoundFault)client get_paginatorpaginatebuild_full_resultr)params paginators j/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/amazon/aws/plugins/modules/rds_cluster.py_describe_db_clustersrs[(()?@ !y!!+F+==? MaPP 7 8 s:=AAcz|jdgDcgc]}|d }}|d}| ||vr||ddSiScc}w)NAssociatedRolesRoleArnDBClusterIdentifier)rr get) params_dictclusterrolecurrent_role_arnss rget_add_role_optionsr's[5<[[ARTV5WXTiXX y !D D(99 DY8Z[[ I Ys 8c^gd}d"tfd|D}dvrd|d<|SiS)N) BacktrackTor 'UseEarliestTimeOnPointInTimeUnavailabler)c38K|]}| ||fywNr.0kr#s r z(get_backtrack_options..(s#Zq{1~?Y;q>*Z  ForceBacktrackForcedictr#optionss` rget_backtrack_optionsr8%sE_G=!-ZGZZ { **+;.[#Y41a!w,1=AY  r5itemsr6s @rget_create_optionsrg/s')GV Y;#4#4#6Y YYr9c|gdtfd|jD}|s|jdd|S)N)ApplyImmediatelyr<r=r>r r@rDrHrIrJNewDBClusterIdentifierrLrMrRrD!CloudwatchLogsExportConfigurationrTrUrVrYrWrXr[r\r]r^rGr_c3<K|]\}}|vs |||fywr,rras rr0z%get_modify_options..}s%cTQALUVUb1a&crdrJ)r5rfpop)r#force_update_passwordmodify_optionsr7s @rget_modify_optionsrp^s?G<c[->->-@ccN /6 r9c4gd}tfd|DS)N)r FinalSnapshotIdentifierSkipFinalSnapshotc38K|]}| ||fywr,rr-s rr0z%get_delete_options..s#S A8RKN#Sr1r4r6s` rget_delete_optionsrusUG SWS SSr9cPgdtfd|jDS)N) r;r<r=r?r r@rArBrCrDrFrHrErJrKrLrMr>rI S3BucketNameS3IngestionRoleArnS3Prefix SourceEngineSourceEngineVersionrPrQrRrTrUrVrWrXc3<K|]\}}|vs |||fywr,rras rr0z)get_restore_s3_options..rcrdrer6s @rget_restore_s3_optionsr}s'!GF Y;#4#4#6Y YYr9cPgdtfd|jDS)N)r;r<r rArBrCrDrFrHrErLrMSnapshotIdentifierrQrRr@rTrVrWrXc3<K|]\}}|vs |||fywr,rras rr0z/get_restore_snapshot_options..rcrdrer6s @rget_restore_snapshot_optionsrs&G, Y;#4#4#6Y YYr9cPgdtfd|jDS)N)r<r rArCrDrErLrM RestoreToTime RestoreTypeSourceDBClusterIdentifierrQUseLatestRestorableTimerRrTrVrWrXc3<K|]\}}|vs |||fywr,rras rr0z.get_restore_cluster_options..rcrdrer6s @rget_restore_cluster_optionsrs&G( Y;#4#4#6Y YYr9cLtjd}tjd}d}d}|dk(r|r |ddvrd}d}||fS|dk(r|r |dd vrd }d }||fS|d k(r|r |dd vrd}d }||fS|rd}d }||fS|dk(rd}d}||fS|dk(rd}d}||fS|dk(rd}d}||fSd}d}||fS)Nstatecreation_sourceabsentStatus)deletingdeleteddelete_db_clusterrustarted)startingr availablestart_db_clusterrpstopped)stoppingrstop_db_clustermodify_db_clustersnapshot restore_db_cluster_from_snapshotrs3restore_db_cluster_from_s3r}r$#restore_db_cluster_to_point_in_timercreate_db_clusterrgmoduler)r$rr method_namemethod_options_names rget_rds_method_attribute_namersa MM' "Emm$56OK  wx(0GG-K"6 4 + ++3 )  wx(0TT,K"6 , + +++ )  wx(0GG+K"6 $ + ++! -K"6  + ++ *,?|FShLiKjk !   sA7B&9#B!!B&cFtjs0 tjdi|ttt|ddyy#tj j tj jf$r'}tj|d|dYd}~td}~wwxYw)NzUnable to backtrack cluster r rrr) rrrbacktrack_db_clusterrrrrrr rs rbacktrack_clusterrs    h  ' ' 1& 1 7L0MObc ##1183F3F3R3RS h  *FvNcGdFe(f g g hsA7B 9BB c t|S#tjjtjjf$r!}t j |dYd}~yd}~wwxYw)N)r zFailed to describe DB clustersr)rrrrrrr) db_cluster_idrs r get_clusterrsYF$GG    - -x/B/B/N/N OFQ$DEEFs 7A&A!!A&ci}|jd}|jd}|jdd}|ggd}t|}t|d}tt|j ||d<t j dr&tt|j ||d<|ds|dr||d <|jd d} | r| |d <|jd d} | r | |dk7r| |d <|jd d} | r| |d D cgc]} | d c} vr| |d <|jdd} | rwg}t| }t|dDcgc]}|d c}}t j drtt|}n||z rtt||z}|r||d<|jdd}|r ||dk7r||d<|D]x}|dk(r ||||<|dvrP|jd|jdtfd|jdgDs||||<e||||k7sq||||<z|r ||d<|||d<t j ddk(r#|ddvrt jdi}||d<t j dd k(r#|ddvrt jd!i}||d<|Scc} wcc}w)"Nrir rC)EnableLogTypesDisableLogTypesEnabledCloudwatchLogsExportsrpurge_cloudwatch_logs_exportsrrkrJrjrLDBClusterOptionGroupMembershipsDBClusterOptionGroupNamerRVpcSecurityGroupsVpcSecurityGroupIdpurge_security_groupsr@DBClusterParameterGroupr])rWrXrWrXc3rK|].}|jdk(xr|jdk(0yw)rW IAMRoleNameNr!)r.dn_domainn_domain_iam_role_names rr0z+changing_cluster_options..ls>AEE(O+^0F!%%P]J^0^^s47DomainMembershipsrrrFmysqlpostgresz.Only aurora clusters can use the state startedrz.Only aurora clusters can use the state stopped) rmsetsortedlist differencerrr"any fail_json) modify_paramscurrent_clusterchanging_paramsapply_immediatelyrenable_cloudwatch_logs_export%desired_cloudwatch_logs_configurationprovided_cloudwatch_logscurrent_cloudwatch_logs_exportpasswordnew_cluster_id option_groupgvpc_sgsdesired_vpc_sgsprovided_vpc_sgssgcurrent_vpc_sgs"desired_db_cluster_parameter_groupparamrrs @@rchanging_cluster_optionsr"sO%))*<=!%%&;? ==8 9GM3>>?WXYH 12C D 22B C45FGChO? @  !5t?`/a-*+ $%-.:)* 5t.P)Q"R 5DO1 2)6):):;XZ^)_&) -AZ1[ [=_O9 :: M !%25%9OE "  3 3$((2H%2%6%67J%K "(,,-@"E*7u)=&   ?5#9 9%25%9OE "1:41>-.  (2CO. / }}W* 8 $(= =   M N1>-. }}W* 8 $(= =   M N1>-. K-hs  K K"c Nd}|sJ|jdt|d|d<ttt|t ||d}nt |r!tttt |d}nt ||tjd}t||}|rttt||d}tjdXttt|d}|ttt|d|tjdtjdz}t||}|rttt|d}tjd r=|jd r,tttd d tjd id}|S)NFrQTrn)rntags DBClusterArn purge_tagspromoterNpromote_read_replica_db_clusterr db_cluster_identifier) parameters)r"r rrrevalr8rrrr rr'r) r$rrrchangedmodifiable_optionsro existing_tagsadd_role_paramss rensure_presentrsyG  >>& ! -!? 6@R!SJv FFK1J6I1J:1VW  , ff.CJ.O PG!:&9!:&--@W2X" 66H'RNFFKH}}V$0 (9P Q ;N+!MM&)MM,/ +:w?O1 }}YGKK0M$N   --v}}=T/UV   Nr9c >tjjd}tjjd}|d}tjry tj ||d |vrttt|d tjjd rttt|d y#t jjt jjf$r(}tj|d|d|d Yd}~d}~wwxYw)Nglobal_cluster_identifierrrT)DbClusterIdentifierrZzFailed to remove cluster z from global DB cluster .rGlobalWriteForwardingStatusdb_cluster_promotingwaitr) rrr"rrremove_from_global_clusterrrrrrr )r$global_cluster_idrdb_cluster_arnrs rhandle_remove_from_global_dbrs ))*EFMM%%&=>M^,N  ))nfw)x%/ ?UV}}  ?RS     - -x/B/B/N/N O  .}o=UVgUhhij    sB==7D4DDc\ ttgddtdgdtdd tdd tdd tdd tdd tdd  }tdid tdd d tddddgdtdtddtdd dtdtdgdtd gddtd td!tdd"d#tdd$td%tdd&tdd'td(td)tdd*tdd+tdd,tgd-.d/tgd0.d1td2tdd3tdgd4d5tdd6td7tdd8td9td:gd ;dtgd?d@tdAtddBtdCgdDtdEgdFtddGtdHgdItdJtdKdLg.dMtdNtdOtdPtdQtdRttdStdSTUdVtdd dWtdXtdYtdZg.d[td\td]tdd^tdRd_g`datddbtddctdd" |j gdd}t|dedfdWd,ggdedg|gdFd d$dggggdhdbdIggd iat j djk} tj dl|matjjd,rtjd,dpvrtjdqdk(rtjjd2r>tjjd5rtjjd*s+tjdrtjd,dsn2tjjd3sdttjd3<tjjd,rWtjd,duvrBtjs2tjjd3rdvtjd3<tjjd3r`tjd3dwvrKtjjd,duvr*tjdxtjd3dytjdj!tjd<t#tjd}tjd>rtjd>j!tjd><t#tjd>r*tjdztjd>d{|s*tjdztjd>d|tjdqd}k(r>tjdVdur)tjd6tjd~od}t%t fdtjD}t'|\}}|rq|dk(r[|r1tjjdFr|dduvr t)|}t+t t|t-||d }n|t/||||z}tjs:tjd>r'tjd rtjd>} ntjd} | rWt#| rLtjjdFr-|dduvr|rt1t t| d|t)|z}t3t#| } | rt5t t| d| d^<tj6dd|i| y#tjjtjjf$r"}tj|dnoYd}~Sd}~wwxYw)N)presentrrrr)choicesdefaultstr)rrr$)typerboolF)rrT)rrrnrrrrrravailability_zonesrzonesaz)relementsaliases backtrack_tobacktrack_windowint)rbackup_retention_periodcharacter_set_name database_namedb_name)r r) cluster_idid cluster_name)requiredr db_cluster_parameter_group_namedb_subnet_group_nameenable_cloudwatch_logs_exports)rr deletion_protectionrenable_http_endpointcopy_tags_to_snapshotdomaindomain_iam_role_nameenable_global_write_forwardingdb_cluster_instance_class"enable_iam_database_authenticationengine)aurora aurora-mysqlaurora-postgresqlrr)r engine_mode) provisioned serverless parallelqueryglobal multimasterengine_versionallocated_storage storage_type)io1r# aurora-iopt1iopsfinal_snapshot_identifierforce_backtrack kms_key_idmaster_user_passwordr)r no_logmaster_usernameusernamenew_db_cluster_identifier)rnew_idnew_cluster_nameoption_group_nameportpreferred_backup_window backup_windowpreferred_maintenance_windowmaintenance_windowremove_from_global_dbreplication_source_identifierreplication_src_idrestore_to_time restore_typez full-copyz copy-on-writerole_arns3_bucket_names3_ingestion_role_arn s3_prefix#serverless_v2_scaling_configurationr5float) min_capacity max_capacity)rr7skip_final_snapshotsnapshot_identifiersource_db_cluster_identifier source_enginersource_engine_version source_regionstorage_encryptedr resource_tags)rr .use_earliest_time_on_point_in_time_unavailableuse_latest_restorable_timevpc_security_group_ids)rHr"r7r5rRrSrIrrr)rHrQrP) argument_spec required_ifmutually_exclusivesupports_check_moder rrds)retry_decoratorzFailed to connect to AWS.rrrz When engine=zH allocated_storage, iops and db_cluster_instance_class must be specifiedr/)r#r$r%r#)r#r0z storage_type=zS is only supported for aurora engines 'aurora', 'aurora-mysql', 'aurora-postgresql'zA new cluster ID z# was provided but it already existsz: was provided but the cluster to be renamed does not existrz\skip_final_snapshot is False but all of the following are missing: final_snapshot_identifierc3RK|]}|vs|tj|f ywr,r)r.r/parameter_optionss rr0zmain..zs(,tq]^bs]saq1A-B,ts ''rrFrrrr)r5updaterrr jittered_backoffrrrrrrrr"rrlowerrrrrrrrr rr exit_json) arg_specrequired_by_s3_creation_sourcer_rr$rrrrrresultras @rmainrisFPYZ%1NO">&%0&*&EVT2 vt ,"= H?FE:?Vegt_U?V?5) ? !%% ; ?  6 ?I;/?#D:^_?)-?"V?(,%'H?!f-?#'&?"v.?#/? v!?""V#?$(,'8%?&#'E"2'?(,0V+<)?*`a+?,!hi-?.v/?0E*1?2u.OP3?4u 5?6#'&7?8&)9?:6;?<":,tD=?>j\2??@#'/_"`A?B&C?Du E?F!%o-> ?G?H&*3G2H%II?J#/K?L'+4H3I&JM?NO?P;"@AQ?RS?TvU?V#fW?X&Y?Z-1!w/!w/- [?h!feBW'W == !Y . !!"56MM%%f-MM%%&AB  "6==#:";Bq'q  V]]%6%6~%F,4FMM. ) }}(V]]>-JNh-h ==  X &.] ]    n =>?RS .4]];R-S-Y-Y-[FMM)*&--(?@AG }}015;]]C^5_5e5e5g 12 v}}%@A B   #FMM2M$N#OOrs    #FMM2M$N#OPJK   g(* MM/ 0E 9 MM5 6 >n  G',tFMM,t(tuJ'DW'M$K$ - -6==,,-DE8$(WW:7CG  5NT:M5Nz5Z [G ~gz;H[\ \G   /J!KPVP]P]^qPr]]#>? ]]#:; k*-&--2C2CD[2\ 8  O O' DWX/88 %k*&= >F !&&&9I2JKv /W//i    + +X-@-@-N-N OAQ$?@@As<c7d+ d&&d+__main__)( DOCUMENTATIONEXAMPLESRETURNr ImportError0ansible.module_utils.common.dict_transformationsrrvs[ z j Xo b V\XZOOL[Pf2&',Z^"JT $ZNZ4Z0#,LddFfR.b6A0H zFo  sBB'&B'