Skip to content

port

The port domain has 1 action. On the meta surface they are all reached through arcane_port; on the individual surface each one is its own tool; on the dynamic surface run them with arcane_execute_action and the canonical ID.

ActionTitleKind
port.listList port mappingsread

List port mappings

  • Kind: read
  • Required parameters: none
  • Meta tool: arcane_port with "action": "list"
  • Individual tool: arcane_port_list
  • Arcane route: GET /api/environments/{id}/ports
  • Operation ID: list-ports
  • Usage: One row per port binding of every container in the environment, stopped ones included (containerId, containerName, hostIp, hostPort, containerPort, protocol, isPublished). Exposed-only ports have isPublished false, no hostPort and hostIp “invalid IP”, and a published port can appear once per host IP (e.g. 0.0.0.0 and ::). Use it to find which host ports are taken or which container publishes a port. search matches container name, host IP, host or container port number and protocol, and the call needs the containers:list permission. Paginated (limit defaults to 20). Sort by hostPort, containerPort, protocol, containerName, hostIp or isPublished (sorting by hostPort or hostIp puts unpublished rows last in either order), and pass containerId to container.get for the full config of one container.
  • Related actions: container.get, container.list, container.create