Aggregator pipelines

Pipeline

Pipeline by ID.

GEThttps://cloud-api.calyptia.com/v1/aggregator_pipelines/{pipelineID}

Authorization

Path parameters

pipelineID*string (uuid)

Query parameters

Response

Body

id*string (uuid)

name*string

DNS label format as of defined on RFC1123

Example: "my-pipeline"

kind*PipelineKind (enum)

deploymentdaemonSet

config*PipelineConfig (object)

Pipeline configuration history entry.

configSections*array of ConfigSection (object)

status*PipelineStatus (object)

Pipeline status history entry.

resourceProfile*ResourceProfile (object)

Resource profile model.

deploymentStrategy*DeploymentStrategy (enum)

The deployment strategy to use when creating or updating changes to this pipeline.

rollingupdatehotReload

tracingEnabled*boolean

waitForChecksBeforeDeploying*boolean

image*nullable string

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

replicasCount*integer

replicasCountPrev*integer

the previous replica set counter

checksTotal*integer

total number of checks associated with the pipeline.

checksOK*integer

total number of checks with ok status.

checksRunning*integer

total number of checks with running status.

tags*nullable array of string

metadata*nullable object

secretsnullable array of PipelineSecret (object)

filesnullable array of PipelineFile (object)

portsnullable array of PipelinePort (object)

minReplicas*integer

minReplicas is the lower limit for the number of replicas to which the autoscaler can scale down.

maxReplicas*integer

maxReplicas is the upper limit for the number of replicas to which the autoscaler can scale up.

scaleUpType*ScalePolicy (enum)

UnknownPodsPercent

scaleUpValue*integer

value contains the amount of change which is permitted by the policy.

scaleUpPeriodSeconds*integer

ScaleUpPeriodSeconds specifies the window of time for which the policy should hold true.

scaleDownType*ScalePolicy (enum)

UnknownPodsPercent

scaleDownValue*integer

value contains the amount of change which is permitted by the policy.

scaleDownPeriodSeconds*integer

ScaleUpPeriodSeconds specifies the window of time for which the policy should hold true.

utilizationCPUAverage*integer

UtilizationCPUAverage defines the target value for average CPU utilization

utilizationMemoryAverage*integer

UtilizationMemoryAverage defines the target value for average CPU utilization

portKind*PipelinePortKind (enum)

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

LoadBalancerClusterIPNodePort

labels*nullable object

createdAt*string (date-time)

updatedAt*string (date-time)

Request

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

Response

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "my-pipeline",
  "kind": "deployment",
  "config": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "rawConfig": "text",
    "configFormat": "ini",
    "createdAt": "2025-01-15T04:39:39.325Z"
  },
  "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-01-15T04:39:39.325Z",
      "updatedAt": "2025-01-15T04:39:39.325Z"
    }
  ],
  "status": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "config": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "rawConfig": "text",
      "createdAt": "2025-01-15T04:39:39.325Z"
    },
    "status": "NEW",
    "events": [
      {
        "source": "k8s:deployment",
        "reason": "text",
        "message": "text",
        "loggedAt": "2025-01-15T04:39:39.325Z"
      }
    ],
    "createdAt": "2025-01-15T04:39:39.325Z"
  },
  "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": "2025-01-15T04:39:39.325Z",
    "updatedAt": "2025-01-15T04:39:39.325Z"
  },
  "deploymentStrategy": "rollingupdate",
  "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": "2025-01-15T04:39:39.325Z",
      "updatedAt": "2025-01-15T04:39:39.325Z"
    }
  ],
  "files": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "processingRuleID": "123e4567-e89b-12d3-a456-426614174000",
      "name": "myfile",
      "contents": "Ynl0ZXM=",
      "encrypted": false,
      "createdAt": "2025-01-15T04:39:39.325Z",
      "updatedAt": "2025-01-15T04:39:39.325Z"
    }
  ],
  "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": "2025-01-15T04:39:39.325Z",
      "updatedAt": "2025-01-15T04:39:39.325Z"
    }
  ],
  "minReplicas": 0,
  "maxReplicas": 0,
  "scaleUpType": "Unknown",
  "scaleUpValue": 0,
  "scaleUpPeriodSeconds": 0,
  "scaleDownType": "Unknown",
  "scaleDownValue": 0,
  "scaleDownPeriodSeconds": 0,
  "utilizationCPUAverage": 0,
  "utilizationMemoryAverage": 0,
  "portKind": "LoadBalancer",
  "createdAt": "2025-01-15T04:39:39.325Z",
  "updatedAt": "2025-01-15T04:39:39.325Z"
}

