Aggregators

Create core instance

Create core instance within a project. The project in which the core instance is created is parser from the authorization token. Users are not allowed to create core instances.

POSThttps://cloud-api.calyptia.com/v1/aggregators

Authorization

project

Body

application/json

name*string (hostname)

Example: "new-core-instance"

imagenullable string

default core-fluent-bit image to use by the pipelines created on this core_instance.

Example: "ghcr.io/calyptia/core/calyptia-fluent-bit:23.1.2"

version*string

Example: "v0.1.12"

addHealthCheckPipeline*boolean

clusterLoggingboolean

Enable cluster-logging functionality on this core instance.

healthCheckPipelinePort*integer (int32)

healthCheckPipelinePortKind*PipelinePortKind (enum)

The kind/type of the service associated to this port.

LoadBalancerClusterIPNodePort

metadatanullable object

environmentIDnullable string

environment ID to associate this core instance with.

skipServiceCreationnullable boolean

If true, kubernetes service creation will be skipped for all pipelines that exists on this core_instance.

Response

201

Created

Body

application/json

id*string (uuid)

privateRSAKey*string (byte)

publicRSAKey*string (byte)

name*string (hostname)

Example: "my-core-instance"

version*string

Example: "v0.1.12"

image*string

default core-fluent-bit image to use by the pipelines created on this core_instance.

Example: "ghcr.io/calyptia/core/calyptia-fluent-bit:23.1.2"

tags*nullable array of string

healthCheckPipeline*Pipeline (object)

Pipeline model.

clusterLoggingPipeline*Pipeline (object)

Pipeline model.

resourceProfiles*array of ResourceProfile (object)

environmentName*string

environment name on which the agent belongs to.

skipServiceCreation*boolean

createdAt*string (date-time)

Request

JavaScriptCurlPython

const response = await fetch('https://cloud-api.calyptia.com/v1/aggregators', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "name": "new-core-instance",
      "version": "v0.1.12",
      "addHealthCheckPipeline": false,
      "healthCheckPipelinePort": 0,
      "healthCheckPipelinePortKind": "LoadBalancer"
    }),
});
const data = await response.json();

Response

