twilio-ruby 5.31.1 → 5.54.0

data/lib/twilio-ruby/rest/serverless/v1/service/environment/log.rb

@@ -13,7 +13,7 @@ module Twilio
         class ServiceContext < InstanceContext
           class EnvironmentContext < InstanceContext
             ##
-            # PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
+            # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
             class LogList < ListResource
               ##
               # Initialize the LogList
@@ -37,6 +37,10 @@ module Twilio
               # memory before returning.
               # @param [String] function_sid The SID of the function whose invocation produced
               #   the Log resources to read.
+              # @param [Time] start_date The date/time (in GMT, ISO 8601) after which the Log
+              #   resources must have been created. Defaults to 1 day prior to current date/time.
+              # @param [Time] end_date The date/time (in GMT, ISO 8601) before which the Log
+              #   resources must have been created. Defaults to current date/time.
               # @param [Integer] limit Upper limit for the number of records to return. stream()
               #    guarantees to never return more than limit.  Default is no limit
               # @param [Integer] page_size Number of records to fetch per request, when
@@ -44,8 +48,14 @@ module Twilio
               #    but a limit is defined, stream() will attempt to read the limit with the most
               #    efficient page size, i.e. min(limit, 1000)
               # @return [Array] Array of up to limit results
-              def list(function_sid: :unset, limit: nil, page_size: nil)
-                self.stream(function_sid: function_sid, limit: limit, page_size: page_size).entries
+              def list(function_sid: :unset, start_date: :unset, end_date: :unset, limit: nil, page_size: nil)
+                self.stream(
+                    function_sid: function_sid,
+                    start_date: start_date,
+                    end_date: end_date,
+                    limit: limit,
+                    page_size: page_size
+                ).entries
               end
 
               ##
@@ -54,6 +64,10 @@ module Twilio
               # is reached.
               # @param [String] function_sid The SID of the function whose invocation produced
               #   the Log resources to read.
+              # @param [Time] start_date The date/time (in GMT, ISO 8601) after which the Log
+              #   resources must have been created. Defaults to 1 day prior to current date/time.
+              # @param [Time] end_date The date/time (in GMT, ISO 8601) before which the Log
+              #   resources must have been created. Defaults to current date/time.
               # @param [Integer] limit Upper limit for the number of records to return. stream()
               #    guarantees to never return more than limit. Default is no limit.
               # @param [Integer] page_size Number of records to fetch per request, when
@@ -61,10 +75,15 @@ module Twilio
               #    but a limit is defined, stream() will attempt to read the limit with the most
               #    efficient page size, i.e. min(limit, 1000)
               # @return [Enumerable] Enumerable that will yield up to limit results
-              def stream(function_sid: :unset, limit: nil, page_size: nil)
+              def stream(function_sid: :unset, start_date: :unset, end_date: :unset, limit: nil, page_size: nil)
                 limits = @version.read_limits(limit, page_size)
 
-                page = self.page(function_sid: function_sid, page_size: limits[:page_size], )
+                page = self.page(
+                    function_sid: function_sid,
+                    start_date: start_date,
+                    end_date: end_date,
+                    page_size: limits[:page_size],
+                )
 
                 @version.stream(page, limit: limits[:limit], page_limit: limits[:page_limit])
               end
@@ -88,22 +107,26 @@ module Twilio
               # Request is executed immediately.
               # @param [String] function_sid The SID of the function whose invocation produced
               #   the Log resources to read.
+              # @param [Time] start_date The date/time (in GMT, ISO 8601) after which the Log
+              #   resources must have been created. Defaults to 1 day prior to current date/time.
+              # @param [Time] end_date The date/time (in GMT, ISO 8601) before which the Log
+              #   resources must have been created. Defaults to current date/time.
               # @param [String] page_token PageToken provided by the API
               # @param [Integer] page_number Page Number, this value is simply for client state
               # @param [Integer] page_size Number of records to return, defaults to 50
               # @return [Page] Page of LogInstance
-              def page(function_sid: :unset, page_token: :unset, page_number: :unset, page_size: :unset)
+              def page(function_sid: :unset, start_date: :unset, end_date: :unset, page_token: :unset, page_number: :unset, page_size: :unset)
                 params = Twilio::Values.of({
                     'FunctionSid' => function_sid,
+                    'StartDate' => Twilio.serialize_iso8601_datetime(start_date),
+                    'EndDate' => Twilio.serialize_iso8601_datetime(end_date),
                     'PageToken' => page_token,
                     'Page' => page_number,
                     'PageSize' => page_size,
                 })
