Class: NgrokAPI::Services::EventSourcesClient

Inherits:
Object
  • Object
show all
Defined in:
lib/ngrokapi/services/event_sources_client.rb

Overview

ngrok.com/docs/api#api-event-sources

Constant Summary collapse

PATH =

The API path for the requests

'/event_subscriptions/%{subscription_id}/sources'

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(client:) ⇒ EventSourcesClient

Returns a new instance of EventSourcesClient.



13
14
15
 
# File 'lib/ngrokapi/services/event_sources_client.rb', line 13

def initialize(client:)
  @client = client
end

Instance Attribute Details

#client ⇒ Object (readonly)

Returns the value of attribute client.



11
12
13
 
# File 'lib/ngrokapi/services/event_sources_client.rb', line 11

def client
  @client
end

Instance Method Details

#create(subscription_id: "", type: "", filter: "", fields: []) ⇒ NgrokAPI::Models::EventSource

Add an additional type for which this event subscription will trigger

ngrok.com/docs/api#api-event-sources-create

Parameters:

  • subscription_id (string) (defaults to: "") —

    The unique identifier for the Event Subscription that this Event Source is attached to.

  • type (string) (defaults to: "") —

    Type of event for which an event subscription will trigger

Returns:



25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
 
# File 'lib/ngrokapi/services/event_sources_client.rb', line 25

def create(
  subscription_id: "",
  type: "",
  filter: "",
  fields: []
)
  path = '/event_subscriptions/%{subscription_id}/sources'
  replacements = {
    subscription_id: subscription_id,
  }
  data = {}
  data[:type] = type if type
  result = @client.post(path % replacements, data: data)
  NgrokAPI::Models::EventSource.new(client: self, result: result)
end

#delete(subscription_id: "", type: "") ⇒ NgrokAPI::Models::Empty

Remove a type for which this event subscription will trigger

ngrok.com/docs/api#api-event-sources-delete

Parameters:

  • subscription_id (string) (defaults to: "") —

    The unique identifier for the Event Subscription that this Event Source is attached to.

  • type (string) (defaults to: "") —

    Type of event for which an event subscription will trigger

Returns:

  • (NgrokAPI::Models::Empty) —

    result from the API request



49
50
51
52
53
54
55
56
57
58
59
 
# File 'lib/ngrokapi/services/event_sources_client.rb', line 49

def delete(
  subscription_id: "",
  type: ""
)
  path = '/event_subscriptions/%{subscription_id}/sources/%{type}'
  replacements = {
    subscription_id: subscription_id,
    type: type,
  }
  @client.delete(path % replacements)
end

#delete!(subscription_id: "", type: "") ⇒ NgrokAPI::Models::Empty

Remove a type for which this event subscription will trigger Throws an exception if API error.

ngrok.com/docs/api#api-event-sources-delete

Parameters:

  • subscription_id (string) (defaults to: "") —

    The unique identifier for the Event Subscription that this Event Source is attached to.

  • type (string) (defaults to: "") —

    Type of event for which an event subscription will trigger

Returns:

  • (NgrokAPI::Models::Empty) —

    result from the API request



70
71
72
73
74
75
76
77
78
79
80
 
# File 'lib/ngrokapi/services/event_sources_client.rb', line 70

def delete!(
  subscription_id: "",
  type: ""
)
  path = '/event_subscriptions/%{subscription_id}/sources/%{type}'
  replacements = {
    subscription_id: subscription_id,
    type: type,
  }
  @client.delete(path % replacements, danger: true)
end

#get(subscription_id: "", type: "") ⇒ NgrokAPI::Models::EventSource

Get the details for a given type that triggers for the given event subscription

ngrok.com/docs/api#api-event-sources-get

Parameters:

  • subscription_id (string) (defaults to: "") —

    The unique identifier for the Event Subscription that this Event Source is attached to.

  • type (string) (defaults to: "") —

    Type of event for which an event subscription will trigger

Returns:



90
91
92
93
94
95
96
97
98
99
100
101
102
 
# File 'lib/ngrokapi/services/event_sources_client.rb', line 90

def get(
  subscription_id: "",
  type: ""
)
  path = '/event_subscriptions/%{subscription_id}/sources/%{type}'
  replacements = {
    subscription_id: subscription_id,
    type: type,
  }
  data = {}
  result = @client.get(path % replacements, data: data)
  NgrokAPI::Models::EventSource.new(client: self, result: result)
