Fetch network node details

GET 
/api/v1/networks/nodes/:nodeId

This API endpoint retrieve details of a network node identified by the provided nodeId. This includes details about node and its associated network, machine information.

Request

Path Parameters

nodeId stringrequired

The nodeId - uuid of the network node

Responses

200

Success response

application/json

Schema

Schema

success boolean
message string
status string
statusCode int32
errorCode string
subErrors object[]

payload

object

Schema for network node response

nodeId string

dnsName string

ipv4Address string

ipv6Address string

networkId string

createdAt date-time

networks

object

Networks schema

networkId string

provider string

ipSubnet string

dnsName string

dnsSuffix string

networkName string

isDefault boolean

isNetworkKeyManaged boolean

machineData

object

Schema for machine data in network node response

machineId string

displayIconMediaPath string

alias string

name string

lastActiveAt date-time

Example (from schema)

{
  "success": true,
  "message": "string",
  "status": "string",
  "statusCode": 0,
  "errorCode": "string",
  "subErrors": [
    {}
  ],
  "payload": {
    "nodeId": "string",
    "dnsName": "string",
    "ipv4Address": "string",
    "ipv6Address": "string",
    "networkId": "string",
    "createdAt": "2024-07-29T15:51:28.071Z",
    "networks": {
      "networkId": "string",
      "provider": "string",
      "ipSubnet": "string",
      "dnsName": "string",
      "dnsSuffix": "string",
      "networkName": "string",
      "isDefault": true,
      "isNetworkKeyManaged": true
    },
    "machineData": {
      "machineId": "string",
      "displayIconMediaPath": "string",
      "alias": "string",
      "name": "string",
      "lastActiveAt": "2024-07-29T15:51:28.071Z"
    }
  }
}

Network node details example

Network node details response example

{
  "success": true,
  "message": "Network node fetched successfully",
  "status": "OK",
  "statusCode": 200,
  "errorCode": "",
  "subErrors": [
    {}
  ],
  "payload": {
    "nodeId": "f32552de-903f-48a0-bb2d-4b39b016b3ef",
    "dnsName": "test-dns",
    "ipv4Address": "100.64.0.1",
    "ipv6Address": "string",
    "networkId": "xxb63e2aaedx-pffc-123",
    "createdAt": "2024-06-17T08:01:52.134Z",
    "networks": {
      "networkId": "xxb63e2aaedx-pffc-123",
      "provider": "provider",
      "ipSubnet": "10.0.0.0/24",
      "dnsName": "test-dns",
      "dnsSuffix": "mec.sh",
      "networkName": "test",
      "isDefault": true,
      "isNetworkKeyManaged": true
    },
    "machineData": {
      "machineId": "xxb63e2aaedx-xxxx-123",
      "displayIconMediaPath": "string",
      "alias": "test-alias",
      "name": "Test machine",
      "lastActiveAt": "2024-06-06T05:42:20.278Z"
    }
  }
}

Loading...