Hubs

Endpoints related to managing hubs on Cycle.

List Hubs

Lists all associated Hubs.

SecuritybearerAuth

Request

query Parameters

	object In a list return, the data associated with the page number and size returned. 20 results per page, page 2 would be `page[size]=20&page[number]=2`
	object Filter Field The filter field is a key-value object, where the key is what you would like to filter, and the value is the value you're filtering for.

Responses

200

Returns a list of Hubs.

default

General error response from the platform

get/v1/hubs

Response samples

200
default

application/json

{"data": [{"id": "651586fca6078e98982dbd90",
"identifier": "string",
"name": "string",
"creator": {"id": "651586fca6078e98982dbd90",
"type": "account"
},
"events": {"created": "2021-01-30T08:30:00Z",
"updated": "2021-01-30T08:30:00Z",
"deleted": "2021-01-30T08:30:00Z",
"converted": "2021-01-30T08:30:00Z",
"first_order": "2021-01-30T08:30:00Z",
"first_provider": "2021-01-30T08:30:00Z",
"first_server": "2021-01-30T08:30:00Z",
"first_environment": "2021-01-30T08:30:00Z",
"first_image": "2021-01-30T08:30:00Z",
"first_container": "2021-01-30T08:30:00Z"
},
"state": {"changed": "2021-01-30T08:30:00Z",
"error": {"message": "string",
"time": "2021-01-30T08:30:00Z"
}
},
"security": {"force_2fa": true
},
"webhooks": {"server_deployed": "string",
"server_deleted": "string"
},
"billing": {"term": {"start": "2021-01-30T08:30:00Z",
"end": "2021-01-30T08:30:00Z",
"renew": "once"
},
"allow_prepaid": true,
"pause_invoices": true,
"disable": true,
"plans": {"tier_id": "string",
"support_id": "string"
},
"emails": ["string"
]
},
"meta": {"membership": {"id": "651586fca6078e98982dbd90",
"account_id": "string",
"hub_id": "651586fca6078e98982dbd90",
"events": {"created": "2021-01-30T08:30:00Z",
"updated": "2021-01-30T08:30:00Z",
"deleted": "2021-01-30T08:30:00Z",
"joined": "2021-01-30T08:30:00Z"
},
"role_id": "651586fca6078e98982dbd90",
"preferences": {"portal": {"notifications": {"jobs": { }
}
},
"email": {"notificaitons": {"server": { }
}
}
},
"state": {"changed": "2021-01-30T08:30:00Z",
"error": {"message": "string",
"time": "2021-01-30T08:30:00Z"
}
},
"invitation": {"sender": {"id": "651586fca6078e98982dbd90",
"type": "string"
},
"recipient": "string",
"events": {"created": "2021-01-30T08:30:00Z",
"updated": "2021-01-30T08:30:00Z",
"deleted": "2021-01-30T08:30:00Z",
"accepted": "2021-01-30T08:30:00Z",
"declined": "2021-01-30T08:30:00Z",
"revoked": "2021-01-30T08:30:00Z"
}
},
"cycle": {"employee_id": "string"
}
}
}
}
]
}

Create Hub

Create a Hub.

SecuritybearerAuth

Request

Request Body schema: application/json

Parameters for creating a Hub.

name	string A name for the Hub.
identifier	string (Identifier) A human-readable identifier used to refer to a resource, where using the official ID may be inconvenient. The identifier is automatically tokenized from the name/relevant field of the resource if one is not provided. For example, a container named "My Container" will have the identifier of `my-container` and is automatically created by the platform. The identifier does not have to be unique.
	object (HubWebhooks) Hub related webhooks. When supplied, the given webhook will be called with a payload any time one of these events occurs.

Responses

200

Returns a Hub resource.

default

General error response from the platform

post/v1/hubs

Request samples

Payload

application/json

{"name": "string",
"identifier": "string",
"webhooks": {"server_deployed": "string",
"server_deleted": "string"
}
}

Response samples

200
default

application/json

