ngrok-api 0.16.0 → 0.19.0

data/lib/ngrokapi/services/edges_tls_client.rb

@@ -0,0 +1,267 @@
+# frozen_string_literal: true
+
+module NgrokAPI
+  module Services
+    ##
+    # https://ngrok.com/docs/api#api-edges-tls
+    class EdgesTLSClient
+      # The API path for the requests
+      PATH = '/edges/tls'
+      # The List Property from the resulting API for list calls
+      LIST_PROPERTY = 'tls_edges'
+
+      attr_reader :client
+
+      def initialize(client:)
+        @client = client
+      end
+
+      ##
+      # Create a TLS Edge
+      #
+      # @param [string] description human-readable description of what this edge will be used for; optional, max 255 bytes.
+      # @param [string] metadata arbitrary user-defined machine-readable data of this edge. Optional, max 4096 bytes.
+      # @param [List<string>] hostports hostports served by this edge
+      # @param [EndpointBackendMutate] backend edge modules
+      # @param [EndpointIPPolicyMutate] ip_restriction
+      # @param [EndpointMutualTLSMutate] mutual_tls
+      # @param [EndpointTLSTermination] tls_termination
+      # @return [NgrokAPI::Models::TLSEdge] result from the API request
+      #
+      # https://ngrok.com/docs/api#api-edges-tls-create
+      def create(description: "", metadata: "", hostports: nil, backend: nil, ip_restriction: nil, mutual_tls: nil, tls_termination: nil)
+        path = '/edges/tls'
+        replacements = {
+        }
+        data = {}
+        data[:description] = description if description
+        data[:metadata] = metadata if metadata
+        data[:hostports] = hostports if hostports
+        data[:backend] = backend if backend
+        data[:ip_restriction] = ip_restriction if ip_restriction
+        data[:mutual_tls] = mutual_tls if mutual_tls
+        data[:tls_termination] = tls_termination if tls_termination
+        result = @client.post(path % replacements, data: data)
+        NgrokAPI::Models::TLSEdge.new(client: self, attrs: result)
+      end
+
+      ##
+      # Create a TLS Edge
+      # Throws an exception if API error.
+      #
+      # @param [string] description human-readable description of what this edge will be used for; optional, max 255 bytes.
+      # @param [string] metadata arbitrary user-defined machine-readable data of this edge. Optional, max 4096 bytes.
+      # @param [List<string>] hostports hostports served by this edge
+      # @param [EndpointBackendMutate] backend edge modules
+      # @param [EndpointIPPolicyMutate] ip_restriction
+      # @param [EndpointMutualTLSMutate] mutual_tls
+      # @param [EndpointTLSTermination] tls_termination
+      # @return [NgrokAPI::Models::TLSEdge] result from the API request
+      #
+      # https://ngrok.com/docs/api#api-edges-tls-create
+      def create!(description: "", metadata: "", hostports: nil, backend: nil, ip_restriction: nil, mutual_tls: nil, tls_termination: nil)
+        path = '/edges/tls'
+        replacements = {
+        }
+        data = {}
+        data[:description] = description if description
+        data[:metadata] = metadata if metadata
+        data[:hostports] = hostports if hostports
+        data[:backend] = backend if backend
+        data[:ip_restriction] = ip_restriction if ip_restriction
+        data[:mutual_tls] = mutual_tls if mutual_tls
+        data[:tls_termination] = tls_termination if tls_termination
+        result = @client.post(path % replacements, data: data, danger: true)
+        NgrokAPI::Models::TLSEdge.new(client: self, attrs: result)
+      end
+
+      ##
+      # Get a TLS Edge by ID
+      #
+      # @param [string] id a resource identifier
+      # @return [NgrokAPI::Models::TLSEdge] result from the API request
+      #
+      # https://ngrok.com/docs/api#api-edges-tls-get
+      def get(id: "")
+        path = '/edges/tls/%{id}'
+        replacements = {
+          id: id,
+        }
+        data = {}
+        result = @client.get(path % replacements, data: data)
+        NgrokAPI::Models::TLSEdge.new(client: self, attrs: result)
+      end
+
+      ##
+      # Get a TLS Edge by ID
+      # Throws an exception if API error.
+      #
+      # @param [string] id a resource identifier
+      # @return [NgrokAPI::Models::TLSEdge] result from the API request
+      #
+      # https://ngrok.com/docs/api#api-edges-tls-get
+      def get!(id: "")
+        path = '/edges/tls/%{id}'
+        replacements = {
+          id: id,
+        }
+        data = {}
+        result = @client.get(path % replacements, data: data, danger: true)
+        NgrokAPI::Models::TLSEdge.new(client: self, attrs: result)
+      end
+
+      ##
+      # Returns a list of all TLS Edges on this account
+      #
+      # @param [string] before_id
+      # @param [string] limit
+      # @param [string] url optional and mutually exclusive from before_id and limit
+      # @return [NgrokAPI::Models::Listable] result from the API request
+      #
+      # https://ngrok.com/docs/api#api-edges-tls-list
+      def list(before_id: nil, limit: nil, url: nil)
+        result = @client.list(
+          before_id: before_id,
+          limit: limit,
+          url: url,
+          path: PATH
+        )
+
+        NgrokAPI::Models::Listable.new(
+          client: self,
+          attrs: result,
+          list_property: LIST_PROPERTY,
+          klass: NgrokAPI::Models::TLSEdge
+        )
+      end
+
+      ##
+      # Returns a list of all TLS Edges on this account
+      # Throws an exception if API error.
+      #
+      # @param [string] before_id
+      # @param [string] limit
+      # @param [string] url optional and mutually exclusive from before_id and limit
+      # @return [NgrokAPI::Models::Listable] result from the API request
+      #
+      # https://ngrok.com/docs/api#api-edges-tls-list
+      def list!(before_id: nil, limit: nil, url: nil)
+        result = @client.list(
+          before_id: before_id,
+          limit: limit,
+          danger: true,
+          url: url,
+          path: PATH
+        )
+
+        NgrokAPI::Models::Listable.new(
+          client: self,
+          attrs: result,
+          list_property: LIST_PROPERTY,
+          klass: NgrokAPI::Models::TLSEdge,
+          danger: true
+        )
+      end
+
+      ##
+      # Updates a TLS 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.
+      #
+      # @param [string] id unique identifier of this edge
+      # @param [string] description human-readable description of what this edge will be used for; optional, max 255 bytes.
+      # @param [string] metadata arbitrary user-defined machine-readable data of this edge. Optional, max 4096 bytes.
+      # @param [List<string>] hostports hostports served by this edge
+      # @param [EndpointBackendMutate] backend edge modules
+      # @param [EndpointIPPolicyMutate] ip_restriction
+      # @param [EndpointMutualTLSMutate] mutual_tls
+      # @param [EndpointTLSTermination] tls_termination
+      # @return [NgrokAPI::Models::TLSEdge] result from the API request
+      #
+      # https://ngrok.com/docs/api#api-edges-tls-update
+      def update(id: "", description: nil, metadata: nil, hostports: nil, backend: nil, ip_restriction: nil, mutual_tls: nil, tls_termination: nil)
+        path = '/edges/tls/%{id}'
+        replacements = {
+          id: id,
+        }
+        data = {}
+        data[:description] = description if description
+        data[:metadata] = metadata if metadata
+        data[:hostports] = hostports if hostports
+        data[:backend] = backend if backend
+        data[:ip_restriction] = ip_restriction if ip_restriction
+        data[:mutual_tls] = mutual_tls if mutual_tls
+        data[:tls_termination] = tls_termination if tls_termination
+        result = @client.patch(path % replacements, data: data)
+        NgrokAPI::Models::TLSEdge.new(client: self, attrs: result)
+      end
+
+      ##
+      # Updates a TLS 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.
+      # Throws an exception if API error.
+      #
+      # @param [string] id unique identifier of this edge
+      # @param [string] description human-readable description of what this edge will be used for; optional, max 255 bytes.
+      # @param [string] metadata arbitrary user-defined machine-readable data of this edge. Optional, max 4096 bytes.
+      # @param [List<string>] hostports hostports served by this edge
+      # @param [EndpointBackendMutate] backend edge modules
+      # @param [EndpointIPPolicyMutate] ip_restriction
+      # @param [EndpointMutualTLSMutate] mutual_tls
+      # @param [EndpointTLSTermination] tls_termination
+      # @return [NgrokAPI::Models::TLSEdge] result from the API request
+      #
+      # https://ngrok.com/docs/api#api-edges-tls-update
+      def update!(id: "", description: nil, metadata: nil, hostports: nil, backend: nil, ip_restriction: nil, mutual_tls: nil, tls_termination: nil)
+        path = '/edges/tls/%{id}'
+        replacements = {
+          id: id,
+        }
+        data = {}
+        data[:description] = description if description
+        data[:metadata] = metadata if metadata
+        data[:hostports] = hostports if hostports
+        data[:backend] = backend if backend
+        data[:ip_restriction] = ip_restriction if ip_restriction
+        data[:mutual_tls] = mutual_tls if mutual_tls
+        data[:tls_termination] = tls_termination if tls_termination
+        result = @client.patch(path % replacements, data: data, danger: true)
+        NgrokAPI::Models::TLSEdge.new(client: self, attrs: result)
+      end
+
+      ##
+      # Delete a TLS Edge by ID
+      #
+      # @param [string] id a resource identifier
+      # @return [NgrokAPI::Models::Empty] result from the API request
+      #
+      # https://ngrok.com/docs/api#api-edges-tls-delete
+      def delete(id: "")
+        path = '/edges/tls/%{id}'
+        replacements = {
+          id: id,
+        }
+        @client.delete(path % replacements)
+      end
+
+      ##
+      # Delete a TLS Edge by ID
+      # Throws an exception if API error.
+      #
+      # @param [string] id a resource identifier
+      # @return [NgrokAPI::Models::Empty] result from the API request
+      #
+      # https://ngrok.com/docs/api#api-edges-tls-delete
+      def delete!(id: "")
+        path = '/edges/tls/%{id}'
+        replacements = {
+          id: id,
+        }
+        @client.delete(path % replacements, danger: true)
+      end
+    end
+  end
+end

