HTTPS Edges#

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

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

Create an HTTPS 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], None]) – hostports served by this edge

  • mutual_tls (Optional[EndpointMutualTLSMutate, None]) – edge modules

  • tls_termination (Optional[EndpointTLSTerminationAtEdge, None]) –

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

Return type:

HTTPSEdge

delete(id)[source]#

Delete an HTTPS Edge by ID

Parameters:

id (str) – a resource identifier

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

get(id)[source]#

Get an HTTPS Edge by ID

Parameters:

id (str) – a resource identifier

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

Return type:

HTTPSEdge

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

Returns a list of all HTTPS Edges on this account

Parameters:

  • before_id (Optional[str, None]) –

  • limit (Optional[str, None]) –

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

Return type:

HTTPSEdgeList

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

Updates an HTTPS 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, None]) – human-readable description of what this edge will be used for; optional, max 255 bytes.

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

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

  • mutual_tls (Optional[EndpointMutualTLSMutate, None]) – edge modules

  • tls_termination (Optional[EndpointTLSTerminationAtEdge, None]) –

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

Return type:

HTTPSEdge