Current File : //lib/python2.7/site-packages/salt/modules/boto_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 d d l m
Z
d d l j j
Z
d d l Z e j e � Z yG d d l Z 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 d d d d � Z 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 � Z" 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 d � Z( d 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 d d d d d d d d d d d d d d d � Z, e d d d d d � Z- d d d d d � Z. d d d d d � Z/ d d d d d � Z0 d d d d d � Z1 d S( u
Connection module for Amazon Elasticache
.. versionadded:: 2014.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: boto
i ( t absolute_importt print_functiont unicode_literalsN( t six( t SaltInvocationErroru botoc C@ sB t j j j d t � } | t k r> t d t d d t �n | S( u,
Only load if boto libraries exist.
t check_boto3u boto.assign_funcsu elasticachet pack( t saltt utilst versionst check_boto_reqst Falset Truet __utils__t __name__t __salt__( t
has_boto_reqs( ( sA /usr/lib/python2.7/site-packages/salt/modules/boto_elasticache.pyt __virtual__J s
c C@ sd t d | d | d | d | � } y | j | � t SWn' t j j k
r_ } t j | � t SXd S( u�
Check to see if a cache cluster exists.
CLI example::
salt myminion boto_elasticache.exists myelasticache
t regiont keyt keyidt profileN( t _get_connt describe_cache_clustersR t botot exceptiont BotoServerErrort logt debugR ( t nameR R R R t connt e( ( sA /usr/lib/python2.7/site-packages/salt/modules/boto_elasticache.pyt existsW s !
c C@ sd t d | d | d | d | � } y | j | � t SWn' t j j k
r_ } t j | � t SXd S( u�
Check to see if a replication group exists.
CLI example::
salt myminion boto_elasticache.group_exists myelasticache
R R R R N( R t describe_replication_groupsR R R R R R R ( R R R R R R R ( ( sA /usr/lib/python2.7/site-packages/salt/modules/boto_elasticache.pyt group_existsi s !
c
C@ s� t d | d | d | d | � } | s+ d
Sy� | j | | | � } | s] t j d | � t SxM t r� t j d � t | | | | | � }
|
s� t S|
d d k r` t Sq` WWnC t j
j k
r� } d j | � } t j
| � t j | � i SXd
S( u�
Create replication group.
CLI example::
salt myminion boto_elasticache.create_replication_group myelasticache myprimarycluster description
R R R R u Created cache cluster %s.i u statusu availableu' Failed to create replication group {0}.N( R t Nonet create_replication_groupR t infoR t timet sleept describe_replication_groupR R R t formatt errorR (
R t primary_cluster_idt replication_group_descriptiont waitR R R R R t cct configR t msg( ( sA /usr/lib/python2.7/site-packages/salt/modules/boto_elasticache.pyR$ { s*
!
c C@ s� t d | d | d | d | � } | s+ t Sy1 | j | � d j | � } t j | � t SWnC t j j k
r� } t j
| � d j | � } t j | � t SXd S( u�
Delete an ElastiCache replication group.
CLI example::
salt myminion boto_elasticache.delete_replication_group my-replication-group region=us-east-1
R R R R u* Deleted ElastiCache replication group {0}.u2 Failed to delete ElastiCache replication group {0}N( R R t delete_replication_groupR) R R% R R R R R R* ( R R R R R R R0 R ( ( sA /usr/lib/python2.7/site-packages/salt/modules/boto_elasticache.pyR1 � s !
c C@ s t d | d | d | d | � } | s+ d Sy | j | � } WnC t j j k
r� } d j | � } t j | � t j | � i SXt
j � }
| d d } | d d } d
d d d
d d d d g } x7t j
| � D]&\ } } t j j | � }
|
d
k r$| r| |
|
<q$d |
|
<n |
d k rP| rC| |
|
<qPd |
|
<n |
d k r|| ro| |
|
<q|d |
|
<n |
d
k r�| r�| |
|
<q�d |
|
<n |
d k r�| r�| |
|
<q�d |
|
<n |
d k r� | r�| |
|
<q d |
|
<q� q� W|
S( u�
Get replication group information.
CLI example::
salt myminion boto_elasticache.describe_replication_group mygroup
R R R R u+ Failed to get config for cache cluster {0}.u! DescribeReplicationGroupsResponseu DescribeReplicationGroupsResultu ReplicationGroupsi u statusu descriptionu primary_endpointu member_clustersu replication_group_idu pending_modified_valuesu primary_cluster_idu node_groupsN( R R# R! R R R R) R R* R t odictt OrderedDictR t iteritemsR t pythonize_name( R R R R R t parameterR R. R R0 t rett attrst valt _key( ( sA /usr/lib/python2.7/site-packages/salt/modules/boto_elasticache.pyR( � sX !
c C@ sg t d | d | d | d | � } | s+ d$ Sy | j | d t �} WnC t j j k
r� } d j | � } t j | � t j
| � i SX| d d } | d d
} t j � } d d d
d d d d d d d d d d d d d d g }
xut
j | � D]d\ } } t j j | � } | |
k r+q� n | d k r[| rN| d | | <q_d$ | | <q� | d k r�| r�g | D] }
|
^ qt| | <q_g | | <q� | d k r�| r�g | D] }
|
d ^ q�| | <q_g | | <q� | d k r%| r| d | d <| d | d! <q_d$ | d <d$ | d! <q� | d k rU| rH| d" | d# <q_d$ | d# <q� | | | <q� W| S(% u�
Get the configuration for a cache cluster.
CLI example::
salt myminion boto_elasticache.get_config myelasticache
R R R R t show_cache_node_infou+ Failed to get config for cache cluster {0}.u DescribeCacheClustersResponseu DescribeCacheClustersResultu
CacheClustersi u engineu cache_parameter_groupu cache_cluster_idu cache_security_groupsu replication_group_idu auto_minor_version_upgradeu num_cache_nodesu preferred_availability_zoneu security_groupsu cache_subnet_group_nameu engine_versionu cache_node_typeu notification_configurationu preferred_maintenance_windowu configuration_endpointu cache_cluster_statusu cache_nodesu CacheParameterGroupNameu CacheSecurityGroupNameu Portu portu Addressu addressu TopicArnu notification_topic_arnN( R R# R R R R R R) R R* R R2 R3 R R4 R R5 ( R R R R R R R. R R0 R7 R8 R9 R: t k( ( sA /usr/lib/python2.7/site-packages/salt/modules/boto_elasticache.pyt
get_config� sb !
$
c
C@ s� t d | d | d | d | � } | s+ d Sy | j | d t �} WnC t j j k
r� } d j | � } t j | � t j
| � i SX| d d } | d d
d d
d d
} | S( u}
Get hostname from cache node
CLI example::
salt myminion boto_elasticache.get_node_host myelasticache
R R R R R; u+ Failed to get config for cache cluster {0}.u DescribeCacheClustersResponseu DescribeCacheClustersResultu
CacheClustersi u
CacheNodesu Endpointu AddressN( R R# R R R R R R) R R* R (
R R R R R R R. R R0 t host( ( sA /usr/lib/python2.7/site-packages/salt/modules/boto_elasticache.pyt
get_node_host6 s !
c
C@ s� t d | d | d | d | � } | s+ d
Sy | j | � } WnC t j j k
r� } d j | � } t j | � t j | � i SX| d d } | d d d
d d } | d } | S( u�
Get hostname from replication cache group
CLI example::
salt myminion boto_elasticache.get_group_host myelasticachegroup
R R R R u+ Failed to get config for cache cluster {0}.u! DescribeReplicationGroupsResponseu DescribeReplicationGroupsResultu ReplicationGroupsi u
NodeGroupsu PrimaryEndpointu AddressN(
R R# R! R R R R) R R* R (
R R R R R R R. R R0 R> ( ( sA /usr/lib/python2.7/site-packages/salt/modules/boto_elasticache.pyt get_group_hostP s !
c C@ s� t d | d | d | d | � } y� d } g } xn | d
k r� | j d | d | � } | j d i � j d i � } | | j d
g � 7} | j d d
� } q3 W| s� t j d � n | SWn' t j j k
r� }
t j |
� g SXd
S( u�
Return a list of all cache subnet groups with details
CLI example::
salt myminion boto_elasticache.get_all_subnet_groups region=us-east-1
R R R R u t cache_subnet_group_namet markeru! DescribeCacheSubnetGroupsResponseu DescribeCacheSubnetGroupsResultu CacheSubnetGroupsu Markeru# No ElastiCache subnet groups found.N(
R R# t describe_cache_subnet_groupst getR R R R R R* ( R R R R R R RB t groupsR7 t trimmedR ( ( sA /usr/lib/python2.7/site-packages/salt/modules/boto_elasticache.pyt get_all_cache_subnet_groupsj s" !
c C@ s- g t | | | | | � D] } | d ^ q S( u�
Return a list of all cache subnet group names
CLI example::
salt myminion boto_elasticache.list_subnet_groups region=us-east-1
u CacheSubnetGroupName( RG ( R R R R R t g( ( sA /usr/lib/python2.7/site-packages/salt/modules/boto_elasticache.pyt list_cache_subnet_groups� s c
C@ s� t d | d | d | d | � } | s+ t Sy@ | j d | � } | sf d j | � } t j | � t St SWn' t j j k
r� } t j | � t SXd S( u�
Check to see if an ElastiCache subnet group exists.
CLI example::
salt myminion boto_elasticache.subnet_group_exists my-param-group region=us-east-1
R R R R RA u5 ElastiCache subnet group does not exist in region {0}N(
R R RC R) R R R R R R (
R t tagsR R R R R t ecR0 R ( ( sA /usr/lib/python2.7/site-packages/salt/modules/boto_elasticache.pyt subnet_group_exists� s !
c C@ s� t | | f � s! t d � � n t d | d | d | d | � } | sL t St | | | | | | � rk t S| r� g } xm | D]b }
t d d |
d | d | d | d | �} d | k r� t j d t � t S| | d g 7} q~ Wn yS | j
| | | � } | s%d
j | � }
t j |
� t St j d | � t SWnC t
j j k
r} t j | � d
j | � }
t j |
� t SXd S(
u
Create an ElastiCache subnet group
CLI example to create an ElastiCache subnet group::
salt myminion boto_elasticache.create_subnet_group my-subnet-group "group description" subnet_ids='[subnet-12345678, subnet-87654321]' region=us-east-1
uF Exactly one of either 'subnet_ids' or 'subnet_names' must be provided.R R R R u boto_vpc.get_resource_idu subnetu idu) Couldn't resolve subnet name %s to an ID.u- Failed to create ElastiCache subnet group {0}u# Created ElastiCache subnet group %sN( t _exactly_oneR R R RL R R R R* t subnet_namet create_cache_subnet_groupR) R% R R R R ( R t descriptiont
subnet_idst subnet_namesRJ R R R R R t nt rRK R0 R ( ( sA /usr/lib/python2.7/site-packages/salt/modules/boto_elasticache.pyt create_subnet_group� s< !
c C@ s� t d | d | d | d | � } y/ | j | � } | d } | d d d } Wny t j j k
r� } d j | � } t j | � t j | � t St
t t f k
r� d
j | � } t j | � t SXi } x� t
j | � D]� \ } }
| d k r|
| d <q� | d
k r |
| d <q� | d k r9|
| d <q� | d k r�g | d <xX |
D]C } i } | d | d <| d d }
|
| d <| d j | � qVWq� |
| | <q� W| S( u�
Get information about a cache subnet group.
CLI example::
salt myminion boto_elasticache.get_cache_subnet_group mycache_subnet_group
R R R R u! DescribeCacheSubnetGroupsResponseu DescribeCacheSubnetGroupsResultu CacheSubnetGroupsi u% Failed to get cache subnet group {0}.u) Failed to get cache subnet group {0} (2).u CacheSubnetGroupNameu cache_subnet_group_nameu CacheSubnetGroupDescriptionu cache_subnet_group_descriptionu VpcIdu vpc_idu Subnetsu subnetsu SubnetIdentifieru subnet_idu SubnetAvailabilityZoneu Nameu subnet_availability_zone( R RC R R R R) R R* R R t
IndexErrort TypeErrort KeyErrorR R4 t append( R R R R R R t csgR R0 R7 R9 t subnett _subnett _az( ( sA /usr/lib/python2.7/site-packages/salt/modules/boto_elasticache.pyt get_cache_subnet_group� s@ !
c C@ s� t d | d | d | d | � } | s+ t Sy1 | j | � d j | � } t j | � t SWnC t j j k
r� } t j
| � d j | � } t j | � t SXd S( u�
Delete an ElastiCache subnet group.
CLI example::
salt myminion boto_elasticache.delete_subnet_group my-subnet-group region=us-east-1
R R R R u% Deleted ElastiCache subnet group {0}.u- Failed to delete ElastiCache subnet group {0}N( R R t delete_cache_subnet_groupR) R R% R R R R R R* ( R R R R R R R0 R ( ( sA /usr/lib/python2.7/site-packages/salt/modules/boto_elasticache.pyt delete_subnet_group s !
c C@ s# t d | d | d | d | � } y� | j | | | | | | | | | | |
| | |
| | � | sx t j d | � t SxM t r� t j d � t | | | | | � } | s� t S| d d k r{ t Sq{ Wt j d | � WnC t j j
k
r } d j | � } t j | � t j
| � t SXd
S( u�
Create a cache cluster.
CLI example::
salt myminion boto_elasticache.create myelasticache 1 redis cache.t1.micro
cache_security_group_names='["myelasticachesg"]'
R R R R u Created cache cluster %s.i u cache_cluster_statusu availableu# Failed to create cache cluster {0}.N( R t create_cache_clusterR R% R R& R' R= R R R R) R* R R ( R t num_cache_nodest enginet cache_node_typet replication_group_idt engine_versiont cache_parameter_group_nameRA t cache_security_group_namest security_group_idst
snapshot_arnst preferred_availability_zonet preferred_maintenance_windowt portt notification_topic_arnt auto_minor_version_upgradeR- R R R R R R/ R R0 ( ( sA /usr/lib/python2.7/site-packages/salt/modules/boto_elasticache.pyt create s2 !
c
C@ s� t d | d | d | d | � } y� | j | � | sK t j d | � t SxM t r� t | | | | | � } | sv t S| d d k r� t St j d � qN Wt j d | � t SWnC t j j
k
r� } d j | � } t j | � t j
| � t SXd
S( uq
Delete a cache cluster.
CLI example::
salt myminion boto_elasticache.delete myelasticache
R R R R u Deleted cache cluster %s.u cache_cluster_statusu deletingi u# Failed to delete cache cluster {0}.N( R t delete_cache_clusterR R% R R= R& R' R R R R) R* R R (
R R- R R R R R R/ R R0 ( ( sA /usr/lib/python2.7/site-packages/salt/modules/boto_elasticache.pyt deleteH s( !
c C@ sq t d | d | d | d | � } | j | | � } | rM t j d | � t Sd j | � } t j | � t Sd S( u�
Create a cache security group.
CLI example::
salt myminion boto_elasticache.create_cache_security_group myelasticachesg 'My Cache Security Group'
R R R R u Created cache security group %s.u* Failed to create cache security group {0}.N( R t create_cache_security_groupR R% R R) R* R ( R RP R R R R R t createdR0 ( ( sA /usr/lib/python2.7/site-packages/salt/modules/boto_elasticache.pyRs g s !
c C@ sn t d | d | d | d | � } | j | � } | rJ t j d | � t Sd j | � } t j | � t Sd S( u�
Delete a cache security group.
CLI example::
salt myminion boto_elasticache.delete_cache_security_group myelasticachesg 'My Cache Security Group'
R R R R u Deleted cache security group %s.u* Failed to delete cache security group {0}.N( R t delete_cache_security_groupR R% R R) R* R ( R R R R R R t deletedR0 ( ( sA /usr/lib/python2.7/site-packages/salt/modules/boto_elasticache.pyRu | s !
c C@ s� t d | d | d | d | � } yq | j | | | � } | rh d } | j | | � } t j | � t Sd } | j | | � } t j | � t SWnL t j j
k
r� }
t j |
� d } | j | | � } t j | � t SXd S( u�
Authorize network ingress from an ec2 security group to a cache security
group.
CLI example::
salt myminion boto_elasticache.authorize_cache_security_group_ingress myelasticachesg myec2sg 879879
R R R R u& Added {0} to cache security group {1}.u. Failed to add {0} to cache security group {1}.N( R t& authorize_cache_security_group_ingressR) R R% R R* R R R t EC2ResponseErrorR ( R t ec2_security_group_namet ec2_security_group_owner_idR R R R R t addedR0 R ( ( sA /usr/lib/python2.7/site-packages/salt/modules/boto_elasticache.pyRw � s& !
c C@ s� t d | d | d | d | � } yq | j | | | � } | rh d } | j | | � } t j | � t Sd } | j | | � } t j | � t SWnL t j j
k
r� }
t j |
� d } | j | | � } t j | � t SXd S( u�
Revoke network ingress from an ec2 security group to a cache security
group.
CLI example::
salt myminion boto_elasticache.revoke_cache_security_group_ingress myelasticachesg myec2sg 879879
R R R R u* Removed {0} from cache security group {1}.u3 Failed to remove {0} from cache security group {1}.N( R t# revoke_cache_security_group_ingressR) R R% R R* R R R Rx R ( R Ry Rz R R R R R t removedR0 R ( ( sA /usr/lib/python2.7/site-packages/salt/modules/boto_elasticache.pyR| � s& !
(2 t __doc__t
__future__R R R t loggingR& t salt.extR t salt.exceptionsR t salt.utils.odictR R2 t salt.utils.versionsR t getLoggerR R R t boto.elasticachet
boto.utilst setLevelt CRITICALR t HAS_BOTOt ImportErrorR R R# R R" R$ R1 R( R= R? R@ RG RI RL RU R^ R` Rp Rr Rs Ru Rw R| ( ( ( sA /usr/lib/python2.7/site-packages/salt/modules/boto_elasticache.pyt <module>+ sl
>B + , % "
Mini Shell