File manager - Edit - /opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/__pycache__/boto_rds.cpython-310.pyc
Back
o ;j� � @ s\ d Z ddlZddlZddlmZ ddlZddlZddlm Z e� e �Z z$ddl Z ddlZddlmZ e� d��ej� e� d��ej� dZW n eyR d ZY nw i d d ef�d d ef�ddef�ddef�ddef�ddef�ddef�ddef�ddef�d d ef�d d ef�d d!ef�d"d#ef�d$d%ef�d&d'ef�d(d)ef�d*d+ef�i d,d-ef�d.d/ef�d0d1ef�d2d3ef�d4d5ef�d6d7ef�d8d9ef�d:d;ef�d<d=ef�d>d?ef�d@dAef�dBdCef�dDdEef�dFdGef�dHdIef�dJdKef�dLdMef��dNefdOefdPefdQefdRefdSefdTefdUefdV��ZdWdX� ZdYdZ� Zd�d[d\�Z d�d]d^�Z d�d_d`�Z d�dadb�Z d�dcdd�Z d�dedf�Z! d�dgdh�Z" d�didj�Z# d�dkdl�Z$ m d�dndo�Z%d�dpdq�Z& r d�dsdt�Z' u d�dvdw�Z(d�dxdy�Z) zd�d{d|�Z*d�d}d~�Z+d�dd��Z,d�d�d��Z- d�d�d��Z. d�d�d��Z/ d�d�d��Z0d�d�� Z1dS )�a� Connection module for Amazon RDS .. versionadded:: 2015.8.0 :configuration: This module accepts explicit rds credentials but can also utilize IAM roles assigned to the instance through Instance Profiles. Dynamic credentials are then automatically obtained from AWS API and no further configuration is necessary. More Information available at: .. code-block:: text http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/iam-roles-for-amazon-ec2.html If IAM roles are not used you need to specify them either in a pillar or in the minion's config file: .. code-block:: yaml rds.keyid: GKTADJGHEIQSXMKKRBJ08H rds.key: askdjghsdfjkghWupUjasdflkdfklgjsdfjajkghs A region may also be specified in the configuration: .. code-block:: yaml rds.region: us-east-1 If a region is not specified, the default is us-east-1. It's also possible to specify key, keyid and region via a profile, either as a passed in dict, or as a string to pull from pillars or minion config: .. code-block:: yaml myprofile: keyid: GKTADJGHEIQSXMKKRBJ08H key: askdjghsdfjkghWupUjasdflkdfklgjsdfjajkghs region: us-east-1 :depends: boto3 � N)� OrderedDict)�SaltInvocationError)� ClientError�boto�boto3TF�allocated_storage�AllocatedStorage�allow_major_version_upgradeZAllowMajorVersionUpgrade�apply_immediatelyZApplyImmediately�auto_minor_version_upgrade�AutoMinorVersionUpgrade�availability_zone�AvailabilityZone�backup_retention_period�BackupRetentionPeriod�ca_certificate_identifier�CACertificateIdentifier�character_set_name�CharacterSetName�copy_tags_to_snapshot�CopyTagsToSnapshot�db_cluster_identifier�DBClusterIdentifier�db_instance_class�DBInstanceClass�db_name�DBName�db_parameter_group_name�DBParameterGroupName�db_port_numberZ DBPortNumber�db_security_groupsZDBSecurityGroups�db_subnet_group_name�DBSubnetGroupName�domainZDomain�domain_iam_role_nameZDomainIAMRoleName�engine�Engine�engine_version� EngineVersion�iops�Iops� kms_key_id�KmsKeyId� license_model� LicenseModel�master_user_passwordZMasterUserPassword�master_usernameZMasterUsername�monitoring_interval�MonitoringInterval�monitoring_role_arn�MonitoringRoleArn�multi_azZMultiAZ�name�DBInstanceIdentifier�new_db_instance_identifierZNewDBInstanceIdentifier�option_group_name�OptionGroupName�port�Port�preferred_backup_window�PreferredBackupWindow� preferred_maintenance_window�PreferredMaintenanceWindow� PromotionTier�PubliclyAccessible�StorageEncrypted� StorageType�Tags�TdeCredentialArnZTdeCredentialPasswordZVpcSecurityGroupIds)�promotion_tier�publicly_accessible�storage_encrypted� storage_type�tags�tde_credential_arn�tde_credential_password�vpc_security_group_idsc C s t jjjdd�S )zg Only load if boto libraries exist and if boto libraries are greater than a given version. z1.3.1)Z boto3_ver)�salt�utilsZversionsZcheck_boto_reqs� rQ rQ �I/opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/boto_rds.py� __virtual__{ s rS c C s t r td td� d S d S )Nzboto3.assign_funcs�rds)�HAS_BOTO� __utils__�__name__)�optsrQ rQ rR �__init__� s �rY c C �` t ||||d�}z |j| d�}dt|�iW S ty/ } zdtd |�iW Y d}~S d}~ww )z� Check to see if an RDS exists. CLI Example: .. code-block:: bash salt myminion boto_rds.exists myrds region=us-east-1 ��region�key�keyid�profile�r7 �exists�error�boto3.get_errorN)� _get_conn�describe_db_instances�boolr rV � r6 rK r\ r] r^ r_ �connrT �erQ rQ rR ra � s ��ra c C rZ )z� Check to see if an RDS option group exists. CLI Example: .. code-block:: bash salt myminion boto_rds.option_group_exists myoptiongr region=us-east-1 r[ �r: ra rb rc N)rd Zdescribe_option_groupsrf r rV rg rQ rQ rR �option_group_exists� s ��rk c C s� t ||||d�}z|j| d�}t|�dd�W S tyA } z i } |jd d dkr-d| d < td |�| d < | W Y d}~S d}~ww ) z� Check to see if an RDS parameter group exists. CLI Example: .. code-block:: bash salt myminion boto_rds.parameter_group_exists myparametergroup region=us-east-1 r[ �r N)ra rb �Error�CodeZDBParameterGroupNotFoundFra rc rb )rd � describe_db_parameter_groupsrf r �responserV ) r6 rK r\ r] r^ r_ rh rT ri ZresprQ rQ rR �parameter_group_exists� s ��rq c C s� z t ||||d�}|sdt|�iW S |j| d�}dt|�iW S tyG } z d|jv r5ddiW Y d}~S dtd |�iW Y d}~S d}~ww ) z� Check to see if an RDS subnet group exists. CLI Example: .. code-block:: bash salt myminion boto_rds.subnet_group_exists my-param-group region=us-east-1 r[ ra �r" ZDBSubnetGroupNotFoundFaultFNrb rc )rd rf �describe_db_subnet_groupsr �messagerV rg rQ rQ rR �subnet_group_exists� s ��ru c+ 9 C s |st d��|s t d��|st d��|st d��|s t d��| r&|r&t d��|r7g d�}+||+vr7t d|+� ���| rLtd | |&|(|)|*d �},|rJ||, n|,}z�t|&|(|)|*d �}-|-s^d t|-�iW S i }.tt�� �}/tt� �� �}0t|�}|0� |/�D ]}1t� |1 }2|2d ur�t|1 }3|3d |2�|.|3d < qvdd� |.� � D �}.|-j d!i |.��}4|4s�ddiW S |s�dd| � d�d�W S d}5t | |5|&|(|)|*d�}6|6r�|6d }7n dd� | �d�W S |7|kr�dd � | |7�d�W S t�d � t�d |7� q� t�y }8 zd td |8�iW Y d }8~8S d }8~8ww )"z� Create an RDS Instance CLI example to create an RDS Instance:: salt myminion boto_rds.create myrds 10 db.t2.micro MySQL sqlusr sqlpassw z allocated_storage is requiredz db_instance_class is requiredzengine is requiredzmaster_username is requiredz master_user_password is requiredz@availability_zone and multi_az are mutually exclusive arguments.)Z availableZ modifyingz backing-upzwait_status can be one of: z"boto_secgroup.convert_to_group_ids)�groupsr\ r] r^ r_ r[ �resultsN� r c S s i | ] \}}|d ur||�qS )NrQ )�.0�k�vrQ rQ rR � <dictcomp>I s zcreate.<locals>.<dictcomp>�createdFT� RDS instance z created.�r} rt z DBInstances[*].DBInstanceStatus)r6 �jmespathr\ r] r^ r_ zARDS instance {} should have been created but now I can't find it.)r} rb z+RDS instance {} created (current status {})� z'Instance status after 10 seconds is: %srb rc rQ )r �__salt__rd rf �set�boto3_param_map�keys�locals�_tag_doc� intersection�itemsZcreate_db_instancere �format�time�sleep�log�infor rV )9r6 r r r% r0 r/ r r rN Zvpc_security_groupsr r! r? r r r= r; r5 r' r r- r) r9 r rH Z wait_statusrK r rJ rL rM rI r+ r# r r1 r3 r$ r\ rG r] r^ r_ Z wait_statiZv_tmprh �kwargs� boto_paramsr� Z param_key�val�mappedrT r� �status�statri rQ rQ rR �create� s� 4��� � �� ��� � ��r� c C sx t std��td || ||||�}|�d�s!t|�d|� d�d�S td | | ||||�}|�d�r<t|�d| � d�d�S zet||||d �}i }d D ]}t� | d ur[tt� | �||< qId D ]}t� | d urptt� | �||< q^d D ]}t� | d ur�tt� | �||< qst | �}|j d| |||||| | d�|��}dt|�iW S t y� } zdt d |�iW Y d }~S d }~ww )z� Create an RDS read replica CLI example to create an RDS read replica:: salt myminion boto_rds.create_read_replica replicaname source_name z#backup_retention_period is required�boto_rds.existsra zRDS instance source z does not exists.�ra rt zRDS replica instance z already exists.r[ )r: r4 N)r2 r* r< )r r )r7 ZSourceDBInstanceIdentifierr r rB rE r" rD rb rc rQ ) r r r� �getrf rd r� �str�intr� Z create_db_instance_read_replicar rV )r6 Z source_namer r r; r r) r9 rH rK r! rJ r r1 r3 r\ r] r^ r_ �resrh r� �taglistZ rds_replicari rQ rQ rR �create_read_replicax sZ � ����� � ��r� c C s� t d | |||||�} | �d�rdt| �iS z&t||||d�} | s(dt| �iW S t|�} | j| |||| d�} dt| �iW S tyV } zdtd | �iW Y d} ~ S d} ~ ww ) z� Create an RDS option group CLI example to create an RDS option group:: salt myminion boto_rds.create_option_group my-opt-group mysql 5.6 "group description" z boto_rds.option_group_existsra r[ rw )r: Z EngineNameZMajorEngineVersionZOptionGroupDescriptionrE rb rc N)r� r� rf rd r� �create_option_groupr rV )r6 Z engine_nameZmajor_engine_versionZoption_group_descriptionrK r\ r] r^ r_ r� rh r� rT ri rQ rQ rR r� � s, � � ��r� c C s� t d | |||||�}|�d�rdt|�iS z4t||||d�} | s(dt| �iW S t|�} | j| ||| d�} | s@dd| � �d�W S t| �d | � �d �W S tyd } zd td | �iW Y d } ~ S d } ~ ww )z� Create an RDS parameter group CLI example to create an RDS parameter group:: salt myminion boto_rds.create_parameter_group my-param-group mysql5.6 "group description" � boto_rds.parameter_group_existsra r[ rw )r ZDBParameterGroupFamily� DescriptionrE Fz%Failed to create RDS parameter group r z Created RDS parameter group r� rb rc N)r� r� rf rd r� Zcreate_db_parameter_groupr rV ) r6 Zdb_parameter_group_family� descriptionrK r\ r] r^ r_ r� rh r� rT ri rQ rQ rR �create_parameter_group� s6 � ��� ��r� c C s� t d | |||||�}|�d�rdt|�iS z%t||||d�} | s(dt| �iW S t|�} | j| ||| d�} dt| �iW S tyU } zdtd | �iW Y d } ~ S d } ~ ww ) z� Create an RDS subnet group CLI example to create an RDS subnet group:: salt myminion boto_rds.create_subnet_group my-subnet-group "group description" '[subnet-12345678, subnet-87654321]' region=us-east-1 z boto_rds.subnet_group_existsra r[ rw )r" ZDBSubnetGroupDescriptionZ SubnetIdsrE r} rb rc N)r� r� rf rd r� Zcreate_db_subnet_groupr rV ) r6 r� Z subnet_idsrK r\ r] r^ r_ r� rh r� rT ri rQ rQ rR �create_subnet_group$ s* � � ��r� �pending-rebootc C s. t d | |||||�}|�d�st|�d| � d�d�S g } |�� D ]5\}} t� } | �d|i� | �d|i� t| �tu rH| �d| rCd nd i� n | �dt| �i� | �| � q!| s]d d iS z t ||||d �} | sod t| �iW S | j | | d�}d t|�iW S t y� } zdt d | �iW Y d} ~ S d} ~ ww )a Update an RDS parameter group. CLI Example: .. code-block:: bash salt myminion boto_rds.update_parameter_group my-param-group parameters='{"back_log":1, "binlog_cache_size":4096}' region=us-east-1 r� ra zRDS parameter group � does not exist.r� � ParameterName� ApplyMethod�ParameterValue�onZoffrw Fr[ )r � Parametersrb rc N) r� r� rf r� r �update�typer� �appendrd Zmodify_db_parameter_groupr rV )r6 � parametersZ apply_methodrK r\ r] r^ r_ r� Z param_list�value�itemrh ri rQ rQ rR �update_parameter_groupO s< � � � ��r� c s� t d � |||||�}|�d�st|�d� � d�d�S z<t||||d�}|s-dt|�iW S |j� d��� fd d ���d g �D ��d ���rSd }d�fdd�|D �iW S ddiW S tyq } zdtd | �iW Y d} ~ S d} ~ w ty} ddi Y S w )z� Return RDS instance details. CLI Example: .. code-block:: bash salt myminion boto_rds.describe myrds r� ra r~ r� r� r[ rw r` c s g | ] }|� d �� kr|�qS r` �r� )ry �i)r6 rQ rR � <listcomp>� s �z describe.<locals>.<listcomp>� DBInstancesr ) r7 r r& ZDBInstanceStatusr r r> r r r@ ZLatestRestorableTimer( r r. r* r rB rD rF ZDBInstancePortr rC r, Z DbiResourceIdr r r2 r4 rA ZDomainMembershipsrT c s i | ]}|� � |��qS rQ r� )ry rz )rT rQ rR r| � s z describe.<locals>.<dictcomp>Nrb rc ) r� r� rf rd re �popr rV � IndexError) r6 rK r\ r] r^ r_ r� rh r� ri rQ )r6 rT rR �describe� s2 � �� � �r� r� c C s� t ||||d�}|�d�}i } | r| �d| i�nd |r#| �d|i�nd |jd i | ��} |r4| �|�n| } zdd� | D �W S tyr } z(t| di ��d i ��d �} | d krgt� t d | �� W Y d} ~ g S W Y d} ~ g S d} ~ ww )av Return a detailed listing of some, or all, DB Instances visible in the current scope. Arbitrary subelements or subsections of the returned dataset can be selected by passing in a valid JMSEPath filter as well. CLI Example: .. code-block:: bash salt myminion boto_rds.describe_db_instances jmespath='DBInstances[*].DBInstanceIdentifier' r[ re r7 N�Filtersc S � g | ]}|�qS rQ rQ �ry �prQ rQ rR r� � � z)describe_db_instances.<locals>.<listcomp>rp rm rn ZDBInstanceNotFoundrc rQ ) rd � get_paginatorr� �paginate�searchr �getattrr� r� rb rV ) r6 �filtersr� r\ r] r^ r_ rh �pag�args�pitri �coderQ rQ rR re � s( �� ���re �DBSubnetGroupsc C sz t ||||d�}|�d�}i } | r| �d| i�nd |r#| �d|i�nd |jdi | ��} |r4| �|�n| } dd� | D �S ) aO Return a detailed listing of some, or all, DB Subnet Groups visible in the current scope. Arbitrary subelements or subsections of the returned dataset can be selected by passing in a valid JMSEPath filter as well. CLI Example: .. code-block:: bash salt myminion boto_rds.describe_db_subnet_groups r[ rs r" Nr� c S r� rQ rQ r� rQ rQ rR r� r� z-describe_db_subnet_groups.<locals>.<listcomp>rQ )rd r� r� r� r� ) r6 r� r� r\ r] r^ r_ rh r� r� r� rQ rQ rR rs � s ��rs c C s� d}t d | |||||�}|�d�r]z0t||||d�}|r:|j| d�} | r=d| d d v r@| d d d d }|W S W |S W |S W |S ty\ } zd td | �iW Y d } ~ S d } ~ ww |S ) z� Return the endpoint of an RDS instance. CLI Example: .. code-block:: bash salt myminion boto_rds.get_endpoint myrds Fr� ra r[ r` ZEndpointr� r ZAddressrb rc N)r� r� rd re r rV ) r6 rK r\ r] r^ r_ Zendpointr� rh rT ri rQ rQ rR � get_endpoint s* � ��� ��r� � c C sj | dkr|sd} |s|st d��z�t||||d�} | s"dt| �iW S i } t� d dur4tt� d �| d< t� d durDtt� d �| d < | jdd | i| ��} |s\t| �d | � d �d�W S t�� } td | |||||d�} | �d�s~t| �d | � d�d�W S t�� | | kr�t d� | | ���t � d| | � t� d� qa t y� } zdtd |�iW Y d}~S d}~ww )z� Delete an RDS instance. CLI Example: .. code-block:: bash salt myminion boto_rds.delete myrds skip_final_snapshot=True region=us-east-1 r� i� zaAt least one of the following must be specified: skip_final_snapshot final_db_snapshot_identifierr[ �deleted�skip_final_snapshotNZSkipFinalSnapshot� final_db_snapshot_identifierZFinalDBSnapshotIdentifierr7 zDeleted RDS instance �.�r� rt Tr� )r6 rK r\ r] r^ r_ ra z completely.z@RDS instance {} has not been deleted completely after {} secondsz;Waiting up to %s seconds for RDS instance %s to be deleted.r� rb rc rQ )r rd rf r� r� Zdelete_db_instancer� r� r� r� r� r� r� r rV )r6 r� r� r\ r] r^ r_ rK Zwait_for_deletion�timeoutrh r� r� Z start_timeri rQ rQ rR �delete2 sh �� �� ��� � ��r� c C s� z1t ||||d�}|sdt|�iW S |j| d�}|s&t|�d| � d�d�W S t|�d| � d�d�W S tyK } zdtd |�iW Y d }~S d }~ww ) z� Delete an RDS option group. CLI Example: .. code-block:: bash salt myminion boto_rds.delete_option_group my-opt-group region=us-east-1 r[ r� rj z"Failed to delete RDS option group r� r� zDeleted RDS option group rb rc N)rd rf �delete_option_groupr rV )r6 r\ r] r^ r_ rh r� ri rQ rQ rR r� � s � � ��r� c C �| z#t ||||d�}|sdt|�iW S |j| d�}t|�d| � d�d�W S ty= } zdtd |�iW Y d }~S d }~ww ) z� Delete an RDS parameter group. CLI Example: .. code-block:: bash salt myminion boto_rds.delete_parameter_group my-param-group region=us-east-1 r[ rw rl z Deleted RDS parameter group r� r� rb rc N)rd rf Zdelete_db_parameter_groupr rV �r6 r\ r] r^ r_ rh �rri rQ rQ rR �delete_parameter_group� � � ��r� c C r� ) z� Delete an RDS subnet group. CLI Example: .. code-block:: bash salt myminion boto_rds.delete_subnet_group my-subnet-group region=us-east-1 r[ rw rr zDeleted RDS subnet group r� r� rb rc N)rd rf Zdelete_db_subnet_groupr rV r� rQ rQ rR �delete_subnet_group� r� r� c C s t d | d||||d�}|�d�sdt|�iS z\t||||d�} | s)dt| �iW S i } dD ]}t� | dur?tt� | �| |< q-t� d durPtt� d �| d< | jdd | i| ��} | sht| �d | � d �d �W S t| �d | � d �d �W S ty� } zdt d | �iW Y d} ~ S d} ~ ww )z� Returns a list of `DBParameterGroup` descriptions. CLI example to description of parameter group:: salt myminion boto_rds.describe_parameter_group parametergroupname region=us-east-1 r� N�rK r\ r] r^ r_ ra r[ rw )�Markerr� � MaxRecordsr z(Failed to get RDS description for group r� )rw rt z Got RDS descrition for group rb rc rQ ) r� r� rf rd r� r� r� ro r rV ) r6 r� r� r� r\ r] r^ r_ r� rh r� r� ri rQ rQ rR �describe_parameter_group� s8 � � � � ��r� c C sh t d | d||||d�}|�d�sdd| � d�d�S zt||||d �} | s+dd d�W S i } | �d | i� d D ]}t� | durHtt� | �| |< q6t� d durYtt� d �| d < | �d�} | jdi | ��} g d�} t � }ddi}| D ] }|d D ]}t � }| D ] }|�|�||< q�|||�d�< qyqs||d< |W S t y� } zdt d |�iW Y d}~S d}~ww )z� Returns a list of `DBParameterGroup` parameters. CLI example to description of parameters :: salt myminion boto_rds.describe_parameters parametergroupname region=us-east-1 r� Nr� ra FzParameter group z does not exist)�resultrt r[ z'Could not establish a connection to RDSr )r� �Sourcer� Zdescribe_db_parameters) r� r� r� r� Z ApplyTypeZDataTypeZ AllowedValuesZ IsModifieableZMinimumEngineVersionr� r� Tr� r� r� rb rc rQ ) r� r� rd r� r� r� r� r� r� r r rV )r6 r� r� r� r\ r] r^ r_ r� rh r� r� r� r� r� �retr� r� �datarz ri rQ rQ rR �describe_parameters sN � ��� � ��r� c) 3 C s> t d | d|%|&|'|(d�})|)�d�sdd| � d�d�S zjt|%|&|'|(d �}*|*s*d diW S i }+d h},tt�� �}-tt� �� �}.|.�|-��|,�D ]}&t� |& }/|/dur]t|& }0|0d |/�|+|0d < qD|*j dd| i|+��}1|1svt |1�d| � d�d�W S t |1�d| � d�t |1�d�W S t y� }2 zdt d |2�iW Y d}2~2S d}2~2ww )z� Modify settings for a DB instance. CLI example to description of parameters :: salt myminion boto_rds.modify_db_instance db_instance_identifier region=us-east-1 r� Nr� ra FzRDS db instance r� )�modifiedrt r[ r� r6 rx r r7 z!Failed to modify RDS db instance r� zModified RDS db instance )r� rt rw rb rc rQ )r� r� rd r� r� r� r� r� � difference�modify_db_instancerf �dictr rV )3r6 r r r r r r r r r r r r r r r! r# r$ r' r) r+ r- r/ r1 r3 r5 r8 r9 r= r? rG rH rI rJ rL rM rN r\ r] r^ r_ r� rh r� Zexcludedr� r� r� r� r� ri rQ rQ rR r� Y sD 1 � � � � � ��r� c C sJ g }| d ur#| � � D ]\}}t|��d�rq |�t|�t|�d�� q |S )N�__)ZKeyZValue)r� r� � startswithr� )rK r� rz r{ rQ rQ rR r� � s r� )NNNNN)%NNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNN)NNNNNNNNNNNNNNNNN)r� NNNNN)NNr� NNNN)NNr� NNNN) NNNNNNNTr� )NNNN)NNNNNNN)(NNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNN)2�__doc__�loggingr� � collectionsr Zsalt.utils.compatrO Zsalt.utils.versionsZsalt.exceptionsr � getLoggerrW r� r r Zbotocore.exceptionsr �setLevel�CRITICALrU � ImportErrorr� rf r� �listr� rS rY ra rk rq ru r� r� r� r� r� r� r� re rs r� r� r� r� r� r� r� r� r� rQ rQ rQ rR �<module> s( 1 ��������� � � � � ��������������� � � � � �!�"�#�. � � �" � �S �0 �6 �. � :I �& � � V �6 �N � Z
| ver. 1.4 |
Github
|
.
| PHP 8.2.30 | Generation time: 0 |
proxy
|
phpinfo
|
Settings