data/lib/ngrokapi/services/endpoints_client.rb

@@ -0,0 +1,112 @@
+# frozen_string_literal: true
+
+module NgrokAPI
+  module Services
+    ##
+    # Endpoints provides an API for querying the endpoint objects
+    #  which define what tunnel or edge is used to serve a hostport.
+    #  Only active endpoints associated with a tunnel or backend are returned.
+    #
+    # https://ngrok.com/docs/api#api-endpoints
+    class EndpointsClient
+      # The List Property from the resulting API for list calls
+      LIST_PROPERTY = 'endpoints'
+      # The API path for the requests
+      PATH = '/endpoints'
+
+      attr_reader :client
+
+      def initialize(client:)
+        @client = client
+      end
+
+      ##
+      # List all active endpoints on the account
+      #
+      # @param [string] before_id
+      # @param [string] limit
+      # @param [string] url optional and mutually exclusive from before_id and limit
+      # @return [NgrokAPI::Models::Listable] result from the API request
+      #
+      # https://ngrok.com/docs/api#api-endpoints-list
+      def list(before_id: nil, limit: nil, url: nil)
+        result = @client.list(
+          before_id: before_id,
+          limit: limit,
+          url: url,
+          path: PATH
+        )
+
+        NgrokAPI::Models::Listable.new(
+          client: self,
+          attrs: result,
+          list_property: LIST_PROPERTY,
+          klass: NgrokAPI::Models::Endpoint
+        )
+      end
+
+      ##
+      # List all active endpoints on the account
+      # Throws an exception if API error.
+      #
+      # @param [string] before_id
+      # @param [string] limit
+      # @param [string] url optional and mutually exclusive from before_id and limit
+      # @return [NgrokAPI::Models::Listable] result from the API request
+      #
+      # https://ngrok.com/docs/api#api-endpoints-list
+      def list!(before_id: nil, limit: nil, url: nil)
+        result = @client.list(
+          before_id: before_id,
+          limit: limit,
+          danger: true,
+          url: url,
+          path: PATH
+        )
+
+        NgrokAPI::Models::Listable.new(
+          client: self,
+          attrs: result,
+          list_property: LIST_PROPERTY,
+          klass: NgrokAPI::Models::Endpoint,
+          danger: true
+        )
+      end
+
+      ##
+      # Get the status of an endpoint by ID
+      #
+      # @param [string] id a resource identifier
+      # @return [NgrokAPI::Models::Endpoint] result from the API request
+      #
+      # https://ngrok.com/docs/api#api-endpoints-get
+      def get(id: "")
+        path = '/endpoints/%{id}'
+        replacements = {
+          id: id,
+        }
+        data = {}
+        result = @client.get(path % replacements, data: data)
+        NgrokAPI::Models::Endpoint.new(client: self, attrs: result)
+      end
+
+      ##
+      # Get the status of an endpoint by ID
+      # Throws an exception if API error.
+      #
+      # @param [string] id a resource identifier
+      # @return [NgrokAPI::Models::Endpoint] result from the API request
+      #
+      # https://ngrok.com/docs/api#api-endpoints-get
+      def get!(id: "")
+        path = '/endpoints/%{id}'
+        replacements = {
+          id: id,
+        }
+        data = {}
+        result = @client.get(path % replacements, data: data, danger: true)
+        NgrokAPI::Models::Endpoint.new(client: self, attrs: result)
+      end
+    end
+  end
+end

