Cisco Cisco Prime Network Registrar 8.1 Technical References

Page of 316
ModifyBlock 
Cisco Prime Network Registrar IPAM 8.1.1 CLI and API Guide 
     203 
Element 
Description 
Modify? 
Return 
Code 
Fault String 
userDefinedFields 
Array of user defined fields.  
Each element in the array has the 
format “name=value” where 
“name” is the UDF tag name. 
Yes 
-63 
 
-64 
Invalid UDF 
 
Missing Required 
UDF 
ignoreErrors 
Flag, when set to true will cause 
the system to ignore any errors 
associated with reparenting a 
block from a container with a 
container/blocktype information 
template to a container without.  
No 
 
 
Reparenting a Block via Modify Block API 
A block may be reparented by specifying a target container name different than the current 
parent container name.  In the case of reparenting blocks contained in device containers, a 
target interface name must also be provided.  To reparent a block, use this call in 
conjunction with the 
GetBlock
 API (page 211) calls.  First, retrieve the block using a 
GetBlock
 call. Then, modify the returned structure, setting the new container name and 
in the case of device container, the new interface name.  Lastly, pass that modified 
structure to the 
ModifyBlock
 API. 
Note:  
ModifyBlock
 either reparents, when a new container name different than the 
current parent container has been specified, 
or modifies the block without a reparent.  
Both cannot be performed during the same modify block invocation. 
Modifying Block Subnet Policies 
Use the subnet field and 
WSSubnetPolicy
 structure to specify changes to block subnet 
policies. 
WSSubnetPolicy 
Below is the portion of 
Imports.wsdl that describes 
WSSubnetPolicy
, the structure passed 
in 
WSGenericBlock
 as “subnet”. The elements are described in the table that follows.  
<complexType name="WSSubnetPolicy"> 
<sequence> 
  <element name="DHCPOptionsSet" nillable="true" type="soapenc:string" />  
  <element name="DHCPPolicySet" nillable="true" type="soapenc:string" />  
  <element name="DNSServers" nillable="true" 
           type="impl:ArrayOf_soapenc_string" />  
  <element name="defaultGateway" nillable="true" type="soapenc:string" />  
  <element name="failoverDHCPServer" nillable="true" type="soapenc:string" />  
<element name="forwardDomainTypes" nillable="true" type="impl:ArrayOf_soapenc_string"/> 
  <element name="forwardDomains" nillable="true" 
           type="impl:ArrayOf_soapenc_string" />  
  <element name="primaryDHCPServer" nillable="true" type="soapenc:string" />  
  <element name="primaryWINSServer" nillable="true" type="soapenc:string" />  
<element name="reverseDomainTypes" nillable="true" type="impl:ArrayOf_soapenc_string"/> 
  <element name="reverseDomains" nillable="true" type="impl:ArrayOf_soapenc_string" />  
 </sequence> 
</complexType>