Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

XSKY alerts API

AlertController Operations about alert

XSKY alerts API is one of 124 APIs that XSKY publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include alerts. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 7 operations across 4 paths, and defines 14 schemas. It is described by OpenAPI 2.0, at version SDS_4.2.000.0.200302.

Requests are made against the base URL https://{xms-controller}/v1.

7 operations 4 paths 14 schemas 2 DELETE2 GET1 PATCH1 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 2.0
API Version
SDS_4.2.000.0.200302
Base URL
https://{xms-controller}/v1
Authentication
API Key, API Key
License
Commercial
Resource Areas
1

Authentication & Security 2

XSKY alerts API declares 2 security schemes for authenticating requests. An API key is passed in the header as Xms-Auth-Token (tokenInHeader). An API key is passed in the query as token (tokenInQuery).

  • tokenInHeader — auth by token
  • tokenInQuery — auth by token

Paths & Operations 7

Across 4 paths, the API surfaces 7 operations — 2 DELETE, 2 GET, 1 PATCH, 1 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

alerts 7

AlertController Operations about alert

GET
/alerts/
List all alerts
ListAlerts 11 params → 200400500
DELETE
/alerts/
delete alerts
DeleteAlerts 1 param → 204400500
PATCH
/alerts/
set the ack status of alerts
DoAlerts 1 param → 204400500
GET
/alerts/stats
count all alert
CountAlerts 4 params → 200500
PUT
/alerts/{alert_id}
set the ack status of alert
DoAlert 2 params → 200400404500
DELETE
/alerts/{alert_id}
Delete alert
DeleteAlert 1 param → 204400404500
POST
/alerts/{alert_id}:resolve
set the resolved status of alert
ResolveAlert 1 param → 200400404500

Schemas 14

The contract defines 14 schemas that model the data the API accepts and returns. The most detailed are Alert (23 properties), ErrorRecord (9 properties), AlertStats (4 properties), Host_Nestview (3 properties). Each schema is shown below with its type and property counts.

Alert_Nestview
object
2 properties
AlertsActionReq
object
1 property 1 required
AlertActionReq
object
1 property 1 required
Host_Nestview
object
3 properties 1 required
ErrorRecord
object
ErrorRecord defines the error record attributes.
9 properties
AlertsActionReq_Alerts
object
1 property 1 required
AlertResp
object
1 property 1 required
AlertStatsResp
object
1 property 1 required
AlertsResp
object
1 property 1 required
AlertRecord
AlertRecord defines the response errors of alert
Alert
object
Alert is a generic representation of an alert in the Prometheus eco-system.
23 properties
AlertStats
object
4 properties
AlertActionReq_Alert
object
1 property 1 required
ActionLog_Nestview
object
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

xsky-alerts-api-openapi.yml Raw ↑

Other APIs XSKY publishes across the network.

XSKY access-paths API
XSKY access-tokens API
XSKY action-logs API
XSKY alert-groups API
XSKY alert-rules API
XSKY auth API
XSKY block-snapshots API
XSKY block-volume-group-snapshots API
XSKY block-volume-groups API
XSKY block-volume-migration-jobs API
XSKY block-volumes API
XSKY chunks API