Resource Status Tracking (HTTP API)

73KB

Resources Status Schema.yaml

Open

get

Authorizations

ApiKeyHeader

Query parameters

serviceIdsstring[] · max: 100Optional

Limit to ServiceIDs

resourceIdsstring[] · max: 100Optional

Limit to ResourceIDs

pageinteger · min: 1Optional

A page number

Default: 1

itemsPerPageinteger · min: 1 · max: 100Optional

Number of items per page

Default: 50

Responses

200

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

application/jsontext/event-stream

get

/api/v2/resources/states/deviations

HTTPcURLJavaScriptPython

GET /api/v2/resources/states/deviations HTTP/1.1
Accept: */*

200

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

{
  "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": 50
    }
  }
}

get

Authorizations

ApiKeyHeader

Query parameters

idsstring[] · max: 100Optional

Limit to ServiceIDs

pageinteger · min: 1Optional

A page number

Default: 1

itemsPerPageinteger · min: 1 · max: 100Optional

Number of items per page

Default: 50

Responses

200

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

application/jsontext/event-stream

dataone ofRequired

or

integerOptional

The current number of deviations

Example: 42

get

/api/v2/resources/states/deviations/count

HTTPcURLJavaScriptPython

GET /api/v2/resources/states/deviations/count HTTP/1.1
Accept: */*

200

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

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

get

Authorizations

ApiKeyHeader

Query parameters

serviceIdsstring[] · max: 100Optional

Limit to ServiceIDs

resourceIdsstring[] · max: 100Optional

Limit to ResourceIDs

deviatedall ofOptional

Return only deviated resources

booleanOptional

Flag indicating if a deviation was detected or not

and

anyOptionalDefault: false

pageinteger · min: 1Optional

A page number

Default: 1

itemsPerPageinteger · min: 1 · max: 100Optional

Number of items per page

Default: 50

Responses

200

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.

application/jsontext/event-stream

get

/api/v2/resources/states

HTTPcURLJavaScriptPython

GET /api/v2/resources/states HTTP/1.1
Accept: */*

200

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.

{
  "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": 50
    }
  }
}

get

Authorizations

ApiKeyHeader

Query parameters

namesstring[] · max: 100Optional

Limit to specific runners

pageinteger · min: 1Optional

A page number

Default: 1

itemsPerPageinteger · min: 1 · max: 100Optional

Number of items per page

Default: 50

Responses

200

List of heartbeats

application/json

get

/api/v2/resource-runners

HTTPcURLJavaScriptPython

GET /api/v2/resource-runners HTTP/1.1
Accept: */*

200

List of heartbeats

{
  "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": 50
    }
  }
}

get

Authorizations

ApiKeyHeader

Responses

200

Every RST related http endpoint definition

application/json

get

/api/v2/resources/rst/httpschemas

HTTPcURLJavaScriptPython

GET /api/v2/resources/rst/httpschemas HTTP/1.1
Accept: */*

200

Every RST related http endpoint definition

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