Cisco Cisco Configuration Engine 3.5 Entwickleranleitung

Seite von 344
5-30
Cisco Configuration Engine Software Development Kit API Reference and Programmer Guide 3.5
OL-17661-02
Chapter 5      Web Services: Admin, Config, Image, Exec, NSM
Depreciated Image Web Service
<description xsi:type="xsd:string">web svc dist &amp; act
evaluation</description>
<distribution xsi:type="xsd:boolean">true</distribution>
<evalutaion xsi:type="xsd:boolean">true</evalutaion>
<imageIds xsi:type="xsd:string">c7200-2</imageIds>
</multiRef>
Any SOAP toolkit should be able to auto-map these into an object or stub appropriate for use in the client 
domain. In the Java example, xsi:type="ns2:JobDTO" maps to the Javabean JobDTO.java with the 
following properties:
boolean distribution;
boolean activation;
boolean evaluation;
int batchSize;
Calendar date;
String description;
String[] imageIds;
Notes
  •
For users of the EFT version of this Web service, note that groups are now hierarchical. For example, 
the group default in earlier releases of Cisco Configuration Engine is now addressed as 
/config/default.
  •
Device configuration templates must be hosted on a Web server. Configuration templates (used only 
if a configuration change is needed when activating a new image) for devices must be hosted on a 
Web server accessible over HTTP from the server.
  •
When stopping jobs, note that the server can only prevent the next queued operations from being 
submitted, but might not be able to cancel the currently executing operation for each of the devices 
in the job. For example, once a device reload is in progress, there is no way to terminate the reload 
and the server is helpless to prevent the impending activation. However, if during a job that involves 
a distribution and activation, if the stop is submitted during the distribution phase, the activation can 
be prevented.
Example Scenarios
Note
These examples have not been updated for Cisco Configuration Engine because this service has been 
depreciated. All users are STRONGLY encouraged to utilize the newer ImageService. This service is 
only provided for backward compatibility with specific customers.
A scenario that exercises all Web Service methods is described below, from creating devices and image 
associations to submitting distribution jobs and querying their status, etc. The names used are only for 
the purposes of this example. They are referenced in some sample bulkupload XML files which are also 
provided.