SD-WAN Bulk API: Data Refresh Frequency

[Prodrick]

For the SD-WAN Bulk API, when one calls state and statistics endpoints, how delayed are the results, i.e. how often are the backend data updated?

Thanks

https://developer.cisco.com/docs/sdwan/#!bulk-api

[stephli2]

Hi Prodrick,

which specific endpoints are you using?

[Prodrick]

Here are a few from this reference: https://developer.cisco.com/docs/sdwan/#!bulk-api/bulk-api

State

• Control Connection: GET https://{vmanage-ip-address}/dataservice/data/device/state/ControlConnection?count=count
• Interface: GET https://{vmanage-ip-address}/dataservice/data/device/state/Interface?count=count
• OMP Peers: GET https://{vmanage-ip-address}/dataservice/data/device/state/OMPPeer?count=count
• System: GET https://{vmanage-ip-address}/dataservice/data/device/state/System?count=count

Statistics:

• Device System Status: GET https://{vmanage-ip-address}/dataservice/data/device/state/devicesystemstatusstatistics?startDate=yyyy-mm-ddThh:mm:ss&endDate=yyyy-mm-ddThh:mm:ss
• Interfaces: GET https://vmanage-ip-address/dataservice/data/device/statistics/interfacestatistics?startDate=yyyy-mm-ddThh:mm:ss&endDate=yyyy-mm-ddThh:mm:ss
• Application-aware Routing Status: GET https://{vmanage-ip-address}/dataservice/data/device/statistics/approutestatsstatistics?startDate=yyyy-mm-ddThh:mm:ss&endDate=yyyy-mm-ddThh:mm:ss

[bigevilbeard]

If i recall, Bulk API state endpoints return data that is updated every 30 seconds. The statistics endpoints return data that is updated every 5 seconds. This means that the results of a call to a state endpoint may be up to 30 seconds old, and the results of a call to a statistics endpoint may be up to 5 seconds old.

Starting from Cisco SD-WAN Release 20.6.1, Cisco SD-WAN Manager supports below API limits:

• API Rate-limit: 100/second

• Bulk API Rate-limit: 48/minute

[Prodrick]

I am looking for an official reference document that specifies the refresh frequency 

[bigevilbeard]

If its not in the https://developer.cisco.com/docs/sdwan/#!bulk-api i would not know where to suggest you look. If you get no reply here i would suggest raising this with TAC.

Hope this helps.

[Prodrick]

Hoping someone from Cisco will respond here with a definitive answer.