Get a cluster
Get a cluster.
Authorizations:
path Parameters
orgName required | string Example: my-company Signadot Org Name |
clusterName required | string Cluster Name |
Responses
Response samples
- 200
- 400
- 401
- 502
{- "createdAt": "string",
- "name": "string",
- "operator": {
- "version": "string"
}
}
Add a cluster
Add a Kubernetes cluster to Signadot.
Authorizations:
path Parameters
orgName required | string Example: my-company Signadot Org Name |
clusterName required | string Example: my-cluster Cluster Name |
Responses
Response samples
- 200
- 400
- 401
- 502
{- "createdAt": "string",
- "name": "string",
- "operator": {
- "version": "string"
}
}
Create cluster token
Create a new token for connecting a cluster.
Authorizations:
path Parameters
orgName required | string Example: my-company Signadot Org Name |
clusterName required | string Example: my-new-cluster Cluster Name |
Responses
Response samples
- 200
{- "createdAt": "string",
- "id": "string",
- "maskedValue": "string",
- "status": {
- "lastConnectedAt": "string",
- "lastConnectedIp": "string"
}, - "token": "string"
}
List cluster tokens
List the cluster tokens associated with a cluster.
Authorizations:
path Parameters
orgName required | string Example: my-company Signadot Org Name |
clusterName required | string Example: my-new-cluster Cluster Name |
Responses
Response samples
- 200
[- {
- "createdAt": "string",
- "id": "string",
- "maskedValue": "string",
- "status": {
- "lastConnectedAt": "string",
- "lastConnectedIp": "string"
}, - "token": "string"
}
]
Delete cluster token
Delete a cluster token associated with a cluster.
Authorizations:
path Parameters
orgName required | string Example: my-company Signadot Org Name |
clusterName required | string Example: my-new-cluster Cluster Name |
tokenId required | string Example: kq6mtksk7mn5 Token Id |
Responses
Response samples
- 200
{ }
Get a cluster token
Get a cluster token associated with a cluster.
Authorizations:
path Parameters
orgName required | string Example: my-company Signadot Org Name |
clusterName required | string Example: my-new-cluster Cluster Name |
tokenId required | string Example: kq6mtksk7mn5 Token Id |
Responses
Response samples
- 200
{- "createdAt": "string",
- "id": "string",
- "maskedValue": "string",
- "status": {
- "lastConnectedAt": "string",
- "lastConnectedIp": "string"
}, - "token": "string"
}
List resource plugins
List all resource plugins under the specified Signadot org.
Authorizations:
path Parameters
orgName required | string Example: my-company Signadot Org Name |
Responses
Response samples
- 200
- 400
- 401
- 502
[- {
- "createdAt": "string",
- "name": "string",
- "spec": {
- "create": [
- {
- "inputs": [
- {
- "as": {
- "env": "string",
- "path": "string"
}, - "name": "string",
- "type": "string",
- "valueFromSandbox": true,
- "valueFromStep": {
- "name": "string",
- "output": "string"
}
}
], - "name": "string",
- "outputs": [
- {
- "description": "string",
- "name": "string",
- "type": "string",
- "valueFromPath": "string"
}
], - "script": "string"
}
], - "delete": [
- {
- "inputs": [
- {
- "as": {
- "env": "string",
- "path": "string"
}, - "name": "string",
- "type": "string",
- "valueFromSandbox": true,
- "valueFromStep": {
- "name": "string",
- "output": "string"
}
}
], - "name": "string",
- "outputs": [
- {
- "description": "string",
- "name": "string",
- "type": "string",
- "valueFromPath": "string"
}
], - "script": "string"
}
], - "description": "string",
- "runner": {
- "image": "string",
- "namespace": "string",
- "podTemplateOverlay": "string"
}
}, - "status": {
- "resources": [
- {
- "cluster": "string",
- "name": "string",
- "sandbox": "string"
}
]
}, - "updatedAt": "string"
}
]
Get the requested resource plugin
Get the specified resource plugin by name
Authorizations:
path Parameters
orgName required | string Example: my-company Signadot Org Name |
pluginName required | string Example: mariadb-plugin Resource plugin name |
Responses
Response samples
- 200
- 400
- 401
- 502
{- "createdAt": "string",
- "name": "string",
- "spec": {
- "create": [
- {
- "inputs": [
- {
- "as": {
- "env": "string",
- "path": "string"
}, - "name": "string",
- "type": "string",
- "valueFromSandbox": true,
- "valueFromStep": {
- "name": "string",
- "output": "string"
}
}
], - "name": "string",
- "outputs": [
- {
- "description": "string",
- "name": "string",
- "type": "string",
- "valueFromPath": "string"
}
], - "script": "string"
}
], - "delete": [
- {
- "inputs": [
- {
- "as": {
- "env": "string",
- "path": "string"
}, - "name": "string",
- "type": "string",
- "valueFromSandbox": true,
- "valueFromStep": {
- "name": "string",
- "output": "string"
}
}
], - "name": "string",
- "outputs": [
- {
- "description": "string",
- "name": "string",
- "type": "string",
- "valueFromPath": "string"
}
], - "script": "string"
}
], - "description": "string",
- "runner": {
- "image": "string",
- "namespace": "string",
- "podTemplateOverlay": "string"
}
}, - "status": {
- "resources": [
- {
- "cluster": "string",
- "name": "string",
- "sandbox": "string"
}
]
}, - "updatedAt": "string"
}
Apply a resource plugin
Apply a resource plugin. Updates are not supported at this time.
Authorizations:
path Parameters
orgName required | string Example: my-company Signadot Org Name |
pluginName required | string Example: mariadb-plugin Resource plugin name |
Request Body schema: application/jsonrequired
Request to create or update a resource plugin
createdAt | string The time at which the resource plugin was created |
name | string Name of the resource plugin |
object (resourceplugin.Spec) | |
object (resourceplugin.Status) | |
updatedAt | string The time at which the resource plugin was last updated |
Responses
Request samples
- Payload
{- "createdAt": "string",
- "name": "string",
- "spec": {
- "create": [
- {
- "inputs": [
- {
- "as": {
- "env": "string",
- "path": "string"
}, - "name": "string",
- "type": "string",
- "valueFromSandbox": true,
- "valueFromStep": {
- "name": "string",
- "output": "string"
}
}
], - "name": "string",
- "outputs": [
- {
- "description": "string",
- "name": "string",
- "type": "string",
- "valueFromPath": "string"
}
], - "script": "string"
}
], - "delete": [
- {
- "inputs": [
- {
- "as": {
- "env": "string",
- "path": "string"
}, - "name": "string",
- "type": "string",
- "valueFromSandbox": true,
- "valueFromStep": {
- "name": "string",
- "output": "string"
}
}
], - "name": "string",
- "outputs": [
- {
- "description": "string",
- "name": "string",
- "type": "string",
- "valueFromPath": "string"
}
], - "script": "string"
}
], - "description": "string",
- "runner": {
- "image": "string",
- "namespace": "string",
- "podTemplateOverlay": "string"
}
}, - "status": {
- "resources": [
- {
- "cluster": "string",
- "name": "string",
- "sandbox": "string"
}
]
}, - "updatedAt": "string"
}
Response samples
- 200
- 400
- 401
- 502
{ }
List routegroups
List all routegroups under the specified Signadot org.
Authorizations:
path Parameters
orgName required | string Example: my-company Signadot Org Name |
Responses
Response samples
- 200
- 400
- 401
- 502
[- {
- "createdAt": "string",
- "endpoints": [
- {
- "name": "string",
- "target": "string",
- "url": "string"
}
], - "name": "string",
- "routingKey": "string",
- "spec": {
- "cluster": "string",
- "description": "string",
- "endpoints": [
- {
- "name": "string",
- "target": "string"
}
], - "match": {
- "all": [
- { }
], - "any": [
- { }
], - "label": {
- "key": "string",
- "value": "string"
}
}, - "ttl": {
- "duration": "string",
- "offsetFrom": "string"
}
}, - "status": {
- "matchedSandboxes": [
- "string"
], - "message": "string",
- "ready": true,
- "reason": "string",
- "scheduledDeleteTime": "string"
}, - "updatedAt": "string"
}
]
Get a routegroup
Fetch the details about a given routegroup.
Authorizations:
path Parameters
orgName required | string Example: my-company Signadot Org Name |
routegroupName required | string Example: my-routegroup RouteGroup Name |
Responses
Response samples
- 200
- 400
- 401
- 502
{- "createdAt": "string",
- "endpoints": [
- {
- "name": "string",
- "target": "string",
- "url": "string"
}
], - "name": "string",
- "routingKey": "string",
- "spec": {
- "cluster": "string",
- "description": "string",
- "endpoints": [
- {
- "name": "string",
- "target": "string"
}
], - "match": {
- "all": [
- { }
], - "any": [
- { }
], - "label": {
- "key": "string",
- "value": "string"
}
}, - "ttl": {
- "duration": "string",
- "offsetFrom": "string"
}
}, - "status": {
- "matchedSandboxes": [
- "string"
], - "message": "string",
- "ready": true,
- "reason": "string",
- "scheduledDeleteTime": "string"
}, - "updatedAt": "string"
}
Create or update a routegroup
Creates or updates a routegroup with the provided parameters.
Authorizations:
path Parameters
orgName required | string Example: my-company Signadot Org Name |
routegroupName required | string Example: my-routegroup RouteGroup Name |
Request Body schema: application/jsonrequired
Request to create or update routegroup
createdAt | string |
Array of objects (routeGroup.Endpoint) | |
name | string |
routingKey | string |
object (routeGroup.Spec) | |
object (routeGroup.Status) | |
updatedAt | string |
Responses
Request samples
- Payload
{- "createdAt": "string",
- "endpoints": [
- {
- "name": "string",
- "target": "string",
- "url": "string"
}
], - "name": "string",
- "routingKey": "string",
- "spec": {
- "cluster": "string",
- "description": "string",
- "endpoints": [
- {
- "name": "string",
- "target": "string"
}
], - "match": {
- "all": [
- { }
], - "any": [
- { }
], - "label": {
- "key": "string",
- "value": "string"
}
}, - "ttl": {
- "duration": "string",
- "offsetFrom": "string"
}
}, - "status": {
- "matchedSandboxes": [
- "string"
], - "message": "string",
- "ready": true,
- "reason": "string",
- "scheduledDeleteTime": "string"
}, - "updatedAt": "string"
}
Response samples
- 200
- 400
- 401
- 502
{- "createdAt": "string",
- "endpoints": [
- {
- "name": "string",
- "target": "string",
- "url": "string"
}
], - "name": "string",
- "routingKey": "string",
- "spec": {
- "cluster": "string",
- "description": "string",
- "endpoints": [
- {
- "name": "string",
- "target": "string"
}
], - "match": {
- "all": [
- { }
], - "any": [
- { }
], - "label": {
- "key": "string",
- "value": "string"
}
}, - "ttl": {
- "duration": "string",
- "offsetFrom": "string"
}
}, - "status": {
- "matchedSandboxes": [
- "string"
], - "message": "string",
- "ready": true,
- "reason": "string",
- "scheduledDeleteTime": "string"
}, - "updatedAt": "string"
}
List sandboxes
List all sandboxes under the specified Signadot org.
Authorizations:
path Parameters
orgName required | string Example: my-company Signadot Org Name |
Responses
Response samples
- 200
- 400
- 401
- 502
[- {
- "createdAt": "string",
- "endpoints": [
- {
- "baselineUrl": "string",
- "host": "string",
- "name": "string",
- "port": 0,
- "protocol": "string",
- "routeType": "string",
- "target": "string",
- "url": "string"
}
], - "name": "string",
- "routingKey": "string",
- "spec": {
- "cluster": "string",
- "defaultRouteGroup": {
- "endpoints": [
- {
- "name": "string",
- "target": "string"
}
]
}, - "description": "string",
- "endpoints": [
- {
- "host": "string",
- "name": "string",
- "port": 0,
- "protocol": "string"
}
], - "forks": [
- {
- "customizations": {
- "env": [
- {
- "container": "string",
- "name": "string",
- "operation": "string",
- "value": "string",
- "valueFrom": {
- "fork": {
- "expression": null,
- "forkOf": null
}, - "resource": {
- "name": null,
- "outputKey": null
}
}
}
], - "images": [
- {
- "container": "string",
- "image": "string"
}
], - "patch": {
- "type": "string",
- "value": "string"
}
}, - "endpoints": [
- {
- "name": "string",
- "port": 0,
- "protocol": "string"
}
], - "forkOf": {
- "kind": "Deployment",
- "name": "my-frontend",
- "namespace": "default"
}
}
], - "labels": {
- "property1": "string",
- "property2": "string"
}, - "resources": [
- {
- "name": "string",
- "params": {
- "property1": "string",
- "property2": "string"
}, - "plugin": "string"
}
], - "ttl": {
- "duration": "string",
- "offsetFrom": "string"
}
}, - "status": {
- "local": [
- {
- "name": "string",
- "tunnel": {
- "health": {
- "connected": true,
- "lastCheckTime": "string",
- "lastConnectedTime": "string"
}
}
}
], - "message": "string",
- "ready": true,
- "reason": "string"
}, - "updatedAt": "string"
}
]
Delete a sandbox
Delete a given sandbox.
Authorizations:
path Parameters
orgName required | string Example: my-company Signadot Org Name |
sandboxName required | string Example: my-sandbox Sandbox Name |
query Parameters
force | boolean force |
Responses
Response samples
- 200
- 400
- 401
- 502
{ }
Get a sandbox
Fetch the details about a given sandbox.
Authorizations:
path Parameters
orgName required | string Example: my-company Signadot Org Name |
sandboxName required | string Example: my-sandbox Sandbox Name |
Responses
Response samples
- 200
- 400
- 401
- 502
{- "createdAt": "string",
- "endpoints": [
- {
- "baselineUrl": "string",
- "host": "string",
- "name": "string",
- "port": 0,
- "protocol": "string",
- "routeType": "string",
- "target": "string",
- "url": "string"
}
], - "name": "string",
- "routingKey": "string",
- "spec": {
- "cluster": "string",
- "defaultRouteGroup": {
- "endpoints": [
- {
- "name": "string",
- "target": "string"
}
]
}, - "description": "string",
- "endpoints": [
- {
- "host": "string",
- "name": "string",
- "port": 0,
- "protocol": "string"
}
], - "forks": [
- {
- "customizations": {
- "env": [
- {
- "container": "string",
- "name": "string",
- "operation": "string",
- "value": "string",
- "valueFrom": {
- "fork": {
- "expression": "string",
- "forkOf": {
- "kind": null,
- "name": null,
- "namespace": null
}
}, - "resource": {
- "name": "string",
- "outputKey": "string"
}
}
}
], - "images": [
- {
- "container": "string",
- "image": "string"
}
], - "patch": {
- "type": "string",
- "value": "string"
}
}, - "endpoints": [
- {
- "name": "string",
- "port": 0,
- "protocol": "string"
}
], - "forkOf": {
- "kind": "Deployment",
- "name": "my-frontend",
- "namespace": "default"
}
}
], - "labels": {
- "property1": "string",
- "property2": "string"
}, - "resources": [
- {
- "name": "string",
- "params": {
- "property1": "string",
- "property2": "string"
}, - "plugin": "string"
}
], - "ttl": {
- "duration": "string",
- "offsetFrom": "string"
}
}, - "status": {
- "local": [
- {
- "name": "string",
- "tunnel": {
- "health": {
- "connected": true,
- "lastCheckTime": "string",
- "lastConnectedTime": "string"
}
}
}
], - "message": "string",
- "ready": true,
- "reason": "string"
}, - "updatedAt": "string"
}
Create or update a sandbox
Creates or updates a sandbox with the provided parameters.
Authorizations:
path Parameters
orgName required | string Example: my-company Signadot Org Name |
sandboxName required | string Example: my-sandbox Sandbox Name |
Request Body schema: application/jsonrequired
Request to create sandbox
createdAt | string |
Array of objects (sandbox.Endpoint) | |
name | string Human-readable name of this sandbox |
routingKey | string |
object (sandbox.Spec) | |
object (sandbox.Readiness) | |
updatedAt | string |
Responses
Request samples
- Payload
{- "createdAt": "string",
- "endpoints": [
- {
- "baselineUrl": "string",
- "host": "string",
- "name": "string",
- "port": 0,
- "protocol": "string",
- "routeType": "string",
- "target": "string",
- "url": "string"
}
], - "name": "string",
- "routingKey": "string",
- "spec": {
- "cluster": "string",
- "defaultRouteGroup": {
- "endpoints": [
- {
- "name": "string",
- "target": "string"
}
]
}, - "description": "string",
- "endpoints": [
- {
- "host": "string",
- "name": "string",
- "port": 0,
- "protocol": "string"
}
], - "forks": [
- {
- "customizations": {
- "env": [
- {
- "container": "string",
- "name": "string",
- "operation": "string",
- "value": "string",
- "valueFrom": {
- "fork": {
- "expression": "string",
- "forkOf": {
- "kind": null,
- "name": null,
- "namespace": null
}
}, - "resource": {
- "name": "string",
- "outputKey": "string"
}
}
}
], - "images": [
- {
- "container": "string",
- "image": "string"
}
], - "patch": {
- "type": "string",
- "value": "string"
}
}, - "endpoints": [
- {
- "name": "string",
- "port": 0,
- "protocol": "string"
}
], - "forkOf": {
- "kind": "Deployment",
- "name": "my-frontend",
- "namespace": "default"
}
}
], - "labels": {
- "property1": "string",
- "property2": "string"
}, - "resources": [
- {
- "name": "string",
- "params": {
- "property1": "string",
- "property2": "string"
}, - "plugin": "string"
}
], - "ttl": {
- "duration": "string",
- "offsetFrom": "string"
}
}, - "status": {
- "local": [
- {
- "name": "string",
- "tunnel": {
- "health": {
- "connected": true,
- "lastCheckTime": "string",
- "lastConnectedTime": "string"
}
}
}
], - "message": "string",
- "ready": true,
- "reason": "string"
}, - "updatedAt": "string"
}
Response samples
- 200
- 400
- 401
- 502
{- "createdAt": "string",
- "endpoints": [
- {
- "baselineUrl": "string",
- "host": "string",
- "name": "string",
- "port": 0,
- "protocol": "string",
- "routeType": "string",
- "target": "string",
- "url": "string"
}
], - "name": "string",
- "routingKey": "string",
- "spec": {
- "cluster": "string",
- "defaultRouteGroup": {
- "endpoints": [
- {
- "name": "string",
- "target": "string"
}
]
}, - "description": "string",
- "endpoints": [
- {
- "host": "string",
- "name": "string",
- "port": 0,
- "protocol": "string"
}
], - "forks": [
- {
- "customizations": {
- "env": [
- {
- "container": "string",
- "name": "string",
- "operation": "string",
- "value": "string",
- "valueFrom": {
- "fork": {
- "expression": "string",
- "forkOf": {
- "kind": null,
- "name": null,
- "namespace": null
}
}, - "resource": {
- "name": "string",
- "outputKey": "string"
}
}
}
], - "images": [
- {
- "container": "string",
- "image": "string"
}
], - "patch": {
- "type": "string",
- "value": "string"
}
}, - "endpoints": [
- {
- "name": "string",
- "port": 0,
- "protocol": "string"
}
], - "forkOf": {
- "kind": "Deployment",
- "name": "my-frontend",
- "namespace": "default"
}
}
], - "labels": {
- "property1": "string",
- "property2": "string"
}, - "resources": [
- {
- "name": "string",
- "params": {
- "property1": "string",
- "property2": "string"
}, - "plugin": "string"
}
], - "ttl": {
- "duration": "string",
- "offsetFrom": "string"
}
}, - "status": {
- "local": [
- {
- "name": "string",
- "tunnel": {
- "health": {
- "connected": true,
- "lastCheckTime": "string",
- "lastConnectedTime": "string"
}
}
}
], - "message": "string",
- "ready": true,
- "reason": "string"
}, - "updatedAt": "string"
}