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 alert-rules API

AlertRuleController Operations about alert rule

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

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

This API exposes 10 operations across 4 paths, and defines 12 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.

10 operations 4 paths 12 schemas 2 DELETE4 GET1 PATCH2 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 alert-rules 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 10

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

alert-rules 10

AlertRuleController Operations about alert rule

GET
/alert-rules/
List all alert rules
ListAlertRules 8 params → 200400500
POST
/alert-rules/
create alert rule
CreateAlertRule 1 param → 200400409500
PUT
/alert-rules/
create alert rule
CreateAlertRule 1 param → 200400409500
GET
/alert-rules/schema
get alert rule schema
GetAlertRuleSchema → 200
GET
/alert-rules/{rule_id}
get alert rule
GetAlertRule 1 param → 200404500
DELETE
/alert-rules/{rule_id}
delete alert rule
DeleteAlertRule 1 param → 204400404500
PATCH
/alert-rules/{rule_id}
set alert rule
UpdateAlertRule 2 params → 200400404409500
GET
/alert-rules/{rule_id}/blacklist
List all blacklist of alert rule
ListAlertRuleResourceBlacklist 4 params → 200400500
POST
/alert-rules/{rule_id}/blacklist
create resource blacklist of alert rule
CreateAlertRuleResourceBlacklist 2 params → 200400404409500
DELETE
/alert-rules/{rule_id}/blacklist
delete resource blacklist of alert rule
DeleteAlertRuleResourceBlacklist 2 params → 204400404500

Schemas 12

The contract defines 12 schemas that model the data the API accepts and returns. The most detailed are AlertRule (13 properties), AlertRuleCreateReq_Rule (7 properties), AlertRuleUpdateReq_Rule (3 properties), AlertRuleSchemaResp (2 properties). Each schema is shown below with its type and property counts.

AlertRuleSchema
object
AlertRuleSchema defines alert rule schema
2 properties
UpdateAlertRuleResourceBlacklistReq
object
1 property 1 required
AlertRuleUpdateReq
object
1 property 1 required
AlertRuleResp
object
1 property 1 required
AlertRuleUpdateReq_Rule
object
3 properties
AlertRuleResourceBlacklistResp
object
AlertRulesResp
object
1 property 1 required
AlertRule
object
AlertRule defines the alert rule
13 properties
UpdateAlertRuleResourceBlacklistReq_AlertRuleResourceBlacklist
object
1 property
AlertRuleCreateReq
object
1 property 1 required
AlertRuleSchemaResp
object
2 properties 2 required
AlertRuleCreateReq_Rule
object
7 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

xsky-alert-rules-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 alerts 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