List a component's alarms

GET

/components/{name}/alarms

const url = 'https://example.com/api/v1/components/example/alarms';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://example.com/api/v1/components/example/alarms

What is currently wrong with this component, newest first, each with the capabilities it degrades. Pass include_cleared for the history rather than the active set. Gated by component:read; an out-of-scope component is a non-disclosing 404.

Parameters

Path Parameters

name

required

The component’s unique name

string

The component’s unique name

Query Parameters

include_cleared

Include cleared alarms, so the list is the history rather than what is wrong now

boolean

Include cleared alarms, so the list is the history rather than what is wrong now

Responses

200

application/json

object

$schema

A URL to the JSON Schema for this object.

string format: uri

alarms

required

Array<object> | null

object

$schema

A URL to the JSON Schema for this object.

string format: uri

active

required

boolean

capabilities

required

The capabilities this alarm degrades; empty means it reaches no role

Array<string> | null

cleared_at

Null while the alarm is active

string format: date-time

component

required

string

required

string

message

required

string

raised_at

required

string format: date-time

severity

required

Info, warning, or critical

string

component

required

string

Example

{
  "$schema": "/api/v1/schemas/ListAlarmsOutputBody.json",
  "alarms": [
    {
      "$schema": "/api/v1/schemas/AlarmBody.json"
    }
  ]
}

default

Error

application/problem+json

object

$schema

A URL to the JSON Schema for this object.

string format: uri

detail

A human-readable explanation specific to this occurrence of the problem.

string

errors

Optional list of individual error details

Array<object> | null

object

location

Where the error occurred, e.g. ‘body.items[3].tags’ or ‘path.thing-id’

string

message

Error message text

string

value

The value at the given location

instance

A URI reference that identifies the specific occurrence of the problem.

string format: uri

status

HTTP status code

integer format: int64

title

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

string

type

A URI reference to human-readable documentation for the error.

string format: uri

default: about:blank

Example

{
  "$schema": "/api/v1/schemas/ErrorModel.json",
  "detail": "Property foo is required but is missing.",
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}