Current File : //usr/lib/python2.7/site-packages/salt/modules/boto3_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
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 � 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 d d � Z! d d d d 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: boto3
i ( t absolute_importt print_functiont unicode_literalsNu boto3c C@ s6 t j j j � } | t k r2 t d t d � n | S( u,
Only load if boto libraries exist.
u boto3.assign_funcsu sns( t saltt utilst versionst check_boto_reqst Truet __utils__t __name__( t
has_boto_reqs( ( s: /usr/lib/python2.7/site-packages/salt/modules/boto3_sns.pyt __virtual__C s c C@ s� t d | d | d | d | � } i } d } xt | d k r� | j d | � } | j d d � } t j d | � } x+ | D]# } | j d � d
}
| | |
<qy Wq0 W| S( ur
Returns a list of the requester's topics
CLI example::
salt myminion boto3_sns.list_topics
t regiont keyt keyidt profileu t NextTokenu NextTokenu Topics[*].TopicArnu :i����N( t _get_connt Nonet list_topicst gett jmespatht searcht split( R R
R R t connt resR t rett arnst tt
short_name( ( s: /usr/lib/python2.7/site-packages/salt/modules/boto3_sns.pyR M s !
c C@ s� t d | d | d | d | � } i } x� | j � D]~ \ } } | | | f k r4 i | d 6} t | d | d | d | d | �| d <t | d | d | d | d | �| d <q4 q4 W| S( u�
Returns details about a specific SNS topic, specified by name or ARN.
CLI example::
salt my_favorite_client boto3_sns.describe_topic a_sns_topic_of_my_choice
R R
R R u TopicArnu
Subscriptionsu
Attributes( R t itemst list_subscriptions_by_topict get_topic_attributes( t nameR R
R R t topicsR t topict arn( ( s: /usr/lib/python2.7/site-packages/salt/modules/boto3_sns.pyt describe_topicb s !
c C@ sA t d | d | d | d | � } | t | j � | j � � k S( u�
Check to see if an SNS topic exists.
CLI example::
salt myminion boto3_sns.topic_exists mytopic region=us-east-1
R R
R R ( R t listt valuest keys( R! R R
R R R" ( ( s: /usr/lib/python2.7/site-packages/salt/modules/boto3_sns.pyt topic_existsv s !c C@ s� t d | d | d | d | � } y5 | j d | � } t j d | | d � | d SWnN t j j k
r� } t j d | | � d
St k
r� t j d | � d
SXd
S( ux
Create an SNS topic.
CLI example::
salt myminion boto3_sns.create_topic mytopic region=us-east-1
R R
R R t Nameu SNS topic %s created with ARN %su TopicArnu! Failed to create SNS topic %s: %su Failed to create SNS topic %sN(
R t create_topict logt infot botocoret
exceptionst ClientErrort errorR t KeyError( R* R R
R R R R t e( ( s: /usr/lib/python2.7/site-packages/salt/modules/boto3_sns.pyR+ � s !
c C@ s} t d | d | d | d | � } y( | j d | � t j d | � t SWn- t j j k
rx } t j d t | � t
SXd S( ux
Delete an SNS topic.
CLI example::
salt myminion boto3_sns.delete_topic mytopic region=us-east-1
R R
R R t TopicArnu SNS topic %s deletedu! Failed to delete SNS topic %s: %sN( R t delete_topicR, R- R R. R/ R0 R1 R! t False( R4 R R
R R R R3 ( ( s: /usr/lib/python2.7/site-packages/salt/modules/boto3_sns.pyR5 � s !c C@ sr t d | d | d | d | � } y | j d | � j d � SWn- t j j k
rm } t j d | | � d SXd S( u�
Returns all of the properties of a topic. Topic properties returned might differ based on the
authorization of the user.
CLI example::
salt myminion boto3_sns.get_topic_attributes someTopic region=us-west-1
R R
R R R4 u
Attributesu0 Failed to garner attributes for SNS topic %s: %sN( R R R R. R/ R0 R, R1 R ( R4 R R
R R R R3 ( ( s: /usr/lib/python2.7/site-packages/salt/modules/boto3_sns.pyR � s ! c C@ s� t d | d | d | d | � } y: | j d | d | d | � t j d | | | � t SWn3 t j j k
r� } t j d | | | | � t SXd
S( u�
Set an attribute of a topic to a new value.
CLI example::
salt myminion boto3_sns.set_topic_attributes someTopic DisplayName myDisplayNameValue
R R
R R R4 t
AttributeNamet AttributeValueu# Set attribute %s=%s on SNS topic %su2 Failed to set attribute %s=%s for SNS topic %s: %sN(
R t set_topic_attributesR, t debugR R. R/ R0 R1 R6 ( R4 R7 R8 R R
R R R R3 ( ( s: /usr/lib/python2.7/site-packages/salt/modules/boto3_sns.pyR9 � s !
c C@ s� t d | d | d | d | � } d } g } y] xV | d k r� | j d | d | � } | j d d � } | j d g � } | | 7} q3 WWn- t j j k
r� }
t j d
| |
� d SX| S( u�
Returns a list of the subscriptions to a specific topic
CLI example::
salt myminion boto3_sns.list_subscriptions_by_topic mytopic region=us-east-1
R R
R R u R4 R u NextTokenu
Subscriptionsu1 Failed to list subscriptions for SNS topic %s: %sN( R R R R R. R/ R0 R, R1 ( R4 R R
R R R R R R t subsR3 ( ( s: /usr/lib/python2.7/site-packages/salt/modules/boto3_sns.pyR � s !c
C@ s� t d | d | d | d | � } d } g } yW xP | d
k r� | j d | � } | j d d
� } | j d g � } | | 7} q3 WWn* t j j k
r� } t j d | � d
SX| S( u�
Returns a list of the requester's topics
CLI example::
salt myminion boto3_sns.list_subscriptions region=us-east-1
R R
R R u R u NextTokenu
Subscriptionsu$ Failed to list SNS subscriptions: %sN( R R t list_subscriptionsR R. R/ R0 R, R1 (
R R
R R R R R R R; R3 ( ( s: /usr/lib/python2.7/site-packages/salt/modules/boto3_sns.pyR< � s !c C@ s� t d | d | d | d | � } y | j d | � } | d SWnN t j j k
rn } t j d | | � d St k
r� t j d | � d SXd S(
u�
Returns all of the properties of a subscription.
CLI example::
salt myminion boto3_sns.get_subscription_attributes somesubscription region=us-west-1
R R
R R t SubscriptionArnu
Attributesu5 Failed to list attributes for SNS subscription %s: %su1 Failed to list attributes for SNS subscription %sN( R t get_subscription_attributesR. R/ R0 R, R1 R R2 ( R= R R
R R R R R3 ( ( s: /usr/lib/python2.7/site-packages/salt/modules/boto3_sns.pyR> � s !
c C@ s� t d | d | d | d | � } y: | j d | d | d | � t j d | | | � t SWn3 t j j k
r� } t j d | | | | � t SXd
S( u�
Set an attribute of a subscription to a new value.
CLI example::
salt myminion boto3_sns.set_subscription_attributes someSubscription RawMessageDelivery jsonStringValue
R R
R R R= R7 R8 u* Set attribute %s=%s on SNS subscription %su9 Failed to set attribute %s=%s for SNS subscription %s: %sN(
R t set_subscription_attributesR, R: R R. R/ R0 R1 R6 ( R= R7 R8 R R
R R R R3 ( ( s: /usr/lib/python2.7/site-packages/salt/modules/boto3_sns.pyR? s !
c
C@ s� t d | d | d | d | � } yG | j d | d | d | � } t j d | | | | d � | d SWnN t j j k
r� } t j d
| | � d St k
r� t j d | � d SXd S(
u�
Subscribe to a Topic.
CLI example::
salt myminion boto3_sns.subscribe mytopic https https://www.example.com/sns-endpoint
R R
R R R4 t Protocolt Endpointu4 Subscribed %s %s to topic %s with SubscriptionArn %su SubscriptionArnu1 Failed to create subscription to SNS topic %s: %su- Failed to create subscription to SNS topic %sN(
R t subscribeR, R- R. R/ R0 R1 R R2 (
R4 R@ RA R R
R R R R R3 ( ( s: /usr/lib/python2.7/site-packages/salt/modules/boto3_sns.pyRB * s !
c C@ s� t d | d | d | d | � } g | D]! } | j d � | k r( | ^ q( } | si t j d | � t S| d d } t d | d | d | d | � } y+ | j d | � t j d
| | � t SWn- t j
j k
r� }
t j d | |
� t SXd S(
u�
Unsubscribe a specific SubscriptionArn of a topic.
CLI Example:
.. code-block:: bash
salt myminion boto3_sns.unsubscribe my_subscription_arn region=us-east-1
R R
R R u SubscriptionArnu Subscription ARN %s not foundi u TopicArnR= u) Deleted subscription %s from SNS topic %su$ Failed to delete subscription %s: %sN( R< R R, R1 R6 R t unsubscribeR- R R. R/ R0 ( R= R R
R R R; t st subR4 R R3 ( ( s: /usr/lib/python2.7/site-packages/salt/modules/boto3_sns.pyRC @ s
!.!
(# t __doc__t
__future__R R R t loggingt salt.utils.versionsR t getLoggerR R, R. t boto3R t setLevelt CRITICALR t HAS_BOTOt ImportErrorR6 R R R R% R) R+ R5 R R9 R R< R> R? RB RC ( ( ( s: /usr/lib/python2.7/site-packages/salt/modules/boto3_sns.pyt <module>) s8
Mini Shell