Aggregators
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.
Create core instance request body.
new-core-instance
default core-fluent-bit image to use by the pipelines created on this core_instance.
null
Example: ghcr.io/calyptia/core/calyptia-fluent-bit:23.1.2
v0.1.12
Enable cluster-logging functionality on this core instance.
The kind/type of the service associated to this port.
LoadBalancer
Possible values: null
environment ID to associate this core instance with.
null
If true, kubernetes service creation will be skipped for all pipelines that exists on this core_instance.
null
POST /v1/aggregators HTTP/1.1
Host: cloud-api.calyptia.com
X-Project-Token: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 296
{
"name": "new-core-instance",
"image": "ghcr.io/calyptia/core/calyptia-fluent-bit:23.1.2",
"version": "v0.1.12",
"addHealthCheckPipeline": true,
"clusterLogging": true,
"healthCheckPipelinePort": 1,
"healthCheckPipelinePortKind": "LoadBalancer",
"metadata": {},
"environmentID": "text",
"skipServiceCreation": true
}
Created
{
"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": "classic",
"createdAt": "2025-06-27T23:07:08.118Z"
},
"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": "2025-06-27T23:07:08.118Z",
"updatedAt": "2025-06-27T23:07:08.118Z"
}
],
"status": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"config": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"rawConfig": "text",
"createdAt": "2025-06-27T23:07:08.118Z"
},
"status": "NEW",
"events": [
{
"source": "k8s:deployment",
"reason": "text",
"message": "text",
"loggedAt": "2025-06-27T23:07:08.118Z"
}
],
"createdAt": "2025-06-27T23:07:08.118Z"
},
"resourceProfile": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "my-resource-profile",
"storageMaxChunksUp": 1,
"storageSyncFull": true,
"storageBacklogMemLimit": "1Mi",
"storageVolumeSize": "2Mi",
"storageMaxChunksPause": true,
"cpuBufferWorkers": 1,
"cpuLimit": "3Mi",
"cpuRequest": "4Mi",
"memoryLimit": "5Mi",
"memoryRequest": "6Mi",
"createdAt": "2025-06-27T23:07:08.118Z",
"updatedAt": "2025-06-27T23:07:08.118Z"
},
"deploymentStrategy": "rollingupdate",
"tracingEnabled": false,
"waitForChecksBeforeDeploying": false,
"image": "ghcr.io/calyptia/core/calyptia-fluent-bit:23.1.2",
"replicasCount": 1,
"replicasCountPrev": 1,
"checksTotal": 1,
"checksOK": 1,
"checksRunning": 1,
"tags": [
"text"
],
"metadata": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"secrets": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"key": "mysecret",
"value": "Ynl0ZXM=",
"createdAt": "2025-06-27T23:07:08.118Z",
"updatedAt": "2025-06-27T23:07:08.118Z"
}
],
"files": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"processingRuleID": "123e4567-e89b-12d3-a456-426614174000",
"name": "myfile",
"contents": "Ynl0ZXM=",
"encrypted": true,
"createdAt": "2025-06-27T23:07:08.118Z",
"updatedAt": "2025-06-27T23:07:08.118Z"
}
],
"ports": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"protocol": "tcp",
"kind": "LoadBalancer",
"frontendPort": 1,
"backendPort": 1,
"endpoint": "text",
"pluginID": "forward.0",
"pluginName": "forward",
"pluginAlias": "myforwardinput",
"createdAt": "2025-06-27T23:07:08.118Z",
"updatedAt": "2025-06-27T23:07:08.118Z"
}
],
"minReplicas": 1,
"maxReplicas": 1,
"scaleUpType": "Unknown",
"scaleUpValue": 1,
"scaleUpPeriodSeconds": 1,
"scaleDownType": "Unknown",
"scaleDownValue": 1,
"scaleDownPeriodSeconds": 1,
"utilizationCPUAverage": 1,
"utilizationMemoryAverage": 1,
"storageClass": "text",
"pvcRetentionPolicy": {
"whenScaled": "Retain",
"whenDeleted": "Retain"
},
"portKind": "LoadBalancer",
"labels": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"createdAt": "2025-06-27T23:07:08.118Z",
"updatedAt": "2025-06-27T23:07:08.118Z"
},
"clusterLoggingPipeline": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "my-pipeline",
"kind": "deployment",
"config": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"rawConfig": "text",
"configFormat": "classic",
"createdAt": "2025-06-27T23:07:08.118Z"
},
"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": "2025-06-27T23:07:08.118Z",
"updatedAt": "2025-06-27T23:07:08.118Z"
}
],
"status": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"config": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"rawConfig": "text",
"createdAt": "2025-06-27T23:07:08.118Z"
},
"status": "NEW",
"events": [
{
"source": "k8s:deployment",
"reason": "text",
"message": "text",
"loggedAt": "2025-06-27T23:07:08.118Z"
}
],
"createdAt": "2025-06-27T23:07:08.118Z"
},
"resourceProfile": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "my-resource-profile",
"storageMaxChunksUp": 1,
"storageSyncFull": true,
"storageBacklogMemLimit": "1Mi",
"storageVolumeSize": "2Mi",
"storageMaxChunksPause": true,
"cpuBufferWorkers": 1,
"cpuLimit": "3Mi",
"cpuRequest": "4Mi",
"memoryLimit": "5Mi",
"memoryRequest": "6Mi",
"createdAt": "2025-06-27T23:07:08.118Z",
"updatedAt": "2025-06-27T23:07:08.118Z"
},
"deploymentStrategy": "rollingupdate",
"tracingEnabled": false,
"waitForChecksBeforeDeploying": false,
"image": "ghcr.io/calyptia/core/calyptia-fluent-bit:23.1.2",
"replicasCount": 1,
"replicasCountPrev": 1,
"checksTotal": 1,
"checksOK": 1,
"checksRunning": 1,
"tags": [
"text"
],
"metadata": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"secrets": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"key": "mysecret",
"value": "Ynl0ZXM=",
"createdAt": "2025-06-27T23:07:08.118Z",
"updatedAt": "2025-06-27T23:07:08.118Z"
}
],
"files": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"processingRuleID": "123e4567-e89b-12d3-a456-426614174000",
"name": "myfile",
"contents": "Ynl0ZXM=",
"encrypted": true,
"createdAt": "2025-06-27T23:07:08.118Z",
"updatedAt": "2025-06-27T23:07:08.118Z"
}
],
"ports": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"protocol": "tcp",
"kind": "LoadBalancer",
"frontendPort": 1,
"backendPort": 1,
"endpoint": "text",
"pluginID": "forward.0",
"pluginName": "forward",
"pluginAlias": "myforwardinput",
"createdAt": "2025-06-27T23:07:08.118Z",
"updatedAt": "2025-06-27T23:07:08.118Z"
}
],
"minReplicas": 1,
"maxReplicas": 1,
"scaleUpType": "Unknown",
"scaleUpValue": 1,
"scaleUpPeriodSeconds": 1,
"scaleDownType": "Unknown",
"scaleDownValue": 1,
"scaleDownPeriodSeconds": 1,
"utilizationCPUAverage": 1,
"utilizationMemoryAverage": 1,
"storageClass": "text",
"pvcRetentionPolicy": {
"whenScaled": "Retain",
"whenDeleted": "Retain"
},
"portKind": "LoadBalancer",
"labels": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"createdAt": "2025-06-27T23:07:08.118Z",
"updatedAt": "2025-06-27T23:07:08.118Z"
},
"resourceProfiles": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "my-resource-profile",
"storageMaxChunksUp": 1,
"storageSyncFull": true,
"storageBacklogMemLimit": "1Mi",
"storageVolumeSize": "2Mi",
"storageMaxChunksPause": true,
"cpuBufferWorkers": 1,
"cpuLimit": "3Mi",
"cpuRequest": "4Mi",
"memoryLimit": "5Mi",
"memoryRequest": "6Mi",
"createdAt": "2025-06-27T23:07:08.118Z",
"updatedAt": "2025-06-27T23:07:08.118Z"
}
],
"environmentName": "default",
"skipServiceCreation": false,
"createdAt": "2025-06-27T23:07:08.118Z"
}
Core instance by ID.
Exclude internal pipelines (health-check) from count.
GET /v1/aggregators/{aggregatorID} HTTP/1.1
Host: cloud-api.calyptia.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
OK
{
"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": 1,
"createdAt": "2025-06-27T23:07:08.118Z",
"updatedAt": "2025-06-27T23:07:08.118Z",
"tags": [
"text"
],
"environmentName": "default",
"skipServiceCreation": false
}
Update core instance by its ID.
Update core instance request body.
null
Example: new-core-instance
default core-fluent-bit image to use by the pipelines created on this core_instance.
null
Example: ghcr.io/calyptia/core/calyptia-fluent-bit:23.1.2
enable or disable cluster-logging functionality.
null
null
Example: v0.1.12
null
Core Instance Metadata model.
environment ID to associate this core instance with.
null
If true, kubernetes service creation will be skipped for all pipelines that exists on this core_instance.
null
PATCH /v1/aggregators/{aggregatorID} HTTP/1.1
Host: cloud-api.calyptia.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 421
{
"name": "new-core-instance",
"image": "ghcr.io/calyptia/core/calyptia-fluent-bit:23.1.2",
"clusterLogging": true,
"version": "v0.1.12",
"tags": [
"text"
],
"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"
},
"environmentID": "text",
"skipServiceCreation": true
}
No Content
No content