data/lib/ngrokapi/services/event_destinations_client.rb

@@ -38,13 +38,38 @@ module NgrokAPI
         data[:format] = format if format
         data[:target] = target if target
         result = @client.post(path % replacements, data: data)
-        NgrokAPI::Models::EventDestination.new(client: self, result: result)
+        NgrokAPI::Models::EventDestination.new(client: self, attrs: result)
+      end
+
+      ##
+      # Create a new Event Destination. It will not apply to anything until it is
+      # associated with an Event Stream, and that Event Stream is associated with an
+      # Endpoint Config.
+      # Throws an exception if API error.
+      #
+      # @param [string] metadata Arbitrary user-defined machine-readable data of this Event Destination. Optional, max 4096 bytes.
+      # @param [string] description Human-readable description of the Event Destination. Optional, max 255 bytes.
+      # @param [string] format The output format you would like to serialize events into when sending to their target. Currently the only accepted value is ``JSON``.
+      # @param [EventTarget] target 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``.
+      # @return [NgrokAPI::Models::EventDestination] result from the API request
+      #
+      # https://ngrok.com/docs/api#api-event-destinations-create
+      def create!(metadata: "", description: "", format: "", target: nil, verify_with_test_event: nil)
+        path = '/event_destinations'
+        replacements = {
+        }
+        data = {}
+        data[:metadata] = metadata if metadata
+        data[:description] = description if description
+        data[:format] = format if format
+        data[:target] = target if target
+        result = @client.post(path % replacements, data: data, danger: true)
+        NgrokAPI::Models::EventDestination.new(client: self, attrs: result)
       end
 
       ##
       # Delete an Event Destination. If the Event Destination is still referenced by an
