Current File : //lib/python2.7/site-packages/salt/modules/boto_sns.pyc
�
���^c @@ s} d Z d d l m Z 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 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
� Z d d d d d � Z d d d d d � Z d d d d d
� Z d d d � Z d � Z d � Z d � Z d S( u�
Connection module for Amazon SNS
:configuration: This module accepts explicit sns 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
sns.keyid: GKTADJGHEIQSXMKKRBJ08H
sns.key: askdjghsdfjkghWupUjasdflkdfklgjsdfjajkghs
A region may also be specified in the configuration:
.. code-block:: yaml
sns.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_literalsNu 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 snst pack( t saltt utilst versionst check_boto_reqst Falset Truet __utils__t __name__t __salt__( t
has_boto_reqs( ( s9 /usr/lib/python2.7/site-packages/salt/modules/boto_sns.pyt __virtual__B s
c C@ s� t � } y t | SWn t k
r( n Xt d | d | d | d | � } i t | <| j � } xC | d d d D]/ } | d j d � d
} | d t | | <qs Wt | S( un
Returns a list of the all topics..
CLI example::
salt myminion boto_sns.get_all_topics
t regiont keyt keyidt profileu ListTopicsResponseu ListTopicsResultu Topicsu TopicArnu :i����( t _cache_get_keyt __context__t KeyErrort _get_connt get_all_topicst split( R R R R t cache_keyt connt topicst tt
short_name( ( s9 /usr/lib/python2.7/site-packages/salt/modules/boto_sns.pyR N s
!
c C@ s` t d | d | d | d | � } | j d � rF | t | j � � k S| t | j � � k Sd S( u�
Check to see if an SNS topic exists.
CLI example::
salt myminion boto_sns.exists mytopic region=us-east-1
R R R R u arn:aws:sns:N( R t
startswitht listt valuest keys( t nameR R R R R ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/boto_sns.pyt existsf s
c C@ sI t d | d | d | d | � } | j | � t j d | � t � t S( u�
Create an SNS topic.
CLI example to create a topic::
salt myminion boto_sns.create mytopic region=us-east-1
R R R R u Created SNS topic %s( R t create_topict logt infot _invalidate_cacheR
( R# R R R R R ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/boto_sns.pyt createv s
!
c C@ s[ t d | d | d | d | � } | j t | | | | | � � t j d | � t � t S( u�
Delete an SNS topic.
CLI example to delete a topic::
salt myminion boto_sns.delete mytopic region=us-east-1
R R R R u Deleted SNS topic %s( R t delete_topict get_arnR& R' R( R
( R# R R R R R ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/boto_sns.pyt delete� s
! c C@ s� t | � } y t | SWn t k
r+ n Xt d | d | d | d | � } | j t | | | | | � � } | d d d t | <t | S( u�
Get list of all subscriptions to a specific topic.
CLI example to delete a topic::
salt myminion boto_sns.get_all_subscriptions_by_topic mytopic region=us-east-1
R R R R u ListSubscriptionsByTopicResponseu ListSubscriptionsByTopicResultu
Subscriptions( t _subscriptions_cache_keyR R R t get_all_subscriptions_by_topicR+ ( R# R R R R R R t ret( ( s9 /usr/lib/python2.7/site-packages/salt/modules/boto_sns.pyR. � s
!!c C@ s� t d | d | d | d | � } | j t | | | | | � | | � t j d | | | � y t t | � =Wn t k
r� n Xt S( u�
Subscribe to a Topic.
CLI example to delete a topic::
salt myminion boto_sns.subscribe mytopic https https://www.example.com/sns-endpoint region=us-east-1
R R R R u Subscribe %s %s to %s topic( R t subscribeR+ R& R' R R- R R
( t topict protocolt endpointR R R R R ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/boto_sns.pyR0 � s !%
c C@ s� t d | d | d | d | � } | j d � t k r: t Sy$ | j | � t j d | | � Wn' t k
r� } t j d d t �t SXt j
t | � d � t Sd S(
u�
Unsubscribe a specific SubscriptionArn of a topic.
CLI Example:
.. code-block:: bash
salt myminion boto_sns.unsubscribe my_topic my_subscription_arn region=us-east-1
.. versionadded:: 2016.11.0
R R R R u arn:aws:sns:u Unsubscribe %s to %s topicu Unsubscribe Errort exc_infoN(
R R R t unsubscribeR& R' t Exceptiont errorR
R t popR- t None( R1 t subscription_arnR R R R R t e( ( s9 /usr/lib/python2.7/site-packages/salt/modules/boto_sns.pyR5 � s !
c C@ sT | j d � r | St d d | d | d | d | � } d j t | | � | | � S( uy
Returns the full ARN for a given topic name.
CLI example::
salt myminion boto_sns.get_arn mytopic
u arn:aws:sns:u boto_iam.get_account_idR R R R u arn:aws:sns:{0}:{1}:{2}( R R
t formatt _get_region( R# R R R R t
account_id( ( s9 /usr/lib/python2.7/site-packages/salt/modules/boto_sns.pyR+ � s
c C@ s� | r d | k r | d S| rV t d | � rV t d | � } | j d d � } n | r� t d d � r� t d d � } n | s� d } n | S( Nu regionu
config.optionu
sns.regionu us-east-1( R
t getR9 ( R R t _profile( ( s9 /usr/lib/python2.7/site-packages/salt/modules/boto_sns.pyR= � s c C@ s d j t � | � S( Nu {0}_{1}_subscriptions( R< R ( R# ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/boto_sns.pyR- � s c C@ s& y t t � =Wn t k
r! n Xd S( N( R R R ( ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/boto_sns.pyR( � s
c C@ s d S( Nu boto_sns.topics_cache( ( ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/boto_sns.pyR s (! t __doc__t
__future__R R R t loggingt salt.utils.versionsR t getLoggerR R& t botot boto.snst setLevelt CRITICALR
t HAS_BOTOt ImportErrorR R R9 R R$ R) R, R. R0 R5 R+ R= R- R( R ( ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/boto_sns.pyt <module>) s0
Mini Shell