Edit file

File name : namecheap_domains_ns.py

Content :""" Namecheap Nameserver Management .. versionadded:: 2017.7.0 Prerequisites ------------- This module uses the ``requests`` Python module to communicate to the namecheap API. Configuration ------------- The Namecheap username, API key and URL should be set in the minion configuration file, or in the Pillar data. .. code-block:: yaml namecheap.name: companyname namecheap.key: a1b2c3d4e5f67a8b9c0d1e2f3 namecheap.client_ip: 162.155.30.172 #Real url namecheap.url: https://api.namecheap.com/xml.response #Sandbox url #namecheap.url: https://api.sandbox.namecheap.xml.response """ CAN_USE_NAMECHEAP = True try: import salt.utils.namecheap except ImportError: CAN_USE_NAMECHEAP = False __virtualname__ = "namecheap_domains_ns" def __virtual__(): """ Check to make sure requests and xml are installed and requests """ if CAN_USE_NAMECHEAP: return "namecheap_domains_ns" return False def get_info(sld, tld, nameserver): """ Retrieves information about a registered nameserver. Returns the following information: - IP Address set for the nameserver - Domain name which was queried - A list of nameservers and their statuses sld SLD of the domain name tld TLD of the domain name nameserver Nameserver to retrieve CLI Example: .. code-block:: bash salt '*' namecheap_domains_ns.get_info sld tld nameserver """ opts = salt.utils.namecheap.get_opts("namecheap.domains.ns.delete") opts["SLD"] = sld opts["TLD"] = tld opts["Nameserver"] = nameserver response_xml = salt.utils.namecheap.post_request(opts) if response_xml is None: return {} domainnsinforesult = response_xml.getElementsByTagName("DomainNSInfoResult")[0] return salt.utils.namecheap.xml_to_dict(domainnsinforesult) def update(sld, tld, nameserver, old_ip, new_ip): """ Deletes a nameserver. Returns ``True`` if the nameserver was updated successfully. sld SLD of the domain name tld TLD of the domain name nameserver Nameserver to create old_ip Current ip address new_ip New ip address CLI Example: .. code-block:: bash salt '*' namecheap_domains_ns.update sld tld nameserver old_ip new_ip """ opts = salt.utils.namecheap.get_opts("namecheap.domains.ns.update") opts["SLD"] = sld opts["TLD"] = tld opts["Nameserver"] = nameserver opts["OldIP"] = old_ip opts["IP"] = new_ip response_xml = salt.utils.namecheap.post_request(opts) if response_xml is None: return False domainnsupdateresult = response_xml.getElementsByTagName("DomainNSUpdateResult")[0] return salt.utils.namecheap.string_to_value( domainnsupdateresult.getAttribute("IsSuccess") ) def delete(sld, tld, nameserver): """ Deletes a nameserver. Returns ``True`` if the nameserver was deleted successfully sld SLD of the domain name tld TLD of the domain name nameserver Nameserver to delete CLI Example: .. code-block:: bash salt '*' namecheap_domains_ns.delete sld tld nameserver """ opts = salt.utils.namecheap.get_opts("namecheap.domains.ns.delete") opts["SLD"] = sld opts["TLD"] = tld opts["Nameserver"] = nameserver response_xml = salt.utils.namecheap.post_request(opts) if response_xml is None: return False domainnsdeleteresult = response_xml.getElementsByTagName("DomainNSDeleteResult")[0] return salt.utils.namecheap.string_to_value( domainnsdeleteresult.getAttribute("IsSuccess") ) def create(sld, tld, nameserver, ip): """ Creates a new nameserver. Returns ``True`` if the nameserver was created successfully. sld SLD of the domain name tld TLD of the domain name nameserver Nameserver to create ip Nameserver IP address CLI Example: .. code-block:: bash salt '*' namecheap_domains_ns.create sld tld nameserver ip """ opts = salt.utils.namecheap.get_opts("namecheap.domains.ns.create") opts["SLD"] = sld opts["TLD"] = tld opts["Nameserver"] = nameserver opts["IP"] = ip response_xml = salt.utils.namecheap.post_request(opts) if response_xml is None: return False domainnscreateresult = response_xml.getElementsByTagName("DomainNSCreateResult")[0] return salt.utils.namecheap.string_to_value( domainnscreateresult.getAttribute("IsSuccess") )

Save