API Definition

17KB

Service Manager Schema.yaml

validate a commissioning file

POST/api/validate/service

Authorization

ApiKeyHeader

Body

application/json

validate a commissioning file

commissioningFile*string

The commissioning file of this service as base64 encoded content of a buffer

Response

200400406

Validation Successful

Request

JavaScriptCurlPython

const response = await fetch('/api/validate/service', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "commissioningFile": "text"
    }),
});
const data = await response.json();

Response

400406

[
  {
    "message": "text"
  }
]

Create a new service

POST/api/services

Authorization

ApiKeyHeader

Body

application/json

Service to be created

id*string

commissioningFile*string

The commissioning file of this service as base64 encoded content of a buffer

parametersobject

The parameter values of this service as a JSON object

marketplaceobject

targetStateenum

disabledenabled

Response

201400406

Created service

Body

application/json

idstring

Unique identifier representing a specific service.

targetStatestring

Target state of the service (user's wish).

currentStatestring

Current state of the service.

Request

JavaScriptCurlPython

const response = await fetch('/api/services', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "id": "text",
      "commissioningFile": "text"
    }),
});
const data = await response.json();

Response

201400406

{
  "id": "text",
  "targetState": "text",
  "currentState": "text"
}

Read all services

GET/api/services

Authorization

ApiKeyHeader

Response

200

Array of services

Body

application/json

idstring

commissioningDataobject

resourcesobject

targetStatestring

currentStatestring

Request

JavaScriptCurlPython

const response = await fetch('/api/services', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

[
  {
    "id": "text",
    "targetState": "text",
    "currentState": "text"
  }
]

Get the service schemas

POST/api/services/parametersSchema

Authorization

ApiKeyHeader

Body

application/json

Get the service parameters schemas

commissioningFile*string

The commissioning file of this service as base64 encoded content of a buffer

Response

201400406

Service schemas

Body

application/json

ServiceSchemas (object)

Request

JavaScriptCurlPython

const response = await fetch('/api/services/parametersSchema', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "commissioningFile": "text"
    }),
});
const data = await response.json();

Response

400406

[
  {
    "message": "text"
  }
]

Get status of all services

GET/api/services/status

Authorization

ApiKeyHeader

Response

200

Map of service statuses

Body

application/json

object

Request

JavaScriptCurlPython

const response = await fetch('/api/services/status', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Get information of all services

GET/api/services/info

Authorization

ApiKeyHeader

Response

200

Map of service information

Body

application/json

object

Request

JavaScriptCurlPython

const response = await fetch('/api/services/info', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Get the instance names of the services

GET/api/services/instances

Authorization

ApiKeyHeader

Response

200

Map of service information

Body

application/json

itemsstring

Request

JavaScriptCurlPython

const response = await fetch('/api/services/instances', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

[
  "text"
]

Get a specific service

GET/api/services/{id}

Authorization

ApiKeyHeader

Path parameters

id*string

Id of service

Response

200400404

Service

Body

application/json

idstring

commissioningDataobject

resourcesobject

targetStatestring

currentStatestring

Request

JavaScriptCurlPython

const response = await fetch('/api/services/{id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "id": "text",
  "targetState": "text",
  "currentState": "text"
}

Update an existing service

PUT/api/services/{id}

Authorization

ApiKeyHeader

Path parameters

id*string

Id of service

Body

application/json

Data required for updating a service

parametersobject

commissioningFilestring

marketplaceobject

Response

202400406

Accepted

Request

JavaScriptCurlPython

const response = await fetch('/api/services/{id}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

400406

[
  {
    "message": "text"
  }
]

Delete an existing service

DELETE/api/services/{id}

Authorization

ApiKeyHeader

Path parameters

id*string

Id of service

Response

200404

OK

Body

application/json

idstring

The id of the deleted service

Request

JavaScriptCurlPython

const response = await fetch('/api/services/{id}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

200

{
  "id": "text"
}

Get a specific service status

GET/api/services/{id}/status

Authorization

ApiKeyHeader

Path parameters

id*string

Id of service

Response

200400404

Service

Body

application/json

idstring

Unique identifier representing a specific service.

targetStatestring

Target state of the service (user's wish).

currentStatestring

Current state of the service.

Request

JavaScriptCurlPython

const response = await fetch('/api/services/{id}/status', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "id": "text",
  "targetState": "text",
  "currentState": "text"
}

Get the service dependencies

GET/api/services/{id}/dependencies

Authorization

ApiKeyHeader

Path parameters

id*string

Id of service

Response

200400404

Service dependencies

Body

application/json

dependentarray of string

Ids of dependent cross reference services

dependsOnarray of string

Ids of depends on cross reference services

Request

JavaScriptCurlPython

const response = await fetch('/api/services/{id}/dependencies', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "dependent": [
    "text"
  ],
  "dependsOn": [
    "text"
  ]
}

Get all ingress routes

GET/api/services/ingress-routes

Authorization

ApiKeyHeader

Response

200400

Ingress routes

Body

application/json

idstring

containerHoststring

containerPortinteger

containerPrefixRewritestring

ingressPortinteger

ingressUrlPrefixstring

typestring

headersarray of string

Request

JavaScriptCurlPython

const response = await fetch('/api/services/ingress-routes', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

[
  {
    "id": "text",
    "containerHost": "text",
    "containerPrefixRewrite": "text",
    "ingressUrlPrefix": "text",
    "type": "text",
    "headers": [
      "text"
    ]
  }
]

Get all Cybus::Link routes

GET/api/services/links

Authorization

ApiKeyHeader

Response

200400

Links

Body

application/json

idstring

ingressRoutestring

namestring

hrefstring

Request

JavaScriptCurlPython

const response = await fetch('/api/services/links', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

[
  {
    "id": "text",
    "ingressRoute": "text",
    "name": "text",
    "href": "text"
  }
]

Get all links by all services

GET/api/services/all-links

Authorization

ApiKeyHeader

Response

200400

Links

Body

application/json

idstring

namestring

linksarray of object

Request

JavaScriptCurlPython

const response = await fetch('/api/services/all-links', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

[
  {
    "id": "text",
    "name": "text",
    "links": [
      {
        "name": "text",
        "href": "text"
      }
    ]
  }
]

Perform an operation on a service

PUT/api/services/{id}/operation

Authorization

ApiKeyHeader

Path parameters

id*string

Id of service

Body

application/json

Operation to perform

operationstring

Disable and enable

Response

200400404

Service

Body

application/json

idstring

Unique identifier representing a specific service.

targetStatestring

Target state of the service (user's wish).

currentStatestring

Current state of the service.

Request

JavaScriptCurlPython

const response = await fetch('/api/services/{id}/operation', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200

{
  "id": "text",
  "targetState": "text",
  "currentState": "text"
}

Get all of the resource schemas

GET/api/resources/schemas

Authorization

ApiKeyHeader

Response

200400500

Resource schemas in a JSON string

Body

application/json

Other propertiesany

Request

JavaScriptCurlPython

const response = await fetch('/api/resources/schemas', {
    method: 'GET',
    headers: {},
});
const data = await response.json();