DomainZoneCreate

From NETIM
(Difference between revisions)
Jump to: navigation, search
m (Text replace - "API Version 1 (Recommended)" to "API Version 1 (Deprecated)")
 
(7 intermediate revisions by one user not shown)
Line 1: Line 1:
 
[[Category:Functions]]
 
[[Category:Functions]]
 +
 +
 +
<tabs>
 +
<tab name="API Version 2 (Recommended)">
 +
 +
{| class="wikitable" style="width: 200px;"
 +
! Release
 +
! Runtime
 +
|-
 +
|API >= 2.0|| Synchronous
 +
|}
 +
 +
 +
'''Description'''
 +
 +
Creates a DNS record into the domain zonefile
 +
 +
[[StructOperationResponse]] domainZoneCreate(string idSession, string domain, string subdomain, string type, string value, [[StructOptionsZone]] options)
 +
 +
 +
 +
'''Parameters'''
 +
{| class="wikitable" style="width: 700px;"
 +
! Format
 +
! Variable
 +
! Description
 +
! Notes
 +
|-
 +
|style="width: 100px;" | string (32)|| style="width: 100px;" | idSession || style="width: 200px" | Session ID  || style="width: 300px" |
 +
|-
 +
|string (255)|| domain|| Domain name ||
 +
|-
 +
|string (255) ||subdomain || Sub domain  ||
 +
|-
 +
|string ||type|| Type of DNS record || ''A / AAAA / MX / CNAME / TXT / NS / SRV''
 +
|-
 +
|string (150) ||value|| Value of the new DNS record ||
 +
|-
 +
|[[StructOptionsZone]] ||options|| Settings of the new DNS record||
 +
|}
 +
 +
List of DNS record types and acceptable values
 +
 +
{| class="wikitable" style="width: 700px;"
 +
! Type
 +
! Value
 +
|-
 +
|style="width: 100px;" | A || style="width: 150px" | IPv4 Address
 +
|-
 +
|AAAA|| IPv6  Address
 +
|-
 +
|MX || fully qualified domain name of the mailserver
 +
|-
 +
|CNAME || fully qualified domain name
 +
|-
 +
|NS|| fully qualified domain name of the DNS server
 +
|}
 +
 +
 +
'''Return'''
 +
 +
A structure [[StructOperationResponse]]
 +
 +
 +
'''Notes'''
 +
 +
none
 +
 +
 +
== Examples ==
 +
 +
''' PHP '''
 +
<source lang="php">
 +
<?php
 +
$clientSOAP = new SoapClient("http://URL.wsdl");
 +
$structOptionsZone = array('service' => '', 'protocol' => '', 'ttl' => '', 'priority' => '', 'weight' => '', 'port' => '');
 +
 +
try
 +
{
 +
      $idSession = $clientSOAP->sessionOpen("XXXX", "XXXX", "EN");     
 +
      $StructOperationResponse = $clientSOAP->domainZoneCreate($idSession, "netim.com", "www", "A", "192.168.0.1", $structOptionsZone);
 +
     
 +
      print_r($StructOperationResponse);
 +
}
 +
catch(SoapFault $fault)
 +
{
 +
      echo "Exception : " .$fault->getMessage(). "\n";
 +
}
 +
 +
if (isset($idSession))
 +
{
 +
      $clientSOAP->sessionClose($idSession);
 +
}
 +
?>
 +
</source >
 +
 +
 +
</tab>
 +
<tab name="API Version 1 (Deprecated)">
 +
 