-      # Event Stream, this will throw an error until that Event Stream has removed that
-      # reference.
+      # Event Subscription.
       #
       # @param [string] id a resource identifier
       # @return [NgrokAPI::Models::Empty] result from the API request
@@ -60,8 +85,7 @@ module NgrokAPI
 
       ##
       # Delete an Event Destination. If the Event Destination is still referenced by an
-      # Event Stream, this will throw an error until that Event Stream has removed that
-      # reference.
+      # Event Subscription.
       # Throws an exception if API error.
       #
       # @param [string] id a resource identifier
@@ -90,7 +114,7 @@ module NgrokAPI
         }
         data = {}
         result = @client.get(path % replacements, data: data)
-        NgrokAPI::Models::EventDestination.new(client: self, result: result)
+        NgrokAPI::Models::EventDestination.new(client: self, attrs: result)
       end
 
       ##
@@ -108,7 +132,7 @@ module NgrokAPI
         }
         data = {}
         result = @client.get(path % replacements, data: data, danger: true)
-        NgrokAPI::Models::EventDestination.new(client: self, result: result)
+        NgrokAPI::Models::EventDestination.new(client: self, attrs: result)
       end
 
       ##
@@ -120,8 +144,7 @@ module NgrokAPI
       # @return [NgrokAPI::Models::Listable] result from the API request
       #
       # https://ngrok.com/docs/api#api-event-destinations-list
