Test TCP port connectivity from inside a virtual network namespace

Request

Runs nc -v -z {host} {port} inside the management namespace for the specified virtual network, testing connectivity as seen from that network context.

Use ?wait=1 to block and receive the result synchronously.

Requires nodes::service:tg-net-nc or nodes::remote-execute permission.

Security

JWTAuthorizer

Path

nodeIDstringrequired

Node ID

Query

waitinteger

Pass 1 to block until the node responds and return its output.

Value:1

Bodyapplication/jsonrequired

networkstringrequired

Virtual network name whose namespace to test from

Example:"virtual-network"

hoststringrequired

Target host IP or hostname

Example:"10.0.0.1"

portintegerrequired

Target TCP port

Example:80

curl -i -X POST \
  'https://apidocs.trustgrid.io/_mock/node/{nodeID}/trigger/tg-net-nc?wait=1' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "network": "virtual-network",
    "host": "10.0.0.1",
    "port": 80
  }'

Responses

OK

Bodyapplication/json

outputobject

Response

{
  "output": {
    "message": "string",
    "exitCode": "string"
  }
}