Basic Name Server Monitor Example
=================================

This sample invokes and displays the results of a DomainTools
"Name Server Monitor" via DXL.

For more information see:
    https://www.domaintools.com/resources/api-documentation/name-server-monitor/

Prerequisites
*************
* The samples configuration step has been completed (see :doc:`sampleconfig`)
* The DomainTools API DXL service is running (see `DomainTools API DXL Service <https://github.com/opendxl/opendxl-domaintools-service-python>`_)

Running
*******

To run this sample execute the
``sample/basic/basic_name_server_monitor_example.py`` script as follows:

    .. parsed-literal::

        python sample/basic/basic_name_server_monitor_example.py

The output should appear similar to the following:

    .. code-block:: json

        {
            "response": {
                "alerts": [
                    {
                        "action": "Transfer Out",
                        "domain": "00000000000.PW",
                        "new_name_server": "i-now.cn",
                        "old_name_server": "dnspod.net"
                    },
                    {
                        "action": "New",
                        "domain": "1524QQ.COM",
                        "new_name_server": "dnspod.net",
                        "old_name_server": ""
                    }
                ],
                "date": "2017-07-18",
                "limit": 1000,
                "name_server": "DNSPOD.NET",
                "page": 1,
                "page_count": 35,
                "total": "34494"
            }
        }

The received results are displayed.

Details
*******

The majority of the sample code is shown below:

    .. code-block:: python

        # Create the client
        with DxlClient(config) as dxl_client:

            # Connect to the fabric
            dxl_client.connect()

            logger.info("Connected to DXL fabric.")

            # Create client wrapper
            client = DomainToolsApiClient(dxl_client)

            # Invoke 'name_server_monitor' method on service
            resp_dict = client.name_server_monitor("DNSPOD.NET")

            # Print out the response (convert dictionary to JSON for pretty printing)
            print("Response:\n{}".format(
                MessageUtils.dict_to_json(resp_dict, pretty_print=True)))


Once a connection is established to the DXL fabric, a
:class:`dxldomaintoolsclient.client.DomainToolsApiClient` instance is created
which will be used to invoke remote commands on the DomainTools API DXL
service.

Next, the
:func:`dxldomaintoolsclient.client.DomainToolsApiClient.name_server_monitor`
method is invoked with a hostname.

The final step is to display the contents of the returned dictionary (``dict``)
which contains the results of the name server monitor query.

From the DomainTools
`Name Server Monitor documentation <https://www.domaintools.com/resources/api-documentation/name-server-monitor/>`_:

        `"The Name Server Monitor API searches the daily activity of all our
        monitored TLDs on any given name server. New, Deleted and Transferred
        domains records can be queried up to 6 days in the past."`