Contact Uscybus.io

API Definition

17KB
Service Manager Schema.yaml

validate a commissioning file

post
Authorizations
Body
commissioningFilestringrequired

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

Responses
curl -L \
  --request POST \
  --url '/validate/service' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "commissioningFile": "text"
  }'
No body

Validation Successful

Create a new service

post
Authorizations
Body
idstring · min: 4required
commissioningFilestringrequired

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

parametersobjectoptional

The parameter values of this service as a JSON object

marketplaceobjectoptional
targetStatestring · enumoptional
Available options:
Responses
curl -L \
  --request POST \
  --url '/services' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "id": "text",
    "commissioningFile": "text",
    "parameters": {},
    "marketplace": {},
    "targetState": "disabled"
  }'
{
  "id": "text",
  "targetState": "text",
  "currentState": "text"
}

Created service

Read all services

get
Authorizations
Responses
curl -L \
  --url '/services' \
  --header 'Authorization: YOUR_API_KEY'
[
  {
    "id": "text",
    "commissioningData": {},
    "resources": {},
    "targetState": "text",
    "currentState": "text"
  }
]

Array of services

Get the service schemas

post
Authorizations
Body
commissioningFilestringrequired

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

Responses
curl -L \
  --request POST \
  --url '/services/parametersSchema' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "commissioningFile": "text"
  }'
{}

Service schemas

Get status of all services

get
Authorizations
Responses
curl -L \
  --url '/services/status' \
  --header 'Authorization: YOUR_API_KEY'
{}

Map of service statuses

Get information of all services

get
Authorizations
Responses
curl -L \
  --url '/services/info' \
  --header 'Authorization: YOUR_API_KEY'
{}

Map of service information

Get the instance names of the services

get
Authorizations
Responses
curl -L \
  --url '/services/instances' \
  --header 'Authorization: YOUR_API_KEY'
[
  "text"
]

Map of service information

Get a specific service

get
Authorizations
Path parameters
idanyrequired

Id of service

Responses
curl -L \
  --url '/services/{id}' \
  --header 'Authorization: YOUR_API_KEY'
{
  "id": "text",
  "commissioningData": {},
  "resources": {},
  "targetState": "text",
  "currentState": "text"
}

Service

Update an existing service

put
Authorizations
Path parameters
idanyrequired

Id of service

Body
parametersobjectoptional
commissioningFilestringoptional
marketplaceobjectoptional
Responses
curl -L \
  --request PUT \
  --url '/services/{id}' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "parameters": {},
    "commissioningFile": "text",
    "marketplace": {}
  }'
No body

Accepted

Delete an existing service

delete
Authorizations
Path parameters
idanyrequired

Id of service

Responses
curl -L \
  --request DELETE \
  --url '/services/{id}' \
  --header 'Authorization: YOUR_API_KEY'
{
  "id": "text"
}

OK

Get a specific service status

get
Authorizations
Path parameters
idanyrequired

Id of service

Responses
curl -L \
  --url '/services/{id}/status' \
  --header 'Authorization: YOUR_API_KEY'
{
  "id": "text",
  "targetState": "text",
  "currentState": "text"
}

Service

Get the service dependencies

get
Authorizations
Path parameters
idanyrequired

Id of service

Responses
curl -L \
  --url '/services/{id}/dependencies' \
  --header 'Authorization: YOUR_API_KEY'
{
  "dependent": [
    "text"
  ],
  "dependsOn": [
    "text"
  ]
}

Service dependencies

Get all ingress routes

get
Authorizations
Responses
curl -L \
  --url '/services/ingress-routes' \
  --header 'Authorization: YOUR_API_KEY'
[
  {
    "id": "text",
    "containerHost": "text",
    "containerPort": 1,
    "containerPrefixRewrite": "text",
    "ingressPort": 1,
    "ingressUrlPrefix": "text",
    "type": "text",
    "headers": [
      "text"
    ]
  }
]

Ingress routes

Get all Cybus::Link routes

get
Authorizations
Responses
curl -L \
  --url '/services/links' \
  --header 'Authorization: YOUR_API_KEY'
[
  {
    "id": "text",
    "ingressRoute": "text",
    "name": "text",
    "href": "text"
  }
]

Links

Get all links by all services

get
Authorizations
Responses
curl -L \
  --url '/services/all-links' \
  --header 'Authorization: YOUR_API_KEY'
[
  {
    "id": "text",
    "name": "text",
    "links": []
  }
]

Links

Perform an operation on a service

put
Authorizations
Path parameters
idanyrequired

Id of service

Body
operationstringoptional

Disable and enable

Responses
curl -L \
  --request PUT \
  --url '/services/{id}/operation' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "operation": "text"
  }'
{
  "id": "text",
  "targetState": "text",
  "currentState": "text"
}

Service

Get all of the resource schemas

get
Authorizations
Responses
curl -L \
  --url '/resources/schemas' \
  --header 'Authorization: YOUR_API_KEY'
{
  "[a-zA-Z0-9]+": {},
  "ANY_ADDITIONAL_PROPERTY": "anything"
}

Resource schemas in a JSON string

Previous“Machine Utilization Example” - Push data to MSSQL DatabaseNextResources

Last updated

Was this helpful?