Create multiple services
Create multiple services on outbound interfaces in one simulation. Every service in the request is created, or none are. At most 100 services may be created per request. The same rules as POST /api/v3/simulations/nodes/interfaces/services/ apply: services can only be added to outbound interfaces without a connection, and there can be at most 252 services on any individual interface.
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.
Query parameters
id
interface
name
node
node_port
ordering
Which field to use when ordering the results.
search
A search term.
service_type
The type of service exposed (e.g. SSH or HTTP).
SSH- SSHHTTPS- HTTPSHTTP- HTTPOTHER- Other
Allowed values:
simulation
teleport_access_port
worker_fqdn
worker_port
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
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