Delete pipeline

Delete pipeline by its ID.

DELETEhttps://cloud-api.calyptia.com/v1/aggregator_pipelines/{pipelineID}

Authorization

Path parameters

pipelineID*string (uuid)

Response

No Content

Request

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

Update pipeline

Update pipeline by its ID.

PATCHhttps://cloud-api.calyptia.com/v1/aggregator_pipelines/{pipelineID}

Authorization

Path parameters

pipelineID*string (uuid)

Body

namenullable string

DNS label format as of defined on RFC1123

Example: "new-pipeline"

kindenum

Kind of deployment used when deploying this pipeline

daemonSetdeployment

deploymentStrategyenum

The deployment strategy to use when creating or updating changes to this pipeline.

rollingupdatehotReload

replicasCountnullable integer

rawConfignullable string

configFormatnullable enum

inijsonyaml

imagenullable string

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

secretsnullable array of UpdatePipelineSecret (object)

filesnullable array of UpdatePipelineFile (object)

resourceProfilenullable string

Example: "my-resource-profile"

noAutoCreateEndpointsFromConfignullable boolean

noAutoCreateChecksFromConfignullable boolean

skipConfigValidationboolean

checksBeforeDeployingnullable boolean

If set to true:

If all checks associated with the pipeline run successfully, the status of the pipeline will be switched to CHECKS_OK and the deployment will be executed.

If any of the checks associated with the pipeline fails, the status of the pipeline will be switched to CHECKS_FAILED and the deployment of the pipeline will be blocked.

If set to false (default):

If all checks associated with the pipeline run successfully, the status of the pipeline will be switched to CHECKS_OK and the deployment will be executed.

If any of the checks associated with the pipeline fails, the status of the pipeline will be switched to CHECKS_FAILED and the deployment of the pipeline

statusnullable enum

NEWFAILEDSTARTINGSTARTEDSCALINGCHECKS_OKCHECKS_FAILED -

portKindPipelinePortKind (enum)

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

LoadBalancerClusterIPNodePort

eventsnullable array of PipelineEvent (object)

metadatanullable object

minReplicasnullable integer

maxReplicasnullable integer

scaleUpTypeScalePolicy (enum)

UnknownPodsPercent

scaleUpValuenullable integer

scaleUpPeriodSecondsnullable integer

scaleDownTypeScalePolicy (enum)

UnknownPodsPercent

scaleDownValuenullable integer

scaleDownPeriodSecondsnullable integer

utilizationCPUAveragenullable integer

utilizationMemoryAveragenullable integer

labelsnullable object

affinityAffinity (object)

topologySpreadConstraintsnullable array of TopologySpreadConstraint (object)

Response

Body

addedPortsarray of PipelinePort (object)

removedPortsarray of PipelinePort (object)

addedChecksarray of PipelineCheck (object)

removedChecksarray of PipelineCheck (object)

Request

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

Response

{
  "addedPorts": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "protocol": "tcp",
      "kind": "LoadBalancer",
      "frontendPort": 0,
      "backendPort": 0,
      "endpoint": "text",
      "pluginID": "forward.0",
      "pluginName": "forward",
      "pluginAlias": "myforwardinput",
      "createdAt": "2025-01-15T04:39:39.325Z",
      "updatedAt": "2025-01-15T04:39:39.325Z"
    }
  ],
  "removedPorts": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "protocol": "tcp",
      "kind": "LoadBalancer",
      "frontendPort": 0,
      "backendPort": 0,
      "endpoint": "text",
      "pluginID": "forward.0",
      "pluginName": "forward",
      "pluginAlias": "myforwardinput",
      "createdAt": "2025-01-15T04:39:39.325Z",
      "updatedAt": "2025-01-15T04:39:39.325Z"
    }
  ],
  "addedChecks": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "protocol": "tcp",
      "status": "new",
      "retries": 3,
      "port": 0,
      "host": "localhost",
      "createdAt": "2025-01-15T04:39:39.325Z",
      "updatedAt": "2025-01-15T04:39:39.325Z"
    }
  ],
  "removedChecks": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "protocol": "tcp",
      "status": "new",
      "retries": 3,
      "port": 0,
      "host": "localhost",
      "createdAt": "2025-01-15T04:39:39.325Z",
      "updatedAt": "2025-01-15T04:39:39.325Z"
    }
  ]
}

PreviousResource profiles NextConfig history