{"data": {"id": "651586fca6078e98982dbd90",
"identifier": "string",
"name": "string",
"creator": {"id": "651586fca6078e98982dbd90",
"type": "account"
},
"events": {"created": "2021-01-30T08:30:00Z",
"updated": "2021-01-30T08:30:00Z",
"deleted": "2021-01-30T08:30:00Z",
"converted": "2021-01-30T08:30:00Z",
"first_order": "2021-01-30T08:30:00Z",
"first_provider": "2021-01-30T08:30:00Z",
"first_server": "2021-01-30T08:30:00Z",
"first_environment": "2021-01-30T08:30:00Z",
"first_image": "2021-01-30T08:30:00Z",
"first_container": "2021-01-30T08:30:00Z"
},
"state": {"changed": "2021-01-30T08:30:00Z",
"error": {"message": "string",
"time": "2021-01-30T08:30:00Z"
}
},
"security": {"force_2fa": true
},
"webhooks": {"server_deployed": "string",
"server_deleted": "string"
},
"billing": {"term": {"start": "2021-01-30T08:30:00Z",
"end": "2021-01-30T08:30:00Z",
"renew": "once"
},
"allow_prepaid": true,
"pause_invoices": true,
"disable": true,
"plans": {"tier_id": "string",
"support_id": "string"
},
"emails": ["string"
]
},
"meta": {"membership": {"id": "651586fca6078e98982dbd90",
"account_id": "string",
"hub_id": "651586fca6078e98982dbd90",
"events": {"created": "2021-01-30T08:30:00Z",
"updated": "2021-01-30T08:30:00Z",
"deleted": "2021-01-30T08:30:00Z",
"joined": "2021-01-30T08:30:00Z"
},
"role_id": "651586fca6078e98982dbd90",
"preferences": {"portal": {"notifications": {"jobs": {"apikey_alerts": null
}
}
},
"email": {"notificaitons": {"server": {"new": null,
"offline": null
}
}
}
},
"state": {"changed": "2021-01-30T08:30:00Z",
"error": {"message": "string",
"time": "2021-01-30T08:30:00Z"
}
},
"invitation": {"sender": {"id": "651586fca6078e98982dbd90",
"type": "string"
},
"recipient": "string",
"events": {"created": "2021-01-30T08:30:00Z",
"updated": "2021-01-30T08:30:00Z",
"deleted": "2021-01-30T08:30:00Z",
"accepted": "2021-01-30T08:30:00Z",
"declined": "2021-01-30T08:30:00Z",
"revoked": "2021-01-30T08:30:00Z"
}
},
"cycle": {"employee_id": "string"
}
}
}
}
}

Get Hub

Requires the hubs-view capability.

SecuritybearerAuth

Request

query Parameters

Update Hub

Updates the specified hub, setting the values of the parameters passed.

SecuritybearerAuth and hubAuth

Request

Request Body schema: application/json

Parameters for updating a hub.

name	string A name for the hub.
	object (HubWebhooks) Hub related webhooks. When supplied, the given webhook will be called with a payload any time one of these events occurs.
	object (HubSecurity) Security options for a hub.

Responses

200

Returns the updated Hub resource.

default

General error response from the platform

patch/v1/hubs/current

Request samples

Payload

application/json

{"name": "string",
"webhooks": {"server_deployed": "string",
"server_deleted": "string"
},
"security": {"force_2fa": true
}
}

Response samples

200
default

application/json