-                response = @version.page(
-                    'GET',
-                    @uri,
-                    params
-                )
+
+                response = @version.page('GET', @uri, params: params)
+
                 LogPage.new(@version, response, @solution)
               end
 
@@ -128,7 +151,7 @@ module Twilio
             end
 
             ##
-            # PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
+            # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
             class LogPage < Page
               ##
               # Initialize the LogPage
@@ -164,7 +187,7 @@ module Twilio
             end
 
             ##
-            # PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
+            # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
             class LogContext < InstanceContext
               ##
               # Initialize the LogContext
@@ -184,16 +207,10 @@ module Twilio
               end
 
               ##
-              # Fetch a LogInstance
+              # Fetch the LogInstance
               # @return [LogInstance] Fetched LogInstance
               def fetch
-                params = Twilio::Values.of({})
-
-                payload = @version.fetch(
-                    'GET',
-                    @uri,
-                    params,
-                )
+                payload = @version.fetch('GET', @uri)
 
                 LogInstance.new(
                     @version,
@@ -220,7 +237,7 @@ module Twilio
             end
 
             ##
-            # PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
+            # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
             class LogInstance < InstanceResource
               ##
               # Initialize the LogInstance
@@ -241,6 +258,7 @@ module Twilio
                     'account_sid' => payload['account_sid'],
                     'service_sid' => payload['service_sid'],
                     'environment_sid' => payload['environment_sid'],
+                    'build_sid' => payload['build_sid'],
                     'deployment_sid' => payload['deployment_sid'],
                     'function_sid' => payload['function_sid'],
                     'request_sid' => payload['request_sid'],
@@ -299,6 +317,12 @@ module Twilio
                 @properties['environment_sid']
               end
 
+              ##
+              # @return [String] The SID of the build that corresponds to the log
+              def build_sid
+                @properties['build_sid']
+              end
+
               ##
               # @return [String] The SID of the deployment that corresponds to the log
               def deployment_sid
@@ -342,7 +366,7 @@ module Twilio
               end
 
               ##
-              # Fetch a LogInstance
+              # Fetch the LogInstance
               # @return [LogInstance] Fetched LogInstance
               def fetch
                 context.fetch

data/lib/twilio-ruby/rest/serverless/v1/service/environment/variable.rb

@@ -13,14 +13,14 @@ module Twilio
         class ServiceContext < InstanceContext
           class EnvironmentContext < InstanceContext
             ##
-            # PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
+            # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
             class VariableList < ListResource
               ##
               # Initialize the VariableList
               # @param [Version] version Version that contains the resource
               # @param [String] service_sid The SID of the Service that the Variable resource is
               #   associated with.
-              # @param [String] environment_sid The SID of the environment in which the variable
+              # @param [String] environment_sid The SID of the Environment in which the Variable
               #   exists.
               # @return [VariableList] VariableList
               def initialize(version, service_sid: nil, environment_sid: nil)
@@ -92,11 +92,9 @@ module Twilio
                     'Page' => page_number,
                     'PageSize' => page_size,
                 })
-                response = @version.page(
-                    'GET',
-                    @uri,
-                    params
-                )
+
+                response = @version.page('GET', @uri, params: params)
+
                 VariablePage.new(@version, response, @solution)
               end
 
@@ -114,21 +112,16 @@ module Twilio
               end
 
               ##
-              # Retrieve a single page of VariableInstance records from the API.
-              # Request is executed immediately.
+              # Create the VariableInstance
               # @param [String] key A string by which the Variable resource can be referenced.
-              #   Must be less than 128 characters long.
-              # @param [String] value A string that contains the actual value of the variable.
-              #   Must have less than 450 bytes.
-              # @return [VariableInstance] Newly created VariableInstance
+              #   It can be a maximum of 128 characters.
+              # @param [String] value A string that contains the actual value of the Variable.
+              #   It can be a maximum of 450 bytes in size.
+              # @return [VariableInstance] Created VariableInstance
               def create(key: nil, value: nil)
                 data = Twilio::Values.of({'Key' => key, 'Value' => value, })
 
