Cisco Cisco Prime Network Registrar 8.1 Technical References
ModifyBlock
Cisco Prime Network Registrar IPAM 8.1.1 CLI and API Guide
203
Element
Description
Modify?
Return
Code
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>
<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>