Ports

Pipeline ports

Ports from a pipeline.

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

Authorization

userproject

Path parameters

pipelineID*string (uuid)

Query parameters

Response

200

OK

Body

application/json

id*string (uuid)

protocol*string

Example: "tcp"

kind*PipelinePortKind (enum)

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

LoadBalancerClusterIPNodePort

frontendPort*integer (int32)

backendPort*integer (int32)

endpoint*string

pluginID*nullable string

Example: "forward.0"

pluginName*nullable string

Example: "forward"

pluginAlias*nullable string

Example: "myforwardinput"

createdAt*string (date-time)

updatedAt*string (date-time)

Request

JavaScriptCurlPython

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

Response

200

[
  {
    "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-22T05:30:15.240Z",
    "updatedAt": "2024-12-22T05:30:15.240Z"
  }
]

Create pipeline port

Create port within a pipeline. Ports can automatically be parsed from a config file, but this action allows you to programatically add more.

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

Authorization

userproject

Path parameters

pipelineID*string (uuid)

Body

application/json

protocol*string

Example: "tcp"

frontendPort*integer (int32)

backendPort*integer (int32)

endpoint*string

kindPipelinePortKind (enum)

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

LoadBalancerClusterIPNodePort

Response

201

Created

Body

application/json

id*string (uuid)

kindnullable string

pluginID*nullable string

Example: "forward.0"

pluginName*nullable string

Example: "forward"

pluginAlias*nullable string

Example: "myforwardinput"

createdAt*string (date-time)

Request

JavaScriptCurlPython

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

Response

201

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "kind": "text",
  "pluginID": "forward.0",
  "pluginName": "forward",
  "pluginAlias": "myforwardinput",
  "createdAt": "2024-12-22T05:30:15.240Z"
}