-                payload = @version.create(
-                    'POST',
-                    @uri,
-                    data: data
-                )
+                payload = @version.create('POST', @uri, data: data)
 
                 VariableInstance.new(
                     @version,
@@ -146,7 +139,7 @@ module Twilio
             end
 
             ##
-            # PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
+            # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
             class VariablePage < Page
               ##
               # Initialize the VariablePage
@@ -182,14 +175,14 @@ module Twilio
             end
 
             ##
-            # PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
+            # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
             class VariableContext < InstanceContext
               ##
               # Initialize the VariableContext
               # @param [Version] version Version that contains the resource
               # @param [String] service_sid The SID of the Service to fetch the Variable
               #   resource from.
-              # @param [String] environment_sid The SID of the environment with the Variable
+              # @param [String] environment_sid The SID of the Environment with the Variable
               #   resource to fetch.
               # @param [String] sid The SID of the Variable resource to fetch.
               # @return [VariableContext] VariableContext
@@ -202,16 +195,10 @@ module Twilio
               end
 
               ##
-              # Fetch a VariableInstance
+              # Fetch the VariableInstance
               # @return [VariableInstance] Fetched VariableInstance
               def fetch
-                params = Twilio::Values.of({})
-
-                payload = @version.fetch(
-                    'GET',
-                    @uri,
-                    params,
-                )
+                payload = @version.fetch('GET', @uri)
 
                 VariableInstance.new(
                     @version,
@@ -225,18 +212,14 @@ module Twilio
               ##
               # Update the VariableInstance
               # @param [String] key A string by which the Variable resource can be referenced.
-              #   Must be less than 128 characters long.
-              # @param [String] value A string that contains the actual value of the variable.
-              #   Must have less than 450 bytes.
+              #   It can be a maximum of 128 characters.
+              # @param [String] value A string that contains the actual value of the Variable.
+              #   It can be a maximum of 450 bytes in size.
               # @return [VariableInstance] Updated VariableInstance
               def update(key: :unset, value: :unset)
                 data = Twilio::Values.of({'Key' => key, 'Value' => value, })
 
-                payload = @version.update(
-                    'POST',
-                    @uri,
-                    data: data,
-                )
+                payload = @version.update('POST', @uri, data: data)
 
                 VariableInstance.new(
                     @version,
@@ -248,10 +231,10 @@ module Twilio
               end
 
               ##
-              # Deletes the VariableInstance
+              # Delete the VariableInstance
               # @return [Boolean] true if delete succeeds, false otherwise
               def delete
-                @version.delete('delete', @uri)
+                 @version.delete('DELETE', @uri)
               end
 
               ##
@@ -270,7 +253,7 @@ module Twilio
             end
 
             ##
-            # PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
+            # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
             class VariableInstance < InstanceResource
               ##
               # Initialize the VariableInstance
@@ -278,7 +261,7 @@ module Twilio
               # @param [Hash] payload payload that contains response from Twilio
               # @param [String] service_sid The SID of the Service that the Variable resource is
               #   associated with.
-              # @param [String] environment_sid The SID of the environment in which the variable
+              # @param [String] environment_sid The SID of the Environment in which the Variable
               #   exists.
               # @param [String] sid The SID of the Variable resource to fetch.
               # @return [VariableInstance] VariableInstance
@@ -342,7 +325,7 @@ module Twilio
               end
 
               ##
-              # @return [String] The SID of the environment in which the variable exists
+              # @return [String] The SID of the Environment in which the Variable exists
               def environment_sid
                 @properties['environment_sid']
               end
@@ -354,7 +337,7 @@ module Twilio
               end
 
               ##
-              # @return [String] A string that contains the actual value of the variable
+              # @return [String] A string that contains the actual value of the Variable
               def value
                 @properties['value']
               end
@@ -378,7 +361,7 @@ module Twilio
               end
 
               ##
-              # Fetch a VariableInstance
+              # Fetch the VariableInstance
               # @return [VariableInstance] Fetched VariableInstance
               def fetch
                 context.fetch
@@ -387,16 +370,16 @@ module Twilio
               ##
               # Update the VariableInstance
               # @param [String] key A string by which the Variable resource can be referenced.
-              #   Must be less than 128 characters long.
-              # @param [String] value A string that contains the actual value of the variable.
-              #   Must have less than 450 bytes.
+              #   It can be a maximum of 128 characters.
+              # @param [String] value A string that contains the actual value of the Variable.
+              #   It can be a maximum of 450 bytes in size.
               # @return [VariableInstance] Updated VariableInstance
               def update(key: :unset, value: :unset)
                 context.update(key: key, value: value, )
               end
 
               ##
-              # Deletes the VariableInstance
+              # Delete the VariableInstance
               # @return [Boolean] true if delete succeeds, false otherwise
               def delete
                 context.delete

data/lib/twilio-ruby/rest/serverless/v1/service/function.rb

@@ -12,7 +12,7 @@ module Twilio
       class V1 < Version
         class ServiceContext < InstanceContext
           ##
-          # PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
+          # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
           class FunctionList < ListResource
             ##
             # Initialize the FunctionList
@@ -89,11 +89,9 @@ module Twilio
                   'Page' => page_number,
                   'PageSize' => page_size,
               })
-              response = @version.page(
-                  'GET',
-                  @uri,
-                  params
-              )
+
+              response = @version.page('GET', @uri, params: params)
+
               FunctionPage.new(@version, response, @solution)
             end
 
@@ -111,19 +109,14 @@ module Twilio
             end
 
             ##
-            # Retrieve a single page of FunctionInstance records from the API.
-            # Request is executed immediately.
+            # Create the FunctionInstance
             # @param [String] friendly_name A descriptive string that you create to describe
-            #   the Function resource. It can be up to 255 characters long.
-            # @return [FunctionInstance] Newly created FunctionInstance
+            #   the Function resource. It can be a maximum of 255 characters.
+            # @return [FunctionInstance] Created FunctionInstance
             def create(friendly_name: nil)
               data = Twilio::Values.of({'FriendlyName' => friendly_name, })
 
-              payload = @version.create(
-                  'POST',
-                  @uri,
-                  data: data
-              )
+              payload = @version.create('POST', @uri, data: data)
 
               FunctionInstance.new(@version, payload, service_sid: @solution[:service_sid], )
             end
@@ -136,7 +129,7 @@ module Twilio
           end
 
           ##
-          # PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
+          # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
           class FunctionPage < Page
             ##
             # Initialize the FunctionPage
@@ -167,7 +160,7 @@ module Twilio
           end
 
           ##
-          # PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
+          # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
           class FunctionContext < InstanceContext
             ##
             # Initialize the FunctionContext
@@ -188,40 +181,30 @@ module Twilio
             end
 
             ##
-            # Fetch a FunctionInstance
+            # Fetch the FunctionInstance
             # @return [FunctionInstance] Fetched FunctionInstance
             def fetch
-              params = Twilio::Values.of({})
-
-              payload = @version.fetch(
-                  'GET',
-                  @uri,
-                  params,
-              )
+              payload = @version.fetch('GET', @uri)
 
               FunctionInstance.new(@version, payload, service_sid: @solution[:service_sid], sid: @solution[:sid], )
             end
 
             ##
-            # Deletes the FunctionInstance
+            # Delete the FunctionInstance
             # @return [Boolean] true if delete succeeds, false otherwise
             def delete
-              @version.delete('delete', @uri)
+               @version.delete('DELETE', @uri)
             end
 
             ##
             # Update the FunctionInstance
             # @param [String] friendly_name A descriptive string that you create to describe
-            #   the Function resource. It can be up to 255 characters long.
+            #   the Function resource. It can be a maximum of 255 characters.
             # @return [FunctionInstance] Updated FunctionInstance
             def update(friendly_name: nil)
               data = Twilio::Values.of({'FriendlyName' => friendly_name, })
 
-              payload = @version.update(
-                  'POST',
-                  @uri,
-                  data: data,
-              )
+              payload = @version.update('POST', @uri, data: data)
 
               FunctionInstance.new(@version, payload, service_sid: @solution[:service_sid], sid: @solution[:sid], )
             end
@@ -264,7 +247,7 @@ module Twilio
           end
 
           ##
-          # PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
+          # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
           class FunctionInstance < InstanceResource
             ##
             # Initialize the FunctionInstance
@@ -348,20 +331,20 @@ module Twilio
             end
 
             ##
-            # @return [String] The URLs of nested resources of the function
+            # @return [String] The URLs of nested resources of the Function resource
             def links
               @properties['links']
             end
 
             ##
-            # Fetch a FunctionInstance
+            # Fetch the FunctionInstance
             # @return [FunctionInstance] Fetched FunctionInstance
             def fetch
               context.fetch
             end
 
             ##
-            # Deletes the FunctionInstance
+            # Delete the FunctionInstance
             # @return [Boolean] true if delete succeeds, false otherwise
             def delete
               context.delete
@@ -370,7 +353,7 @@ module Twilio
             ##
             # Update the FunctionInstance
             # @param [String] friendly_name A descriptive string that you create to describe
-            #   the Function resource. It can be up to 255 characters long.
+            #   the Function resource. It can be a maximum of 255 characters.
             # @return [FunctionInstance] Updated FunctionInstance
             def update(friendly_name: nil)
               context.update(friendly_name: friendly_name, )