Cisco Cisco Evolved Programmable Network Manager 2.0 Developer's Guide

 
MTOSI Interface Details 
 

 

 

 

 

 

Cisco EPN Manager 2.0 MTOSI API Guide for OSS Integration  

 

 

79 

ELAN 

EP-LAN 
EVP-LAN 

E-Tree 

EP-Tree 
EVP-Tree 

E-Access 

Access EPL 
Access EVPL 

 

In EPNM, all the MTOSI APIs return error messages as SOAP Faults. In case of Service Activation APIs 
(Provisioning API), SOAP fault message contains additional detail element to provide more details about the 
error.  This  details contains MTOSI specific error elements structure (internalError, NotImplementedError, 
etc) that contains EPNM specific error element to show the error details with error code and text message in 
the vendor extensions as shown below 
 

<soap:Fault> 
      <faultcode>soap:Server</faultcode> 
      <faultstring>Invalid Port reference for Device ID - TerminationPoint not found with FDN 
[MD=CISCO_EPNM, ME=ASR903-165.68, 
FTP=name=GigabitEthernet0/4/3;LR=LR_ETHERNET]</faultstring> 
      <detail> 
        <ns3:provisionException> 
          <ns3:basicFailureEvent> 
            <ns16:internalError> 
              <ns16:vendorExtensions> 
                <ns27:error> 
                  <ns27:code>MTOSI_0000</ns27:code> 
                  <ns27:message>Invalid Port reference for Device ID - TerminationPoint not found with 
FDN [MD=CISCO_EPNM, ME=ASR903-165.68, 
FTP=name=GigabitEthernet0/4/3;LR=LR_ETHERNET]</ns27:message> 
                </ns27:error> 
              </ns16:vendorExtensions> 
            </ns16:internalError> 
          </ns3:basicFailureEvent> 
        </ns3:provisionException> 
      </detail> 
    </soap:Fault> 

 
Content of the error element in the vendor extensions  has the follow elements for error details 
code - error code to identify the type of error - a programming interface to the api can use this to further 
process the error based on the code according to the OSS integration requirement. 
message - error message that is human readable text to describe the error. 

 
In case of provisioning  configuration (cli) deployment failures where the operation response is not a SOAP 
Fault,  the error code and message are returned in the  deployResult element of the response.