{"data": {"id": "651586fca6078e98982dbd90",
"identifier": "string",
"name": "string",
"creator": {"id": "651586fca6078e98982dbd90",
"type": "account"
},
"events": {"created": "2021-01-30T08:30:00Z",
"updated": "2021-01-30T08:30:00Z",
"deleted": "2021-01-30T08:30:00Z",
"converted": "2021-01-30T08:30:00Z",
"first_order": "2021-01-30T08:30:00Z",
"first_provider": "2021-01-30T08:30:00Z",
"first_server": "2021-01-30T08:30:00Z",
"first_environment": "2021-01-30T08:30:00Z",
"first_image": "2021-01-30T08:30:00Z",
"first_container": "2021-01-30T08:30:00Z"
},
"state": {"changed": "2021-01-30T08:30:00Z",
"error": {"message": "string",
"time": "2021-01-30T08:30:00Z"
}
},
"security": {"force_2fa": true
},
"webhooks": {"server_deployed": "string",
"server_deleted": "string"
},
"billing": {"term": {"start": "2021-01-30T08:30:00Z",
"end": "2021-01-30T08:30:00Z",
"renew": "once"
},
"allow_prepaid": true,
"pause_invoices": true,
"disable": true,
"plans": {"tier_id": "string",
"support_id": "string"
},
"emails": ["string"
]
},
"meta": {"membership": {"id": "651586fca6078e98982dbd90",
"account_id": "string",
"hub_id": "651586fca6078e98982dbd90",
"events": {"created": "2021-01-30T08:30:00Z",
"updated": "2021-01-30T08:30:00Z",
"deleted": "2021-01-30T08:30:00Z",
"joined": "2021-01-30T08:30:00Z"
},
"role_id": "651586fca6078e98982dbd90",
"preferences": {"portal": {"notifications": {"jobs": {"apikey_alerts": null
}
}
},
"email": {"notificaitons": {"server": {"new": null,
"offline": null
}
}
}
},
"state": {"changed": "2021-01-30T08:30:00Z",
"error": {"message": "string",
"time": "2021-01-30T08:30:00Z"
}
},
"invitation": {"sender": {"id": "651586fca6078e98982dbd90",
"type": "string"
},
"recipient": "string",
"events": {"created": "2021-01-30T08:30:00Z",
"updated": "2021-01-30T08:30:00Z",
"deleted": "2021-01-30T08:30:00Z",
"accepted": "2021-01-30T08:30:00Z",
"declined": "2021-01-30T08:30:00Z",
"revoked": "2021-01-30T08:30:00Z"
}
},
"cycle": {"employee_id": "string"
}
}
}
}
}

Delete Hub

Requires the hubs-delete capability. This can only be aquired by being the hub owner.

SecuritybearerAuth

Responses

202

Returns a task descriptor.

default

General error response from the platform

delete/v1/hubs/current

Response samples

202
default

application/json

{"data": {"action": "string",
"job": {"id": "string",
"accepted": true,
"queue": "string",
"schedule": "2021-01-30T08:30:00Z",
"parallel": {"sub_queue": "string",
"tasks": true
},
"tasks": [{"caption": "string",
"header": "string",
"steps": [{"caption": "string",
"description": "string",
"started": "2021-01-30T08:30:00Z",
"completed": "2021-01-30T08:30:00Z"
}
],
"input": {"property1": null,
"property2": null
}
}
]
}
}
}

List Hub Capabilities

Responses

200

Returns a list of capabilities.

default

General error response from the platform

get/v1/hubs/capabilities

Response samples

200
default

application/json

{"data": ["api-keys-manage"
],
"meta": {"captions": {"property1": "string",
"property2": "string"
}
}
}

Get Hub Usage

Requires the hubs-view capability.

SecuritybearerAuth

Request

query Parameters

filter

object

Responses

200

Returns usage detail points of the Hub over a range of time.

default

General error response from the platform

get/v1/hubs/current/usage

Response samples

200
default

application/json

{"data": [{"time": "string",
"servers": 0,
"members": 0,
"environments": 0,
"containers": 0
}
]
}

List Hub Activity

SecuritybearerAuth and hubAuth

Request

query Parameters

include	Array of strings A comma separated list of include values. Included resources will show up under the root document's `include` field, with the key being the id of the included resource. In the case of applying an include to a collection of resources, if two resources share the same include, it will only appear once in the return. Items Enum: "users" "components" "creators" "images" "stack_builds" "stacks" "environments"
	object Filter Field The filter field is a key-value object, where the key is what you would like to filter, and the value is the value you're filtering for.
sort	Array of strings An array of sort values. To sort descending, put a `-` in front of the value, e.g. `-id`.
	object In a list return, the data associated with the page number and size returned. 20 results per page, page 2 would be `page[size]=20&page[number]=2`

Responses

200

Returns a list of Hub Activity entries.

default

General error response from the platform

get/v1/hubs/current/activity

Response samples

200
default

application/json