201

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "privateRSAKey": "Ynl0ZXM=",
  "publicRSAKey": "Ynl0ZXM=",
  "name": "my-core-instance",
  "version": "v0.1.12",
  "image": "ghcr.io/calyptia/core/calyptia-fluent-bit:23.1.2",
  "tags": [
    "text"
  ],
  "healthCheckPipeline": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "my-pipeline",
    "kind": "deployment",
    "config": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "rawConfig": "text",
      "configFormat": "ini",
      "createdAt": "2024-12-22T04:51:56.637Z"
    },
    "configSections": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "projectID": "123e4567-e89b-12d3-a456-426614174000",
        "processingRuleID": "123e4567-e89b-12d3-a456-426614174000",
        "kind": "input",
        "properties": [
          {
            "key": "name",
            "value": "dummy"
          }
        ],
        "createdAt": "2024-12-22T04:51:56.637Z",
        "updatedAt": "2024-12-22T04:51:56.637Z"
      }
    ],
    "status": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "config": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "rawConfig": "text",
        "createdAt": "2024-12-22T04:51:56.637Z"
      },
      "status": "NEW",
      "events": [
        {
          "source": "k8s:deployment",
          "reason": "text",
          "message": "text",
          "loggedAt": "2024-12-22T04:51:56.637Z"
        }
      ],
      "createdAt": "2024-12-22T04:51:56.637Z"
    },
    "resourceProfile": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "my-resource-profile",
      "storageMaxChunksUp": 0,
      "storageSyncFull": false,
      "storageBacklogMemLimit": "1Mi",
      "storageVolumeSize": "2Mi",
      "storageMaxChunksPause": false,
      "cpuBufferWorkers": 0,
      "cpuLimit": "3Mi",
      "cpuRequest": "4Mi",
      "memoryLimit": "5Mi",
      "memoryRequest": "6Mi",
      "createdAt": "2024-12-22T04:51:56.637Z",
      "updatedAt": "2024-12-22T04:51:56.637Z"
    },
    "deploymentStrategy": "recreate",
    "tracingEnabled": false,
    "waitForChecksBeforeDeploying": false,
    "image": "ghcr.io/calyptia/core/calyptia-fluent-bit:23.1.2",
    "replicasCount": 0,
    "replicasCountPrev": 0,
    "checksTotal": 0,
    "checksOK": 0,
    "checksRunning": 0,
    "tags": [
      "text"
    ],
    "secrets": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "key": "mysecret",
        "value": "Ynl0ZXM=",
        "createdAt": "2024-12-22T04:51:56.637Z",
        "updatedAt": "2024-12-22T04:51:56.637Z"
      }
    ],
    "files": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "processingRuleID": "123e4567-e89b-12d3-a456-426614174000",
        "name": "myfile",
        "contents": "Ynl0ZXM=",
        "encrypted": false,
        "createdAt": "2024-12-22T04:51:56.637Z",
        "updatedAt": "2024-12-22T04:51:56.637Z"
      }
    ],
    "ports": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "protocol": "tcp",
        "kind": "LoadBalancer",
        "frontendPort": 0,
        "backendPort": 0,
        "endpoint": "text",
        "pluginID": "forward.0",
        "pluginName": "forward",
        "pluginAlias": "myforwardinput",
        "createdAt": "2024-12-22T04:51:56.637Z",
        "updatedAt": "2024-12-22T04:51:56.637Z"
      }
    ],
    "minReplicas": 0,
    "maxReplicas": 0,
    "scaleUpType": "Unknown",
    "scaleUpValue": 0,
    "scaleUpPeriodSeconds": 0,
    "scaleDownType": "Unknown",
    "scaleDownValue": 0,
    "scaleDownPeriodSeconds": 0,
    "utilizationCPUAverage": 0,
    "utilizationMemoryAverage": 0,
    "portKind": "LoadBalancer",
    "createdAt": "2024-12-22T04:51:56.637Z",
    "updatedAt": "2024-12-22T04:51:56.637Z"
  },
  "clusterLoggingPipeline": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "my-pipeline",
    "kind": "deployment",
    "config": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "rawConfig": "text",
      "configFormat": "ini",
      "createdAt": "2024-12-22T04:51:56.637Z"
    },
    "configSections": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "projectID": "123e4567-e89b-12d3-a456-426614174000",
        "processingRuleID": "123e4567-e89b-12d3-a456-426614174000",
        "kind": "input",
        "properties": [
          {
            "key": "name",
            "value": "dummy"
          }
        ],
        "createdAt": "2024-12-22T04:51:56.637Z",
        "updatedAt": "2024-12-22T04:51:56.637Z"
      }
    ],
    "status": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "config": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "rawConfig": "text",
        "createdAt": "2024-12-22T04:51:56.637Z"
      },
      "status": "NEW",
      "events": [
        {
          "source": "k8s:deployment",
          "reason": "text",
          "message": "text",
          "loggedAt": "2024-12-22T04:51:56.637Z"
        }
      ],
      "createdAt": "2024-12-22T04:51:56.637Z"
    },
    "resourceProfile": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "my-resource-profile",
      "storageMaxChunksUp": 0,
      "storageSyncFull": false,
      "storageBacklogMemLimit": "1Mi",
      "storageVolumeSize": "2Mi",
      "storageMaxChunksPause": false,
      "cpuBufferWorkers": 0,
      "cpuLimit": "3Mi",
      "cpuRequest": "4Mi",
      "memoryLimit": "5Mi",
      "memoryRequest": "6Mi",
      "createdAt": "2024-12-22T04:51:56.637Z",
      "updatedAt": "2024-12-22T04:51:56.637Z"
    },
    "deploymentStrategy": "recreate",
    "tracingEnabled": false,
    "waitForChecksBeforeDeploying": false,
    "image": "ghcr.io/calyptia/core/calyptia-fluent-bit:23.1.2",
    "replicasCount": 0,
    "replicasCountPrev": 0,
    "checksTotal": 0,
    "checksOK": 0,
    "checksRunning": 0,
    "tags": [
      "text"
    ],
    "secrets": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "key": "mysecret",
        "value": "Ynl0ZXM=",
        "createdAt": "2024-12-22T04:51:56.637Z",
        "updatedAt": "2024-12-22T04:51:56.637Z"
      }
    ],
    "files": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "processingRuleID": "123e4567-e89b-12d3-a456-426614174000",
        "name": "myfile",
        "contents": "Ynl0ZXM=",
        "encrypted": false,
        "createdAt": "2024-12-22T04:51:56.637Z",
        "updatedAt": "2024-12-22T04:51:56.637Z"
      }
    ],
    "ports": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "protocol": "tcp",
        "kind": "LoadBalancer",
        "frontendPort": 0,
        "backendPort": 0,
        "endpoint": "text",
        "pluginID": "forward.0",
        "pluginName": "forward",
        "pluginAlias": "myforwardinput",
        "createdAt": "2024-12-22T04:51:56.637Z",
        "updatedAt": "2024-12-22T04:51:56.637Z"
      }
    ],
    "minReplicas": 0,
    "maxReplicas": 0,
    "scaleUpType": "Unknown",
    "scaleUpValue": 0,
    "scaleUpPeriodSeconds": 0,
    "scaleDownType": "Unknown",
    "scaleDownValue": 0,
    "scaleDownPeriodSeconds": 0,
    "utilizationCPUAverage": 0,
    "utilizationMemoryAverage": 0,
    "portKind": "LoadBalancer",
    "createdAt": "2024-12-22T04:51:56.637Z",
    "updatedAt": "2024-12-22T04:51:56.637Z"
  },
  "resourceProfiles": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "my-resource-profile",
      "storageMaxChunksUp": 0,
      "storageSyncFull": false,
      "storageBacklogMemLimit": "1Mi",
      "storageVolumeSize": "2Mi",
      "storageMaxChunksPause": false,
      "cpuBufferWorkers": 0,
      "cpuLimit": "3Mi",
      "cpuRequest": "4Mi",
      "memoryLimit": "5Mi",
      "memoryRequest": "6Mi",
      "createdAt": "2024-12-22T04:51:56.637Z",
      "updatedAt": "2024-12-22T04:51:56.637Z"
    }
  ],
  "environmentName": "default",
  "skipServiceCreation": false,
  "createdAt": "2024-12-22T04:51:56.637Z"
}

