API Module Nameserver retrieveZoneDnsRequest

From Openprovider API documentation

Revision as of 07:52, 28 November 2018 (view source) WikiSysop (Talk | contribs) ← Older edit		Revision as of 06:51, 14 December 2018 (view source) WikiSysop (Talk | contribs) (→Raw XML) Newer edit →
Line 70:		Line 70:
	<array>		<array>
	<item>		<item>
-	<id>603319</id>
	<name>*.demozone.com</name>		<name>*.demozone.com</name>
	<type>A</type>		<type>A</type>
Line 80:		Line 79:
	</item>		</item>
	<item>		<item>
-	<id>603318</id>
	<name>demozone.com</name>		<name>demozone.com</name>
	<type>A</type>		<type>A</type>
Line 90:		Line 88:
	</item>		</item>
	<item>		<item>
-	<id>603320</id>
	<name>demozone.com</name>		<name>demozone.com</name>
	<type>MX</type>		<type>MX</type>
Line 100:		Line 97:
	</item>		</item>
	<item>		<item>
-	<id>603321</id>
	<name>demozone.com</name>		<name>demozone.com</name>
	<type>NS</type>		<type>NS</type>
Line 110:		Line 106:
	</item>		</item>
	<item>		<item>
-	<id>603322</id>
	<name>demozone.com</name>		<name>demozone.com</name>
	<type>NS</type>		<type>NS</type>
Line 120:		Line 115:
	</item>		</item>
	<item>		<item>
-	<id>603323</id>
	<name>demozone.com</name>		<name>demozone.com</name>
	<type>NS</type>		<type>NS</type>
Line 130:		Line 124:
	</item>		</item>
	<item>		<item>
-	<id>603324</id>
	<name>demozone.com</name>		<name>demozone.com</name>
	<type>SOA</type>		<type>SOA</type>

---

Revision as of 06:51, 14 December 2018

Contents 1 Module DNS zone > Retrieve 2 Examples 2.1 Using PHP class 2.2 Raw XML

Module DNS zone > Retrieve

Module	DNS zone
Command name	retrieveZoneDnsRequest
Use	Retrieves information about an existing DNS zone object.
Input	name withRecords - If you need to get all records of the DNS zone, better to use searchZoneRecordDnsRequest withHistory
Output	type (master or slave) name ip creationDate modificationDate records (if withRecords = 1) history (if withHistory = 1) withDnskey (0 or 1, default value is 0)

Examples

Using PHP class

$request = new OP_Request;
$request->setCommand('retrieveZoneDnsRequest')
  ->setAuth(array('username' => 'username', 'password' => 'password'))
  ->setArgs(array(
    'name' => 'demozone.com',
    'withRecords' => 1,
    'withHistory' => 1
  ));

Raw XML

Please note that newlines and leading spaces are added only for readability. Those whitespaces should be excluded from your XML command before sending it to Openprovider.

<?xml version="1.0" encoding="UTF-8"?>
<openXML>
  <credentials>
    <username>username</username>
    <password>password</password>
  </credentials>
  <retrieveZoneDnsRequest>
    <name>demozone.com</name>
    <withRecords>1</withRecords>
  </retrieveZoneDnsRequest>
</openXML>

<?xml version="1.0" encoding="UTF-8"?>
<openXML>
  <reply>
    <code>0</code>
    <desc></desc>
    <data>
      <id>48890</id>
      <type>master</type>
      <name>demozone.com</name>
      <ip>com.demozone</ip>
      <active>1</active>
      <creationDate>2010-07-13 17:07:22</creationDate>
      <modificationDate>2010-07-13 17:07:22</modificationDate>
      <records>
        <array>
          <item>
            <name>*.demozone.com</name>
            <type>A</type>
            <value>89.255.0.43</value>
            <prio></prio>
            <ttl>86400</ttl>
            <creationDate>2010-07-13 17:07:22</creationDate>
            <modificationDate>2010-07-13 17:07:22</modificationDate>
          </item>
          <item>
            <name>demozone.com</name>
            <type>A</type>
            <value>89.255.0.43</value>
            <prio></prio>
            <ttl>86400</ttl>
            <creationDate>2010-07-13 17:07:22</creationDate>
            <modificationDate>2010-07-13 17:07:22</modificationDate>
          </item>
          <item>
            <name>demozone.com</name>
            <type>MX</type>
            <value>mail.openprovider.eu</value>
            <prio>10</prio>
            <ttl>86400</ttl>
            <creationDate>2010-07-13 17:07:22</creationDate>
            <modificationDate>2010-07-13 17:07:22</modificationDate>
          </item>
          <item>
            <name>demozone.com</name>
            <type>NS</type>
            <value>ns3.openprovider.eu</value>
            <prio></prio>
            <ttl>86400</ttl>
            <creationDate>2010-07-13 17:07:22</creationDate>
            <modificationDate>2010-07-13 17:07:22</modificationDate>
          </item>
          <item>
            <name>demozone.com</name>
            <type>NS</type>
            <value>ns1.openprovider.nl</value>
            <prio></prio>
            <ttl>86400</ttl>
            <creationDate>2010-07-13 17:07:22</creationDate>
            <modificationDate>2010-07-13 17:07:22</modificationDate>
          </item>
          <item>
            <name>demozone.com</name>
            <type>NS</type>
            <value>ns2.openprovider.be</value>
            <prio></prio>
            <ttl>86400</ttl>
            <creationDate>2010-07-13 17:07:22</creationDate>
            <modificationDate>2010-07-13 17:07:22</modificationDate>
          </item>
          <item>
            <name>demozone.com</name>
            <type>SOA</type>
            <value>ns1.openprovider.nl dns@openprovider.eu 2010071300</value>
            <prio></prio>
            <ttl>86400</ttl>
            <creationDate>2010-07-13 17:07:22</creationDate>
            <modificationDate>2010-07-13 17:07:22</modificationDate>
          </item>
        </array>
      </records>
      <history>
        <array>
          <item>
            <date>2010-07-13 17:07:22</date>
            <is>+ A |demozone.com | 89.255.0.43</is>
            <was></was>
          </item>
          <item>
            <date>2010-07-13 17:07:22</date>
            <is>+ A |*.demozone.com | 89.255.0.43</is>
            <was></was>
          </item>
          <item>
            <date>2010-07-13 17:07:22</date>
            <is>+ MX |demozone.com | mail.openprovider.eu</is>
            <was></was>
          </item>
          <item>
            <date>2010-07-13 17:07:22</date>
            <is>+ NS |demozone.com | ns3.openprovider.eu</is>
            <was></was>
          </item>
          <item>
            <date>2010-07-13 17:07:22</date>
            <is>+ NS |demozone.com | ns1.openprovider.nl</is>
            <was></was>
          </item>
          <item>
            <date>2010-07-13 17:07:22</date>
            <is>+ NS |demozone.com | ns2.openprovider.be</is>
            <was></was>
          </item>
          <item>
            <date>2010-07-13 17:07:22</date>
            <is>+ SOA |demozone.com | ns1.openprovider.nl dns@openprovider.eu 2010071300</is>
            <was></was>
          </item>
        </array>
      </history>
    </data>
  </reply>
</openXML>