{"data": [{"id": "651586fca6078e98982dbd90",
"hub_id": "651586fca6078e98982dbd90",
"user": {"type": "account",
"id": "string"
},
"verbosity": 0,
"context": {"environment_id": "string",
"container_id": "string",
"cluster": "string",
"instance_id": "string",
"server_id": "string",
"stack_id": "string",
"dns_zone_id": "string",
"virtual_machine_id": "string"
},
"session": {"url": "string",
"ip": "string",
"token": {"application_id": "651586fca6078e98982dbd90",
"application_capabilities_version": 0
},
"api_key": "string"
},
"changes": [{"component": "string",
"before": {"id": "651586fca6078e98982dbd90",
"number": 0,
"string": "string"
},
"after": {"id": "651586fca6078e98982dbd90",
"number": 0,
"string": "string"
}
}
],
"annotations": {"property1": null,
"property2": null
},
"error": {"message": "string"
},
"component": {"id": "651586fca6078e98982dbd90",
"type": "string"
},
"tags": ["string"
],
"status": "info",
"security": {"risk": "info",
"surface": "network",
"event": "suggestion",
"attack": "none"
},
"monitor": {"level": "info",
"event": "suggestion",
"state": "none"
},
"event": "hub.images.prune",
"time": "2021-01-30T08:30:00Z"
}
],
"includes": {"users": {"accounts": {"property1": {"name": {"first": "string",
"last": "string"
},
"email": {"address": "string"
},
"id": "string",
"events": {"property1": "2021-01-30T08:30:00Z",
"property2": "2021-01-30T08:30:00Z",
"last_login": "2021-01-30T08:30:00Z"
}
},
"property2": {"name": {"first": "string",
"last": "string"
},
"email": {"address": "string"
},
"id": "string",
"events": {"property1": "2021-01-30T08:30:00Z",
"property2": "2021-01-30T08:30:00Z",
"last_login": "2021-01-30T08:30:00Z"
}
}
},
"employees": {"property1": {"name": {"first": "string",
"last": "string"
},
"email": {"address": "string"
},
"id": "string",
"events": {"property1": "2021-01-30T08:30:00Z",
"property2": "2021-01-30T08:30:00Z",
"last_login": "2021-01-30T08:30:00Z"
}
},
"property2": {"name": {"first": "string",
"last": "string"
},
"email": {"address": "string"
},
"id": "string",
"events": {"property1": "2021-01-30T08:30:00Z",
"property2": "2021-01-30T08:30:00Z",
"last_login": "2021-01-30T08:30:00Z"
}
}
},
"visitors": {"property1": {"name": {"first": "string",
"last": "string"
},
"email": {"address": "string"
},
"id": "string",
"events": {"property1": "2021-01-30T08:30:00Z",
"property2": "2021-01-30T08:30:00Z",
"last_login": "2021-01-30T08:30:00Z"
}
},
"property2": {"name": {"first": "string",
"last": "string"
},
"email": {"address": "string"
},
"id": "string",
"events": {"property1": "2021-01-30T08:30:00Z",
"property2": "2021-01-30T08:30:00Z",
"last_login": "2021-01-30T08:30:00Z"
}
}
},
"environments": {"property1": {"id": "651586fca6078e98982dbd90",
"identifier": "string",
"name": "string",
"cluster": "string",
"about": {"description": "string",
"favorite": true
},
"creator": {"id": "651586fca6078e98982dbd90",
"type": "account"
},
"hub_id": "651586fca6078e98982dbd90",
"state": {"changed": "2021-01-30T08:30:00Z",
"error": {"message": "string",
"time": "2021-01-30T08:30:00Z"
}
},
"events": {"created": "2021-01-30T08:30:00Z",
"updated": "2021-01-30T08:30:00Z",
"deleted": "2021-01-30T08:30:00Z"
},
"features": {"legacy_networking": true,
"monitoring": {"tier": "limited"
}
},
"services": {"loadbalancer": {"enable": true,
"container_id": "string",
"high_availability": true,
"auto_update": true,
"config": {"ipv4": null,
"ipv6": null,
"type": null,
"details": null,
"bind_host": null
}
},
"discovery": {"enable": true,
"container_id": "string",
"high_availability": true,
"auto_update": true,
"config": {"empty_set_delay": null,
"hosts": { },
"custom_resolvers": [ ]
}
},
"vpn": {"enable": true,
"container_id": "string",
"auto_update": true,
"config": {"allow_internet": null,
"auth": { }
}
},
"scheduler": {"enable": true,
"container_id": "string",
"high_availability": true,
"auto_update": true,
"config": {"public": null,
"access_keys": [ ]
}
}
},
"acl": {"roles": {"property1": {"view": null,
"modify": null,
"manage": null
},
"property2": {"view": null,
"modify": null,
"manage": null
}
}
},
"private_network": {"vxlan_tag": 0,
"subnet": "string",
"ipv6": {"ip": "fd00::21:0:0:0",
"cidr": "fd00::21:0:0:0/96"
},
"legacy": {"subnet": 0,
"ipv4": {"ip": null,
"cidr": null
}
}
},
"deployments": {"tags": {"property1": "v1.2.3-dev",
"property2": "v1.2.3-dev"
}
},
"meta": {"containers_count": {"state": {"new": 0,
"starting": 0,
"running": 5,
"stopping": 0,
"deleting": 0,
"deleted": 0
},
"total": 5,
"available": 5
},
"instances_count": {"state": {"new": 0,
"starting": 0,
"running": 5,
"stopping": 0,
"deleting": 0,
"deleted": 0
},
"total": 5,
"available": 5
},
"containers": [{"id": null,
"name": null,
"state": null,
"image": null,
"environment": null
}
]
}
},
"property2": {"id": "651586fca6078e98982dbd90",
"identifier": "string",
"name": "string",
"cluster": "string",
"about": {"description": "string",
"favorite": true
},
"creator": {"id": "651586fca6078e98982dbd90",
"type": "account"
},
"hub_id": "651586fca6078e98982dbd90",
"state": {"changed": "2021-01-30T08:30:00Z",
"error": {"message": "string",
"time": "2021-01-30T08:30:00Z"
}
},
"events": {"created": "2021-01-30T08:30:00Z",
"updated": "2021-01-30T08:30:00Z",
"deleted": "2021-01-30T08:30:00Z"
},
"features": {"legacy_networking": true,
"monitoring": {"tier": "limited"
}
},
"services": {"loadbalancer": {"enable": true,
"container_id": "string",
"high_availability": true,
"auto_update": true,
"config": {"ipv4": null,
"ipv6": null,
"type": null,
"details": null,
"bind_host": null
}
},
"discovery": {"enable": true,
"container_id": "string",
"high_availability": true,
"auto_update": true,
"config": {"empty_set_delay": null,
"hosts": { },
"custom_resolvers": [ ]
}
},
"vpn": {"enable": true,
"container_id": "string",
"auto_update": true,
"config": {"allow_internet": null,
"auth": { }
}
},
"scheduler": {"enable": true,
"container_id": "string",
"high_availability": true,
"auto_update": true,
"config": {"public": null,
"access_keys": [ ]
}
}
},
"acl": {"roles": {"property1": {"view": null,
"modify": null,
"manage": null
},
"property2": {"view": null,
"modify": null,
"manage": null
}
}
},
"private_network": {"vxlan_tag": 0,
"subnet": "string",
"ipv6": {"ip": "fd00::21:0:0:0",
"cidr": "fd00::21:0:0:0/96"
},
"legacy": {"subnet": 0,
"ipv4": {"ip": null,
"cidr": null
}
}
},
"deployments": {"tags": {"property1": "v1.2.3-dev",
"property2": "v1.2.3-dev"
}
},
"meta": {"containers_count": {"state": {"new": 0,
"starting": 0,
"running": 5,
"stopping": 0,
"deleting": 0,
"deleted": 0
},
"total": 5,
"available": 5
},
"instances_count": {"state": {"new": 0,
"starting": 0,
"running": 5,
"stopping": 0,
"deleting": 0,
"deleted": 0
},
"total": 5,
"available": 5
},
"containers": [{"id": null,
"name": null,
"state": null,
"image": null,
"environment": null
}
]
}
}
},
"api_keys": {"property1": {"id": "651586fca6078e98982dbd90",
"name": "string",
"hub_id": "651586fca6078e98982dbd90",
"secret": "string",
"permissions": {"all_environments": true,
"environments": [{"id": null,
"manage": null
}
]
},
"capabilities": {"all": true,
"specific": ["string"
]
},
"ips": ["string"
],
"state": {"changed": "2021-01-30T08:30:00Z",
"error": {"message": "string",
"time": "2021-01-30T08:30:00Z"
}
},
"events": {"property1": "2021-01-30T08:30:00Z",
"property2": "2021-01-30T08:30:00Z"
}
},
"property2": {"id": "651586fca6078e98982dbd90",
"name": "string",
"hub_id": "651586fca6078e98982dbd90",
"secret": "string",
"permissions": {"all_environments": true,
"environments": [{"id": null,
"manage": null
}
]
},
"capabilities": {"all": true,
"specific": ["string"
]
},
"ips": ["string"
],
"state": {"changed": "2021-01-30T08:30:00Z",
"error": {"message": "string",
"time": "2021-01-30T08:30:00Z"
}
},
"events": {"property1": "2021-01-30T08:30:00Z",
"property2": "2021-01-30T08:30:00Z"
}
}
}
},
"components": {"property1": {"id": "651586fca6078e98982dbd90",
"identifier": "string",
"name": "string",
"creator": {"id": "651586fca6078e98982dbd90",
"type": "account"
},
"environment": {"id": "651586fca6078e98982dbd90",
"cluster": "string",
"container_subnet": "string",
"ipv6": {"ip": "fd00::21:0:0:0",
"cidr": "fd00::21:0:0:0/96"
},
"legacy": {"subnet": 0,
"ipv4": {"ip": "fd00::21:0:0:0",
"cidr": "fd00::21:0:0:0/96"
}
}
},
"hub_id": "651586fca6078e98982dbd90",
"image": {"id": "651586fca6078e98982dbd90",
"extension": {"identifier": "virtual-machine-v1",
"id": "651586fca6078e98982dbd90"
},
"service": "discovery"
},
"stack": {"id": "651586fca6078e98982dbd90",
"build_id": "string",
"identifier": "string"
},
"config": {"network": {"public": "enable",
"hostname": "string",
"ports": ["string"
]
},
"deploy": {"instances": 0,
"strategy": "resource-density",
"function": {"max_pool_size": 0,
"max_shard_concurrency": 0,
"max_runtime": "72h45m2s",
"max_queue_time": "72h45m2s"
},
"stateful": {"options": {"use_base_hostname": null
}
},
"constraints": {"node": {"tags": { }
},
"secrets": [null
]
},
"shutdown": {"graceful_timeout": "72h45m2s",
"signals": [null
]
},
"startup": {"delay": "72h45m2s"
},
"update": {"stagger": "72h45m2s"
},
"restart": {"condition": "always",
"delay": "72h45m2s",
"max_attempts": 0
},
"health_check": {"command": "string",
"retries": 0,
"delay": "72h45m2s",
"interval": "72h45m2s",
"timeout": "72h45m2s",
"restart": true
},
"telemetry": {"retention": "72h45m2s",
"interval": "72h45m2s",
"disable": true
}
},
"scale": {"autoscale_group": "string",
"instances": {"max": 0,
"max_server": 0,
"min_ttl": "72h45m2s"
},
"window": "72h45m2s",
"thresholds": [{"type": null,
"details": { }
}
]
},
"runtime": {"command": {"path": "string",
"args": "string"
},
"namespaces": ["ipc"
],
"environment_vars": {"property1": "string",
"property2": "string"
},
"privileged": true,
"capabilities": ["CAP_CHOWN"
],
"workdir": "string",
"sysctl": {"property1": "string",
"property2": "string"
},
"rlimits": {"property1": {"hard": null,
"soft": null
},
"property2": {"hard": null,
"soft": null
}
},
"seccomp": {"disable": true,
"rules": [null
]
},
"host": {"expose_proc": true
},
"rootfs": {"readonly": true
},
"devices": {"shm_size": "64M"
}
},
"resources": {"cpu": {"shares": {"limit": null,
"reserve": null
},
"cpus": "string"
},
"ram": {"limit": "1G",
"reserve": "string"
}
},
"integrations": {"webhooks": {"events": {"deploy": null,
"start": null,
"stop": null
},
"config": "string"
},
"files": [{"source": null,
"destination": null
}
],
"lets_encrypt": {"enable": true,
"certificate_path": "string",
"chain_path": "string",
"key_path": "string",
"bundle_path": "string",
"additional_certs_path": "string"
},
"backups": {"integration_id": "my-image-source",
"backup": {"command": null,
"timeout": null,
"cron_string": null
},
"restore": {"command": null,
"timeout": null
},
"retention": "365d"
},
"shared_file_systems": {"property1": {"writable": null,
"mount_point": null
},
"property2": {"writable": null,
"mount_point": null
}
},
"logs": {"groups": [null
]
}
}
},
"deployment": {"version": "v1.2.3-dev"
},
"instances": 0,
"volumes": [{"id": "651586fca6078e98982dbd90",
"hash": "string",
"config": {"read_only": true,
"block_device": true,
"local": {"max_size": null,
"storage_pool": null
},
"destination": "string",
"remote_access": {"enable": null,
"ips": [ ],
"webhook": null,
"password": { }
}
}
}
],
"annotations": {"property1": null,
"property2": null
},
"role": "orchestrator",
"stateful": true,
"deprecate": true,
"lock": true,
"state": {"changed": "2021-01-30T08:30:00Z",
"error": {"message": "string",
"time": "2021-01-30T08:30:00Z"
}
},
"events": {"created": "2021-01-30T08:30:00Z",
"updated": "2021-01-30T08:30:00Z",
"deleted": "2021-01-30T08:30:00Z",
"started": "2021-01-30T08:30:00Z"
},
"meta": {"instances_count": {"state": {"new": 0,
"starting": 0,
"running": 5,
"stopping": 0,
"deleting": 0,
"deleted": 0
},
"total": 5,
"available": 5
},
"domains": [{"fqdn": "string",
"record": {"id": null,
"hub_id": null,
"creator": null,
"zone_id": null,
"name": null,
"resolved_domain": null,
"type": null,
"features": { },
"state": null,
"events": null
}
}
],
"ips": [{"id": "651586fca6078e98982dbd90",
"hub_id": "651586fca6078e98982dbd90",
"kind": "ipv4",
"assignment": {"container_id": null,
"instance_id": null,
"environment_id": null,
"virtual_machine": { }
},
"pool_id": "string",
"address": "string",
"gateway": "string",
"cidr": "string",
"state": {"changed": null,
"error": { }
}
}
]
}
},
"property2": {"id": "651586fca6078e98982dbd90",
"identifier": "string",
"name": "string",
"creator": {"id": "651586fca6078e98982dbd90",
"type": "account"
},
"environment": {"id": "651586fca6078e98982dbd90",
"cluster": "string",
"container_subnet": "string",
"ipv6": {"ip": "fd00::21:0:0:0",
"cidr": "fd00::21:0:0:0/96"
},
"legacy": {"subnet": 0,
"ipv4": {"ip": "fd00::21:0:0:0",
"cidr": "fd00::21:0:0:0/96"
}
}
},
"hub_id": "651586fca6078e98982dbd90",
"image": {"id": "651586fca6078e98982dbd90",
"extension": {"identifier": "virtual-machine-v1",
"id": "651586fca6078e98982dbd90"
},
"service": "discovery"
},
"stack": {"id": "651586fca6078e98982dbd90",
"build_id": "string",
"identifier": "string"
},
"config": {"network": {"public": "enable",
"hostname": "string",
"ports": ["string"
]
},
"deploy": {"instances": 0,
"strategy": "resource-density",
"function": {"max_pool_size": 0,
"max_shard_concurrency": 0,
"max_runtime": "72h45m2s",
"max_queue_time": "72h45m2s"
},
"stateful": {"options": {"use_base_hostname": null
}
},
"constraints": {"node": {"tags": { }
},
"secrets": [null
]
},
"shutdown": {"graceful_timeout": "72h45m2s",
"signals": [null
]
},
"startup": {"delay": "72h45m2s"
},
"update": {"stagger": "72h45m2s"
},
"restart": {"condition": "always",
"delay": "72h45m2s",
"max_attempts": 0
},
"health_check": {"command": "string",
"retries": 0,
"delay": "72h45m2s",
"interval": "72h45m2s",
"timeout": "72h45m2s",
"restart": true
},
"telemetry": {"retention": "72h45m2s",
"interval": "72h45m2s",
"disable": true
}
},
"scale": {"autoscale_group": "string",
"instances": {"max": 0,
"max_server": 0,
"min_ttl": "72h45m2s"
},
"window": "72h45m2s",
"thresholds": [{"type": null,
"details": { }
}
]
},
"runtime": {"command": {"path": "string",
"args": "string"
},
"namespaces": ["ipc"
],
"environment_vars": {"property1": "string",
"property2": "string"
},
"privileged": true,
"capabilities": ["CAP_CHOWN"
],
"workdir": "string",
"sysctl": {"property1": "string",
"property2": "string"
},
"rlimits": {"property1": {"hard": null,
"soft": null
},
"property2": {"hard": null,
"soft": null
}
},
"seccomp": {"disable": true,
"rules": [null
]
},
"host": {"expose_proc": true
},
"rootfs": {"readonly": true
},
"devices": {"shm_size": "64M"
}
},
"resources": {"cpu": {"shares": {"limit": null,
"reserve": null
},
"cpus": "string"
},
"ram": {"limit": "1G",
"reserve": "string"
}
},
"integrations": {"webhooks": {"events": {"deploy": null,
"start": null,
"stop": null
},
"config": "string"
},
"files": [{"source": null,
"destination": null
}
],
"lets_encrypt": {"enable": true,
"certificate_path": "string",
"chain_path": "string",
"key_path": "string",
"bundle_path": "string",
"additional_certs_path": "string"
},
"backups": {"integration_id": "my-image-source",
"backup": {"command": null,
"timeout": null,
"cron_string": null
},
"restore": {"command": null,
"timeout": null
},
"retention": "365d"
},
"shared_file_systems": {"property1": {"writable": null,
"mount_point": null
},
"property2": {"writable": null,
"mount_point": null
}
},
"logs": {"groups": [null
]
}
}
},
"deployment": {"version": "v1.2.3-dev"
},
"instances": 0,
"volumes": [{"id": "651586fca6078e98982dbd90",
"hash": "string",
"config": {"read_only": true,
"block_device": true,
"local": {"max_size": null,
"storage_pool": null
},
"destination": "string",
"remote_access": {"enable": null,
"ips": [ ],
"webhook": null,
"password": { }
}
}
}
],
"annotations": {"property1": null,
"property2": null
},
"role": "orchestrator",
"stateful": true,
"deprecate": true,
"lock": true,
"state": {"changed": "2021-01-30T08:30:00Z",
"error": {"message": "string",
"time": "2021-01-30T08:30:00Z"
}
},
"events": {"created": "2021-01-30T08:30:00Z",
"updated": "2021-01-30T08:30:00Z",
"deleted": "2021-01-30T08:30:00Z",
"started": "2021-01-30T08:30:00Z"
},
"meta": {"instances_count": {"state": {"new": 0,
"starting": 0,
"running": 5,
"stopping": 0,
"deleting": 0,
"deleted": 0
},
"total": 5,
"available": 5
},
"domains": [{"fqdn": "string",
"record": {"id": null,
"hub_id": null,
"creator": null,
"zone_id": null,
"name": null,
"resolved_domain": null,
"type": null,
"features": { },
"state": null,
"events": null
}
}
],
"ips": [{"id": "651586fca6078e98982dbd90",
"hub_id": "651586fca6078e98982dbd90",
"kind": "ipv4",
"assignment": {"container_id": null,
"instance_id": null,
"environment_id": null,
"virtual_machine": { }
},
"pool_id": "string",
"address": "string",
"gateway": "string",
"cidr": "string",
"state": {"changed": null,
"error": { }
}
}
]
}
}
}
}
}

List Default Hub Roles

Responses

200

Returns a list of the default roles/capabilities for a hub.

default

General error response from the platform

get/v1/hubs/current/roles/defaults

Response samples

200
default

application/json

{"data": [{"name": "string",
"identifier": "string",
"root": true,
"capabilities": {"all": true,
"specific": ["api-keys-manage"
]
}
}
]
}

➔ Next to API Keys

Hubs

List Hubs

query Parameters

Filter Field

Create Hub

Request Body schema: application/json

Get Hub

query Parameters

Update Hub

Request Body schema: application/json

Delete Hub

List Hub Capabilities

Get Hub Usage

query Parameters

List Hub Activity

query Parameters

Filter Field

List Default Hub Roles