LogoLogo
Contact Uscybus.io
Connectware 1.9.0
Connectware 1.9.0
  • Getting Started
    • Introduction
    • Installing Connectware
      • System Requirements
      • Acquiring your License Key
      • Installing Connectware on Docker
      • Installing Connectware on Kubernetes
    • Connectware Admin UI
    • Basic Components of Connectware
    • Connecting your First Machine
      • Your First Service Commissioning File
  • Documentation
    • Services
      • Service Commissioning Files
        • Structure of Service Commissioning Files
          • description
          • metadata
          • parameters
          • definitions
          • resources
            • Cybus::Connection
            • Cybus::Endpoint
            • Cybus:Mapping
            • Cybus::Container
              • Docker problem with network changes
            • Cybus::Link
            • Cybus::IngressRoute
            • Cybus::User
            • Cybus::Role
            • Cybus::Volume
            • Cybus::File
            • Cybus::Server
            • Cybus::Node
        • Sample Service Commissioning Files
          • Modbus
            • “Bearbeitungszentrum BAZ” - Single File
            • “Bearbeitungszentrum BAZ” - Multiple Files
            • “Bearbeitungszentrum BAZ” - Single File and Custom Topics
            • “Bearbeitungszentrum BAZ” - Agent Mode
          • Machine Condition Monitoring : OPC UA + InfluxDB + Grafana Dashboard
            • “Machine Condition Monitoring Example” - Single File
          • Machine Utilization Example (Multi file service composition) : Modbus TCP + InfluxDB + Grafana + MSS
            • “Machine Utilization Example” - Machine Connectivity
            • “Machine Utilization Example” - Dashboards with role based access permission
            • “Machine Utilization Example” - Push data to MSSQL Database
      • Services View
      • Setting Up and Configuring Services
        • Installing Services
        • Enabling Services
        • Updating Services
        • Disabling Services
        • Deleting Services
      • Service Details View
      • FlowSync
        • Example 1 - Node with Transaction Mode (HTTP)
        • Example 2 - Node Responds (HTTP)
        • Example 3 - Node with Error (HTTP)
        • Example 4 - Node with Timeout Error Code and Error Message (HTTP)
        • Example 5 - Full Transactional Data Flow (HTTP)
        • Example 6 - Full Transactional Data Flow (OPC UA)
      • ServiceID
      • Inter-Service Referencing
      • Deviation
      • Service Logs
        • Logs of Individual Services
        • Logs of All Services
      • Rule Engine
        • Data Processing Rules
        • Rule Sandbox
      • Shared Subscriptions
        • Setting Up Shared Subscriptions
      • API Definition
    • Resources
      • Servers
      • Containers
      • Volumes
      • Connections
      • Endpoints
      • Mappings
      • Nodes
      • API Definition
    • User Management
      • Users and Roles View
      • Users
      • Roles
      • Permissions
      • Password Policy Rules
      • Default Admin User
      • MQTT Users
      • Adding a MQTT Publish Prefix for Users
      • Multi-Factor Authentication
      • Long lived JSON Web Tokens
      • Access Permissions for Admin-UI
        • UI Access
        • Minimum Access Role Pages
      • API Definition
    • Client Registry
      • Implicit Flow
      • Explicit Flow
      • Granting Access
      • API Definition
    • Certificates
    • Monitoring
      • Data Explorer
      • Live Data
    • Workbench
      • Flows in Git Repositories
    • System Status
      • Info
      • Metrics
      • Status
      • Retrieving More System Information
      • System Health
      • API Definition
    • Backup and Restore
      • Volumes
      • User Database
    • Configuration
      • Environment Variables
      • LDAP Configuration
      • MFA Configuration
    • Agents
      • Agents View
      • Installing Agents
        • Installing Agents via Docker
        • Installing Agents via Docker Compose
        • Installing Agents via Kubernetes
        • Using Mutual TLS for Agents
      • Registering Agents in Connectware
      • Using Agents
      • Monitoring Agents
      • Troubleshooting Agents
    • Industry Protocol Details
      • ADS
        • AdsConnection
        • AdsEndpoint
      • BACnet
        • BacnetConnection
        • BacnetEndpoint
      • EtherNet/IP
        • EthernetIpConnection
        • EthernetIpEndpoint
      • Focas
        • FocasConnection
        • FocasEndpoint
      • Generic VRPC
        • GenericVrpcConnection
        • GenericVrpcEndpoint
      • Hottinger Baldwin Messtechnik (HBM)
        • HbmdaqConnection
        • HbmdaqEndpoint
      • Heidenhain DNC
        • HeidenhainConnection
        • HeidenhainEndpoint
      • HTTP/REST
        • HttpConnection
        • HttpEndpoint
      • HTTP Server
        • HttpServer
        • HttpNode
      • InfluxDB
        • InfluxdbConnection
        • InfluxdbEndpoint
      • Kafka
        • KafkaConnection
        • KafkaEndpoint
      • Modbus/TCP
        • ModbusConnection
        • ModbusEndpoint
      • MQTT
        • MqttConnection
        • MqttEndpoint
      • MSSQL
        • MssqlConnection
        • MssqlEndpoint
      • OPC DA
        • OpcdaConnection
        • OpcdaEndpoint
      • OPC UA
        • OPC UA Client
          • OpcuaConnection
          • OpcuaEndpoint
        • OPC UA Server
          • OpcuaServer
          • OpcuaNode
        • OPC UA Object Types
        • OPC UA Server References
          • OpcuaReferenceNode
          • OpcuaObjectNode
      • Siemens SIMATIC S7
        • S7Connection
        • S7Endpoint
      • Shdr
        • ShdrConnection
        • ShdrEndpoint
      • Sinumerik
        • SinumerikConnection
        • SinumerikEndpoint
      • Sopas
        • SopasConnection
        • SopasEndpoint
      • SQL
        • SqlConnection
        • SqlEndpoint
      • Werma WIN Ethernet
        • WermaConnection
        • WermaEndpoint
      • Systemstate
        • SystemstateConnection
        • SystemstateEndpoint
      • API Definition
    • Connectware Licensing
    • Changelog
      • General changes from 0.x to 1.0
        • Upgrading from 0.x to 1.0
    • Upgrade Guide
      • Upgrading from 1.x to 1.7.0
      • Upgrading from 1.x to 1.5.0
