Skip to content
Start here

Connections

List Cloudflare Tunnel connections
zero_trust.tunnels.cloudflared.connections.get(strtunnel_id, ConnectionGetParams**kwargs) -> SyncSinglePage[Client]
GET/accounts/{account_id}/cfd_tunnel/{tunnel_id}/connections
Clean up Cloudflare Tunnel connections
zero_trust.tunnels.cloudflared.connections.delete(strtunnel_id, ConnectionDeleteParams**kwargs) -> object
DELETE/accounts/{account_id}/cfd_tunnel/{tunnel_id}/connections
ModelsExpand Collapse
class Client:

A client (typically cloudflared) that maintains connections to a Cloudflare data center.

id: Optional[str]

UUID of the Cloudflare Tunnel connection.

formatuuid
maxLength36
arch: Optional[str]

The cloudflared OS architecture used to establish this connection.

config_version: Optional[int]

The version of the remote tunnel configuration. Used internally to sync cloudflared with the Zero Trust dashboard.

conns: Optional[List[Conn]]

The Cloudflare Tunnel connections between your origin and Cloudflare’s edge.

id: Optional[str]

UUID of the Cloudflare Tunnel connection.

formatuuid
maxLength36
client_id: Optional[str]

UUID of the Cloudflare Tunnel connector.

formatuuid
maxLength36
client_version: Optional[str]

The cloudflared version used to establish this connection.

colo_name: Optional[str]

The Cloudflare data center used for this connection.

is_pending_reconnect: Optional[bool]

Cloudflare continues to track connections for several minutes after they disconnect. This is an optimization to improve latency and reliability of reconnecting. If true, the connection has disconnected but is still being tracked. If false, the connection is actively serving traffic.

opened_at: Optional[datetime]

Timestamp of when the connection was established.

formatdate-time
origin_ip: Optional[str]

The public IP address of the host running cloudflared.

uuid: Optional[str]

UUID of the Cloudflare Tunnel connection.

formatuuid
maxLength36
features: Optional[List[str]]

Features enabled for the Cloudflare Tunnel.

run_at: Optional[datetime]

Timestamp of when the tunnel connection was started.

formatdate-time
version: Optional[str]

The cloudflared version used to establish this connection.