available.]]></HELP_STR_2></ITEM><ITEM><ID>0x002D25CE</ID><VALUE><![CDATA[Done]]>
</VALUE><NAME><![CDATA[DETAILEDSTATUS]]></NAME><HELP_STR_1><![CDATA[State of the current
Export Debug Support Data operation]]></HELP_STR_1><HELP_STR_2><![CDATA[This item has 6
options
available.]]></HELP_STR_2></ITEM><ITEM><ID>0x002D25CF</ID><VALUE><![CDATA[100]]></VALUE><NAME><![CDATA[PERCENTCOMPLETE]]></NAME><HELP_STR_1><![CDATA[Progress
of the current Export Debug Support Data operation as a
percent]]></HELP_STR_1><HELP_STR_2><![CDATA[Item attribute: min(0), max(100), step size(1),
unit()]]></HELP_STR_2></ITEM></RECORD></TABLE></HDR>
Expected output (example of when diagnostics package preparation fails, and detailed reason why it
failed):
<?xml version="1.0" encoding="ISO-8859-1"
?><HDR><TABLE><RECORD><ITEM><ID>0x002D25CD</ID><VALUE><![CDATA[Fail]]></VALUE><NAME><![CDATA[OPERSTATUS]]></NAME><HELP_STR_1><![CDATA[Indicates
whether the most recent operation passed, failed, or is in
progress]]></HELP_STR_1><HELP_STR_2><![CDATA[This item has 3 options
available.]]></HELP_STR_2></ITEM><ITEM><ID>0x002D25CE</ID><VALUE><![CDATA[Lock level too
high for Export Debug Support Data
operation]]></VALUE><NAME><![CDATA[DETAILEDSTATUS]]></NAME><HELP_STR_1><![CDATA[State of
the current Export Debug Support Data operation]]></HELP_STR_1><HELP_STR_2><![CDATA[This
item has 6 options
available.]]></HELP_STR_2></ITEM><ITEM><ID>0x002D25CF</ID><VALUE><![CDATA[20]]></VALUE><NAME><![CDATA[PERCENTCOMPLETE]]></NAME><HELP_STR_1><![CDATA[Progress
of the current Export Debug Support Data operation as a
percent]]></HELP_STR_1><HELP_STR_2><![CDATA[Item attribute: min(0), max(100), step size(1),
unit()]]></HELP_STR_2></ITEM></RECORD></TABLE></HDR>
Client software is expected to poll the status by calling this API every 5 seconds, while the Inprogress state
is active, and until the OPERSTATUS is Pass and the PERCENTCOMPLETE is 100 or the OPERSTATUS
is Fail. The first call should wait a minimum of 10 seconds, after the diagnostics trigger API, to allow the
internal states to clear. If, at any time, the OPERSTATUS is Fail, then the client software should abort additional
checking and report the last DETAILEDSTATUS.
Diagnostics Package Retrieval Command
Table 13: Command Details
Description
Command Detail
https://192.168.0.1/ws/v1/diagnostics
Command URL
Retrieves the diagnostics package file.
Command Information
GET
HTTP Method
Read
Access Type
User, Admin
Restricted to Lock Level 0 only.
Access Level
Options:
NA
Example of issuing the diagnostics package retrieval command:
Input:
curl -k -H "X-SESSION-ID: $token" "https://192.168.0.1/ws/v1/diagnostics" -o diagnostics
Expected output (example for success case, which indicates that Diag Package Retrieval was completed)
:
% Total
% Received % Xferd
Average Speed
Time
Time
Time
Current
Dload
Upload
Total
Spent
Left
Speed
Cisco D9800 Network Transport Receiver Version 2.75 RESTful Web Services API Reference Guide
24
API Definitions
Diagnostics Package (Export Debug File) Commands