Powered by GitBook
LogoLogo

Cybus

  • Terms and Condition
  • Imprint
  • Data Privacy

© Copyright 2025, Cybus GmbH

On this page

Was this helpful?

  1. Documentation
  2. Resources

API Definition

PreviousNodesNextUser Management

Last updated 5 months ago

Was this helpful?

13KB
Container Manager Schema.yaml

Get all service containers

get
Responses
200
All service containers
application/json
Responseobject[]
404
Failed to get all service containers
get
GET /api/containers HTTP/1.1
Host: 
Accept: */*
[
  {}
]

Inspect service container

get
Responses
200
Service container inspect
application/json
Responseobject
404
Failed to inspect service container
get
GET /api/containers/{name}/inspect HTTP/1.1
Host: 
Accept: */*
{}

Get service container logs

get
Path parameters
namestringRequired

Name of the service container

Query parameters
timestampsstring · enumOptional

If the logs should yield timestamp

Possible values:
tailstringOptional

Use 'all' to retrieve all, or a number for a limited set

sincestringOptional

Timestamp for the start

untilstringOptional

Timestamp for the end

Responses
200
Service container logs
application/json
Responsestring
404
Failed to get container logs
get
GET /api/containers/{name}/logs HTTP/1.1
Host: 
Accept: */*
text

Get container state

get
Responses
200
Service container state
application/json
Responseobject
404
Failed to get service container state
get
GET /api/containers/{name}/state HTTP/1.1
Host: 
Accept: */*
{}

Returns info about orchestrator being used to run Connectware

