TLS Edges

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

class ngrok.services.EdgesTLSClient(client)[source]
create(description='', metadata='', hostports=None, backend=None, ip_restriction=None, mutual_tls=None, tls_termination=None)[source]

Create a TLS Edge

Parameters
  • description (str) – human-readable description of what this edge will be used for; optional, max 255 bytes.

  • metadata (str) – arbitrary user-defined machine-readable data of this edge. Optional, max 4096 bytes.

  • hostports (Optional[Sequence[str]]) – hostports served by this edge

  • backend (Optional[EndpointBackendMutate]) – edge modules

  • ip_restriction (Optional[EndpointIPPolicyMutate]) –

  • mutual_tls (Optional[EndpointMutualTLSMutate]) –

  • tls_termination (Optional[EndpointTLSTermination]) –

https://ngrok.com/docs/api#api-edges-tls-create

Return type

TLSEdge

delete(id)[source]

Delete a TLS Edge by ID

Parameters

id (str) – a resource identifier

https://ngrok.com/docs/api#api-edges-tls-delete

get(id)[source]

Get a TLS Edge by ID

Parameters

id (str) – a resource identifier

https://ngrok.com/docs/api#api-edges-tls-get

Return type

TLSEdge

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

Returns a list of all TLS Edges on this account

Parameters
  • before_id (Optional[str]) –

  • limit (Optional[str]) –

https://ngrok.com/docs/api#api-edges-tls-list

Return type

TLSEdgeList

update(id, description=None, metadata=None, hostports=None, backend=None, ip_restriction=None, mutual_tls=None, tls_termination=None)[source]

Updates a TLS Edge by ID. If a module is not specified in the update, it will not be modified. However, each module configuration that is specified will completely replace the existing value. There is no way to delete an existing module via this API, instead use the delete module API.

Parameters
  • id (str) – unique identifier of this edge

  • description (Optional[str]) – human-readable description of what this edge will be used for; optional, max 255 bytes.

  • metadata (Optional[str]) – arbitrary user-defined machine-readable data of this edge. Optional, max 4096 bytes.

  • hostports (Optional[Sequence[str]]) – hostports served by this edge

  • backend (Optional[EndpointBackendMutate]) – edge modules

  • ip_restriction (Optional[EndpointIPPolicyMutate]) –

  • mutual_tls (Optional[EndpointMutualTLSMutate]) –

  • tls_termination (Optional[EndpointTLSTermination]) –

https://ngrok.com/docs/api#api-edges-tls-update

Return type

TLSEdge