Cisco Cisco Prime Network Registrar 8.1 Technical References

Page of 316
ImportNetElement 
Cisco Prime Network Registrar IPAM 8.1.1 CLI and API Guide 
188 
ImportNetElement 
Overview 
The 
ImportNetElement
 API enables the web service client to import network elements 
into Cisco Prime Network Registrar IPAM. 
Request and Response Messages 
Below is the portion of 
Imports.wsdl that describes the 
importNetElement
 request and 
response messages. 
<wsdl:message name="importNetElementRequest"> 
  <wsdl:part name="elementArray" type="impl:ArrayOf_soapenc_string" />  
</wsdl:message> 
<wsdl:message name="importNetElementResponse"> 
  <wsdl:part name="importNetElementReturn" type="soapenc:string" />  
</wsdl:message> 
Response 
The string returned in the response contains the name of the network element allocated, 
for example, “Saved netelement: 
name”. 
Request 
The string array that is passed as input from the client to the web service is described in 
the next section. 
Parameters 
String Array 
The elements of the string array are described below. Note that the 
returnCode
 tag is 
not used for this call. When an error occurs, the faultcode will be 
Server.userException
, with the faultstrings shown below. 
Element 
Description 
Accepted Values 
Required 
Return 
Code 
Faultstring 
0               Name 
The name of the Network 
Element. This can be any 
combination of letters and 
numbers. 
Yes 
 
Duplicate name 
for Netelement: 
name 
1              IP Address 
The IP address or fully-
qualified domain name 
(FQDN) of the Network 
Element. This must be a valid 
IPv4 or IPv6 IP address, or a 
full-qualified host name. 
Yes 
 
 
2              Vendor 
The vendor of the Network 
Element. Vendor must be 
predefined in Cisco Prime 
Network Registrar IPAM. If 
not specified, defaults to 
Unknown.   
Yes when 
Model is 
specified. 
 
no models found 
for given 
description: 
description 
deviceName: 
name
vendorName: 
vendor 
3              Model 
The model name of the 
Yes when 
 
same as above