get
Responses
200
Returns the name of the orchestrator being used to run Connectware
application/json
get
GET /api/containers/orchestrator HTTP/1.1
Host: 
Accept: */*
200

Returns the name of the orchestrator being used to run Connectware

{
  "orchestrator": "Docker"
}

Get all core containers

get
Responses
200
All core containers
application/json
Responseobject[]
404
Failed to get all core containers
get
GET /api/core-containers HTTP/1.1
Host: 
Accept: */*
[
  {}
]

Inspect core container

get
Responses
200
Core container inspect
application/json
Responseobject
404
Failed to inspect core container
get
GET /api/core-containers/{name}/inspect HTTP/1.1
Host: 
Accept: */*
{}

Get core container logs

get
Path parameters
namestringRequired

Name of the core container

Query parameters
timestampsstring · enumOptional

If the logs should yield timestamp

Possible values:
tailstringOptional

Use 'all' to retrieve all, or a number for a limited set

sincestringOptional

Timestamp for the start

untilstringOptional

Timestamp for the end

Responses
200
Core container logs
application/json
Responsestring
404
Failed to get core container logs
get
GET /api/core-containers/{name}/logs HTTP/1.1
Host: 
Accept: */*
text

Get core container state

get
Responses
200
Core Container state
application/json
Responseobject
404
Failed to get core container state
get
GET /api/core-containers/{name}/state HTTP/1.1
Host: 
Accept: */*
{}

Returns info about orchestrator being used to run Connectware

get
Responses
200
Returns the name of the orchestrator being used to run Connectware
application/json
get
GET /api/core-containers/orchestrator HTTP/1.1
Host: 
Accept: */*
200

Returns the name of the orchestrator being used to run Connectware

{
  "orchestrator": "Docker"
}

Get all images

get
Responses
200
All images
application/json
Responseobject[]
404
Failed to get all images
get
GET /api/images HTTP/1.1
Host: 
Accept: */*
[
  {}
]

Inspect a image

get
Responses
200
Image inspect
application/json
Responseobject
404
Failed to inspect image
get
GET /api/images/{name}/inspect HTTP/1.1
Host: 
Accept: */*
{}

Get all networks

get
Responses
200
All networks
application/json
Responseobject[]
404
Failed to get all networks
get
GET /api/networks HTTP/1.1
Host: 
Accept: */*
[
  {}
]

Inspect a network

get
Responses
200
Network inspect
application/json
Responseobject
404
Failed to inspect network
get
GET /api/networks/{name}/inspect HTTP/1.1
Host: 
Accept: */*
{}

Get all volumes

get
Responses
200
All volumes
application/json
Responseobject[]
404
Failed to get all volumes
get
GET /api/volumes HTTP/1.1
Host: 
Accept: */*
[
  {}
]

Inspect a volume

get
Responses
200
Volume inspect
application/json
Responseobject
404
Failed to inspect volume
get
GET /api/volumes/{name}/inspect HTTP/1.1
Host: 
Accept: */*
{}
  • GETGet all service containers
  • GETInspect service container
  • GETGet service container logs
  • GETGet container state
  • GETReturns info about orchestrator being used to run Connectware
  • PUTPerform an operation on a service container
  • GETGet all core containers
  • GETInspect core container
  • GETGet core container logs
  • GETGet core container state
  • GETReturns info about orchestrator being used to run Connectware
  • PUTPerform an operation on a core container
  • GETGet all images
  • GETInspect a image
  • GETGet all networks
  • GETInspect a network
  • GETGet all volumes
  • GETInspect a volume

Perform an operation on a service container

put
Path parameters
namestringRequired

Name of the service container

Body
operationstring · enumRequiredPossible values:
Responses
200
Service container inspection after operation is performed
application/json
Responseobject
400
Invalid request
404
Service container not found
put
PUT /api/containers/{name}/operation HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 21

{
  "operation": "start"
}
{}

Perform an operation on a core container

put
Path parameters
namestringRequired

Name of the core container

Body
operationstring · enumRequiredPossible values:
Responses
200
Core container inspection after operation is performed
application/json
Responseobject
400
Invalid request
404
Core container not found
put
PUT /api/core-containers/{name}/operation HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 21

{
  "operation": "start"
}
{}