Current File : //lib/python2.7/site-packages/salt/modules/boto3_route53.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 d d l m Z m
Z
d d l m Z e j e � Z y? d d l 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 � Z 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 � Z$ d d d d d e d d d d d d � Z% 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 d d d d �
Z( d d d d d � Z) d d d d d d � Z* d � Z+ d � Z, d � Z- d � Z. d d d d d d d d d d � Z/ d d d d d d d d d � Z0 d S(! u�
Execution module for Amazon Route53 written against Boto 3
.. versionadded:: 2017.7.0
:configuration: This module accepts explicit route53 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:: yaml
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
route53.keyid: GKTADJGHEIQSXMKKRBJ08H
route53.key: askdjghsdfjkghWupUjasdflkdfklgjsdfjajkghs
A region may also be specified in the configuration:
.. code-block:: yaml
route53.region: 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
Note that Route53 essentially ignores all (valid) settings for 'region',
since there is only one Endpoint (in us-east-1 if you care) and any (valid)
region setting will just send you there. It is entirely safe to set it to
None as well.
:depends: boto3
i ( t absolute_importt print_functiont unicode_literalsN( t SaltInvocationErrort CommandExecutionError( t six( t ClientErroru 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( ( ( s> /usr/lib/python2.7/site-packages/salt/modules/boto3_route53.pyt __virtual__L s c C@ s1 t j j j t � t r- t d t d � n d S( Nu boto3.assign_funcsu route53( R R t compatt pack_dundert __name__t HAS_BOTO3t __utils__( t opts( ( s> /usr/lib/python2.7/site-packages/salt/modules/boto3_route53.pyt __init__T s u Markeru
NextMarkerc C@ sK g } | j | d � } d } x&| d k rFy | | � } Wn{ t k
r� } | r� | j j d i � j d � d k r� t j d � t j d � | d 8} q! n t j d | | � g SX| r� | j | g � n | }
t |
t
� r� |
j d
d � n d | t |
t � r|
n |
g 7} | j | � } | j
i | | 6� q! W| S( Nu i
u Erroru Codeu
Throttlingu Throttled by AWS API.i i u' Could not collect results from %s(): %su ResponseMetadata( t gett NoneR t responset logt debugt timet sleept errort
isinstancet dictt popt listt update( t funct itemt argst markert
nextmarkert rett Markert triest rt et i( ( s> /usr/lib/python2.7/site-packages/salt/modules/boto3_route53.pyt _collect_resultsZ s( *
%"i
i c C@ s� x� t d | d � D]� } t j d | � d } y | j d | � d d } WnM t k
r� } | j j d i � j d � d k r� t j d
� q� | � n X| d k r� t St j
| � q Wt j d � t S(
Ni u# Getting route53 status (attempt %s)u waitt Idu
ChangeInfou Statusu Erroru Codeu
Throttlingu Throttled by AWS API.u INSYNCu, Timed out waiting for Route53 INSYNC status.(
t rangeR t infot
get_changeR R R R t TrueR R R t False( t changet connR' R t retryt statusR) ( ( s> /usr/lib/python2.7/site-packages/salt/modules/boto3_route53.pyt _wait_for_syncr s $
c
C@ s' t | | f � s! t d � � n | d
k rL t | t � rL t d � � n | ry t | d | d | d | d | �} n$ t | d | d | d | d | �} | d
k r� g | D]$ } | d d d | k r� | ^ q� } n t | � d
k r#t j d g | D] } | d d ^ q� � g } n | S( u�
Find a hosted zone with the given characteristics.
Id
The unique Zone Identifier for the Hosted Zone. Exclusive with Name.
Name
The domain name associated with the Hosted Zone. Exclusive with Id.
Note this has the potential to match more then one hosted zone (e.g. a public and a private
if both exist) which will raise an error unless PrivateZone has also been passed in order
split the different.
PrivateZone
Boolean - Set to True if searching for a private hosted zone.
region
Region to connect to.
key
Secret key to be used.
keyid
Access key to be used.
profile
Dict, or pillar key pointing to a dict, containing AWS region/key/keyid.
CLI Example:
.. code-block:: bash
salt myminion boto3_route53.find_hosted_zone Name=salt.org. profile='{"region": "us-east-1", "keyid": "A12345678AB", "key": "xblahblahblah"}'
u- Exactly one of either Id or Name is required.u7 If set, PrivateZone must be a bool (e.g. True / False).t regiont keyt keyidt profileu
HostedZoneu Configu PrivateZonei uS Request matched more than one Hosted Zone (%s). Refine your criteria and try again.u IdN(
t _exactly_oneR R R t boolt get_hosted_zonet get_hosted_zones_by_domaint lenR R (
R, t Namet PrivateZoneR7 R8 R9 R: R% t mt z( ( s> /usr/lib/python2.7/site-packages/salt/modules/boto3_route53.pyt find_hosted_zone� s $ '$ 4" c C@ sA t d | d | d | d | � } i | d 6} t | j d | � S( u
Return detailed info about the given zone.
Id
The unique Zone Identifier for the Hosted Zone.
region
Region to connect to.
key
Secret key to be used.
keyid
Access key to be used.
profile
Dict, or pillar key pointing to a dict, containing AWS region/key/keyid.
CLI Example:
.. code-block:: bash
salt myminion boto3_route53.get_hosted_zone Z1234567690 profile='{"region": "us-east-1", "keyid": "A12345678AB", "key": "xblahblahblah"}'
R7 R8 R9 R: u IdN( t _get_connR+ R= R ( R, R7 R8 R9 R: R3 R" ( ( s> /usr/lib/python2.7/site-packages/salt/modules/boto3_route53.pyR= � s !
c
C@ s� t d | d | d | d | � } g t | j d i � D]" } | d t | � k r7 | ^ q7 } g } x= | D]5 } | t d | d d | d | d | d | � 7} ql W| S( u�
Find any zones with the given domain name and return detailed info about them.
Note that this can return multiple Route53 zones, since a domain name can be used in
both public and private zones.
Name
The domain name associated with the Hosted Zone(s).
region
Region to connect to.
key
Secret key to be used.
keyid
Access key to be used.
profile
Dict, or pillar key pointing to a dict, containing AWS region/key/keyid.
CLI Example:
.. code-block:: bash
salt myminion boto3_route53.get_hosted_zones_by_domain salt.org. profile='{"region": "us-east-1", "keyid": "A12345678AB", "key": "xblahblahblah"}'
R7 R8 R9 R: u HostedZonesu NameR, u Id( RE R+ t list_hosted_zonest
aws_encodeR= ( R@ R7 R8 R9 R: R3 RC t zonesR% ( ( s> /usr/lib/python2.7/site-packages/salt/modules/boto3_route53.pyR> � s ! "
3c C@ sM t d | d | d | d | � } | r4 i | d 6n i } t | j d | � S( u�
Return detailed info about all zones in the bound account.
DelegationSetId
If you're using reusable delegation sets and you want to list all of the hosted zones that
are associated with a reusable delegation set, specify the ID of that delegation set.
region
Region to connect to.
key
Secret key to be used.
keyid
Access key to be used.
profile
Dict, or pillar key pointing to a dict, containing AWS region/key/keyid.
CLI Example:
.. code-block:: bash
salt myminion boto3_route53.describe_hosted_zones profile='{"region": "us-east-1", "keyid": "A12345678AB", "key": "xblahblahblah"}'
R7 R8 R9 R: u DelegationSetIdu HostedZones( RE R+ RF ( t DelegationSetIdR7 R8 R9 R: R3 R" ( ( s> /usr/lib/python2.7/site-packages/salt/modules/boto3_route53.pyRF � s !u c
C@ s | j d � s t d � � n t | � } t d | d | d |
d | � } t d | d | d | d | d |
d | � }
|
r� t j d | � d) Si | d
6| d 6i | d 6| d
6d 6} | r� | j i | d 6� n d) | r t | | f � st d � � n t
d d | d | d | d | d |
d | � j d g � } | rw| rwg | D] } | d | k rR| ^ qR} n | s�t j d � d) St
| � d k r�t j d g | D] } | d ^ q�� d) S| d } | r�| d } n | s�| d } n | j i i | d 6| d 6d 6� n% t | | | f � rEt j d � n d } x� | ryE | j | � } | j d d) � t | d! d" | � r�| g Sg SWqNt k
r} | r�| j j d# i � j d$ � d% k r�t j d& � t j d' � | d 8} qNn t j d( | | � g SXqNWg S(* u
Create a new Route53 Hosted Zone. Returns a Python data structure with information about the
newly created Hosted Zone.
Name
The name of the domain. This should be a fully-specified domain, and should terminate with
a period. This is the name you have registered with your DNS registrar. It is also the name
you will delegate from your registrar to the Amazon Route 53 delegation servers returned in
response to this request.
VPCId
When creating a private hosted zone, either the VPC ID or VPC Name to associate with is
required. Exclusive with VPCName. Ignored if passed for a non-private zone.
VPCName
When creating a private hosted zone, either the VPC ID or VPC Name to associate with is
required. Exclusive with VPCId. Ignored if passed for a non-private zone.
VPCRegion
When creating a private hosted zone, the region of the associated VPC is required. If not
provided, an effort will be made to determine it from VPCId or VPCName, if possible. If
this fails, you'll need to provide an explicit value for this option. Ignored if passed for
a non-private zone.
CallerReference
A unique string that identifies the request and that allows create_hosted_zone() calls to be
retried without the risk of executing the operation twice. This is a required parameter
when creating new Hosted Zones. Maximum length of 128.
Comment
Any comments you want to include about the hosted zone.
PrivateZone
Boolean - Set to True if creating a private hosted zone.
DelegationSetId
If you want to associate a reusable delegation set with this hosted zone, the ID that Amazon
Route 53 assigned to the reusable delegation set when you created it. Note that XXX TODO
create_delegation_set() is not yet implemented, so you'd need to manually create any
delegation sets before utilizing this.
region
Region endpoint to connect to.
key
AWS key to bind with.
keyid
AWS keyid to bind with.
profile
Dict, or pillar key pointing to a dict, containing AWS region/key/keyid.
CLI Example::
salt myminion boto3_route53.create_hosted_zone example.org.
u .u> Domain must be fully-qualified, complete with trailing period.R7 R8 R9 R: R@ RA ub Route 53 hosted zone %s already exists. You may want to pass e.g. 'PrivateZone=True' or similar...u Nameu CallerReferenceu Commentu PrivateZoneu HostedZoneConfigu DelegationSetIduA Either VPCName or VPCId is required when creating a private zone.u boto_vpc.describe_vpcst vpc_idt nameu vpcsu regionu@ Private zone requested but no VPC matching given criteria found.i uK Private zone requested but multiple VPCs matching given criteria found: %s.u idi u VPCIdu VPCRegionu VPCuR Options VPCId, VPCName, and VPCRegion are ignored when creating non-private zones.i
u ResponseMetadatau
ChangeInfou Idu Erroru Codeu
Throttlingu Throttled by AWS API.i u# Failed to create hosted zone %s: %sN( t endswithR RG RE RD R R. R R R; t __salt__R R R? t anyt create_hosted_zoneR R6 R R R R R ( R@ t VPCIdt VPCNamet VPCRegiont CallerReferencet CommentRA RI R7 R8 R9 R: R3 t deetsR" t vpcst vt vpcR' R( R) ( ( s> /usr/lib/python2.7/site-packages/salt/modules/boto3_route53.pyRO sv < !
,
% *
c C@ s� t | | f � s! t d � � n t d | d | d | d | � } | r� i | d 6| d 6| d 6| d 6| d
6| d 6} t | � }
|
s� t j d | � g S|
d
d d } n d } x� | r{y3 | j d | d | � } | j d d � | g SWq� t k
rw}
| r[|
j
j d i � j d � d k r[t j d � t
j d � | d 8} q� n t j d | pm| |
� q� Xq� Wg S( u
Update the comment on an existing Route 53 hosted zone.
Id
The unique Zone Identifier for the Hosted Zone.
Name
The domain name associated with the Hosted Zone(s).
Comment
Any comments you want to include about the hosted zone.
PrivateZone
Boolean - Set to True if changing a private hosted zone.
CLI Example::
salt myminion boto3_route53.update_hosted_zone_comment Name=example.org. Comment="This is an example comment for an example zone"
u- Exactly one of either Id or Name is required.R7 R8 R9 R: u Nameu PrivateZoneu regionu keyu keyidu profileu4 Couldn't resolve domain name %s to a hosted zone ID.i u
HostedZoneu Idi
R, RT u ResponseMetadatau Erroru Codeu
Throttlingu Throttled by AWS API.i i u. Failed to update comment on hosted zone %s: %sN( R; R RE RD R R t update_hosted_zone_commentR R R R R R R R ( R, R@ RT RA R7 R8 R9 R: R3 R" t zoneR' R( R) ( ( s> /usr/lib/python2.7/site-packages/salt/modules/boto3_route53.pyRY � s4 ! *
c
C@ s t | | f � s! t d � � n t | | f � sB t d � � n | r� i | d 6t d 6| d 6| d 6| d 6| d 6}
t |
� } | s� t j d | � t S| d
d d } n t d
d | d | d | d | d | d | � j d g � } | r(| r(g | D] }
|
d | k r|
^ q} n | s?t j d � t St | � d k r�t j d d j
g | D] }
|
d ^ qg� � t S| d
} | r�| d } n | s�| d } n i | d 6i | d 6| d 6d 6}
| d) k r�|
j i | d 6� n d) t
d | d | d | d | � } d } x� | ry( | j |
� } t | d d | � SWq't k
r} | j j d! i � j d" � d# k r�t j d$ � t S| r�| j j d! i � j d" � d% k r�t j d& � t j d' � | d 8} q'n t j d( | p| | p | | � q'Xq'Wt S(* u]
Associates an Amazon VPC with a private hosted zone.
To perform the association, the VPC and the private hosted zone must already exist. You can't
convert a public hosted zone into a private hosted zone. If you want to associate a VPC from
one AWS account with a zone from a another, the AWS account owning the hosted zone must first
submit a CreateVPCAssociationAuthorization (using create_vpc_association_authorization() or by
other means, such as the AWS console). With that done, the account owning the VPC can then call
associate_vpc_with_hosted_zone() to create the association.
Note that if both sides happen to be within the same account, associate_vpc_with_hosted_zone()
is enough on its own, and there is no need for the CreateVPCAssociationAuthorization step.
Also note that looking up hosted zones by name (e.g. using the Name parameter) only works
within a single account - if you're associating a VPC to a zone in a different account, as
outlined above, you unfortunately MUST use the HostedZoneId parameter exclusively.
HostedZoneId
The unique Zone Identifier for the Hosted Zone.
Name
The domain name associated with the Hosted Zone(s).
VPCId
When working with a private hosted zone, either the VPC ID or VPC Name to associate with is
required. Exclusive with VPCName.
VPCName
When working with a private hosted zone, either the VPC ID or VPC Name to associate with is
required. Exclusive with VPCId.
VPCRegion
When working with a private hosted zone, the region of the associated VPC is required. If
not provided, an effort will be made to determine it from VPCId or VPCName, if possible. If
this fails, you'll need to provide an explicit value for VPCRegion.
Comment
Any comments you want to include about the change being made.
CLI Example::
salt myminion boto3_route53.associate_vpc_with_hosted_zone Name=example.org. VPCName=myVPC VPCRegion=us-east-1 Comment="Whoo-hoo! I added another VPC."
u7 Exactly one of either HostedZoneId or Name is required.u3 Exactly one of either VPCId or VPCName is required.u Nameu PrivateZoneu regionu keyu keyidu profileu< Couldn't resolve domain name %s to a private hosted zone ID.i u
HostedZoneu Idu boto_vpc.describe_vpcsRJ RK R7 R8 R9 R: u vpcsu) No VPC matching the given criteria found.i u4 Multiple VPCs matching the given criteria found: %s.u , u idu HostedZoneIdu VPCIdu VPCRegionu VPCu Commenti
u
ChangeInfou Erroru Codeu ConflictingDomainExistsu VPC Association already exists.u
Throttlingu Throttled by AWS API.i u2 Failed to associate VPC %s with hosted zone %s: %sN( R; R R0 RD R R R1 RM R R? t joinR R RE t associate_vpc_with_hosted_zoneR6 R R R R R ( t HostedZoneIdR@ RP RQ RR RT R7 R8 R9 R: R" RZ RV RW RX R3 R' R( R) ( ( s> /usr/lib/python2.7/site-packages/salt/modules/boto3_route53.pyR\ � sd 1 " ,
'
"&! $
*
!c
C@ s t | | f � s! t d � � n t | | f � sB t d � � n | r� i | d 6t d 6| d 6| d 6| d 6| d 6}
t |
� } | s� t j d | � t S| d
d d } n t d
d | d | d | d | d | d | � j d g � } | r(| r(g | D] }
|
d | k r|
^ q} n | s?t j d � t St | � d k r�t j d d j
g | D] }
|
d ^ qg� � t S| d
} | r�| d } n | s�| d } n i | d 6i | d 6| d 6d 6}
| d) k r�|
j i | d 6� n d) t
d | d | d | d | � } d } x� | ry( | j |
� } t | d d | � SWq't k
r} | j j d! i � j d" � d# k r�t j d$ � t S| r�| j j d! i � j d" � d% k r�t j d& � t j d' � | d 8} q'n t j d( | p| | p | | � q'Xq'Wt S(* u;
Disassociates an Amazon VPC from a private hosted zone.
You can't disassociate the last VPC from a private hosted zone. You also can't convert a
private hosted zone into a public hosted zone.
Note that looking up hosted zones by name (e.g. using the Name parameter) only works XXX FACTCHECK
within a single AWS account - if you're disassociating a VPC in one account from a hosted zone
in a different account you unfortunately MUST use the HostedZoneId parameter exclusively. XXX FIXME DOCU
HostedZoneId
The unique Zone Identifier for the Hosted Zone.
Name
The domain name associated with the Hosted Zone(s).
VPCId
When working with a private hosted zone, either the VPC ID or VPC Name to associate with is
required. Exclusive with VPCName.
VPCName
When working with a private hosted zone, either the VPC ID or VPC Name to associate with is
required. Exclusive with VPCId.
VPCRegion
When working with a private hosted zone, the region of the associated VPC is required. If
not provided, an effort will be made to determine it from VPCId or VPCName, if possible. If
this fails, you'll need to provide an explicit value for VPCRegion.
Comment
Any comments you want to include about the change being made.
CLI Example::
salt myminion boto3_route53.disassociate_vpc_from_hosted_zone Name=example.org. VPCName=myVPC VPCRegion=us-east-1 Comment="Whoops! Don't wanna talk to this-here zone no more."
u7 Exactly one of either HostedZoneId or Name is required.u3 Exactly one of either VPCId or VPCName is required.u Nameu PrivateZoneu regionu keyu keyidu profileu< Couldn't resolve domain name %s to a private hosted zone ID.i u
HostedZoneu Idu boto_vpc.describe_vpcsRJ RK R7 R8 R9 R: u vpcsu) No VPC matching the given criteria found.i u4 Multiple VPCs matching the given criteria found: %s.u , u idu HostedZoneIdu VPCIdu VPCRegionu VPCu Commenti
u
ChangeInfou Erroru Codeu VPCAssociationNotFoundu No VPC Association exists.u
Throttlingu Throttled by AWS API.i u2 Failed to associate VPC %s with hosted zone %s: %sN( R; R R0 RD R R R1 RM R R? R[ R R RE t! disassociate_vpc_from_hosted_zoneR6 R R R R R ( R] R@ RP RQ RR RT R7 R8 R9 R: R" RZ RV RW RX R3 R' R( R) ( ( s> /usr/lib/python2.7/site-packages/salt/modules/boto3_route53.pyR^ : s` * " ,
'
"&! $
*
!c C@ sy t d | d | d | d | � } y+ | j d | � } t | d d | � SWn& t k
rt } t j d | | � n Xt S( u~
Delete a Route53 hosted zone.
CLI Example::
salt myminion boto3_route53.delete_hosted_zone Z1234567890
R7 R8 R9 R: R, u
ChangeInfou Idu# Failed to delete hosted zone %s: %s( RE t delete_hosted_zoneR6 R R R R1 ( R, R7 R8 R9 R: R3 R( R) ( ( s> /usr/lib/python2.7/site-packages/salt/modules/boto3_route53.pyR_ � s !c C@ s� i | d 6| d 6| d 6| d 6| d 6| d 6} t | � } | sV t j d | � t S| d d d
} t d | d | d
| d | d | � S( u�
Delete a Route53 hosted zone by domain name, and PrivateZone status if provided.
CLI Example::
salt myminion boto3_route53.delete_hosted_zone_by_domain example.org.
u Nameu PrivateZoneu regionu keyu keyidu profileu4 Couldn't resolve domain name %s to a hosted zone ID.i u
HostedZoneu IdR, R7 R8 R9 R: ( RD R R R1 R_ ( R@ RA R7 R8 R9 R: R" RZ R, ( ( s> /usr/lib/python2.7/site-packages/salt/modules/boto3_route53.pyt delete_hosted_zone_by_domain� s c C@ s� d } y/ | j d � t j d t | j d � � } WnN t k
rW | j d � } n/ t k
r� } t j d | � t | � � n Xt j
d | | � | S( u�
An implementation of the encoding required to suport AWS's domain name
rules defined here__:
.. __: http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/DomainNameFormat.html
While AWS's documentation specifies individual ASCII characters which need
to be encoded, we instead just try to force the string to one of
escaped unicode or idna depending on whether there are non-ASCII characters
present.
This means that we support things like ドメイン.テスト as a domain name string.
More information about IDNA encoding in python is found here__:
.. __: https://pypi.org/project/idna
u asciiu \\x([a-f0-8]{2})u unicode_escapeu idnauA Couldn't encode %s using either 'unicode_escape' or 'idna' codecsu AWS-encoded result for %s: %sN( R t encodet ret subt _hexReplacet UnicodeEncodeErrort ExceptionR R R R ( t xR% R) ( ( s> /usr/lib/python2.7/site-packages/salt/modules/boto3_route53.pyRG � s
c C@ s< d } x/| t | d � k r7t | d | d d � | d | d d <d | d | d k r� d } xo | t | d | d d � k r� t | d | d d | d � | d | d d | d <| d 7} ql Wn d | d | d k r*t | d | d d d � | d | d d d <n | d 7} q W| S(
uX
helper method to process a change batch & encode the bits which need encoding.
i u Changesu ResourceRecordSetu Nameu ResourceRecordsu Valuei u AliasTargetu DNSName( R? RG ( t ot
change_idxt rr_idx( ( s> /usr/lib/python2.7/site-packages/salt/modules/boto3_route53.pyt _aws_encode_changebatch� s ,%<7c C@ s& d | k r | j d � S| j d � S( u�
An implementation of the decoding required to suport AWS's domain name
rules defined here__:
.. __: http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/DomainNameFormat.html
The important part is this:
If the domain name includes any characters other than a to z, 0 to 9, - (hyphen),
or _ (underscore), Route 53 API actions return the characters as escape codes.
This is true whether you specify the characters as characters or as escape
codes when you create the entity.
The Route 53 console displays the characters as characters, not as escape codes."
For a list of ASCII characters the corresponding octal codes, do an internet search on "ascii table".
We look for the existance of any escape codes which give us a clue that
we're received an escaped unicode string; or we assume it's idna encoded
and then decode as necessary.
u \u unicode_escapeu idna( t decode( Rg ( ( s> /usr/lib/python2.7/site-packages/salt/modules/boto3_route53.pyt _aws_decode s
c C@ s0 t | j d � d � } d t t | � � d S( u5
Converts a hex code to a base 16 int then the octal of it, minus the leading
zero.
This is necessary because x.encode('unicode_escape') automatically assumes
you want a hex string, which AWS will accept but doesn't result in what
you really want unless it's an octal escape sequence
i i u \( t intt groupt strt oct( Rg t c( ( s> /usr/lib/python2.7/site-packages/salt/modules/boto3_route53.pyRd ! s c C@ s] t | | f � s! t d � � n | r� i | d 6| d 6| d 6| d 6| d 6} | d# k rr | j i | d 6� n d# t | � }
|
s� t j d | � g S|
d d
d } n t d | d
| d | d | � } g } | }
| } d# } t } xft rX| r| Si | d 6} |
r2| j i t
|
� d 6� n d# |
rX| rX| j i | d 6� n d# | rx| j i | d 6� n d# yy| j | � } | d } | j d � }
| j d � } | j d � } x | D]} t
| d � | d <d | k r]d } xb | t | d � k rYd | d | k rLt
| d | d � | d | d <n | d 7} q�Wn d | k r�t
| d d � | d d <n | r�| d | k r�t } Pn | r�| d | k r�| r�t } Pq�q�n | | g 7} q�W|
s�t } n Wq� t k
rT} | j j d i � j d � d k rKt j d! � t j d" � q� n | � q� Xq� Wd# S($ u9
Get all resource records from a given zone matching the provided StartRecordName (if given) or all
records in the zone (if not), optionally filtered by a specific StartRecordType. This will return
any and all RRs matching, regardless of their special AWS flavors (weighted, geolocation, alias,
etc.) so your code should be prepared for potentially large numbers of records back from this
function - for example, if you've created a complex geolocation mapping with lots of entries all
over the world providing the same server name to many different regional clients.
If you want EXACTLY ONE record to operate on, you'll need to implement any logic required to
pick the specific RR you care about from those returned.
Note that if you pass in Name without providing a value for PrivateZone (either True or
False), CommandExecutionError can be raised in the case of both public and private zones
matching the domain. XXX FIXME DOCU
CLI example::
salt myminion boto3_route53.get_records test.example.org example.org A
u< Exactly one of either HostedZoneId or Name must be provided.u Nameu regionu keyu keyidu profileu PrivateZoneu4 Couldn't resolve domain name %s to a hosted zone ID.i u
HostedZoneu IdR7 R8 R9 R: u HostedZoneIdu StartRecordNameu StartRecordTypeu StartRecordIdentifieru ResourceRecordSetsu NextRecordNameu NextRecordTypeu NextRecordIdentifieru ResourceRecordsu Valuei u AliasTargetu DNSNameu Typeu Erroru Codeu
Throttlingu Throttled by AWS API.i N( R; R R R RD R R RE R1 R0 RG t list_resource_record_setsR Rm R? R R R R R ( R] R@ t StartRecordNamet StartRecordTypeRA R7 R8 R9 R: R" RZ R3 R% t next_rr_namet next_rr_typet
next_rr_idt doneR( t rrst rrRg R) ( ( s> /usr/lib/python2.7/site-packages/salt/modules/boto3_route53.pyt get_resource_records. sr
& !
&&
'
$
c C@ s� t | | f � s! t d � � n | r� i | d 6| d 6| d 6| d 6| d 6} | d k rr | j i | d 6� n d t | � } | s� t j d | � g S| d d
d } n i | d 6t | � d
6} t d | d | d | d | � }
d } x� | r�y+ |
j | � } t
| d d |
d � SWq� t k
r�}
| r�|
j j
d i � j
d � d k r�t j d � t j d � | d 8} q� n t j d | p�| t j |
� � |
� q� Xq� Wt S( u�
See the `AWS Route53 API docs`__ as well as the `Boto3 documentation`__ for all the details...
.. __: https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html
.. __: http://boto3.readthedocs.io/en/latest/reference/services/route53.html#Route53.Client.change_resource_record_sets
The syntax for a ChangeBatch parameter is as follows, but note that the permutations of allowed
parameters and combinations thereof are quite varied, so perusal of the above linked docs is
highly recommended for any non-trival configurations.
.. code-block:: text
{
"Comment": "string",
"Changes": [
{
"Action": "CREATE"|"DELETE"|"UPSERT",
"ResourceRecordSet": {
"Name": "string",
"Type": "SOA"|"A"|"TXT"|"NS"|"CNAME"|"MX"|"NAPTR"|"PTR"|"SRV"|"SPF"|"AAAA",
"SetIdentifier": "string",
"Weight": 123,
"Region": "us-east-1"|"us-east-2"|"us-west-1"|"us-west-2"|"ca-central-1"|"eu-west-1"|"eu-west-2"|"eu-central-1"|"ap-southeast-1"|"ap-southeast-2"|"ap-northeast-1"|"ap-northeast-2"|"sa-east-1"|"cn-north-1"|"ap-south-1",
"GeoLocation": {
"ContinentCode": "string",
"CountryCode": "string",
"SubdivisionCode": "string"
},
"Failover": "PRIMARY"|"SECONDARY",
"TTL": 123,
"ResourceRecords": [
{
"Value": "string"
},
],
"AliasTarget": {
"HostedZoneId": "string",
"DNSName": "string",
"EvaluateTargetHealth": True|False
},
"HealthCheckId": "string",
"TrafficPolicyInstanceId": "string"
}
},
]
}
CLI Example:
.. code-block:: bash
foo='{
"Name": "my-cname.example.org.",
"TTL": 600,
"Type": "CNAME",
"ResourceRecords": [
{
"Value": "my-host.example.org"
}
]
}'
foo=`echo $foo` # Remove newlines
salt myminion boto3_route53.change_resource_record_sets DomainName=example.org. keyid=A1234567890ABCDEF123 key=xblahblahblah ChangeBatch="{'Changes': [{'Action': 'UPSERT', 'ResourceRecordSet': $foo}]}"
u: Exactly one of either HostZoneId or Name must be provided.u Nameu regionu keyu keyidu profileu PrivateZoneu4 Couldn't resolve domain name %s to a hosted zone ID.i u
HostedZoneu Idu HostedZoneIdu ChangeBatchR7 R8 R9 R: i u
ChangeInfoi u Erroru Codeu
Throttlingu Throttled by AWS API.i i u; Failed to apply requested changes to the hosted zone %s: %sN( R; R R R RD R R Rk RE t change_resource_record_setsR6 R R R R R R R t text_typeR1 ( R] R@ RA t ChangeBatchR7 R8 R9 R: R" RZ R3 R' R( R) ( ( s> /usr/lib/python2.7/site-packages/salt/modules/boto3_route53.pyR} � s8 E
& ! *
(1 t __doc__t
__future__R R R t loggingR Rb t salt.utils.compatR t salt.utils.versionst salt.exceptionsR R t salt.extR t getLoggerR R t boto3t botocore.exceptionsR t setLevelt CRITICALR0 R t ImportErrorR1 R R R+ R6 R RD R= R> RF RO RY R\ R^ R_ R` RG Rk Rm Rd R| R} ( ( ( s> /usr/lib/python2.7/site-packages/salt/modules/boto3_route53.pyt <module>. sb
6 % ~ 1 g r !
X
Mini Shell