D360

Get Device Tunnel Status

Returns the tunnel policy status for a device, including the state of primary, secondary, and tertiary tunnel endpoints. Instead of raw IP addresses, the Tunnel Concentrator Service name is resolved where possible.

get/d360/device/tunnel-status

Request

  • Base URL
    https://api.extremecloudiq.com
  • URL
    https://api.extremecloudiq.com/d360/device/tunnel-status
  • Auth
    HTTP bearer

Query parameters

deviceIdinteger required

The device ID

Response

OK

tunnel_policy_namestring

The name of the tunnel policy

total_client_countinteger

Total number of clients across all active tunnel endpoints

has_failed_endpointboolean

Whether any endpoint is in FAIL state

last_updatedinteger

Timestamp when the tunnel state was last updated (Unix timestamp in milliseconds)

Example response

[
  {
    "tunnel_policy_name": "Corporate-Tunnel-Policy",
    "primary": {
      "service_name": "TunnelConcentrator-Primary",
      "ip_address": "10.0.0.1",
      "state": "ACTIVE",
      "client_count": 25,
      "mtu_state": "NORMAL",
      "mtu_configured": 1500
    },
    "secondary": {
      "service_name": "TunnelConcentrator-Primary",
      "ip_address": "10.0.0.1",
      "state": "ACTIVE",
      "client_count": 25,
      "mtu_state": "NORMAL",
      "mtu_configured": 1500
    },
    "tertiary": {
      "service_name": "TunnelConcentrator-Primary",
      "ip_address": "10.0.0.1",
      "state": "ACTIVE",
      "client_count": 25,
      "mtu_state": "NORMAL",
      "mtu_configured": 1500
    },
    "total_client_count": 75,
    "last_updated": 1622548800000
  }
]

Changes

No operation changes recorded.