This page provides links to Swagger documentation for the WaveSuite Health & Analytics product.
To understand the execution of WaveSuite H&A workflows in detail, see How To WS-HA.
To view the list of new APIs, deleted/deprecated APIs, and changed APIs for 25.6 release, see:
| Request Method | API Path | Deleted in Release | Alternate API with same Request Method |
|---|---|---|---|
| GET | /api/v1/alarm-configs/{alarmConfigId} | 25.12 | NA |
| PUT | /api/v1/alarm-configs/{alarmConfigId} | 25.12 | NA |
| DELETE | /api/v1/alarm-configs/{alarmConfigId} | 25.12 | NA |
| POST | /api/v1/network-ports/clear-alarm-profile/bulk | 25.12 | NA |
| POST | /api/v1/network-ports/apply-alarm-profile/{alarmProfileId}/bulk | 25.12 | NA |
| POST | /api/v1/network-elements/clear-alarm-profile/bulk | 25.12 | NA |
| POST | /api/v1/network-elements/apply-alarm-profile/{alarmProfileId}/bulk | 25.12 | NA |
| POST | POST/api/v1/network-cards/clear-alarm-profile/bulk | 25.12 | NA |
| POST | /api/v1/network-cards/apply-alarm-profile/{alarmProfileId}/bulk | 25.12 | NA |
| GET | /api/v1/alarm-configs/{alarmConfigId}/alarm-profiles | 25.12 | NA |
| PUT | /api/v1/alarm-profiles/{alarmProfileId} | 25.12 | NA |
| DELETE | /api/v1/alarm-profiles/{alarmProfileId} | 25.12 | NA |
| POST | /api/v1/alarm-profiles | 25.12 | NA |
| POST | /api/v1/alarm-profiles/{alarmProfileId}/alarm-configs | 25.12 | NA |
| POST | /api/v1/alarm-configs | 25.12 | NA |
To understand the execution of WaveSuite H&A workflows in detail, see How To WS-HA.
To view the list of new APIs, deleted/deprecated APIs, and changed APIs for 25.6 release, see:
| Request Method | API Path | Deprecated in Release | Support Discontinued from the Release | Alternate API with same Request Method |
|---|---|---|---|---|
| POST | /api/v1/network-connections/{connectionId}/apply-alarm-profile | 25.6 | 26.6 | /api/v1/services/{serviceId}/apply-alarm-profile |
| POST | /api/v1/network-connections/{connectionId}/clear-alarm-profile | 25.6 | 26.6 | /api/v1//services/{serviceId}/clear-alarm-profile |
| GET | /api/v1/network-connections/{connectionId}/legend-data | 25.6 | 26.6 | /api/v1/services/{serviceId}/legend-data |
| PUT | /api/v1/network-connections/{connectionId}/network-groups | 25.6 | 26.6 | /api/v1/services/{serviceId}/network-groups |
| POST | /api/v1/network-connections/{connectionId}/network-groups | 25.6 | 26.6 | /api/v1/services/{serviceId}/network-groups |
| DELETE | /api/v1/network-connections/{connectionId}/network-groups | 25.6 | 26.6 | /api/v1/services/{serviceId}/network-groups |
| GET | /api/v1/network-external-links/{externalLinkId}/legend-data | 25.6 | 26.6 | /api/v1/physical-connections/{physicalConnectionId}/legend-data |
| PUT | /api/v1/network-external-links/{externalLinkId}/network-groups | 25.6 | 26.6 | /api/v1/physical-connections/{physicalConnectionId}/network-groups |
| POST | /api/v1/network-external-links/{externalLinkId}/network-groups | 25.6 | 26.6 | /api/v1/physical-connections/{physicalConnectionId}/network-groups |
| DELETE | /api/v1/network-external-links/{externalLinkId}/network-groups | 25.6 | 26.6 | /api/v1/physical-connections/{physicalConnectionId}/network-groups |
| POST | /api/v1/network-groups/{networkGroupId}/network-connections | 25.6 | 26.6 | /api/v1/network-groups/{networkGroupId}/services |
| DELETE | /api/v1/network-groups/{networkGroupId}/network-connections | 25.6 | 26.6 | /api/v1/network-groups/{networkGroupId}/services |
| POST | /api/v1/network-groups/{networkGroupId}/network-external-links | 25.6 | 26.6 | /api/v1/network-groups/{networkGroupId}/physical-connections |
| DELETE | /api/v1/network-groups/{networkGroupId}/network-external-links | 25.6 | 26.6 | /api/v1/network-groups/{networkGroupId}/physical-connections |
| POST | /api/v1/network-groups/{networkGroupId}/network-lightpaths | 25.6 | 26.6 | /api/v1/network-groups/{networkGroupId}/lightpaths |
| DELETE | /api/v1/network-groups/{networkGroupId}/network-lightpaths | 25.6 | 26.6 | /api/v1/network-groups/{networkGroupId}/lightpaths |
| GET | /api/v1/network-lightpaths/{lightpathId}/legend-data | 25.6 | 26.6 | /api/v1/lightpaths/{lightpathId}/legend-data |
| PUT | /api/v1/network-lightpaths/{lightpathId}/network-groups | 25.6 | 26.6 | /api/v1/lightpaths/{lightpathId}/network-groups |
| POST | /api/v1/network-lightpaths/{lightpathId}/network-groups | 25.6 | 26.6 | /api/v1/lightpaths/{lightpathId}/network-groups |
| DELETE | /api/v1/network-lightpaths/{lightpathId}/network-groups | 25.6 | 26.6 | /api/v1/lightpaths/{lightpathId}/network-groups |
| POST | /api/v1/network-managers/{networkManagerId}/reset-alarm-profiles | 25.6 | 26.6 | /api/v1/networks/{networkId}/reset-alarm-profiles |
| GET | /api/v1/network-ports/{portId}/alarm-statuses/summary | 25.6 | 26.6 | NA |
| GET | /api/v1/network-connections/connection-trends | 25.6 | 26.6 | /api/v1/services/trends |
| GET | /api/v1/network-connections/connection-trends/overview | 25.6 | 26.6 | /api/v1/services/trends/overview |
| GET | /api/v1/network-connections/overview | 25.6 | 26.6 | /services/overview |
| GET | /api/v1/network-connections/{connectionId}/network-lightpaths/overview | 25.6 | 26.6 | /api/v1/services/{serviceId}/lightpaths/overview |
| GET | /api/v1/network-connections/{connectionId}/network-ports/overview | 25.6 | 26.6 | /api/v1/services/{serviceId}/network-ports/overview |
| GET | /api/v1/network-connections/{connectionId}/overview | 25.6 | 26.6 | /api/v1/services/{serviceId}/overview |
| GET | /api/v1/network-elements/{elementId}/network-connections/overview | 25.6 | 26.6 | /api/v1/network-elements/{elementId}/services/overview |
| GET | /api/v1/network-external-links/{externalLinkId}/network-lightpaths/overview | 25.6 | 26.6 | /api/v1/physical-connections/{physicalConnectionId}/lightpaths/overview |
| GET | /api/v1/network-external-links/{externalLinkId}/overview | 25.6 | 26.6 | /api/v1/physical-connections/{physicalConnectionId}/overview |
| GET | /api/v1/network-groups/{networkGroupId}/network-connections/overview | 25.6 | 26.6 | /api/v1/network-groups/{networkGroupId}/services/overview |
| GET | /api/v1/network-groups/{networkGroupId}/network-external-links/overview | 25.6 | 26.6 | /api/v1/network-groups/{networkGroupId}/physical-connections/overview |
| GET | /api/v1/network-groups/{networkGroupId}/network-lightpaths/overview | 25.6 | 26.6 | /api/v1/network-groups/{networkGroupId}/lightpaths/overview |
| GET | /api/v1/network-lightpaths/lightpath-trends/overview | 25.6 | 26.6 | /api/v1/lightpaths/trends/overview |
| GET | /api/v1/network-lightpaths/overview | 25.6 | 26.6 | /api/v1/network-lightpaths/overview |
| GET | /api/v1/network-lightpaths/{lightpathId}/network-connections/overview | 25.6 | 26.6 | /api/v1/lightpaths/{lightpathId}/services/overview |
| GET | /api/v1/network-lightpaths/{lightpathId}/network-external-links/overview | 25.6 | 26.6 | /api/v1/lightpaths/{lightpathId}/physical-connections/overview |
| GET | /api/v1/network-lightpaths/{lightpathId}/network-ports/overview | 25.6 | 26.6 | /api/v1/lightpaths/{lightpathId}/network-ports/overview |
| GET | /api/v1/network-lightpaths/{lightpathId}/overview | 25.6 | 26.6 | /api/v1/lightpaths/{lightpathId}/overview |
| GET | /api/v1/network-managers | 25.6 | 26.6 | /api/v1/networks |
| GET | /api/v1/network-managers/{networkManagerId} | 25.6 | 26.6 | /api/v1/networks/{networkId} |
| PUT | /api/v1/network-managers/{networkManagerId} | 25.6 | 26.6 | /api/v1/networks/{networkId} |
| GET | /api/v1/network-managers/{networkManagerId}/forecasted-kpis/{measurement} | 25.6 | 26.6 | NA |
| GET | /api/v1/network-managers/{networkManagerId}/kpis/{measurement} | 25.6 | 26.6 | /api/v1/networks/{networkId}/kpis/{measurement} |
| GET | /api/v1/network-managers/{networkManagerId}/kpis/{measurement}/histogram | 25.6 | 26.6 | /api/v1/network-ports/{portId}/kpis/{measurement}/histogram |
| GET | /api/v1/network-managers/{networkManagerId}/kpis/{measurement}/summary | 25.6 | 26.6 | /api/v1/network-ports/{portId}/kpis/{measurement}/summary |
| GET | /api/v1/network-managers/{networkManagerId}/network-element-filter-rules | 25.6 | 26.6 | /api/v1/networks/{networkId}/network-element-filter-rules |
| GET | /api/v1/network-ports/{portId}/network-connections/overview | 25.6 | 26.6 | /api/v1/network-ports/{portId}/services/overview |
| GET | /api/v1/network-ports/{portId}/network-lightpaths/overview | 25.6 | 26.6 | /api/v1/network-ports/{portId}/lightpaths/overview |
| GET | /api/v1/reports/{reportDefinitionId}/target-connections | 25.6 | 26.6 | /api/v1/reports/{reportDefinitionId}/target-services |
| GET | /api/v1/reports/{reportDefinitionId}/target-connections/overview | 25.6 | 26.6 | /api/v1/reports/{reportDefinitionId}/target-services/overview |
| GET | /api/v1/reports/{reportDefinitionId}/target-external-links | 25.6 | 26.6 | /api/v1/reports/{reportDefinitionId}/target-physical-connections |
| GET | /api/v1/reports/{reportDefinitionId}/target-external-links/overview | 25.6 | 26.6 | /api/v1/reports/{reportDefinitionId}/target-external-links/overview |
To understand the execution of WaveSuite H&A workflows in detail, see How To WS-HA.
| Endpoint label | Endpoint name | Change |
|---|---|---|
| Returns all data sources | GET /api/v1/data-sources | These endpoints are removed from the DataSource API set in the WaveSuite Health & Analytics API. |
| Creates a single data source instance | POST /api/v1/data-sources | |
| Deletes a data source instance | DELETE /api/v1/data-sources/{dataSourceId} | |
| Returns a single data source instance | GET /api/v1/data-sources/{dataSourceId} | |
| Updates a data source instance | PUT /api/v1/data-sources/{dataSourceId} | |
| Returns the list of data source interfaces associated to a single data source instance | GET /api/v1/data-sources/{dataSourceId}/data-source-interfaces | |
| Associates a data source instance to a list of data source interfaces | POST /api/v1/data-sources/{dataSourceId}/data-source-interfaces | |
| Deletes a data source interface instance | DELETE /api/v1/data-source-interfaces/{dataSourceInterfaceId} | |
| Returns a single data source interface instance | GET /api/v1/data-source-interfaces/{dataSourceInterfaceId} | |
| Updates a data source interface instance | PUT /api/v1/data-source-interfaces/{dataSourceInterfaceId} | |
| Returns the list of data sources configured to use a single data source interface instance | GET /api/v1/data-source-interfaces/{dataSourceInterfaceId}/data-sources | |
| Associates a data source interface instance to a list of data sources | POST /api/v1/data-source-interfaces/{dataSourceInterfaceId}/data-sources | |
| Returns the list of current status of a data source instance for a particular interface | GET /api/v1/data-sources/{dataSourceId}/data-source-interfaces/ {dataSourceInterfaceId}/status | |
| Test the reachability of the data source over a particular data source interface | POST /api/v1/data-sources/{dataSourceId}/data-source-interfaces/ {dataSourceInterfaceId}/test | |
| Get Network Cards | GET /wavesuite/ha/api/v1/network-cards | These endpoints are removed from the NetworkSet API set in the WaveSuite Health & Analytics API. |
| Save Network Card | POST /wavesuite/ha/api/v1/network-cards | |
| Delete the Network Card | DELETE /wavesuite/ha/api/v1/network-cards/{cardId} | |
| Get Network Card | GET /wavesuite/ha/api/v1/network-cards/{cardId} | |
| Update an existing Network Card | PUT /wavesuite/ha/api/v1/network-cards/{cardId} | |
| Get Network Elements | GET /wavesuite/ha/api/v1/network-elements | |
| Save Network Element | POST /wavesuite/ha/api/v1/ network-elements | |
| Get Network Ports by Network Element ID | GET /wavesuite/ha/api/v1/ network-elements/{elementId}/network-ports | |
| Get Network Cards by Network Element ID | GET /wavesuite/ha/api/v1/network-elements/{elementId}/network-cards | |
| Get Network Connections by Network Element ID | GET /wavesuite/ha/api/v1/network-elements/{elementId}/network-connections | |
| Get Network Lightpaths by Network Element ID | GET /wavesuite/ha/api/v1/ network-elements/{elementId}/network-lightpaths | |
| Get Network External Links by Network Element ID | GET /wavesuite/ha/api/v1/ network-elements/{elementId}/network-external-links | |
| Delete the Network Element | DELETE /wavesuite/ha/api/v1/ network-elements/{elementId} | |
| Get Network Element | GET /wavesuite/ha/api/v1/ network-elements/{elementId} | |
| Update an existing Network Element | PUT /wavesuite/ha/api/v1/ network-elements/{elementId} | |
| Revert location configuration to a group of network elements | POST /wavesuite/ha/api/v1/ network-elements/revert-location-config/bulk | |
| Get Network Ports | GET /wavesuite/ha/api/v1/ network-ports | |
| Save Network Port | POST /wavesuite/ha/api/v1/ network-ports | |
| Delete the Network Port | DELETE /wavesuite/ha/api/v1/ network-ports/{portId} | |
| Get Network Port | GET /wavesuite/ha/api/v1/ network-ports/{portId} | |
| Update an existing Network Port | PUT /wavesuite/ha/api/v1/ network-ports/{portId} | |
| Get Network Connections by Network Port ID | GET /wavesuite/ha/api/v1/ network-ports/{portId}/network-connections | |
| Get Network Lightpaths by Network Port ID | GET /wavesuite/ha/api/v1/ network-ports/{portId}/network-lightpaths | |
| Get Network Connections | GET /wavesuite/ha/api/v1/ network-connections | |
| Save Network Connections | POST /wavesuite/ha/api/v1/ network-connections | |
| Delete the Network Connection | DELETE /wavesuite/ha/api/v1/ network-connections/{connectionId} | |
| Get Network Connection | GET /wavesuite/ha/api/v1/ network-connections/{connectionId} | |
| Update an existing Network Connection | PUT /wavesuite/ha/api/v1/ network-connections/{connectionId} | |
| Get Network Ports by Network Connection ID | GET /wavesuite/ha/api/v1/ network-connections/{connectionId}/network-ports | |
| Create or update the list of Network Ports associated to the Network Connection | POST /wavesuite/ha/api/v1/ network-connections/{connectionId}/network-ports | |
| Get Network Elements by Network Connection ID | GET /wavesuite/ha/api/v1/ network-connections/{connectionId}/network-elements | |
| Get Network External Links by Network Connection ID | GET /wavesuite/ha/api/v1/ network-connections/{connectionId} /network-external-links | |
| Get Network Lightpaths by Network Connection ID | GET /wavesuite/ha/api/v1/ network-connections/{connectionId}/network-lightpaths | |
| Create or update the list of Network Lightpaths associated to the Network Connection | POST /wavesuite/ha/api/v1/ network-connections/{connectionId}/network-lightpaths | |
| Get Network Lightpaths | GET /wavesuite/ha/api/v1/ network-lightpaths | |
| Save Network Lightpath | POST /wavesuite/ha/api/v1/network-lightpaths | |
| Delete the Network Lightpath | DELETE /wavesuite/ha/api/v1/network-lightpaths/{lightpathId} | |
| Get Network Lightpath | GET /wavesuite/ha/api/v1/ network-lightpaths/{lightpathId} | |
| Update an existing Network Lightpath | PUT /wavesuite/ha/api/v1/network-lightpaths/{lightpathId} | |
| Get Network Ports by Network Lightpath ID | GET /wavesuite/ha/api/v1/network-lightpaths/{lightpathId}/network-ports | |
| Get Network Connections by Network Lightpath ID | GET /wavesuite/ha/api/v1/ network-lightpaths/{lightpathId}/network-connections | |
| Get Network Elements by Network Lightpath ID | GET /wavesuite/ha/api/v1/network-lightpaths/{lightpathId}/network-elements | |
| Get Network External Links by Network Lightpath ID | GET /wavesuite/ha/api/v1/ network-lightpaths/{lightpathId}/network-external-links | |
| Create or update the list of Network External Links associated to the Network Lightpath | POST /wavesuite/ha/api/v1/network-lightpaths/{lightpathId} /network-external-links | |
| Get Network External Links | GET /wavesuite/ha/api/v1/network-external-links | |
| Save Network External Link | POST /wavesuite/ha/api/v1/network-external-links | |
| Delete the Network External Link | DELETE /wavesuite/ha/api/v1/network-external-links/{externalLinkId} | |
| Get Network External Link | GET /wavesuite/ha/api/v1/network-external-links/{externalLinkId} | |
| Update an existing Network External Link | PUT /wavesuite/ha/api/v1/network-external-links/{externalLinkId} | |
| Get Network Lightpaths by Network External Link ID | GET /wavesuite/ha/api/v1/network-external-links/{externalLinkId} /network-lightpaths |
To understand the execution of WaveSuite H&A workflows in detail, see How To WS-HA.
Admin API – What’s changed:
Admin API – What’s deleted:
Audit Logs API – No changes
Event Notifications API – No changes
H&A API – What’s new:
H&A API – What’s deleted: