## List All Tunnels `zero_trust.tunnels.list(TunnelListParams**kwargs) -> SyncV4PagePaginationArray[TunnelListResponse]` **get** `/accounts/{account_id}/tunnels` Lists and filters all types of Tunnels in an account. ### Parameters - `account_id: str` Cloudflare account ID - `exclude_prefix: Optional[str]` - `existed_at: Optional[str]` If provided, include only resources that were created (and not deleted) before this time. URL encoded. - `include_prefix: Optional[str]` - `is_deleted: Optional[bool]` If `true`, only include deleted tunnels. If `false`, exclude deleted tunnels. If empty, all tunnels will be included. - `name: Optional[str]` A user-friendly name for the tunnel. - `page: Optional[float]` Page number of paginated results. - `per_page: Optional[float]` Number of results to display. - `status: Optional[Literal["inactive", "degraded", "healthy", "down"]]` The status of the tunnel. Valid values are `inactive` (tunnel has never been run), `degraded` (tunnel is active and able to serve traffic but in an unhealthy state), `healthy` (tunnel is active and able to serve traffic), or `down` (tunnel can not serve traffic as it has no connections to the Cloudflare Edge). - `"inactive"` - `"degraded"` - `"healthy"` - `"down"` - `tun_types: Optional[List[Literal["cfd_tunnel", "warp_connector", "warp", 4 more]]]` The types of tunnels to filter by, separated by commas. - `"cfd_tunnel"` - `"warp_connector"` - `"warp"` - `"magic"` - `"ip_sec"` - `"gre"` - `"cni"` - `uuid: Optional[str]` UUID of the tunnel. - `was_active_at: Optional[Union[str, datetime]]` - `was_inactive_at: Optional[Union[str, datetime]]` ### Returns - `TunnelListResponse` A Cloudflare Tunnel that connects your origin to Cloudflare's edge. - `class CloudflareTunnel: …` A Cloudflare Tunnel that connects your origin to Cloudflare's edge. - `id: Optional[str]` UUID of the tunnel. - `account_tag: Optional[str]` Cloudflare account ID - `config_src: Optional[Literal["local", "cloudflare"]]` Indicates if this is a locally or remotely configured tunnel. If `local`, manage the tunnel using a YAML file on the origin machine. If `cloudflare`, manage the tunnel on the Zero Trust dashboard. - `"local"` - `"cloudflare"` - `connections: Optional[List[Connection]]` The Cloudflare Tunnel connections between your origin and Cloudflare's edge. - `id: Optional[str]` UUID of the Cloudflare Tunnel connection. - `client_id: Optional[str]` UUID of the Cloudflare Tunnel connector. - `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. - `origin_ip: Optional[str]` The public IP address of the host running cloudflared. - `uuid: Optional[str]` UUID of the Cloudflare Tunnel connection. - `conns_active_at: Optional[datetime]` Timestamp of when the tunnel established at least one connection to Cloudflare's edge. If `null`, the tunnel is inactive. - `conns_inactive_at: Optional[datetime]` Timestamp of when the tunnel became inactive (no connections to Cloudflare's edge). If `null`, the tunnel is active. - `created_at: Optional[datetime]` Timestamp of when the resource was created. - `deleted_at: Optional[datetime]` Timestamp of when the resource was deleted. If `null`, the resource has not been deleted. - `metadata: Optional[object]` Metadata associated with the tunnel. - `name: Optional[str]` A user-friendly name for a tunnel. - `remote_config: Optional[bool]` If `true`, the tunnel can be configured remotely from the Zero Trust dashboard. If `false`, the tunnel must be configured locally on the origin machine. - `status: Optional[Literal["inactive", "degraded", "healthy", "down"]]` The status of the tunnel. Valid values are `inactive` (tunnel has never been run), `degraded` (tunnel is active and able to serve traffic but in an unhealthy state), `healthy` (tunnel is active and able to serve traffic), or `down` (tunnel can not serve traffic as it has no connections to the Cloudflare Edge). - `"inactive"` - `"degraded"` - `"healthy"` - `"down"` - `tun_type: Optional[Literal["cfd_tunnel", "warp_connector", "warp", 4 more]]` The type of tunnel. - `"cfd_tunnel"` - `"warp_connector"` - `"warp"` - `"magic"` - `"ip_sec"` - `"gre"` - `"cni"` - `class TunnelWARPConnectorTunnel: …` A Warp Connector Tunnel that connects your origin to Cloudflare's edge. - `id: Optional[str]` UUID of the tunnel. - `account_tag: Optional[str]` Cloudflare account ID - `connections: Optional[List[TunnelWARPConnectorTunnelConnection]]` The Cloudflare Tunnel connections between your origin and Cloudflare's edge. - `id: Optional[str]` UUID of the Cloudflare Tunnel connection. - `client_id: Optional[str]` UUID of the Cloudflare Tunnel connector. - `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. - `origin_ip: Optional[str]` The public IP address of the host running cloudflared. - `uuid: Optional[str]` UUID of the Cloudflare Tunnel connection. - `conns_active_at: Optional[datetime]` Timestamp of when the tunnel established at least one connection to Cloudflare's edge. If `null`, the tunnel is inactive. - `conns_inactive_at: Optional[datetime]` Timestamp of when the tunnel became inactive (no connections to Cloudflare's edge). If `null`, the tunnel is active. - `created_at: Optional[datetime]` Timestamp of when the resource was created. - `deleted_at: Optional[datetime]` Timestamp of when the resource was deleted. If `null`, the resource has not been deleted. - `metadata: Optional[object]` Metadata associated with the tunnel. - `name: Optional[str]` A user-friendly name for a tunnel. - `status: Optional[Literal["inactive", "degraded", "healthy", "down"]]` The status of the tunnel. Valid values are `inactive` (tunnel has never been run), `degraded` (tunnel is active and able to serve traffic but in an unhealthy state), `healthy` (tunnel is active and able to serve traffic), or `down` (tunnel can not serve traffic as it has no connections to the Cloudflare Edge). - `"inactive"` - `"degraded"` - `"healthy"` - `"down"` - `tun_type: Optional[Literal["cfd_tunnel", "warp_connector", "warp", 4 more]]` The type of tunnel. - `"cfd_tunnel"` - `"warp_connector"` - `"warp"` - `"magic"` - `"ip_sec"` - `"gre"` - `"cni"` ### Example ```python import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) page = client.zero_trust.tunnels.list( account_id="699d98642c564d2e855e9661899b7252", ) page = page.result[0] print(page) ``` #### Response ```json { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "result": [ { "id": "f70ff985-a4ef-4643-bbbc-4a0ed4fc8415", "account_tag": "699d98642c564d2e855e9661899b7252", "config_src": "cloudflare", "connections": [ { "id": "1bedc50d-42b3-473c-b108-ff3d10c0d925", "client_id": "1bedc50d-42b3-473c-b108-ff3d10c0d925", "client_version": "2022.7.1", "colo_name": "DFW", "is_pending_reconnect": false, "opened_at": "2021-01-25T18:22:34.317854Z", "origin_ip": "10.1.0.137", "uuid": "1bedc50d-42b3-473c-b108-ff3d10c0d925" } ], "conns_active_at": "2009-11-10T23:00:00Z", "conns_inactive_at": "2009-11-10T23:00:00Z", "created_at": "2021-01-25T18:22:34.317854Z", "deleted_at": "2009-11-10T23:00:00.000000Z", "metadata": {}, "name": "blog", "remote_config": true, "status": "healthy", "tun_type": "cfd_tunnel" } ], "success": true, "result_info": { "count": 1, "page": 1, "per_page": 20, "total_count": 2000 } } ```