-      def list(before_id: nil, limit: nil,
-               url: nil)
+      def list(before_id: nil, limit: nil, url: nil)
         result = @client.list(
           before_id: before_id,
           limit: limit,
@@ -131,7 +154,7 @@ module NgrokAPI
 
         NgrokAPI::Models::Listable.new(
           client: self,
-          result: result,
+          attrs: result,
           list_property: LIST_PROPERTY,
           klass: NgrokAPI::Models::EventDestination
         )
@@ -147,8 +170,7 @@ module NgrokAPI
       # @return [NgrokAPI::Models::Listable] result from the API request
       #
       # https://ngrok.com/docs/api#api-event-destinations-list
-      def list!(before_id: nil, limit: nil,
-                url: nil)
+      def list!(before_id: nil, limit: nil, url: nil)
         result = @client.list(
           before_id: before_id,
           limit: limit,
@@ -159,7 +181,7 @@ module NgrokAPI
 
         NgrokAPI::Models::Listable.new(
           client: self,
-          result: result,
+          attrs: result,
           list_property: LIST_PROPERTY,
           klass: NgrokAPI::Models::EventDestination,
           danger: true
@@ -188,7 +210,7 @@ module NgrokAPI
         data[:format] = format if format
         data[:target] = target if target
         result = @client.patch(path % replacements, data: data)
-        NgrokAPI::Models::EventDestination.new(client: self, result: result)
+        NgrokAPI::Models::EventDestination.new(client: self, attrs: result)
       end
 
       ##
@@ -214,7 +236,7 @@ module NgrokAPI
         data[:format] = format if format
         data[:target] = target if target
         result = @client.patch(path % replacements, data: data, danger: true)
-        NgrokAPI::Models::EventDestination.new(client: self, result: result)
+        NgrokAPI::Models::EventDestination.new(client: self, attrs: result)
       end
     end
   end

data/lib/ngrokapi/services/event_sources_client.rb

@@ -30,7 +30,27 @@ module NgrokAPI
         data = {}
         data[:type] = type if type
         result = @client.post(path % replacements, data: data)
-        NgrokAPI::Models::EventSource.new(client: self, result: result)
+        NgrokAPI::Models::EventSource.new(client: self, attrs: result)
+      end
+
+      ##
+      # Add an additional type for which this event subscription will trigger
+      # Throws an exception if API error.
+      #
+      # @param [string] subscription_id The unique identifier for the Event Subscription that this Event Source is attached to.
+      # @param [string] type Type of event for which an event subscription will trigger
+      # @return [NgrokAPI::Models::EventSource] result from the API request
+      #
+      # https://ngrok.com/docs/api#api-event-sources-create
+      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, danger: true)
+        NgrokAPI::Models::EventSource.new(client: self, attrs: result)
       end
 
       ##
@@ -84,7 +104,7 @@ module NgrokAPI
         }
         data = {}
         result = @client.get(path % replacements, data: data)
-        NgrokAPI::Models::EventSource.new(client: self, result: result)
+        NgrokAPI::Models::EventSource.new(client: self, attrs: result)
       end
 
       ##
@@ -104,7 +124,7 @@ module NgrokAPI
         }
         data = {}
         result = @client.get(path % replacements, data: data, danger: true)
-        NgrokAPI::Models::EventSource.new(client: self, result: result)
+        NgrokAPI::Models::EventSource.new(client: self, attrs: result)
       end
 
       ##
@@ -121,7 +141,7 @@ module NgrokAPI
         }
         data = {}
         result = @client.get(path % replacements, data: data)
-        NgrokAPI::Models::EventSourceList.new(client: self, result: result)
+        NgrokAPI::Models::EventSourceList.new(client: self, attrs: result)
       end
 
       ##
@@ -139,7 +159,7 @@ module NgrokAPI
         }
         data = {}
         result = @client.get(path % replacements, data: data, danger: true)
-        NgrokAPI::Models::EventSourceList.new(client: self, result: result)
+        NgrokAPI::Models::EventSourceList.new(client: self, attrs: result)
       end
 
       ##
@@ -158,7 +178,7 @@ module NgrokAPI
         }
         data = {}
         result = @client.patch(path % replacements, data: data)
-        NgrokAPI::Models::EventSource.new(client: self, result: result)
+        NgrokAPI::Models::EventSource.new(client: self, attrs: result)
       end
 
       ##
@@ -178,7 +198,7 @@ module NgrokAPI
         }
         data = {}
         result = @client.patch(path % replacements, data: data, danger: true)
-        NgrokAPI::Models::EventSource.new(client: self, result: result)
+        NgrokAPI::Models::EventSource.new(client: self, attrs: result)
       end
     end
   end