{| class="wikitable" style="width: 200px;"
 
{| class="wikitable" style="width: 200px;"
 
! Release
 
! Release
Line 70: Line 170:
 
<?php
 
<?php
 
$clientSOAP = new SoapClient("http://URL.wsdl");
 
$clientSOAP = new SoapClient("http://URL.wsdl");
$structOptionsZone = array();
+
$structOptionsZone = array('service' => '', 'protocol' => '', 'ttl' => '', 'priority' => '', 'weight' => '', 'port' => '');  
  
 
try
 
try
 
{
 
{
       $idSession = $clientSOAP−>login("XXXX", "XXXX", "EN");       
+
       $idSession = $clientSOAP->login("XXXX", "XXXX", "EN");       
       $trackingID = $clientSOAP−>domainZoneCreate($idSession, "netim.com", "www", "A", "192.168.0.1", $structOptionsZone);
+
       $trackingID = $clientSOAP->domainZoneCreate($idSession, "netim.com", "www", "A", "192.168.0.1", $structOptionsZone);
 
        
 
        
 
       echo($trackingID);
 
       echo($trackingID);
Line 81: Line 181:
 
catch(SoapFault $fault)
 
catch(SoapFault $fault)
 
{
 
{
       echo "Exception : " .$fault−>getMessage(). "\n";
+
       echo "Exception : " .$fault->getMessage(). "\n";
 
}
 
}
  
 
if (isset($idSession))
 
if (isset($idSession))
 
{
 
{
       $clientSOAP−>logout($idSession);
+
       $clientSOAP->logout($idSession);
 
}
 
}
 
?>
 
?>
Line 118: Line 218:
 
}  
 
}  
 
</source>
 
</source>
 +
 +
</tab>
 +
</tabs>

Latest revision as of 14:52, 2 August 2017


Release Runtime
API >= 2.0 Synchronous


Description

Creates a DNS record into the domain zonefile

StructOperationResponse domainZoneCreate(string idSession, string domain, string subdomain, string type, string value, StructOptionsZone options) 


Parameters

Format Variable Description Notes
string (32) idSession Session ID
string (255) domain Domain name
string (255) subdomain Sub domain
string type Type of DNS record A / AAAA / MX / CNAME / TXT / NS / SRV
string (150) value Value of the new DNS record
StructOptionsZone options Settings of the new DNS record

List of DNS record types and acceptable values

Type Value
A IPv4 Address
AAAA IPv6 Address
MX fully qualified domain name of the mailserver
CNAME fully qualified domain name
NS fully qualified domain name of the DNS server


Return

A structure StructOperationResponse


Notes

none


[edit] Examples

PHP

<?php
$clientSOAP = new SoapClient("http://URL.wsdl");
$structOptionsZone = array('service' => '', 'protocol' => '', 'ttl' => '', 'priority' => '', 'weight' => '', 'port' => ''); 
 
try
{
      $idSession = $clientSOAP->sessionOpen("XXXX", "XXXX", "EN");      
      $StructOperationResponse = $clientSOAP->domainZoneCreate($idSession, "netim.com", "www", "A", "192.168.0.1", $structOptionsZone);
 
      print_r($StructOperationResponse);
}
catch(SoapFault $fault)
{
      echo "Exception : " .$fault->getMessage(). "\n";
}
 
if (isset($idSession))
{
      $clientSOAP->sessionClose($idSession);
}
?>


Release Runtime
API > 1.0 Synchronous


Description

Creates a DNS record into the domain zonefile

int domainZoneCreate(string idSession, string domain, string subdomain, string type, string value, StructOptionsZone options) 


Parameters

Format Variable Description Notes
string (32) idSession Session ID
string (255) domain Domain name
string (255) subdomain Sub domain
string type Type of DNS record A / AAAA / MX / CNAME / TXT / NS / SRV
string (150) value Value of the new DNS record
StructOptionsZone options Settings of the new DNS record

List of DNS record types and acceptable values

Type Value
A IPv4 Address
AAAA IPv6 Address
MX fully qualified domain name of the mailserver
CNAME fully qualified domain name
NS fully qualified domain name of the DNS server


Return

A tracking number


Notes

none


[edit] Examples

PHP

<?php
$clientSOAP = new SoapClient("http://URL.wsdl");
$structOptionsZone = array('service' => '', 'protocol' => '', 'ttl' => '', 'priority' => '', 'weight' => '', 'port' => ''); 
 
try
{
      $idSession = $clientSOAP->login("XXXX", "XXXX", "EN");      
      $trackingID = $clientSOAP->domainZoneCreate($idSession, "netim.com", "www", "A", "192.168.0.1", $structOptionsZone);
 
      echo($trackingID);
}
catch(SoapFault $fault)
{
      echo "Exception : " .$fault->getMessage(). "\n";
}
 
if (isset($idSession))
{
      $clientSOAP->logout($idSession);
}
?>


JAVA

DRSServiceLocator service = new DRSServiceLocator();
String idSession;
int trackingID;
StructOptionsZone structOptionsZone = new StructOptionsZone();
 
try
{
      DRSPortType port = service.getDRSPort();
      idSession = port.login("XXXX", "XXXX", "EN");
 
      trackingID = port.domainZoneCreate(idSession, "netim.com", "www", "A", "192.168.0.1", structOptionsZone);
      System.out.println(trackingID);
 
      port.logout(idSession);
}
catch (RemoteException re)
{
      System.out.println(re.getMessage());
}
catch (ServiceException se)
{
      se.printStackTrace();
}
Personal tools
Namespaces

Variants
Actions
Your account
Domain names
Shared Hosting
Old Hosting offers
SSL Certificates
Resellers
Affiliates
Contact Us
Miscellaneous