Orchestrator endpoints

This document contains the endpoints for the Orchestrator category.

Gets all hosts from the orchestrator

/api/v1/orchestrator/hosts Authorized

This endpoint returns all hosts from the orchestrator

Gets a host from the orchestrator

/api/v1/orchestrator/hosts/{id} Authorized

This endpoint returns a host from the orchestrator

Parameters
Name Type In Required Description
id string path required Host ID

Gets a host hardware info from the orchestrator

/api/v1/orchestrator/hosts/{id}/hardware Authorized

This endpoint returns a host hardware info from the orchestrator

Parameters
Name Type In Required Description
id string path required Host ID

Register a Host in the orchestrator

/api/v1/orchestrator/hosts Authorized

This endpoint register a host in the orchestrator

Parameters
Name Type In Required Description
hostRequest object body optional Host Request
Schema
{
  "authentication": "*OrchestratorAuthentication",
  "description": "string",
  "host": "string",
  "port": "string",
  "prefix": "string",
  "required_claims": "[]string",
  "required_roles": "[]string",
  "schema": "string",
  "tags": "[]string"
}

Unregister a host from the orchestrator

/api/v1/orchestrator/hosts/{id} Authorized

This endpoint unregister a host from the orchestrator

Parameters
Name Type In Required Description
id string path required Host ID

Enable a host in the orchestrator

/api/v1/orchestrator/hosts/{id}/enable Authorized

This endpoint will enable an existing host in the orchestrator

Disable a host in the orchestrator

/api/v1/orchestrator/hosts/{id}/disable Authorized

This endpoint will disable an existing host in the orchestrator

Update a Host in the orchestrator

/api/v1/orchestrator/hosts Authorized

This endpoint updates a host in the orchestrator

Parameters
Name Type In Required Description
hostRequest object body optional Host Update Request
Schema
{
  "authentication": "*OrchestratorAuthentication",
  "description": "string",
  "host": "string",
  "port": "string",
  "prefix": "string",
  "schema": "string"
}

Get orchestrator resource overview

/api/v1/orchestrator/overview/resources Authorized

This endpoint returns orchestrator resource overview

Get orchestrator host resources

/api/v1/orchestrator/overview/{id}/resources Authorized

This endpoint returns orchestrator host resources

Parameters
Name Type In Required Description
id string path required Host ID

Get orchestrator Virtual Machines

/api/v1/orchestrator/machines Authorized

This endpoint returns orchestrator Virtual Machines

Get orchestrator Virtual Machine

/api/v1/orchestrator/machines/{id} Authorized

This endpoint returns orchestrator Virtual Machine by its ID

Deletes orchestrator virtual machine

/api/v1/orchestrator/machines/{id} Authorized

This endpoint deletes orchestrator virtual machine

Parameters
Name Type In Required Description
id string path required Virtual Machine ID

Get orchestrator virtual machine status

/api/v1/orchestrator/machines/{vmId}/status Authorized

This endpoint returns orchestrator virtual machine status

Parameters
Name Type In Required Description
id string path required Virtual Machine ID

Renames orchestrator virtual machine

/api/v1/orchestrator/machines/{id}/rename Authorized

This endpoint renames orchestrator virtual machine

Parameters
Name Type In Required Description
id string path required Virtual Machine ID

Configures orchestrator virtual machine

/api/v1/orchestrator/machines/{vmId}/set Authorized

This endpoint configures orchestrator virtual machine

Parameters
Name Type In Required Description
id string path required Virtual Machine ID

Starts orchestrator virtual machine

/api/v1/orchestrator/machines/{vmId}/start Authorized

This endpoint starts orchestrator virtual machine

Parameters
Name Type In Required Description
id string path required Virtual Machine ID

Stops orchestrator virtual machine

/api/v1/orchestrator/machines/{vmId}/stop Authorized

This endpoint sops orchestrator virtual machine

Parameters
Name Type In Required Description
id string path required Virtual Machine ID

Executes a command in a orchestrator virtual machine

/api/v1/orchestrator/machines/{vmId}/execute Authorized

This endpoint executes a command in a orchestrator virtual machine

Parameters
Name Type In Required Description
id string path required Virtual Machine ID

Get orchestrator host virtual machines

/api/v1/orchestrator/hosts/{id}/machines Authorized

This endpoint returns orchestrator host virtual machines

Parameters
Name Type In Required Description
id string path required Host ID

Get orchestrator host virtual machine

/api/v1/orchestrator/hosts/{id}/machines/{vmId} Authorized

This endpoint returns orchestrator host virtual machine

Parameters
Name Type In Required Description
id string path required Host ID
vmId string path required Virtual Machine ID

Deletes orchestrator host virtual machine

/api/v1/orchestrator/hosts/{id}/machines/{vmId} Authorized

