Resource Status Tracking (HTTP API)

73KB

Resources Status Schema.yaml

get

Query parameters

serviceIdsstring[] · max: 100optional

Limit to ServiceIDs

resourceIdsstring[] · max: 100optional

Limit to ResourceIDs

pageinteger · min: 1 · default: 1optional

A page number

itemsPerPageinteger · min: 1 · max: 100 · default: 50optional

Number of items per page

Responses

application/jsontext/event-stream

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/api/v2/resources/states/deviations'

200

200

application/json

text/event-stream

application/json

{
  "data": [
    {
      "resource": {
        "id": "myService-myResource",
        "name": "myResource"
      },
      "state": {
        "desired": "connected",
        "current": "connected"
      },
      "runnerInfo": {
        "name": "protocol-mapper",
        "status": "healthy"
      },
      "deviated": true,
      "info": "Host not reachable"
    }
  ],
  "meta": {
    "pagination": {
      "totalPages": 1,
      "totalRows": 1,
      "pageNumber": 1,
      "totalRowsInPage": 1,
      "nextPage": 1,
      "rowsPerPage": 1
    }
  }
}

List of resource state deviations, allowing to identify resources that have diverged from their expected states

get

Query parameters

idsstring[] · max: 100optional

Limit to ServiceIDs

pageinteger · min: 1 · default: 1optional

A page number

itemsPerPageinteger · min: 1 · max: 100 · default: 50optional

Number of items per page

Responses

application/jsontext/event-stream

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/api/v2/resources/states/deviations/count'

200

200

application/json

text/event-stream

application/json

{
  "data": [
    {
      "serviceId": "myService",
      "count": 42
    }
  ],
  "meta": {
    "pagination": {
      "totalPages": 1,
      "totalRows": 1,
      "pageNumber": 1,
      "totalRowsInPage": 1,
      "nextPage": 1,
      "rowsPerPage": 1
    }
  }
}

Number of resources currently in a deviated state. If no filter is applied the number represents the system wide deviations.

get

Query parameters

serviceIdsstring[] · max: 100optional

Limit to ServiceIDs

resourceIdsstring[] · max: 100optional

Limit to ResourceIDs

deviatedall ofoptional

Return only deviated resources

Flag indicating if a deviation was detected or not

pageinteger · min: 1 · default: 1optional

A page number

itemsPerPageinteger · min: 1 · max: 100 · default: 50optional

Number of items per page

Responses

application/jsontext/event-stream

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/api/v2/resources/states'

200

200

application/json

text/event-stream

application/json

{
  "data": [
    {
      "resource": {
        "id": "myService-myResource",
        "name": "myResource"
      },
      "state": {
        "desired": "connected",
        "current": "connected"
      },
      "runnerInfo": {
        "name": "protocol-mapper",
        "status": "healthy"
      },
      "deviated": true,
      "info": "Host not reachable"
    }
  ],
  "meta": {
    "pagination": {
      "totalPages": 1,
      "totalRows": 1,
      "pageNumber": 1,
      "totalRowsInPage": 1,
      "nextPage": 1,
      "rowsPerPage": 1
    }
  }
}

List of resources including their state and status. If no ServiceIDs and no ResourceIDs are provided, it acts as a wildcard request. Filtering for ResourceIds takes precedence over filtering for ServiceIds. Meaning as soon as ResourceIDs are provided, the ServiceIDs will be ignored.

get

Query parameters

namesstring[] · max: 100optional

Limit to specific runners

pageinteger · min: 1 · default: 1optional

A page number

itemsPerPageinteger · min: 1 · max: 100 · default: 50optional

Number of items per page

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/api/v2/resource-runners'

200

200

{
  "data": [
    {
      "name": "protocol-mapper",
      "healthy": true,
      "last": 1716543812,
      "misses": 1,
      "remainingMissedHeartbeats": 1
    }
  ],
  "meta": {
    "pagination": {
      "totalPages": 1,
      "totalRows": 1,
      "pageNumber": 1,
      "totalRowsInPage": 1,
      "nextPage": 1,
      "rowsPerPage": 1
    }
  }
}

List of heartbeats

get

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/api/v2/resources/rst/httpschemas'

200

200

{
  "data": {
    "[a-zA-Z0-9]+": {},
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

Every RST related http endpoint definition