Core instance

Core instance by ID.

GEThttps://cloud-api.calyptia.com/v1/aggregators/{aggregatorID}

Authorization

userproject

Path parameters

aggregatorID*string (uuid)

Query parameters

Response

200

OK

Body

application/json

id*string (uuid)

name*string (hostname)

Example: "my-core-instance"

versionstring

Example: "v0.1.12"

statusenum

Running status of the core instance in reference to the last ping. Refer to https://pkg.go.dev/github.com/calyptia/api@main/types#pkg-constants if looking up for the current timeout defaults.

runningwaitingunreachable

metadataCoreInstanceMetadata (object)

Core Instance Metadata model.

MetadataAWS (object)MetadataGCP (object)MetadataK8S (object)

pipelinesCount*integer

createdAt*string (date-time)

updatedAt*string (date-time)

tagsnullable array of string

environmentName*string

Example: "default"

skipServiceCreation*boolean

Request

JavaScriptCurlPython

const response = await fetch('https://cloud-api.calyptia.com/v1/aggregators/{aggregatorID}', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer <token>"
    },
});
const data = await response.json();

Response

200

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "my-core-instance",
  "version": "v0.1.12",
  "status": "running",
  "metadata": {
    "aws.ami_id": "text",
    "aws.account_id": "text",
    "aws.hostname": "text",
    "aws.vpc_id": "text",
    "aws.private_ipv4": "text",
    "aws.public_ipv4": "text",
    "aws.ec2_instance_id": "text",
    "aws.ec2_instance_type": "text",
    "aws.az": "text"
  },
  "pipelinesCount": 0,
  "createdAt": "2024-12-22T04:51:56.637Z",
  "updatedAt": "2024-12-22T04:51:56.637Z",
  "tags": [
    "text"
  ],
  "environmentName": "default",
  "skipServiceCreation": false
}

Delete core instance

Delete core instance by its ID.

DELETEhttps://cloud-api.calyptia.com/v1/aggregators/{aggregatorID}

Authorization

userproject

Path parameters

aggregatorID*string (uuid)

Response

204

No Content

Request

JavaScriptCurlPython

const response = await fetch('https://cloud-api.calyptia.com/v1/aggregators/{aggregatorID}', {
    method: 'DELETE',
    headers: {
      "Authorization": "Bearer <token>"
    },
});
const data = await response.json();

Update core instance

Update core instance by its ID.

PATCHhttps://cloud-api.calyptia.com/v1/aggregators/{aggregatorID}

Authorization

userproject

Path parameters

aggregatorID*string (uuid)

Body

application/json

namenullable string (hostname)

Example: "new-core-instance"

imagenullable string

default core-fluent-bit image to use by the pipelines created on this core_instance.

Example: "ghcr.io/calyptia/core/calyptia-fluent-bit:23.1.2"

clusterLoggingnullable boolean

enable or disable cluster-logging functionality.

versionnullable string

Example: "v0.1.12"

tagsnullable array of string

metadataCoreInstanceMetadata (object)

Core Instance Metadata model.

MetadataAWS (object)MetadataGCP (object)MetadataK8S (object)

environmentIDnullable string

environment ID to associate this core instance with.

skipServiceCreationnullable boolean

If true, kubernetes service creation will be skipped for all pipelines that exists on this core_instance.

Response

204

No Content

Request

JavaScriptCurlPython

const response = await fetch('https://cloud-api.calyptia.com/v1/aggregators/{aggregatorID}', {
    method: 'PATCH',
    headers: {
      "Authorization": "Bearer <token>",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();