This endpoint deletes orchestrator host virtual machine

Parameters
Name Type In Required Description
id string path required Host ID
vmId string path required Virtual Machine ID

Get orchestrator host virtual machine status

/api/v1/orchestrator/hosts/{id}/machines/{vmId}/status Authorized

This endpoint returns orchestrator host virtual machine status

Parameters
Name Type In Required Description
id string path required Host ID
vmId string path required Virtual Machine ID

Renames orchestrator host virtual machine

/api/v1/orchestrator/hosts/{id}/machines/{vmId}/rename Authorized

This endpoint renames orchestrator host virtual machine

Parameters
Name Type In Required Description
id string path required Host ID
vmId string path required Virtual Machine ID

Configures orchestrator host virtual machine

/api/v1/orchestrator/hosts/{id}/machines/{vmId}/set Authorized

This endpoint configures orchestrator host virtual machine

Parameters
Name Type In Required Description
id string path required Host ID
vmId string path required Virtual Machine ID

Starts orchestrator host virtual machine

/api/v1/orchestrator/hosts/{id}/machines/{vmId}/start Authorized

This endpoint starts orchestrator host virtual machine

Parameters
Name Type In Required Description
id string path required Host ID
vmId string path required Virtual Machine ID

Starts orchestrator host virtual machine

/api/v1/orchestrator/hosts/{id}/machines/{vmId}/stop Authorized

This endpoint starts orchestrator host virtual machine

Parameters
Name Type In Required Description
id string path required Host ID
vmId string path required Virtual Machine ID

Executes a command in a orchestrator host virtual machine

/api/v1/orchestrator/hosts/{id}/machines/{vmId}/execute Authorized

This endpoint executes a command in a orchestrator host virtual machine

Parameters
Name Type In Required Description
id string path required Host ID
vmId string path required Virtual Machine ID

Register a virtual machine in a orchestrator host

/api/v1/orchestrator/hosts/{id}/machines/register Authorized

This endpoint registers a virtual machine in a orchestrator host

Parameters
Name Type In Required Description
id string path required Host ID
request object body optional Register Virtual Machine Request
Schema
{
  "delay_applying_restrictions": "bool",
  "force": "bool",
  "machine_name": "string",
  "owner": "string",
  "path": "string",
  "regenerate_source_uuid": "bool",
  "uuid": "string"
}

Unregister a virtual machine in a orchestrator host

/api/v1/orchestrator/hosts/{id}/machines/{vmId}/unregister Authorized

This endpoint unregister a virtual machine in a orchestrator host

Parameters
Name Type In Required Description
id string path required Host ID
vmId string path required Virtual Machine ID
request object body optional Register Virtual Machine Request
Schema
{
  "clean_source_uuid": "bool",
  "id": "string",
  "owner": "string"
}

Creates a orchestrator host virtual machine

/api/v1/orchestrator/hosts/{id}/machines Authorized

This endpoint creates a orchestrator host virtual machine

Parameters
Name Type In Required Description
id string path required Host ID
request object body optional Create Virtual Machine Request
Schema
{
  "architecture": "string",
  "catalog_manifest": "*CreateCatalogVirtualMachineRequest",
  "name": "string",
  "owner": "string",
  "packer_template": "*CreatePackerVirtualMachineRequest",
  "start_on_create": "bool",
  "vagrant_box": "*CreateVagrantMachineRequest"
}

Creates a virtual machine in one of the hosts for the orchestrator

/api/v1/orchestrator/machines Authorized

This endpoint creates a virtual machine in one of the hosts for the orchestrator

Parameters
Name Type In Required Description
request object body optional Create Virtual Machine Request
Schema
{
  "architecture": "string",
  "catalog_manifest": "*CreateCatalogVirtualMachineRequest",
  "name": "string",
  "owner": "string",
  "packer_template": "*CreatePackerVirtualMachineRequest",
  "start_on_create": "bool",
  "vagrant_box": "*CreateVagrantMachineRequest"
}

Gets orchestrator host reverse proxy configuration

/api/v1/orchestrator/hosts/{id}/reverse-proxy Authorized

This endpoint returns orchestrator host reverse proxy configuration

Parameters
Name Type In Required Description
id string path required Host ID

Gets orchestrator host reverse proxy hosts

/api/v1/orchestrator/hosts/{id}/reverse-proxy/hosts Authorized

This endpoint returns orchestrator host reverse proxy hosts

Parameters
Name Type In Required Description
id string path required Host ID

Gets orchestrator host reverse proxy hosts

/api/v1/orchestrator/hosts/{id}/reverse-proxy/hosts/{reverse_proxy_host_id} Authorized

This endpoint returns orchestrator host reverse proxy hosts

Parameters
Name Type In Required Description
id string path required Host ID

