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 (EventTarget) – 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.

https://ngrok.com/docs/api#api-event-destinations-create

Return type:

EventDestination

delete(id)[source]#

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

Parameters:

id (str) – a resource identifier

https://ngrok.com/docs/api#api-event-destinations-delete

get(id)[source]#

Get detailed information about an Event Destination by ID.

Parameters:

id (str) – a resource identifier

https://ngrok.com/docs/api#api-event-destinations-get

Return type:

EventDestination

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

List all Event Destinations on this account.

Parameters:
  • before_id (str) –

  • limit (str) –

https://ngrok.com/docs/api#api-event-destinations-list

Return type:

EventDestinationList

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 (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 (EventTarget) – 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.

https://ngrok.com/docs/api#api-event-destinations-update

Return type:

EventDestination