List network and application outages
POST {{baseUrl}}/internet-insights/outages/filter?aid=1234
Returns a list of network and application outages using a filter object. Advanced Filter persistance is not currently supported.
Note: Support for pagination will be added in the future.
## Samples Queries with Different Filter Permutations
### Window
curl --location --request POST 'https://api.thousandeyes.com/v7/internet-insights/outages/filter'
--header 'Authorization: Bearer $token
--header 'Accept-Encoding: application/gzip'
--header 'Content-Type: application/json'
--data-raw '{
"window" : "1d"
}'
Date Range
curl --location --request POST 'https://api.thousandeyes.com/v7/internet-insights/outages/filter'
--header 'Authorization: Bearer $token'
--header 'Content-Type: application/json'
--data-raw '{
"startDate": "2022-03-01T01:30:00Z",
"endDate" : "2022-03-01T23:30:15Z"
}'
Date Range with Scope
curl --location --request POST 'https://api.thousandeyes.com/v7/internet-insights/outages/filter'
--header 'Authorization: Bearer $token'
--header 'Content-Type: application/json'
--data-raw '{
"startDate": "2022-03-01T01:30:00Z",
"endDate" : "2022-03-01T23:30:15Z",
"outageScope": "with-affected-test"
}'
Date Range with Network
curl --location --request POST 'https://api.thousandeyes.com/v7/internet-insights/outages/filter'
--header 'Authorization: Bearer $token'
--header 'Content-Type: application/json'
--data-raw '{
"startDate": "2022-03-01T01:30:00Z",
"endDate" : "2022-03-01T23:30:15Z",
"interfaceNetwork": ["Telianet"]
}'
Date Range with Application
curl --location --request POST 'https://api.thousandeyes.com/v7/internet-insights/outages/filter'
--header 'Authorization: Bearer $token'
--header 'Content-Type: application/json'
--data-raw '{
"startDate": "2022-03-01T01:30:00Z",
"endDate" : "2022-03-01T23:30:15Z",
"applicationName": ["Google"]
}'
Date Range with Provider
curl --location --request POST 'https://api.thousandeyes.com/v7/internet-insights/outages/filter'
--header 'Authorization: Bearer $token'
--header 'Content-Type: application/json'
--data-raw '{
"startDate": "2022-03-01T01:30:00Z",
"endDate" : "2022-03-01T23:30:15Z",
"providerName": ["Century Link", "Microsoft"]
}'
Date Range with Application and Scope
curl --location --request POST 'https://api.thousandeyes.com/v7/internet-insights/outages/filter'
--header 'Authorization: Bearer $token'
--header 'Content-Type: application/json'
--data-raw '{
"startDate": "2022-03-01T01:30:00Z",
"endDate" : "2022-03-01T23:30:15Z",
"outageScope": "all",
"applicationName": ["Google"]
}'
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
aid | number | A unique identifier associated with your account group. You can retrieve your AccountGroupId from the /account-groups endpoint. Note that you must be assigned to the target account group. Specifying this parameter without being assigned to the target account group will result in an error response. |
Request Body
{"startDate"=>"2022-03-01T01:30:00Z", "endDate"=>"2022-03-01T23:30:15Z", "outageScope"=>"all", "providerName"=>["Telia", "Amazon"], "interfaceNetwork"=>["Telianet", "Cloudflare"], "applicationName"=>["slack", "facebook"]}
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Content-Type | string | ||
Accept | string |
RESPONSES
status: OK
{"outages":[{"id":"xxxxxxxxxxxxxxxxxx1","type":"app","providerName":"Google","providerType":"SAAS","name":"Google","startDate":"2022-03-01T23:31:11Z","startRoundId":1646177400,"endDate":"2022-03-01T23:31:11Z","endRoundId":1646177700,"duration":214,"affectedTestsCount":1,"affectedServersCount":2,"affectedLocationsCount":1,"affectedInterfacesCount":1,"asn":19994,"_links":{"self":{"href":"https://api.thousandeyes.com/v7/link/to/resource/id","templated":true,"type":"do est Excepteur nisi","deprecation":"voluptate et elit aliquip","name":"eu culpa","profile":"adipisicing sun","title":"in laborum adipisicing","hreflang":"proident sit"}}},{"id":"xxxxxxxxxxxxxxxxxx1","type":"app","providerName":"Google","providerType":"SAAS","name":"Google","startDate":"2022-03-01T23:31:11Z","startRoundId":1646177400,"endDate":"2022-03-01T23:31:11Z","endRoundId":1646177700,"duration":214,"affectedTestsCount":1,"affectedServersCount":2,"affectedLocationsCount":1,"affectedInterfacesCount":1,"asn":19994,"_links":{"self":{"href":"https://api.thousandeyes.com/v7/link/to/resource/id","templated":true,"type":"sint in sunt","deprecation":"laboris dolor do ","name":"nostrud Lorem","profile":"cillum id","title":"eu id pariatur in","hreflang":"culpa aute"}}}],"_links":{"self":{"href":"https://api.thousandeyes.com/v7/link/to/resource/id","templated":true,"type":"nulla exercitation mollit officia","deprecation":"occae","name":"dolor sunt ex mollit","profile":"occaecat dolor sint dolore","title":"sunt velit","hreflang":"Duis aliquip commodo elit"}}}