View source for HostUpdate

[[Category:Functions]]


<tabs>
<tab name="API Version 2 (Recommended)">

{| class="wikitable" style="width: 200px;"
! Release
! Runtime
|-
|API >= 2.0||	Synchronous
|}


'''Description'''

Updates a host at the registry

 [[StructOperationResponse]] hostUpdate(string idSession, string host, string[] ipv4, string[] ipv6)


'''Parameters'''
{| class="wikitable" style="width: 800px;"
! Format
! Variable
! Description
! Notes
|-
|style="width: 100;" | string (32)|| style="width: 100;" | idSession || style="width: 200;" | Session ID || style="width: 400;" |
|-
|string (255)||	host ||	hostname || ''exemple : "ns1.example.com" 
|-
|ArrayOfString||	ipv4  ||	Array of new IPv4 addresses|| 
|-
|ArrayOfString||	ipv6  ||	Array of new IPv6 addresses || 
|}


'''Return'''

 A structure [[StructOperationResponse]]


'''Notes'''

 At least one IP address must be provided (either IPv4 either IPv6)



== Examples ==

''' PHP '''
<source lang="php">
<?php 
$clientSOAP = new SoapClient("http://URL.wsdl");
$host = "xxx.example.com"; 
$ipv4 = array("192.134.0.129", "192.5.4.2", "194.0.9.1"); 
$ipv6 = array("2001:660:3006:4:0:0:1:1", "2001:500:2e:0:0:0:0:2", "2001:678:c:0:0:0:0:1"}); 

try 
{ 
      $idSession = $clientSOAP->sessionOpen("XXXX", "XXXX", "EN"); 
      $StructOperationResponse = $clientSOAP->hostUpdate($idSession, $host, $ipv4, $ipv6); 
       
      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;"
! Release
! Runtime
|-
|API > 1.33||	Asynchronous
|}


'''Description'''

Updates a host at the registry

 int hostUpdate(string idSession, string host, string[] ipv4, string[] ipv6)


'''Parameters'''
{| class="wikitable" style="width: 800px;"
! Format
! Variable
! Description
! Notes
|-
|style="width: 100;" | string (32)|| style="width: 100;" | idSession || style="width: 200;" | Session ID || style="width: 400;" |
|-
|string (255)||	host ||	hostname || ''exemple : "ns1.example.com" 
|-
|ArrayOfString||	ipv4  ||	Array of new IPv4 addresses|| 
|-
|ArrayOfString||	ipv6  ||	Array of new IPv6 addresses || 
|}


'''Return'''

 A tracking ID


'''Notes'''

 At least one IP address must be provided (either IPv4 either IPv6)



== Examples ==

''' PHP '''
<source lang="php">
<?php 
$clientSOAP = new SoapClient("http://URL.wsdl");
$host = "xxx.example.com"; 
$ipv4 = array("192.134.0.129", "192.5.4.2", "194.0.9.1"); 
$ipv6 = array("2001:660:3006:4:0:0:1:1", "2001:500:2e:0:0:0:0:2", "2001:678:c:0:0:0:0:1"}); 

try 
{ 
      $idSession = $clientSOAP->login("XXXX", "XXXX", "EN"); 
      $trackingID = $clientSOAP->hostUpdate($idSession, $host, $ipv4, $ipv6); 
       
      echo($trackingID); 
} 
catch(SoapFault $fault) 
{ 
      echo "Exception : " .$fault->getMessage(). "\n"; 
} 

if(isset($idSession)) 
{ 
      $clientSOAP->logout($idSession); 
} 
?>
</source >


''' JAVA'''
<source lang="java">
DRSServiceLocator service = new DRSServiceLocator(); 
String idSession; 
int trackingID; 
String host = "xxx.example.com"; 
String ipv4[] = {"192.134.0.129", "192.5.4.2", "194.0.9.1"}; 
String ipv6[] = {"2001:660:3006:4:0:0:1:1", "2001:500:2e:0:0:0:0:2", "2001:678:c:0:0:0:0:1"}; 

try 
{ 
      DRSPortType port = service.getDRSPort(); 
      idSession = port.login("XXXX", "XXXX", "EN"); 

      trackingID = port.hostUpdate(idSession, host, ipv4[], ipv6[]); 
      System.out.println(trackingID); 

      port.logout(idSession); 
} 
catch (RemoteException re) 
{ 
      System.out.println(re.getMessage()); 
} 
catch (ServiceException se) 
{ 
      se.printStackTrace(); 
}
</source>


</tab>
</tabs>