end

#get!(subscription_id: "", type: "") ⇒ NgrokAPI::Models::EventSource

Get the details for a given type that triggers for the given event subscription Throws an exception if API error.

ngrok.com/docs/api#api-event-sources-get

Parameters:

  • subscription_id (string) (defaults to: "") —

    The unique identifier for the Event Subscription that this Event Source is attached to.

  • type (string) (defaults to: "") —

    Type of event for which an event subscription will trigger

Returns:



113
114
115
116
117
118
119
120
121
122
123
124
125
 
# File 'lib/ngrokapi/services/event_sources_client.rb', line 113

def get!(
  subscription_id: "",
  type: ""
)
  path = '/event_subscriptions/%{subscription_id}/sources/%{type}'
  replacements = {
    subscription_id: subscription_id,
    type: type,
  }
  data = {}
  result = @client.get(path % replacements, data: data, danger: true)
  NgrokAPI::Models::EventSource.new(client: self, result: result)
end

#list(subscription_id: "") ⇒ NgrokAPI::Models::EventSourceList

List the types for which this event subscription will trigger

ngrok.com/docs/api#api-event-sources-list

Parameters:

  • subscription_id (string) (defaults to: "") —

    The unique identifier for the Event Subscription that this Event Source is attached to.

Returns:



134
135
136
137
138
139
140
141
142
143
144
 
# File 'lib/ngrokapi/services/event_sources_client.rb', line 134

def list(
  subscription_id: ""
)
  path = '/event_subscriptions/%{subscription_id}/sources'
  replacements = {
    subscription_id: subscription_id,
  }
  data = {}
  result = @client.get(path % replacements, data: data)
  NgrokAPI::Models::EventSourceList.new(client: self, result: result)
end

#list!(subscription_id: "") ⇒ NgrokAPI::Models::EventSourceList

List the types for which this event subscription will trigger Throws an exception if API error.

ngrok.com/docs/api#api-event-sources-list

Parameters:

  • subscription_id (string) (defaults to: "") —

    The unique identifier for the Event Subscription that this Event Source is attached to.

Returns:



154
155
156
157
158
159
160
161
162
163
164
 
# File 'lib/ngrokapi/services/event_sources_client.rb', line 154

def list!(
  subscription_id: ""
)
  path = '/event_subscriptions/%{subscription_id}/sources'
  replacements = {
    subscription_id: subscription_id,
  }
  data = {}
  result = @client.get(path % replacements, data: data, danger: true)
  NgrokAPI::Models::EventSourceList.new(client: self, result: result)
end

#update(subscription_id: "", type: "", filter: nil, fields: nil) ⇒ NgrokAPI::Models::EventSource

Update the type for which this event subscription will trigger

ngrok.com/docs/api#api-event-sources-update

Parameters:

  • subscription_id (string) (defaults to: "") —

    The unique identifier for the Event Subscription that this Event Source is attached to.

  • type (string) (defaults to: "") —

    Type of event for which an event subscription will trigger

Returns:



174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
 
# File 'lib/ngrokapi/services/event_sources_client.rb', line 174

def update(
  subscription_id: "",
  type: "",
  filter: nil,
  fields: nil
)
  path = '/event_subscriptions/%{subscription_id}/sources/%{type}'
  replacements = {
    subscription_id: subscription_id,
    type: type,
  }
  data = {}
  result = @client.patch(path % replacements, data: data)
  NgrokAPI::Models::EventSource.new(client: self, result: result)
end

#update!(subscription_id: "", type: "", filter: nil, fields: nil) ⇒ NgrokAPI::Models::EventSource

Update the type for which this event subscription will trigger Throws an exception if API error.

ngrok.com/docs/api#api-event-sources-update

Parameters:

  • subscription_id (string) (defaults to: "") —

    The unique identifier for the Event Subscription that this Event Source is attached to.

  • type (string) (defaults to: "") —

    Type of event for which an event subscription will trigger

Returns:



199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
 
# File 'lib/ngrokapi/services/event_sources_client.rb', line 199

def update!(
  subscription_id: "",
  type: "",
  filter: nil,
  fields: nil
)
  path = '/event_subscriptions/%{subscription_id}/sources/%{type}'
  replacements = {
    subscription_id: subscription_id,
    type: type,
  }
  data = {}
  result = @client.patch(path % replacements, data: data, danger: true)
  NgrokAPI::Models::EventSource.new(client: self, result: result)
end