Expose several node ports as services
Creates every service in services, or none: one refused entry refuses the request, and the error names the entries by position. At most 100 services per request, all in one simulation.
The rules of POST /api/v3/simulations/nodes/interfaces/services/ apply to each entry: an outbound interface with no link, and at most 252 services per interface. A simulation with Teleport on can hold at most 5000 services and VNC-enabled nodes combined.
Required scope: Simulation Edit (roles: Air Org Administrator, Air User)
Authentication
AuthorizationBearer
Bearer authentication of the form Bearer <token>, where token is your auth token.
Request
This endpoint expects an object.
services
Services to create. Every interface must belong to the same simulation. At most 100 services may be created per request.
Response
id
created
modified
node_port
The port number associated with the service within the allowable range for an IP port (UINT16).
worker_port
The port exposed by the worker.
worker_fqdn
The FQDN of the worker machine this service is running on. When the associated node is not active, this will be null.
interface
The outbound interface the service forwards to.
name
The name of the service.
service_type
The type of service exposed (e.g. SSH or HTTP).
SSH- SSHHTTPS- HTTPSHTTP- HTTPOTHER- Other
Allowed values:
teleport_access_port
The port that reaches this service over Teleport. Can only be set when the simulation's organization is allowed to use Teleport. When omitted, Air assigns one if Teleport is enabled on the simulation, and otherwise when Teleport is turned on.
Errors
400
Bad Request Error
403
Forbidden Error
500
Internal Server Error