File manager - Edit - /opt/saltstack/salt/lib/python3.10/site-packages/salt/states/__pycache__/azurearm_dns.cpython-310.pyc
Back
o ;j�g � @ s� d Z ddlZddlmZ ddlZdZe�e�Z dd� Z dd� Z e dd d ��Z e dd d ��Z e ddd��Ze ddd��ZdS )a' Azure (ARM) DNS State Module .. versionadded:: 3000 .. warning:: This cloud provider will be removed from Salt in version 3007 in favor of the `saltext.azurerm Salt Extension <https://github.com/salt-extensions/saltext-azurerm>`_ :maintainer: <devops@eitr.tech> :maturity: new :depends: * `azure <https://pypi.python.org/pypi/azure>`_ >= 2.0.0 * `azure-common <https://pypi.python.org/pypi/azure-common>`_ >= 1.1.8 * `azure-mgmt <https://pypi.python.org/pypi/azure-mgmt>`_ >= 1.0.0 * `azure-mgmt-compute <https://pypi.python.org/pypi/azure-mgmt-compute>`_ >= 1.0.0 * `azure-mgmt-dns <https://pypi.python.org/pypi/azure-mgmt-dns>`_ >= 1.0.1 * `azure-mgmt-network <https://pypi.python.org/pypi/azure-mgmt-network>`_ >= 1.7.1 * `azure-mgmt-resource <https://pypi.python.org/pypi/azure-mgmt-resource>`_ >= 1.1.0 * `azure-mgmt-storage <https://pypi.python.org/pypi/azure-mgmt-storage>`_ >= 1.0.0 * `azure-mgmt-web <https://pypi.python.org/pypi/azure-mgmt-web>`_ >= 0.32.0 * `azure-storage <https://pypi.python.org/pypi/azure-storage>`_ >= 0.34.3 * `msrestazure <https://pypi.python.org/pypi/msrestazure>`_ >= 0.4.21 :platform: linux :configuration: This module requires Azure Resource Manager credentials to be passed as a dictionary of keyword arguments to the ``connection_auth`` parameter in order to work properly. Since the authentication parameters are sensitive, it's recommended to pass them to the states via pillar. Required provider parameters: if using username and password: * ``subscription_id`` * ``username`` * ``password`` if using a service principal: * ``subscription_id`` * ``tenant`` * ``client_id`` * ``secret`` Optional provider parameters: **cloud_environment**: Used to point the cloud driver to different API endpoints, such as Azure GovCloud. Possible values: Possible values: * ``AZURE_PUBLIC_CLOUD`` (default) * ``AZURE_CHINA_CLOUD`` * ``AZURE_US_GOV_CLOUD`` * ``AZURE_GERMAN_CLOUD`` Example Pillar for Azure Resource Manager authentication: .. code-block:: yaml azurearm: user_pass_auth: subscription_id: 3287abc8-f98a-c678-3bde-326766fd3617 username: fletch password: 123pass mysubscription: subscription_id: 3287abc8-f98a-c678-3bde-326766fd3617 tenant: ABCDEFAB-1234-ABCD-1234-ABCDEFABCDEF client_id: ABCDEFAB-1234-ABCD-1234-ABCDEFABCDEF secret: XXXXXXXXXXXXXXXXXXXXXXXX cloud_environment: AZURE_PUBLIC_CLOUD Example states using Azure Resource Manager authentication: .. code-block:: none {% set profile = salt['pillar.get']('azurearm:mysubscription') %} Ensure DNS zone exists: azurearm_dns.zone_present: - name: contoso.com - resource_group: my_rg - tags: how_awesome: very contact_name: Elmer Fudd Gantry - connection_auth: {{ profile }} Ensure DNS record set exists: azurearm_dns.record_set_present: - name: web - zone_name: contoso.com - resource_group: my_rg - record_type: A - ttl: 300 - arecords: - ipv4_address: 10.0.0.1 - tags: how_awesome: very contact_name: Elmer Fudd Gantry - connection_auth: {{ profile }} Ensure DNS record set is absent: azurearm_dns.record_set_absent: - name: web - zone_name: contoso.com - resource_group: my_rg - record_type: A - connection_auth: {{ profile }} Ensure DNS zone is absent: azurearm_dns.zone_absent: - name: contoso.com - resource_group: my_rg - connection_auth: {{ profile }} � N��wrapsZ azurearm_dnsc C s dt v rtS dS )zQ Only make this state available if the azurearm_dns module is available. z)azurearm_dns.zones_list_by_resource_group)Fz'azurearm_dns module could not be loaded)�__salt__�__virtualname__� r r �L/opt/saltstack/salt/lib/python3.10/site-packages/salt/states/azurearm_dns.py� __virtual__� s r c s t � �� fdd��}|S )z> Decorator wrapper to warn about azurearm deprecation c s6 t jjjddtd� � | i t jjjdi |����}|S )NZChlorinez�The 'azurearm' functionality in Salt has been deprecated and its functionality will be removed in version 3007 in favor of the saltext.azurerm Salt Extension. (https://github.com/salt-extensions/saltext-azurerm))�categoryr )�salt�utilsZversionsZ warn_until� FutureWarning�argsZ clean_kwargs)r �kwargs�ret��functionr r �wrapped� s � z%_deprecation_message.<locals>.wrappedr )r r r r r �_deprecation_message� s r �Publicc K s� | ddi d�} t | t�sd| d< | S td | |fddi| ��} d | vr�td | �d i �|p.i �} | r8| | d d < | �d �r�| �d ��� |�� krS| d |d�| d d < |�� dkr�|rft |t�sfd| d< | S | �dg �}tdd� |D ��}tdd� |p|g D ��}||kr�||d�| d d< |r�t |t�s�d| d< | S | �dg �}tdd� |D ��}tdd� |p�g D ��}||kr�||d�| d d< | d s�d| d< d| � d �| d< | S td r�d | d< d| � d �| d< | S ni | ||||||d �d�| d < td �rd| � d!�| d< d | d< | S | � � }|� | � td" d&| ||||||||d#� |��} d | v�r7d| d< d| � d$�| d< | S d%� | | �d ��| d< | S )'ac .. versionadded:: 3000 Ensure a DNS zone exists. :param name: Name of the DNS zone (without a terminating dot). :param resource_group: The resource group assigned to the DNS zone. :param etag: The etag of the zone. `Etags <https://docs.microsoft.com/en-us/azure/dns/dns-zones-records#etags>`_ are used to handle concurrent changes to the same resource safely. :param if_match: The etag of the DNS zone. Omit this value to always overwrite the current zone. Specify the last-seen etag value to prevent accidentally overwritting any concurrent changes. :param if_none_match: Set to '*' to allow a new DNS zone to be created, but to prevent updating an existing zone. Other values will be ignored. :param registration_virtual_networks: A list of references to virtual networks that register hostnames in this DNS zone. This is only when zone_type is Private. (requires `azure-mgmt-dns <https://pypi.python.org/pypi/azure-mgmt-dns>`_ >= 2.0.0rc1) :param resolution_virtual_networks: A list of references to virtual networks that resolve records in this DNS zone. This is only when zone_type is Private. (requires `azure-mgmt-dns <https://pypi.python.org/pypi/azure-mgmt-dns>`_ >= 2.0.0rc1) :param tags: A dictionary of strings can be passed as tag metadata to the DNS zone object. :param zone_type: The type of this DNS zone (Public or Private). Possible values include: 'Public', 'Private'. Default value: 'Public' (requires `azure-mgmt-dns <https://pypi.python.org/pypi/azure-mgmt-dns>`_ >= 2.0.0rc1) :param connection_auth: A dict with subscription and authentication parameters to be used in connecting to the Azure Resource Manager API. Example usage: .. code-block:: yaml Ensure DNS zone exists: azurearm_dns.zone_present: - name: contoso.com - resource_group: my_rg - zone_type: Private - registration_virtual_networks: - /subscriptions/{{ sub }}/resourceGroups/my_rg/providers/Microsoft.Network/virtualNetworks/test_vnet - tags: how_awesome: very contact_name: Elmer Fudd Gantry - connection_auth: {{ profile }} F� ��name�result�comment�changes�HConnection information must be specified via connection_auth dictionary!r �azurearm_dns.zone_get�azurearm_log_level�info�error�dictdiffer.deep_diff�tagsr � zone_type��old�newZprivatezJregistration_virtual_networks must be supplied as a list of VNET ID paths!� registration_virtual_networksc s �$ � | ] }d |v r|d � � V qdS ��idN��lower��.0Zvnetr r r � <genexpr> � � �z zone_present.<locals>.<genexpr>c s � � | ]}|� � V qd S �Nr* r, r r r r. � � �zHresolution_virtual_networks must be supplied as a list of VNET ID paths!�resolution_virtual_networksc s r' r( r* r, r r r r. % r/ c s r0 r1 r* r, r r r r. ( r2 Tr � DNS zone � is already present.�testN� would be updated.)r �resource_group�etagr& r3 r! r" � would be created.z"azurearm_dns.zone_create_or_update) r r8 r9 �if_match� if_none_matchr& r3 r! r" � has been created.z"Failed to create DNS zone {}! ({})r ) � isinstance�dictr � __utils__�getr+ �list�sorted�__opts__�copy�update�format)r r8 r9 r; r< r& r3 r! r" �connection_authr r �zoneZ tag_changesZ reg_vnetsZremote_reg_vnetsZlocal_reg_vnetsZ res_vnetsZremote_res_vnetsZlocal_res_vnetsZ zone_kwargsr r r � zone_present� s� I ����� � �� ����� ����� � � � �rJ c C s� | ddi d�}t |t�sd|d< |S td | |fddi|��}d |v r1d |d < d | � d �|d< |S td rJd | � d�|d< d|d < |i d�|d< |S td | |fi |��}|rld |d < d | � d�|d< |i d�|d< |S d| � d�|d< |S )a~ .. versionadded:: 3000 Ensure a DNS zone does not exist in the resource group. :param name: Name of the DNS zone. :param resource_group: The resource group assigned to the DNS zone. :param connection_auth: A dict with subscription and authentication parameters to be used in connecting to the Azure Resource Manager API. Fr r r r r r r r Tr r4 z was not found.r6 � would be deleted.Nr# r zazurearm_dns.zone_delete� has been deleted.zFailed to delete DNS zone �!)r> r? r rD )r r8 rH r rI �deletedr r r � zone_absenti sF ���� ���rO c $ K s^ | ddi d�}g d�}t |t�sd|d< |S td | |||fdd i|��}d |v�r td |�d i �|p5i �}|r?||d d < |D ]�}t|�}|r�|sSd|d< | S |�|�sad||ii|d < qA|d dkr�t |t�swd�|�|d< | S |�� D ]\}} | || �|�kr�d||ii|d < q{qA|d dkr�t |t�s�d�|�|d< | S dd� ||| fD �\} } | D ].} | D ])} | | }!| �| �}"t |!t �r�|!� � }!t |"t �r�|"� � }"|!|"kr�d||ii|d < q�q�qA|d s�d|d< d| � d�|d< |S t d �r d|d< d| � d �|d< |S n$i | ||||||d �d �|d < |D ]}t|��r/t|�|d d |< �q t d �rDd| � d �|d< d|d< |S |� � }#|#� |� td d5i d!| �d"|�d#|�d$|�d%|�d&|�d'|�d(|�d |�d)| �d*| �d+| �d,| �d-| �d.|�d/|�d0|�d1|�d2|�|#��}d |v�r�d|d< d| � d3�|d< |S d4�| |�d ��|d< |S )6a� .. versionadded:: 3000 Ensure a record set exists in a DNS zone. :param name: The name of the record set, relative to the name of the zone. :param zone_name: Name of the DNS zone (without a terminating dot). :param resource_group: The resource group assigned to the DNS zone. :param record_type: The type of DNS record in this record set. Record sets of type SOA can be updated but not created (they are created when the DNS zone is created). Possible values include: 'A', 'AAAA', 'CAA', 'CNAME', 'MX', 'NS', 'PTR', 'SOA', 'SRV', 'TXT' :param if_match: The etag of the record set. Omit this value to always overwrite the current record set. Specify the last-seen etag value to prevent accidentally overwritting any concurrent changes. :param if_none_match: Set to '*' to allow a new record set to be created, but to prevent updating an existing record set. Other values will be ignored. :param etag: The etag of the record set. `Etags <https://docs.microsoft.com/en-us/azure/dns/dns-zones-records#etags>`__ are used to handle concurrent changes to the same resource safely. :param metadata: A dictionary of strings can be passed as tag metadata to the record set object. :param ttl: The TTL (time-to-live) of the records in the record set. Required when specifying record information. :param arecords: The list of A records in the record set. View the `Azure SDK documentation <https://docs.microsoft.com/en-us/python/api/azure.mgmt.dns.models.arecord?view=azure-python>`__ to create a list of dictionaries representing the record objects. :param aaaa_records: The list of AAAA records in the record set. View the `Azure SDK documentation <https://docs.microsoft.com/en-us/python/api/azure.mgmt.dns.models.aaaarecord?view=azure-python>`__ to create a list of dictionaries representing the record objects. :param mx_records: The list of MX records in the record set. View the `Azure SDK documentation <https://docs.microsoft.com/en-us/python/api/azure.mgmt.dns.models.mxrecord?view=azure-python>`__ to create a list of dictionaries representing the record objects. :param ns_records: The list of NS records in the record set. View the `Azure SDK documentation <https://docs.microsoft.com/en-us/python/api/azure.mgmt.dns.models.nsrecord?view=azure-python>`__ to create a list of dictionaries representing the record objects. :param ptr_records: The list of PTR records in the record set. View the `Azure SDK documentation <https://docs.microsoft.com/en-us/python/api/azure.mgmt.dns.models.ptrrecord?view=azure-python>`__ to create a list of dictionaries representing the record objects. :param srv_records: The list of SRV records in the record set. View the `Azure SDK documentation <https://docs.microsoft.com/en-us/python/api/azure.mgmt.dns.models.srvrecord?view=azure-python>`__ to create a list of dictionaries representing the record objects. :param txt_records: The list of TXT records in the record set. View the `Azure SDK documentation <https://docs.microsoft.com/en-us/python/api/azure.mgmt.dns.models.txtrecord?view=azure-python>`__ to create a list of dictionaries representing the record objects. :param cname_record: The CNAME record in the record set. View the `Azure SDK documentation <https://docs.microsoft.com/en-us/python/api/azure.mgmt.dns.models.cnamerecord?view=azure-python>`__ to create a dictionary representing the record object. :param soa_record: The SOA record in the record set. View the `Azure SDK documentation <https://docs.microsoft.com/en-us/python/api/azure.mgmt.dns.models.soarecord?view=azure-python>`__ to create a dictionary representing the record object. :param caa_records: The list of CAA records in the record set. View the `Azure SDK documentation <https://docs.microsoft.com/en-us/python/api/azure.mgmt.dns.models.caarecord?view=azure-python>`__ to create a list of dictionaries representing the record objects. :param connection_auth: A dict with subscription and authentication parameters to be used in connecting to the Azure Resource Manager API. Example usage: .. code-block:: yaml Ensure record set exists: azurearm_dns.record_set_present: - name: web - zone_name: contoso.com - resource_group: my_rg - record_type: A - ttl: 300 - arecords: - ipv4_address: 10.0.0.1 - metadata: how_awesome: very contact_name: Elmer Fudd Gantry - connection_auth: {{ profile }} Fr r ) �arecords� aaaa_records� mx_records� ns_records� ptr_records� srv_records� txt_records� cname_record� soa_record� caa_recordsr r �azurearm_dns.record_set_getr r r r �metadatar z3TTL is required when specifying record information!r% ����sz8{} record information must be specified as a dictionary!zB{} record information must be specified as a list of dictionaries!c s s � | ]}t |�V qd S r1 )rC )r- Zconfigr r r r. k r2 z%record_set_present.<locals>.<genexpr>Tr � Record set r5 r6 Nr7 )r � zone_namer8 � record_typer9 r[ �ttlr# r: z(azurearm_dns.record_set_create_or_updater r_ r8 r` r; r< r9 ra rP rQ rR rS rT rU rV rW rX rY r= z$Failed to create record set {}! ({})r )r> r? r r@ rA �evalrG �itemsrB �strr+ rD rE rF )$r r_ r8 r` r; r< r9 r[ ra rP rQ rR rS rT rU rV rW rX rY rH r r Z record_vars�rec_setZmetadata_changesZ record_str�record�k�v�localZremote�val�keyZ local_valZ remote_valZrec_set_kwargsr r r �record_set_present� s ���� � � ���� � � ��� �� � � �������� � � � � ������� �rl c C s� | ddi d�}t |t�sd|d< |S td | ||fddi|��}d |v r2d |d < d �| |�|d< |S td rKd| � d�|d< d|d < |i d�|d< |S td | ||fi |��}|rnd |d < d| � d�|d< |i d�|d< |S d| � d�|d< |S )a� .. versionadded:: 3000 Ensure a record set does not exist in the DNS zone. :param name: Name of the record set. :param zone_name: Name of the DNS zone. :param resource_group: The resource group assigned to the DNS zone. :param connection_auth: A dict with subscription and authentication parameters to be used in connecting to the Azure Resource Manager API. Fr r r r rZ r r r Tr z'Record set {} was not found in zone {}.r6 r^ rK Nr# r z azurearm_dns.record_set_deleterL z Failed to delete record set rM )r> r? r rG rD )r r_ r8 rH r re rN r r r �record_set_absent� sJ ����� ���rm )NNNNNNr Nr1 )NNNNNNNNNNNNNNNN)�__doc__�logging� functoolsr Zsalt.utils.azurearmr r � getLogger�__name__�logr r rJ rO rl rm r r r r �<module> sV w � I 8 �
| ver. 1.4 |
Github
|
.
| PHP 8.2.30 | Generation time: 0 |
proxy
|
phpinfo
|
Settings