Event Destinations#

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

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

create(metadata='', description='', format='', target=None)[source]#

Create a new Event Destination. It will not apply to anything until it is associated with an Event Subscription.

Parameters:

metadata (str) – Arbitrary user-defined machine-readable data of this Event Destination. Optional, max 4096 bytes.
description (str) – Human-readable description of the Event Destination. Optional, max 255 bytes.
format (str) – The output format you would like to serialize events into when sending to their target. Currently the only accepted value is JSON.
target (Optional[EventTarget, None]) – An object that encapsulates where and how to send your events. An event destination must contain exactly one of the following objects, leaving the rest null: kinesis, firehose, cloudwatch_logs, or s3.

delete(id)[source]#

Delete an Event Destination. If the Event Destination is still referenced by an Event Subscription.

Get detailed information about an Event Destination by ID.

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

List all Event Destinations on this account.

Parameters:

update(id, metadata=None, description=None, format=None, target=None)[source]#

Update attributes of an Event Destination.

Parameters:

id (str) – Unique identifier for this Event Destination.
metadata (Optional[str, None]) – Arbitrary user-defined machine-readable data of this Event Destination. Optional, max 4096 bytes.
description (Optional[str, None]) – Human-readable description of the Event Destination. Optional, max 255 bytes.
format (Optional[str, None]) – The output format you would like to serialize events into when sending to their target. Currently the only accepted value is JSON.
target (Optional[EventTarget, None]) – An object that encapsulates where and how to send your events. An event destination must contain exactly one of the following objects, leaving the rest null: kinesis, firehose, cloudwatch_logs, or s3.