serviceability-dotnet-samples

Overview

These C# samples demonstrate how to use DotNet Core packages to interact with CUCM Serviceability APIs

Tested using:

selectCmDeviceExt_HttpClient - Risport selectCmDeviceExt sample script, using DotNet Core HttpClient. Filters by device name, passing in two specific device names (<selectCmDeviceExt>)
perfmonCollectCounterData - Demonstrates retrieving/parsing the performance counter data from a specific object, in this case all Hunt Pilots. (<perfmonCollectCounterData>)

From a terminal, use git to clone this repo to your PC, then change into the new directory:

git clone https://www.github.com/CiscoDevNet/serviceability-dotnet-samples
cd serviceability-dotnet-samples

Install the CUCM Tomcat web service API HTTPS certificate:

Download the certificate from your target CUCM server:

echo -n | openssl s_client -connect ds-ucm1251.cisco.com:8443 | sed -ne '/-BEGIN CERTIFICATE-/,/-END CERTIFICATE-/p' > cucm.crt

Copy it to the local certificate trust store directory:
```
sudo cp cucm.crt /usr/local/share/ca-certificates/
```
Update the OS certificate trust list:
```
sudo update-ca-certificates
```

Install needed DotNet dependencies:
```
dotnet restore
```
Open the project directory in Visual Studio Code:
```
code .
```
Rename .env.example to .env, and edit it to specify your CUCM address and API user credentials (be sure to save the file!)

Roles required per Serviceability APIs:
- Risport
  - Standard CCM Admin Users (provides access to the CCMAdmin domain, but not to the CCMAdmin web UI)
  - Standard SERVICEABILITY Read Only
To run a specific sample, open the Run tab in VS Code, select the sample from the launch dropdown, and click the green Start Debugging arrow (or press F5)

To enable printing debug output of the request/response body, set Debug=True in .env