Current File : //usr/lib/python2.7/site-packages/salt/modules/boto_iot.pyc
�
���^c @@ s' d Z d d l m Z m Z m Z d d l Z d d l Z d d l Z d d l Z d d l
Z e j e � Z
d d l m Z y[ d d l Z d d l Z d d l m Z d d l m Z e j d � j e j � e Z Wn e k
r� e Z n Xd � Z d � Z d d d d d
� Z d d d d d � Z! 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 � Z& d d d d d � Z' d d d d d � Z( 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 � 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 d d d d � Z2 d d d d d � Z3 e d d d d d � Z4 e d d d d d � Z5 d d d d d � Z6 d d d d d! � Z7 d d d d d d d" � Z8 d S(# u,
Connection module for Amazon IoT
.. versionadded:: 2016.3.0
:depends:
- boto
- boto3
The dependencies listed above can be installed via package or pip.
:configuration: This module accepts explicit Lambda 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
iot.keyid: GKTADJGHEIQSXMKKRBJ08H
iot.key: askdjghsdfjkghWupUjasdflkdfklgjsdfjajkghs
A region may also be specified in the configuration:
.. code-block:: yaml
iot.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
i ( t absolute_importt print_functiont unicode_literalsN( t string_types( t ClientError( t __version__u boto3c C@ s t j j j d d d d � S( ug
Only load if boto libraries exist and if boto libraries are greater than
a given version.
t boto3_veru 1.2.1t botocore_veru 1.4.41( t saltt utilst versionst check_boto_reqs( ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/boto_iot.pyt __virtual__Q s c C@ s1 t j j j t � t r- t d t d � n d S( Nu boto3.assign_funcsu iot( R R t compatt pack_dundert __name__t HAS_BOTOt __utils__( t opts( ( s9 /usr/lib/python2.7/site-packages/salt/modules/boto_iot.pyt __init___ s c C@ s� y\ t d | d | d | d | � } | j d | � } | j d � rP i t d 6Si t d 6SWnZ t k
r� } t d | � } | j j d i � j d
� d k r� i t d 6Si | d 6SXd
S( uI
Given a thing type name, check to see if the given thing type exists
Returns True if the given thing type exists and returns False if the
given thing type does not exist.
.. versionadded:: 2016.11.0
CLI Example:
.. code-block:: bash
salt myminion boto_iot.thing_type_exists mythingtype
t regiont keyt keyidt profilet
thingTypeNameu
thingTypeNameu existsu boto3.get_erroru Erroru Codeu ResourceNotFoundExceptionu errorN( t _get_connt describe_thing_typet gett Truet FalseR R t response( R R R R R t connt rest et err( ( s9 /usr/lib/python2.7/site-packages/salt/modules/boto_iot.pyt thing_type_existse s ! $ c C@ s* y� t d | d | d | d | � } | j d | � } | r� | j d d � | j d � } | r� xN d D]C } | j | � } | rh t | t j � rh d
j | � | | <qh qh Wn i | d 6Si d d 6SWnZ t k
r%}
t
d |
� } |
j j d
i � j d � d k ri d d 6Si | d 6SXd S( u�
Given a thing type name describe its properties.
Returns a dictionary of interesting properties.
.. versionadded:: 2016.11.0
CLI Example:
.. code-block:: bash
salt myminion boto_iot.describe_thing_type mythingtype
R R R R R u ResponseMetadatau thingTypeMetadatau creationDateu deprecationDateu {0}u
thing_typeu boto3.get_erroru Erroru Codeu ResourceNotFoundExceptionu errorN( u creationDateu deprecationDate( R R t popt NoneR t
isinstancet datetimet datet formatR R R ( R R R R R R R t thingTypeMetadatat dtypet dvalR! R" ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/boto_iot.pyR � s$ !
$ c C@ s� y� t d | d | d | d | � } t d | d | � } | j d | d | � } | r� t j d | d
� i t d 6| d
d
6St j d � i t d 6SWn, t k
r� }
i t d 6t d
|
� d 6SXd S( u�
Given a valid config, create a thing type.
Returns {created: true} if the thing type was created and returns
{created: False} if the thing type was not created.
.. versionadded:: 2016.11.0
CLI Example:
.. code-block:: bash
salt myminion boto_iot.create_thing_type mythingtype \
thingtype_description_string '["searchable_attr_1", "searchable_attr_2"]'
R R R R t thingTypeDescriptiont searchableAttributesR t thingTypePropertiesu& The newly created thing type ARN is %su thingTypeArnu createdu thing type was not createdu boto3.get_erroru errorN(
R t dictt create_thing_typet logt infoR t warningR R R ( R R- t searchableAttributesListR R R R R R/ t thingtypeR! ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/boto_iot.pyR1 � s !
c C@ s� y^ t d | d | d | d | � } | j d | d | � | t k rL t n t } i | d 6SWn, t k
r� } i t d 6t d | � d 6SXd
S( u�
Given a thing type name, deprecate it when undoDeprecate is False
and undeprecate it when undoDeprecate is True.
Returns {deprecated: true} if the thing type was deprecated and returns
{deprecated: false} if the thing type was not deprecated.
.. versionadded:: 2016.11.0
CLI Example:
.. code-block:: bash
salt myminion boto_iot.deprecate_thing_type mythingtype
R R R R R t
undoDeprecateu
deprecatedu boto3.get_erroru errorN( R t deprecate_thing_typeR R R R ( R R7 R R R R R t
deprecatedR! ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/boto_iot.pyR8 � s ! c C@ s� y@ t d | d | d | d | � } | j d | � i t d 6SWna t k
r� } t d | � } | j j d i � j d � d
k r� i t d 6Si t d 6| d 6SXd S(
u8
Given a thing type name, delete it.
Returns {deleted: true} if the thing type was deleted and returns
{deleted: false} if the thing type was not deleted.
.. versionadded:: 2016.11.0
CLI Example:
.. code-block:: bash
salt myminion boto_iot.delete_thing_type mythingtype
R R R R R u deletedu boto3.get_erroru Erroru Codeu ResourceNotFoundExceptionu errorN( R t delete_thing_typeR R R R R R ( R R R R R R R! R" ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/boto_iot.pyR: � s !$ c C@ s� y@ t d | d | d | d | � } | j d | � i t d 6SWnZ t k
r� } t d | � } | j j d i � j d � d
k r� i t d 6Si | d 6SXd S(
u
Given a policy name, check to see if the given policy exists.
Returns True if the given policy exists and returns False if the given
policy does not exist.
CLI Example:
.. code-block:: bash
salt myminion boto_iot.policy_exists mypolicy
R R R R t
policyNameu existsu boto3.get_erroru Erroru Codeu ResourceNotFoundExceptionu errorN( R t
get_policyR R R R R R ( R; R R R R R R! R" ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/boto_iot.pyt
policy_exists s !$ c C@ s� y� t d | d | d | d | � } t | t � sK t j j j | � } n | j d | d | � } | r� t j d | d � i t
d 6| d d
6St j d � i t d 6SWn, t
k
r� } i t d 6t d | � d
6SXd S( u�
Given a valid config, create a policy.
Returns {created: true} if the policy was created and returns
{created: False} if the policy was not created.
CLI Example:
.. code-block:: bash
salt myminion boto_iot.create_policy my_policy \
'{"Version":"2015-12-12",\
"Statement":[{"Effect":"Allow",\
"Action":["iot:Publish"],\
"Resource":["arn:::::topic/foo/bar"]}]}'
R R R R R; t policyDocumentu& The newly created policy version is %su policyVersionIdu createdu versionIdu Policy was not createdu boto3.get_erroru errorN( R R& R R R t jsont dumpst
create_policyR2 R3 R R4 R R R ( R; R> R R R R R t policyR! ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/boto_iot.pyRA + s !
c C@ ss y@ t d | d | d | d | � } | j d | � i t d 6SWn, t k
rn } i t d 6t d | � d 6SXd S(
u
Given a policy name, delete it.
Returns {deleted: true} if the policy was deleted and returns
{deleted: false} if the policy was not deleted.
CLI Example:
.. code-block:: bash
salt myminion boto_iot.delete_policy mypolicy
R R R R R; u deletedu boto3.get_erroru errorN( R t
delete_policyR R R R ( R; R R R R R R! ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/boto_iot.pyRC P s !c C@ s� y� t d | d | d | d | � } | j d | � } | ru d } i t g | D] } | | j | � f ^ qO � d
6Si d d
6SWnd t k
r� } t d | � }
| j j d i � j d
� d k r� i d d
6Si t d | � d 6SXd S( u�
Given a policy name describe its properties.
Returns a dictionary of interesting properties.
CLI Example:
.. code-block:: bash
salt myminion boto_iot.describe_policy mypolicy
R R R R R; u
policyNameu policyArnu policyDocumentu defaultVersionIdu policyu boto3.get_erroru Erroru Codeu ResourceNotFoundExceptionu errorN( u
policyNameu policyArnu policyDocumentu defaultVersionId( R R< R0 R R% R R R ( R; R R R R R RB t keyst kR! R" ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/boto_iot.pyt describe_policyh s ! 3$ c
C@ s� yN t d | d | d | d | � } | j d | d | � } i t | � d 6SWnd t k
r� } t d | � } | j j d i � j d
� d k r� i t d 6Si t d | � d 6SXd
S( uK
Given a policy name and version ID, check to see if the given policy version exists.
Returns True if the given policy version exists and returns False if the given
policy version does not exist.
CLI Example:
.. code-block:: bash
salt myminion boto_iot.policy_version_exists mypolicy versionid
R R R R R; t policyversionIdu existsu boto3.get_erroru Erroru Codeu ResourceNotFoundExceptionu errorN( R t get_policy_versiont boolR R R R R (
R; t policyVersionIdR R R R R RB R! R" ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/boto_iot.pyt policy_version_exists� s ! $ c
C@ s� y� t d | d | d | d | � } t | t � sK t j j j | � } n | j d | d | d | � } | r� t j d | d � i t
d
6| d d 6St j d � i t d
6SWn, t
k
r� } i t d
6t d
| � d 6SXd S( u�
Given a valid config, create a new version of a policy.
Returns {created: true} if the policy version was created and returns
{created: False} if the policy version was not created.
CLI Example:
.. code-block:: bash
salt myminion boto_iot.create_policy_version my_policy \
'{"Statement":[{"Effect":"Allow","Action":["iot:Publish"],"Resource":["arn:::::topic/foo/bar"]}]}'
R R R R R; R> t setAsDefaultu& The newly created policy version is %su policyVersionIdu createdu nameu Policy version was not createdu boto3.get_erroru errorN( R R& R R R R? R@ t create_policy_versionR2 R3 R R4 R R R (
R; R> RL R R R R R RB R! ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/boto_iot.pyRM � s !
c C@ sy yF t d | d | d | d | � } | j d | d | � i t d 6SWn, t k
rt } i t d 6t d | � d 6SXd
S( u0
Given a policy name and version, delete it.
Returns {deleted: true} if the policy version was deleted and returns
{deleted: false} if the policy version was not deleted.
CLI Example:
.. code-block:: bash
salt myminion boto_iot.delete_policy_version mypolicy version
R R R R R; RJ u deletedu boto3.get_erroru errorN( R t delete_policy_versionR R R R ( R; RJ R R R R R R! ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/boto_iot.pyRN � s !c C@ s� y� t d | d | d | d | � } | j d | d | � } | r{ d } i t g | D] } | | j | � f ^ qU � d 6Si d d 6SWnd t k
r� }
t d
|
� } |
j j d i � j d � d k r� i d d 6Si t d
|
� d 6SXd S( u�
Given a policy name and version describe its properties.
Returns a dictionary of interesting properties.
CLI Example:
.. code-block:: bash
salt myminion boto_iot.describe_policy_version mypolicy version
R R R R R; RJ u
policyNameu policyArnu policyDocumentu policyVersionIdu isDefaultVersionu policyu boto3.get_erroru Erroru Codeu ResourceNotFoundExceptionu errorN( u
policyNameu policyArnu policyDocumentu policyVersionIdu isDefaultVersion( R RH R0 R R% R R R ( R; RJ R R R R R RB RD RE R! R" ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/boto_iot.pyt describe_policy_version� s ! 3$ c C@ s� y� t d | d | d | d | � } g } x8 t d | j d d d d �D] } | j | d
� qJ Wt | � s� t j d � n i | d
6SWn% t k
r� } i t d | � d
6SXd S( u�
List all policies
Returns list of policies
CLI Example:
.. code-block:: bash
salt myminion boto_iot.list_policies
Example Return:
.. code-block:: yaml
policies:
- {...}
- {...}
R R R R u boto3.paged_callt marker_flagu
nextMarkert
marker_argu markeru policiesu No policies foundu boto3.get_erroru errorN( R R t
list_policiest extendRI R2 R4 R ( R R R R R t policiest retR! ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/boto_iot.pyRR � s !
c C@ s� y� t d | d | d | d | � } g } x> t d | j d d d d d
| �D] } | j | d � qP Wt | � s� t j d � n i | d 6SWn% t k
r� } i t d
| � d 6SXd S( u
List the versions available for the given policy.
CLI Example:
.. code-block:: bash
salt myminion boto_iot.list_policy_versions mypolicy
Example Return:
.. code-block:: yaml
policyVersions:
- {...}
- {...}
R R R R u boto3.paged_callRP u
nextMarkerRQ u markerR; u policyVersionsu No versions foundu boto3.get_erroru errorN( R R t list_policy_versionsRS RI R2 R4 R ( R; R R R R R t versRU R! ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/boto_iot.pyRV " s !
c C@ s yL t d | d | d | d | � } | j d | d t | � � i t d 6SWn, t k
rz } i t d 6t d | � d 6SXd
S( u�
Sets the specified version of the specified policy as the policy's default
(operative) version. This action affects all certificates that the policy is
attached to.
Returns {changed: true} if the policy version was set
{changed: False} if the policy version was not set.
CLI Example:
.. code-block:: bash
salt myminion boto_iot.set_default_policy_version mypolicy versionid
R R R R R; RJ u changedu boto3.get_erroru errorN( R t set_default_policy_versiont strR R R R ( R; RJ R R R R R R! ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/boto_iot.pyRX E s !
c C@ s� y� t d | d | d | d | � } g } x> t d | j d | d d d d
�D] } | j | d � qP Wt | � s� t j d � n i | d 6SWn% t k
r� } i t d
| � d 6SXd S( u
List the policies attached to the given principal.
CLI Example:
.. code-block:: bash
salt myminion boto_iot.list_principal_policies myprincipal
Example Return:
.. code-block:: yaml
policies:
- {...}
- {...}
R R R R u boto3.paged_callt principalRP u
nextMarkerRQ u markeru policiesu No policies foundu boto3.get_erroru errorN( R R t list_principal_policiesRS RI R2 R4 R ( RZ R R R R R RW RU R! ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/boto_iot.pyR[ ` s !
c C@ sy yF t d | d | d | d | � } | j d | d | � i t d 6SWn, t k
rt } i t d 6t d | � d 6SXd
S( uQ
Attach the specified policy to the specified principal (certificate or other
credential.)
Returns {attached: true} if the policy was attached
{attached: False} if the policy was not attached.
CLI Example:
.. code-block:: bash
salt myminion boto_iot.attach_principal_policy mypolicy mycognitoID
R R R R R; RZ u attachedu boto3.get_erroru errorN( R t attach_principal_policyR R R R ( R; RZ R R R R R R! ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/boto_iot.pyR\ � s !c C@ sy yF t d | d | d | d | � } | j d | d | � i t d 6SWn, t k
rt } i t d 6t d | � d 6SXd
S( uR
Detach the specified policy from the specified principal (certificate or other
credential.)
Returns {detached: true} if the policy was detached
{detached: False} if the policy was not detached.
CLI Example:
.. code-block:: bash
salt myminion boto_iot.detach_principal_policy mypolicy mycognitoID
R R R R R; RZ u detachedu boto3.get_erroru errorN( R t detach_principal_policyR R R R ( R; RZ R R R R R R! ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/boto_iot.pyR] � s !c C@ s� yB t d | d | d | d | � } | j d | � } i t d 6SWnd t k
r� } t d | � } | j j d i � j d � d
k r� i t d 6Si t d | � d 6SXd S(
u
Given a rule name, check to see if the given rule exists.
Returns True if the given rule exists and returns False if the given
rule does not exist.
CLI Example:
.. code-block:: bash
salt myminion boto_iot.topic_rule_exists myrule
R R R R t ruleNameu existsu boto3.get_erroru Erroru Codeu UnauthorizedExceptionu errorN( R t get_topic_ruleR R R R R R ( R^ R R R R R t ruleR! R" ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/boto_iot.pyt topic_rule_exists� s !$ c C@ s� yb t d | d | d | d | � } | j d | d i | d 6| d 6| d 6| d
6� i t d 6SWn, t k
r� }
i t d 6t d |
� d
6SXd S( u�
Given a valid config, create a topic rule.
Returns {created: true} if the rule was created and returns
{created: False} if the rule was not created.
CLI Example:
.. code-block:: bash
salt myminion boto_iot.create_topic_rule my_rule "SELECT * FROM 'some/thing'" \
'[{"lambda":{"functionArn":"arn:::::something"}},{"sns":{\
"targetArn":"arn:::::something","roleArn":"arn:::::something"}}]'
R R R R R^ t topicRulePayloadu sqlu descriptionu actionsu ruleDisabledu createdu boto3.get_erroru errorN( R t create_topic_ruleR R R R ( R^ t sqlt actionst descriptiont ruleDisabledR R R R R R! ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/boto_iot.pyRc � s ! c C@ s� yb t d | d | d | d | � } | j d | d i | d 6| d 6| d 6| d
6� i t d 6SWn, t k
r� }
i t d 6t d |
� d
6SXd S( u�
Given a valid config, replace a topic rule with the new values.
Returns {created: true} if the rule was created and returns
{created: False} if the rule was not created.
CLI Example:
.. code-block:: bash
salt myminion boto_iot.replace_topic_rule my_rule 'SELECT * FROM some.thing' \
'[{"lambda":{"functionArn":"arn:::::something"}},{"sns":{\
"targetArn":"arn:::::something","roleArn":"arn:::::something"}}]'
R R R R R^ Rb u sqlu descriptionu actionsu ruleDisabledu replacedu boto3.get_erroru errorN( R t replace_topic_ruleR R R R ( R^ Rd Re Rf Rg R R R R R R! ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/boto_iot.pyRh � s ! c C@ ss y@ t d | d | d | d | � } | j d | � i t d 6SWn, t k
rn } i t d 6t d | � d 6SXd S(
u�
Given a rule name, delete it.
Returns {deleted: true} if the rule was deleted and returns
{deleted: false} if the rule was not deleted.
CLI Example:
.. code-block:: bash
salt myminion boto_iot.delete_rule myrule
R R R R R^ u deletedu boto3.get_erroru errorN( R t delete_topic_ruleR R R R ( R^ R R R R R R! ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/boto_iot.pyRi s !c
C@ s� y� t d | d | d | d | � } | j d | � } | r� d | k r� | d } d } i t g | D] } | | j | � f ^ qe � d 6Si d d 6SWn% t k
r� } i t d | � d
6SXd S( u�
Given a topic rule name describe its properties.
Returns a dictionary of interesting properties.
CLI Example:
.. code-block:: bash
salt myminion boto_iot.describe_topic_rule myrule
R R R R R^ u ruleu ruleNameu sqlu descriptionu actionsu ruleDisabledu boto3.get_erroru errorN( u ruleNameu sqlu descriptionu actionsu ruleDisabled( R R_ R0 R R% R R (
R^ R R R R R R` RD RE R! ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/boto_iot.pyt describe_topic_rule0 s !
3c C@ s� y� t d | d | d | d | � } i } | d k rC | | d <n | d k r\ | | d <n g } x; t d | j d d d
d | �D] } | j | d � q� Wt | � s� t j d � n i | d 6SWn% t k
r� }
i t d
|
� d 6SXd S( u
List all rules (for a given topic, if specified)
Returns list of rules
CLI Example:
.. code-block:: bash
salt myminion boto_iot.list_topic_rules
Example Return:
.. code-block:: yaml
rules:
- {...}
- {...}
R R R R u topicu ruleDisabledu boto3.paged_callRP u nextTokenRQ u rulesu No rules foundu boto3.get_erroru errorN( R R% R t list_topic_rulesRS RI R2 R4 R ( t topicRg R R R R R t kwargst rulesRU R! ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/boto_iot.pyRk M s$ !
(9 t __doc__t
__future__R R R t loggingR' t salt.utils.compatR t salt.utils.jsont salt.utils.versionst getLoggerR R2 t salt.ext.sixR t botot boto3t botocore.exceptionsR t botocoreR t found_botocore_versiont setLevelt CRITICALR R t ImportErrorR R R R% R# R R1 R8 R: R= RA RC RF RK RM RN RO RR RV RX R[ R\ R] Ra Rc Rh Ri Rj Rk ( ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/boto_iot.pyt <module>0 sd
%( % # $##
Mini Shell