Event Subscriptions#

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

class ngrok.services.EventSubscriptionsClient(client)[source]#
create(metadata='', description='', sources=[], destination_ids=[])[source]#

Create an Event Subscription.

Parameters:
  • metadata (str) – Arbitrary customer supplied information intended to be machine readable. Optional, max 4096 chars.

  • description (str) – Arbitrary customer supplied information intended to be human readable. Optional, max 255 chars.

  • sources (Sequence[EventSourceReplace]) – Sources containing the types for which this event subscription will trigger

  • destination_ids (Sequence[str]) – A list of Event Destination IDs which should be used for this Event Subscription.

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

Return type:

EventSubscription

delete(id)[source]#

Delete an Event Subscription.

Parameters:

id (str) – a resource identifier

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

get(id)[source]#

Get an Event Subscription by ID.

Parameters:

id (str) – a resource identifier

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

Return type:

EventSubscription

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

List this Account’s Event Subscriptions.

Parameters:
  • before_id (Optional[str, None]) –

  • limit (Optional[str, None]) –

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

Return type:

EventSubscriptionList

update(id, metadata=None, description=None, sources=None, destination_ids=None)[source]#

Update an Event Subscription.

Parameters:
  • id (str) – Unique identifier for this Event Subscription.

  • metadata (Optional[str, None]) – Arbitrary customer supplied information intended to be machine readable. Optional, max 4096 chars.

  • description (Optional[str, None]) – Arbitrary customer supplied information intended to be human readable. Optional, max 255 chars.

  • sources (Optional[Sequence[EventSourceReplace], None]) – Sources containing the types for which this event subscription will trigger

  • destination_ids (Optional[Sequence[str], None]) – A list of Event Destination IDs which should be used for this Event Subscription.

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

Return type:

EventSubscription