Cisco D9800 User Manual

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
DescriptionCommand Detail
https://192.168.0.1/ws/v1/diagnosticsCommand URL
Retrieves the diagnostics package file.Command Information
GETHTTP Method
ReadAccess 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

Cisco D9800 Specifications

General

Brand	Cisco
Model	D9800
Category	Receiver
Language	English