Creates a orchestrator host reverse proxy host

/api/v1/orchestrator/hosts/{id}/reverse-proxy/hosts Authorized

This endpoint creates a orchestrator host reverse proxy host

Parameters
Name Type In Required Description
request object body optional Create Host Reverse Proxy Host Request
Schema
{
  "cors": "*ReverseProxyHostCors",
  "host": "string",
  "http_routes": "[]*ReverseProxyHostHttpRoute",
  "port": "string",
  "tcp_route": "*ReverseProxyHostTcpRoute",
  "tls": "*ReverseProxyHostTls"
}

Updates an orchestrator host reverse proxy host

/api/v1/orchestrator/hosts/{id}/reverse-proxy/hosts/{reverse_proxy_host_id} Authorized

This endpoint updates an orchestrator host reverse proxy host

Parameters
Name Type In Required Description
request object body optional Update Host Reverse Proxy Host Request
Schema
{
  "cors": "*ReverseProxyHostCors",
  "host": "string",
  "port": "string",
  "tls": "*ReverseProxyHostTls"
}

Deletes an orchestrator host reverse proxy host

/api/v1/orchestrator/hosts/{id}/reverse-proxy/hosts/{reverse_proxy_host_id} Authorized

This endpoint deletes an orchestrator host reverse proxy host

Parameters
Name Type In Required Description
id string path required Host ID
reverse_proxy_host_id string path required Reverse Proxy Host ID

Upserts an orchestrator host reverse proxy host http route

/api/v1/orchestrator/hosts/{id}/reverse-proxy/hosts/{reverse_proxy_host_id}/http_routes Authorized

This endpoint upserts an orchestrator host reverse proxy host http route

Parameters
Name Type In Required Description
request object body optional Upsert Host Reverse Proxy Host Http Routes Request
Schema
{
  "cors": "*ReverseProxyHostCors",
  "host": "string",
  "port": "string",
  "tls": "*ReverseProxyHostTls"
}

Deletes an orchestrator host reverse proxy host http route

/api/v1/orchestrator/hosts/{id}/reverse-proxy/hosts/{reverse_proxy_host_id}/http_routes/{route_id} Authorized

This endpoint deletes an orchestrator host reverse proxy host http route

Parameters
Name Type In Required Description
id string path required Host ID
reverse_proxy_host_id string path required Reverse Proxy Host ID
route_id string path required Route ID

Update an orchestrator host reverse proxy host tcp route

/api/v1/orchestrator/hosts/{id}/reverse-proxy/hosts/{reverse_proxy_host_id}/tcp_route Authorized

This endpoint updates an orchestrator host reverse proxy host tcp route

Parameters
Name Type In Required Description
request object body optional Update Host Reverse Proxy Host tcp Routes Request
Schema
{
  "cors": "*ReverseProxyHostCors",
  "host": "string",
  "port": "string",
  "tls": "*ReverseProxyHostTls"
}

Restarts orchestrator host reverse proxy

/api/v1/orchestrator/hosts/{id}/reverse-proxy/restart Authorized

This endpoint restarts orchestrator host reverse proxy

Parameters
Name Type In Required Description
id string path required Host ID

Enables orchestrator host reverse proxy

/api/v1/orchestrator/hosts/{id}/reverse-proxy/enable Authorized

This endpoint enables orchestrator host reverse proxy

Parameters
Name Type In Required Description
id string path required Host ID

Disables orchestrator host reverse proxy

/api/v1/orchestrator/hosts/{id}/reverse-proxy/disable Authorized

This endpoint disables orchestrator host reverse proxy

Parameters
Name Type In Required Description
id string path required Host ID

Gets orchestrator host catalog cache

/api/v1/orchestrator/hosts/{id}/catalog/cache Authorized

This endpoint returns orchestrator host catalog cache

Parameters
Name Type In Required Description
id string path required Host ID

Deletes an orchestrator host cache items

/api/v1/orchestrator/hosts/{id}/catalog/cache Authorized

This endpoint deletes an orchestrator host cache items

Parameters
Name Type In Required Description
id string path required Host ID

Deletes an orchestrator host cache item and all its children

/api/v1/orchestrator/hosts/{id}/catalog/cache/{catalog_id} Authorized

This endpoint deletes an orchestrator host cache item and all its children

Parameters
Name Type In Required Description
id string path required Host ID
catalog_id string path required Catalog ID

Deletes an orchestrator host cache item and all its children

/api/v1/orchestrator/hosts/{id}/catalog/cache/{catalog_id}/{catalog_version} Authorized

This endpoint deletes an orchestrator host cache item and all its children

Parameters
Name Type In Required Description
id string path required Host ID
catalog_id string path required Catalog ID
catalog_version string path required Catalog Version