Current File : //usr/lib/python2.7/site-packages/salt/modules/boto3_elasticache.pyo
�
���^c @@ s$ d Z d d l m Z m Z m Z d d l Z d d l Z d d l m Z m Z d d l
Z d d l Z e j
e � Z y; d d l Z d d l Z e j
d � j e j � e Z Wn e k
r� e Z n Xd � Z d � Z d d � Z d d d d d d d d d d
� Z d d d d d d d d � Z d d d d d d
d d d d d �
Z d d d d d d
d d d d d �
Z d d d d d d d � Z d d d d d d � Z! d d d d d d d � Z" d d d d d d d � Z# d d d d d d � Z$ d d d d d d d � Z% d d d d d � Z& d d d d d d d � Z' d d d d d d d � Z( d d d d d d � Z) d d d d d d d � Z* d d d d d � Z+ d d d d d � Z, d d d d d d � Z- d d d d d d � Z. d d d d d � Z/ d d d d d d d! � Z0 d d d d d" � Z1 d d d d d# � Z2 d d d d d$ � Z3 d d d d d% � Z4 d d d d d& � Z5 d d d d d' � Z6 d d d d d( � Z7 d d d d d) � Z8 d d d d d* � Z9 d d d d d d d+ � Z: d d d d d, � Z; d d d d d- � Z< d S(. u@
Execution module for Amazon Elasticache using boto3
===================================================
.. versionadded:: 2017.7.0
:configuration: This module accepts explicit elasticache 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
elasticache.keyid: GKTADJGHEIQSXMKKRBJ08H
elasticache.key: askdjghsdfjkghWupUjasdflkdfklgjsdfjajkghs
A region may also be specified in the configuration:
.. code-block:: yaml
elasticache.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
i ( t absolute_importt print_functiont unicode_literalsN( t SaltInvocationErrort CommandExecutionErroru boto3c C@ s t j j j � S( ug
Only load if boto libraries exist and if boto libraries are greater than
a given version.
( t saltt utilst versionst check_boto_reqs( ( ( sB /usr/lib/python2.7/site-packages/salt/modules/boto3_elasticache.pyt __virtual__J s c C@ sC t j j j t � t r? t d t d d d d d d d �n d S( Nu boto3.assign_funcsu elasticachet get_conn_funcnameu _get_connt cache_id_funcnameu _cache_idt exactly_one_funcname( R R t compatt pack_dundert __name__t HAS_BOTO3t __utils__t None( t opts( ( sB /usr/lib/python2.7/site-packages/salt/modules/boto3_elasticache.pyt __init__R s u Markerc C@ s{ g } | | k r | | n d } xR | d k rv | | � } | | j | � 7} | j | � } | j i | | 6� q% W| S( Nu ( R t gett update( t funct itemt argst markert rett Markert r( ( sB /usr/lib/python2.7/site-packages/salt/modules/boto3_elasticache.pyt _collect_results[ s c K@ s1 | d k r0 t d | d | d | d | � } n y! d | d }
t | |
� } Wn4 t t f k
r� } t d j |
| j � � � n X| j | r� i | | 6n
i d d 6� t g | j
� D]' \ }
} |
j d
� s� |
| f ^ q� � } y t | | | � SWn' t
j j k
r,} t j | � d SXd S( Nt regiont keyt keyidt profileu describe_u su No function '{0}()' found: {1}u u Markeru _( R t _get_connt getattrt AttributeErrort KeyErrorR t formatt messageR t dictt itemst
startswithR t botocoret
exceptionst ClientErrort logt debug( t namet
name_paramt res_typet info_nodet connR R R! R" R R t ft et kt v( ( sB /usr/lib/python2.7/site-packages/salt/modules/boto3_elasticache.pyt _describe_resourcef s $ '@
u deletedc K@ s� y t | � } Wn& t k
r8 t d j | � � � n Xt d | d | d | d |
� } | | k r� t j d | | | | � | | } n
| | | <t g | j � D]' \ }
} |
j d � s� |
| f ^ q� � } yA d | } t
| | � } | rd | d
} t � | } n Wn4 t t
f k
rN} t d j | | j � � � n Xy(| | � | st j d | j � | � t St j d
| | | � | } x� | d k rU| d | d | � } | s�t | � s�| d j | � | k r t j d | j � | � t S| d | k r | n d } t j d | | | � t j | � | | 8} q�Wt j d | j � | | � t SWn0 t j j k
r�} t j d | | | � t SXd S( u0
Delete a generic Elasticache resource.
uF Bad value ('{0}') passed for 'wait' param - must be an int or boolean.R R R! R" uA 'name: %s' param being overridden by explicitly provided '%s: %s'u _u delete_u describe_u su No function '{0}()' found: {1}u %s %s deletion requested.u1 Waiting up to %s seconds for %s %s to be deleted.i R1 R5 u %s %s deleted.i< u, Sleeping %s seconds for %s %s to be deleted.u# %s %s not deleted after %s seconds!u Failed to delete %s %s: %sN( t intt ExceptionR R' R# R/ t infoR) R* R+ R$ t globalsR% R& R( t titlet Truet lenR t timet sleept errort FalseR, R- R. ( R1 R2 t descR3 t waitt status_paramt status_goneR R R! R" R R5 R8 R9 R R6 t sR7 t orig_waitR RC ( ( sB /usr/lib/python2.7/site-packages/salt/modules/boto3_elasticache.pyt _delete_resourcey sV
!
@
-
u availablec K@ s� y t | � } Wn& t k
r8 t d j | � � � n Xt d | d | d | d |
� } | | k r� t j d | | | | � | | } n
| | | <t g | j � D]' \ }
} |
j d � s� |
| f ^ q� � } yA d | } t
| | � } | rd | d
} t � | } n Wn4 t t
f k
rN} t d j | | j � � � n Xy| | � | st j d | j � | � t St j d
| | | � | } x� | d k rG| d | d | � } | r�| d j | � | k r�t j d | j � | � t S| d | k r| n d } t j d | | | � t j | � | | 8} q�Wt j d | j � | | � t SWn< t j j k
r�} d j | | | � } t j | � t SXd S( NuF Bad value ('{0}') passed for 'wait' param - must be an int or boolean.R R R! R" uA 'name: %s' param being overridden by explicitly provided '%s: %s'u _u create_u describe_u su No function '{0}()' found: {1}u %s %s created.u: Waiting up to %s seconds for %s %s to be become available.i R1 R5 u %s %s created and available.i< u2 Sleeping %s seconds for %s %s to become available.u% %s %s not available after %s seconds!u Failed to create {0} {1}: {2}( R; R< R R' R# R/ R= R) R* R+ R$ R> R% R& R( R? R@ R RB RC RD RE R, R- R. ( R1 R2 RF R3 RG RH t status_goodR R R! R" R R5 R8 R9 R R6 RJ R7 RK R RC t msg( ( sB /usr/lib/python2.7/site-packages/salt/modules/boto3_elasticache.pyt _create_resource� s\
!
@
c K@ s� y t | � } Wn& t k
r8 t d j | � � � n Xt d | d | d | d |
� } | | k r� t j d | | | | � | | } n
| | | <t g | j � D]' \ }
} |
j d � s� |
| f ^ q� � } yA d | } t
| | � } | rd | d
} t � | } n Wn4 t t
f k
rN} t d j | | j � � � n Xy| | � | st j d | j � | � t St j d
| | | � | } x� | d k rG| d | d | � } | r�| d j | � | k r�t j d | j � | � t S| d | k r| n d } t j d | | | � t j | � | | 8} q�Wt j d | j � | | � t SWn< t j j k
r�} d j | | | � } t j | � t SXd S( NuF Bad value ('{0}') passed for 'wait' param - must be an int or boolean.R R R! R" uA 'name: %s' param being overridden by explicitly provided '%s: %s'u _u modify_u describe_u su No function '{0}()' found: {1}u %s %s modification requested.u: Waiting up to %s seconds for %s %s to be become available.i R1 R5 u %s %s modified and available.i< u2 Sleeping %s seconds for %s %s to become available.u% %s %s not available after %s seconds!u Failed to modify {0} {1}: {2}( R; R< R R' R# R/ R= R) R* R+ R$ R> R% R& R( R? R@ R RB RC RD RE R, R- R. ( R1 R2 RF R3 RG RH RM R R R! R" R R5 R8 R9 R R6 RJ R7 RK R RC RN ( ( sB /usr/lib/python2.7/site-packages/salt/modules/boto3_elasticache.pyt _modify_resource� s\
!
@
c K@ s@ t d | d d d d d d d | d | d
| d | d | | � S(
u
Return details about all (or just one) Elasticache cache clusters.
Example:
.. code-block:: bash
salt myminion boto3_elasticache.describe_cache_clusters
salt myminion boto3_elasticache.describe_cache_clusters myelasticache
R1 R2 u CacheClusterIdR3 u
cache_clusterR4 u
CacheClustersR5 R R R! R" ( R: ( R1 R5 R R R! R" R ( ( sB /usr/lib/python2.7/site-packages/salt/modules/boto3_elasticache.pyt describe_cache_clusters s c C@ s1 t t d | d | d | d | d | d | � � S( u�
Check to see if a cache cluster exists.
Example:
.. code-block:: bash
salt myminion boto3_elasticache.cache_cluster_exists myelasticache
R1 R5 R R R! R" ( t boolRQ ( R1 R5 R R R! R" ( ( sB /usr/lib/python2.7/site-packages/salt/modules/boto3_elasticache.pyt cache_cluster_exists+ s
iX c K@ s� | rx t | t � s! | g } n t d d | d | d | d | d | � } d | k re g | d <n | d c | 7<n t g | j � D]' \ } }
| j d � s� | |
f ^ q� � } t | d d
d d d
d d | d d d | d | d | d | | � S( uO
Create a cache cluster.
Example:
.. code-block:: bash
salt myminion boto3_elasticache.create_cache_cluster name=myCacheCluster Engine=redis CacheNodeType=cache.t2.micro NumCacheNodes=1 SecurityGroupIds='[sg-11223344]' CacheSubnetGroupName=myCacheSubnetGroup
u" boto_secgroup.convert_to_group_idst groupsR R R! R" u SecurityGroupIdsu _R2 u CacheClusterIdRF u
cache clusterR3 u
cache_clusterRG RH u CacheClusterStatus( t
isinstancet listt __salt__R) R* R+ RO ( R1 RG t security_groupsR R R! R" R t sgsR8 R9 ( ( sB /usr/lib/python2.7/site-packages/salt/modules/boto3_elasticache.pyt create_cache_cluster8 s
@c K@ s� | rx t | t � s! | g } n t d d | d | d | d | d | � } d | k re g | d <n | d c | 7<n t g | j � D]' \ } }
| j d � s� | |
f ^ q� � } t | d d
d d d
d d | d d d | d | d | d | | � S( u�
Update a cache cluster in place.
Notes: {ApplyImmediately: False} is pretty danged silly in the context of salt.
You can pass it, but for fairly obvious reasons the results over multiple
runs will be undefined and probably contrary to your desired state.
Reducing the number of nodes requires an EXPLICIT CacheNodeIdsToRemove be
passed, which until a reasonable heuristic for programmatically deciding
which nodes to remove has been established, MUST be decided and populated
intentionally before a state call, and removed again before the next. In
practice this is not particularly useful and should probably be avoided.
Example:
.. code-block:: bash
salt myminion boto3_elasticache.create_cache_cluster name=myCacheCluster NotificationTopicStatus=inactive
u" boto_secgroup.convert_to_group_idsRT R R R! R" u SecurityGroupIdsu _R2 u CacheClusterIdRF u
cache clusterR3 u
cache_clusterRG RH u CacheClusterStatus( RU RV RW R) R* R+ RP ( R1 RG RX R R R! R" R RY R8 R9 ( ( sB /usr/lib/python2.7/site-packages/salt/modules/boto3_elasticache.pyt modify_cache_clusterV s
@c K@ sC t | d d d d d d d | d d d
| d | d | d
| | � S( u�
Delete a cache cluster.
Example:
.. code-block:: bash
salt myminion boto3_elasticache.delete myelasticache
R2 u CacheClusterIdRF u
cache clusterR3 u
cache_clusterRG RH u CacheClusterStatusR R R! R" ( RL ( R1 RG R R R! R" R ( ( sB /usr/lib/python2.7/site-packages/salt/modules/boto3_elasticache.pyt delete_cache_clustery s
c C@ s= t d | d d d d d d d | d | d
| d | d | � S(
u
Return details about all (or just one) Elasticache replication groups.
Example:
.. code-block:: bash
salt myminion boto3_elasticache.describe_replication_groups
salt myminion boto3_elasticache.describe_replication_groups myelasticache
R1 R2 u ReplicationGroupIdR3 u replication_groupR4 u ReplicationGroupsR5 R R R! R" ( R: ( R1 R5 R R R! R" ( ( sB /usr/lib/python2.7/site-packages/salt/modules/boto3_elasticache.pyt describe_replication_groups� s c C@ s+ t t d | d | d | d | d | � � S( u�
Check to see if a replication group exists.
Example:
.. code-block:: bash
salt myminion boto3_elasticache.replication_group_exists myelasticache
R1 R R R! R" ( RR R] ( R1 R R R! R" ( ( sB /usr/lib/python2.7/site-packages/salt/modules/boto3_elasticache.pyt replication_group_exists� s
!c K@ s� | rx t | t � s! | g } n t d d | d | d | d | d | � } d | k re g | d <n | d c | 7<n t g | j � D]' \ } }
| j d � s� | |
f ^ q� � } t | d d
d d d
d d | d d d | d | d | d | | � S( u�
Create a replication group.
Params are extensive and variable - see
http://boto3.readthedocs.io/en/latest/reference/services/elasticache.html?#ElastiCache.Client.create_replication_group
for in-depth usage documentation.
Example:
.. code-block:: bash
salt myminion boto3_elasticache.create_replication_group name=myelasticache ReplicationGroupDescription=description
u" boto_secgroup.convert_to_group_idsRT R R R! R" u SecurityGroupIdsu _R2 u ReplicationGroupIdRF u replication groupR3 u replication_groupRG RH u Status( RU RV RW R) R* R+ RO ( R1 RG RX R R R! R" R RY R8 R9 ( ( sB /usr/lib/python2.7/site-packages/salt/modules/boto3_elasticache.pyt create_replication_group� s
@c K@ s� | rx t | t � s! | g } n t d d | d | d | d | d | � } d | k re g | d <n | d c | 7<n t g | j � D]' \ } }
| j d � s� | |
f ^ q� � } t | d d
d d d
d d | d d d | d | d | d | | � S( u1
Modify a replication group.
Example:
.. code-block:: bash
salt myminion boto3_elasticache.modify_replication_group name=myelasticache ReplicationGroupDescription=newDescription
u" boto_secgroup.convert_to_group_idsRT R R R! R" u SecurityGroupIdsu _R2 u ReplicationGroupIdRF u replication groupR3 u replication_groupRG RH u Status( RU RV RW R) R* R+ RP ( R1 RG RX R R R! R" R RY R8 R9 ( ( sB /usr/lib/python2.7/site-packages/salt/modules/boto3_elasticache.pyt modify_replication_group� s
@c K@ sC t | d d d d d d d | d d d
| d | d | d
| | � S( u�
Delete an ElastiCache replication group, optionally taking a snapshot first.
Example:
.. code-block:: bash
salt myminion boto3_elasticache.delete_replication_group my-replication-group
R2 u ReplicationGroupIdRF u replication groupR3 u replication_groupRG RH u StatusR R R! R" ( RL ( R1 RG R R R! R" R ( ( sB /usr/lib/python2.7/site-packages/salt/modules/boto3_elasticache.pyt delete_replication_group� s
c C@ s= t d | d d d d d d d | d | d
| d | d | � S(
u�
Return details about all (or just one) Elasticache replication groups.
Example:
.. code-block:: bash
salt myminion boto3_elasticache.describe_cache_subnet_groups region=us-east-1
R1 R2 u CacheSubnetGroupNameR3 u cache_subnet_groupR4 u CacheSubnetGroupsR5 R R R! R" ( R: ( R1 R5 R R R! R" ( ( sB /usr/lib/python2.7/site-packages/salt/modules/boto3_elasticache.pyt describe_cache_subnet_groups� s
c C@ s+ t t d | d | d | d | d | � � S( u�
Check to see if an ElastiCache subnet group exists.
Example:
.. code-block:: bash
salt myminion boto3_elasticache.cache_subnet_group_exists my-subnet-group
R1 R R R! R" ( RR Rb ( R1 R R R! R" ( ( sB /usr/lib/python2.7/site-packages/salt/modules/boto3_elasticache.pyt cache_subnet_group_exists� s
c C@ s- g t d | | | | � D] } | d ^ q S( u�
Return a list of all cache subnet group names
Example:
.. code-block:: bash
salt myminion boto3_elasticache.list_cache_subnet_groups region=us-east-1
u CacheSubnetGroupNameN( Rb R ( R R R! R" t g( ( sB /usr/lib/python2.7/site-packages/salt/modules/boto3_elasticache.pyt list_cache_subnet_groups s
c K@ s� | r"d | k r g | d <n t | t � s: | g } n x� | D]� } | j d � ro | d c | g 7<qA n t d d | d | d | d | d | � j d � } | s� t d
j | � � � n t | � d k r� | d c | d d
g 7<qA t | � d k rA t d j | � � � qA qA Wn t g | j
� D]' \ } }
| j d � s2| |
f ^ q2� } t | d d d d d d d | d | d | d | | �S( uX
Create an ElastiCache subnet group
Example:
.. code-block:: bash
salt myminion boto3_elasticache.create_cache_subnet_group name=my-subnet-group CacheSubnetGroupDescription="description" subnets='[myVPCSubnet1,myVPCSubnet2]'
u SubnetIdsu subnet-u boto_vpc.describe_subnetst subnet_namesR R R! R" u subnetsu+ Could not resolve Subnet Name {0} to an ID.i i u idu* Subnet Name {0} returned more than one ID.u _R2 u CacheSubnetGroupNameRF u cache subnet groupR3 u cache_subnet_group( RU RV R+ RW R R R' RA R R) R* RO ( R1 t subnetsR R R! R" R t subnett snR8 R9 ( ( sB /usr/lib/python2.7/site-packages/salt/modules/boto3_elasticache.pyt create_cache_subnet_group s.
@c K@ s� | rd | k r g | d <n t | t � s: | g } n x� | D]� } t d d | d | d | d | d | � j d � } t | � d k r� | d c | d
d g 7<qA t | � d k r� t d j | � � � qA | j d
� r� | d c | g 7<qA t d j | � � � qA Wn t g | j
� D]' \ } }
| j d � s&| |
f ^ q&� } t | d d d d d d d | d | d | d | | �S( u!
Modify an ElastiCache subnet group
Example:
.. code-block:: bash
salt myminion boto3_elasticache.modify_cache_subnet_group name=my-subnet-group subnets='[myVPCSubnet3]'
u SubnetIdsu boto_vpc.describe_subnetsRf R R R! R" u subnetsi i u idu* Subnet Name {0} returned more than one ID.u subnet-u+ Could not resolve Subnet Name {0} to an ID.u _R2 u CacheSubnetGroupNameRF u cache subnet groupR3 u cache_subnet_group( RU RV RW R RA R R' R+ R R) R* RP ( R1 Rg R R R! R" R Rh Ri R8 R9 ( ( sB /usr/lib/python2.7/site-packages/salt/modules/boto3_elasticache.pyt modify_cache_subnet_group? s,
@c K@ s7 t | d d d d d d d | d | d | d
| | �S( u�
Delete an ElastiCache subnet group.
Example:
.. code-block:: bash
salt myminion boto3_elasticache.delete_subnet_group my-subnet-group region=us-east-1
R2 u CacheSubnetGroupNameRF u cache subnet groupR3 u cache_subnet_groupR R R! R" ( RL ( R1 R R R! R" R ( ( sB /usr/lib/python2.7/site-packages/salt/modules/boto3_elasticache.pyt delete_cache_subnet_groupe s
c C@ s= t d | d d d d d d d | d | d
| d | d | � S(
u
Return details about all (or just one) Elasticache cache clusters.
Example:
.. code-block:: bash
salt myminion boto3_elasticache.describe_cache_security_groups
salt myminion boto3_elasticache.describe_cache_security_groups mycachesecgrp
R1 R2 u CacheSecurityGroupNameR3 u cache_security_groupR4 u CacheSecurityGroupsR5 R R R! R" ( R: ( R1 R5 R R R! R" ( ( sB /usr/lib/python2.7/site-packages/salt/modules/boto3_elasticache.pyt describe_cache_security_groupst s c C@ s+ t t d | d | d | d | d | � � S( u�
Check to see if an ElastiCache security group exists.
Example:
.. code-block:: bash
salt myminion boto3_elasticache.cache_security_group_exists mysecuritygroup
R1 R R R! R" ( RR Rm ( R1 R R R! R" ( ( sB /usr/lib/python2.7/site-packages/salt/modules/boto3_elasticache.pyt cache_security_group_exists� s
c K@ s7 t | d d d d d d d | d | d | d
| | �S( u�
Create a cache security group.
Example:
.. code-block:: bash
salt myminion boto3_elasticache.create_cache_security_group mycachesecgrp Description='My Cache Security Group'
R2 u CacheSecurityGroupNameRF u cache security groupR3 u cache_security_groupR R R! R" ( RO ( R1 R R R! R" R ( ( sB /usr/lib/python2.7/site-packages/salt/modules/boto3_elasticache.pyt create_cache_security_group� s
c K@ s7 t | d d d d d d d | d | d | d
| | �S( u�
Delete a cache security group.
Example:
.. code-block:: bash
salt myminion boto3_elasticache.delete_cache_security_group myelasticachesg
R2 u CacheSecurityGroupNameRF u cache security groupR3 u cache_security_groupR R R! R" ( RL ( R1 R R R! R" R ( ( sB /usr/lib/python2.7/site-packages/salt/modules/boto3_elasticache.pyt delete_cache_security_group� s
c
K@ s� t d | d | d | d | � } d | k rQ t j d | | d � | d } n
| | d <t g | j � D]' \ } } | j d � sk | | f ^ qk � } y, | j | � t j d | d
| � t SWn- t j j
k
r� } t j d | | � t SXd S(
u�
Authorize network ingress from an ec2 security group to a cache security group.
Example:
.. code-block:: bash
salt myminion boto3_elasticache.authorize_cache_security_group_ingress mycachesecgrp EC2SecurityGroupName=someEC2sg EC2SecurityGroupOwnerId=SOMEOWNERID
R R R! R" u CacheSecurityGroupNameuU 'name: %s' param being overridden by explicitly provided 'CacheSecurityGroupName: %s'u CacheSubnetGroupNameu _u) Authorized %s to cache security group %s.u EC2SecurityGroupNameu& Failed to update security group %s: %sN(
R# R/ R= R) R* R+ t& authorize_cache_security_group_ingressR@ R, R- R. RD RE (
R1 R R R! R" R R5 R8 R9 R7 ( ( sB /usr/lib/python2.7/site-packages/salt/modules/boto3_elasticache.pyRq � s
!
@
c
K@ s� t d | d | d | d | � } d | k rQ t j d | | d � | d } n
| | d <t g | j � D]' \ } } | j d � sk | | f ^ qk � } y, | j | � t j d | d
| � t SWn- t j j
k
r� } t j d | | � t SXd S(
u�
Revoke network ingress from an ec2 security group to a cache security
group.
Example:
.. code-block:: bash
salt myminion boto3_elasticache.revoke_cache_security_group_ingress mycachesecgrp EC2SecurityGroupName=someEC2sg EC2SecurityGroupOwnerId=SOMEOWNERID
R R R! R" u CacheSecurityGroupNameuU 'name: %s' param being overridden by explicitly provided 'CacheSecurityGroupName: %s'u CacheSubnetGroupNameu _u( Revoked %s from cache security group %s.u EC2SecurityGroupNameu& Failed to update security group %s: %sN(
R# R/ R= R) R* R+ t# revoke_cache_security_group_ingressR@ R, R- R. RD RE (
R1 R R R! R" R R5 R8 R9 R7 ( ( sB /usr/lib/python2.7/site-packages/salt/modules/boto3_elasticache.pyRr � s !
@
c K@ s t d | d | d | d | � } d | k rQ t j d | | d � | d } n
| | d <t g | j � D]' \ } } | j d � sk | | f ^ qk � } y1 | j | � } | r� d | k r� | d Sg SWn- t j j k
r� }
t j
d
| |
� g SXd S( u�
List tags on an Elasticache resource.
Note that this function is essentially useless as it requires a full AWS ARN for the
resource being operated on, but there is no provided API or programmatic way to find
the ARN for a given object from its name or ID alone. It requires specific knowledge
about the account number, AWS partition, and other magic details to generate.
If you happen to have those handy, feel free to utilize this however...
Example:
.. code-block:: bash
salt myminion boto3_elasticache.list_tags_for_resource name'=arn:aws:elasticache:us-west-2:0123456789:snapshot:mySnapshot'
R R R! R" u ResourceNameuK 'name: %s' param being overridden by explicitly provided 'ResourceName: %s'u _u Taglistu TagListu' Failed to list tags for resource %s: %sN( R# R/ R= R) R* R+ t list_tags_for_resourceR, R- R. RD ( R1 R R R! R" R R5 R8 R9 R R7 ( ( sB /usr/lib/python2.7/site-packages/salt/modules/boto3_elasticache.pyRs � s !
@c
K@ s� t d | d | d | d | � } d | k rQ t j d | | d � | d } n
| | d <t g | j � D]' \ } } | j d � sk | | f ^ qk � } y, | j | � t j d | d | � t SWn- t j j
k
r� } t j d
| | � t SXd S( u�
Add tags to an Elasticache resource.
Note that this function is essentially useless as it requires a full AWS ARN for the
resource being operated on, but there is no provided API or programmatic way to find
the ARN for a given object from its name or ID alone. It requires specific knowledge
about the account number, AWS partition, and other magic details to generate.
If you happen to have those at hand though, feel free to utilize this function...
Example:
.. code-block:: bash
salt myminion boto3_elasticache.add_tags_to_resource name'=arn:aws:elasticache:us-west-2:0123456789:snapshot:mySnapshot' Tags="[{'Key': 'TeamOwner', 'Value': 'infrastructure'}]"
R R R! R" u ResourceNameuK 'name: %s' param being overridden by explicitly provided 'ResourceName: %s'u _u Added tags %s to %s.u Tagsu Failed to add tags to %s: %sN(
R# R/ R= R) R* R+ t add_tags_to_resourceR@ R, R- R. RD RE (
R1 R R R! R" R R5 R8 R9 R7 ( ( sB /usr/lib/python2.7/site-packages/salt/modules/boto3_elasticache.pyRt s !
@
c
K@ s� t d | d | d | d | � } d | k rQ t j d | | d � | d } n
| | d <t g | j � D]' \ } } | j d � sk | | f ^ qk � } y, | j | � t j d | d | � t SWn- t j j
k
r� } t j d
| | � t SXd S( u�
Remove tags from an Elasticache resource.
Note that this function is essentially useless as it requires a full AWS ARN for the
resource being operated on, but there is no provided API or programmatic way to find
the ARN for a given object from its name or ID alone. It requires specific knowledge
about the account number, AWS partition, and other magic details to generate.
If you happen to have those at hand though, feel free to utilize this function...
Example:
.. code-block:: bash
salt myminion boto3_elasticache.remove_tags_from_resource name'=arn:aws:elasticache:us-west-2:0123456789:snapshot:mySnapshot' TagKeys="['TeamOwner']"
R R R! R" u ResourceNameuK 'name: %s' param being overridden by explicitly provided 'ResourceName: %s'u _u Added tags %s to %s.u Tagsu Failed to add tags to %s: %sN(
R# R/ R= R) R* R+ t remove_tags_from_resourceR@ R, R- R. RD RE (
R1 R R R! R" R R5 R8 R9 R7 ( ( sB /usr/lib/python2.7/site-packages/salt/modules/boto3_elasticache.pyRu A s !
@
c
K@ s� t d | d | d | d | � } d | k rQ t j d | | d � | d } n
| | d <t g | j � D]' \ } } | j d � sk | | f ^ qk � } y, | j | � t j d | | d � t SWn- t j j
k
r� } t j d
| | � t SXd S( u�
Make a copy of an existing snapshot.
Example:
.. code-block:: bash
salt myminion boto3_elasticache.copy_snapshot name=mySnapshot TargetSnapshotName=copyOfMySnapshot
R R R! R" u SourceSnapshotNameuQ 'name: %s' param being overridden by explicitly provided 'SourceSnapshotName: %s'u _u Snapshot %s copied to %s.u TargetSnapshotNameu Failed to copy snapshot %s: %sN(
R# R/ R= R) R* R+ t
copy_snapshotR@ R, R- R. RD RE (
R1 R R R! R" R R5 R8 R9 R7 ( ( sB /usr/lib/python2.7/site-packages/salt/modules/boto3_elasticache.pyRv g s !
@
c C@ s= t d | d d d d d d d | d | d
| d | d | � S(
u
Return details about all (or just one) Elasticache cache clusters.
Example:
.. code-block:: bash
salt myminion boto3_elasticache.describe_cache_parameter_groups
salt myminion boto3_elasticache.describe_cache_parameter_groups myParameterGroup
R1 R2 u CacheParameterGroupNameR3 u cache_parameter_groupR4 u CacheParameterGroupsR5 R R R! R" ( R: ( R1 R5 R R R! R" ( ( sB /usr/lib/python2.7/site-packages/salt/modules/boto3_elasticache.pyt describe_cache_parameter_groups� s c K@ s7 t | d d d d d d d | d | d | d
| | �S( u
Create a cache parameter group.
Example:
.. code-block:: bash
salt myminion boto3_elasticache.create_cache_parameter_group name=myParamGroup CacheParameterGroupFamily=redis2.8 Description="My Parameter Group"
R2 u CacheParameterGroupNameRF u cache parameter groupR3 u cache_parameter_groupR R R! R" ( RO ( R1 R R R! R" R ( ( sB /usr/lib/python2.7/site-packages/salt/modules/boto3_elasticache.pyt create_cache_parameter_group� s
c K@ s7 t | d d d d d d d | d | d | d
| | �S( u�
Delete a cache parameter group.
Example:
.. code-block:: bash
salt myminion boto3_elasticache.delete_cache_parameter_group myParamGroup
R2 u CacheParameterGroupNameRF u cache parameter groupR3 u cache_parameter_groupR R R! R" ( RL ( R1 R R R! R" R ( ( sB /usr/lib/python2.7/site-packages/salt/modules/boto3_elasticache.pyt delete_cache_parameter_group� s
(= t __doc__t
__future__R R R t loggingRB t salt.exceptionsR R t salt.utils.compatR t salt.utils.versionst getLoggerR R/ R, t boto3t setLevelt CRITICALR@ R t ImportErrorRE R R R R R: RL RO RP RQ RS RZ R[ R\ R] R^ R_ R` Ra Rb Rc Re Rj Rk Rl Rm Rn Ro Rp Rq Rr Rs Rt Ru Rv Rw Rx Ry ( ( ( sB /usr/lib/python2.7/site-packages/salt/modules/boto3_elasticache.pyt <module>, sx
644
"
&&
"#&&&
Mini Shell