Tunnel Group Backends#

Do not construct this object directly, instead access the tunnel_group_backends property of an ngrok.Client object.

class ngrok.services.TunnelGroupBackendsClient(client)[source]#

A Tunnel Group Backend balances traffic among all online tunnels that match a label selector.

create(description='', metadata='', labels={})[source]#

Create a new TunnelGroup backend

Parameters:

  • description (str) – human-readable description of this backend. Optional

  • metadata (str) – arbitrary user-defined machine-readable data of this backend. Optional

  • labels (Mapping[str, str]) – labels to watch for tunnels on, e.g. app->foo, dc->bar

https://ngrok.com/docs/api#api-tunnel-group-backends-create

Return type:

TunnelGroupBackend

delete(id)[source]#

Delete a TunnelGroup backend by ID.

Parameters:

id (str) – a resource identifier

https://ngrok.com/docs/api#api-tunnel-group-backends-delete

get(id)[source]#

Get detailed information about a TunnelGroup backend by ID

Parameters:

id (str) – a resource identifier

https://ngrok.com/docs/api#api-tunnel-group-backends-get

Return type:

TunnelGroupBackend

list(before_id=None, limit=None)[source]#

List all TunnelGroup backends on this account

Parameters:

  • before_id (Optional[str, None]) –

  • limit (Optional[str, None]) –

https://ngrok.com/docs/api#api-tunnel-group-backends-list

Return type:

TunnelGroupBackendList

update(id, description=None, metadata=None, labels={})[source]#

Update TunnelGroup backend by ID

Parameters:

  • id (str) –

  • description (Optional[str, None]) – human-readable description of this backend. Optional

  • metadata (Optional[str, None]) – arbitrary user-defined machine-readable data of this backend. Optional

  • labels (Mapping[str, str]) – labels to watch for tunnels on, e.g. app->foo, dc->bar

https://ngrok.com/docs/api#api-tunnel-group-backends-update

Return type:

TunnelGroupBackend