twilio-ruby 5.31.0 → 5.46.0

data/lib/twilio-ruby/rest/serverless/v1/service/environment/deployment.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 DeploymentList < ListResource
               ##
               # Initialize the DeploymentList
               # @param [Version] version Version that contains the resource
               # @param [String] service_sid The SID of the Service that the Deployment resource
               #   is associated with.
-              # @param [String] environment_sid The SID of the environment for the deployment.
+              # @param [String] environment_sid The SID of the Environment for the Deployment.
               # @return [DeploymentList] DeploymentList
               def initialize(version, service_sid: nil, environment_sid: nil)
                 super(version)
@@ -91,11 +91,9 @@ module Twilio
                     'Page' => page_number,
                     'PageSize' => page_size,
                 })
-                response = @version.page(
-                    'GET',
-                    @uri,
-                    params
-                )
+
+                response = @version.page('GET', @uri, params: params)
+
                 DeploymentPage.new(@version, response, @solution)
               end
 
@@ -113,18 +111,13 @@ module Twilio
               end
 
               ##
-              # Retrieve a single page of DeploymentInstance records from the API.
-              # Request is executed immediately.
-              # @param [String] build_sid The SID of the build for the deployment.
-              # @return [DeploymentInstance] Newly created DeploymentInstance
-              def create(build_sid: nil)
+              # Create the DeploymentInstance
+              # @param [String] build_sid The SID of the Build for the Deployment.
+              # @return [DeploymentInstance] Created DeploymentInstance
+              def create(build_sid: :unset)
                 data = Twilio::Values.of({'BuildSid' => build_sid, })
 
-                payload = @version.create(
-                    'POST',
-                    @uri,
-                    data: data
-                )
+                payload = @version.create('POST', @uri, data: data)
 
                 DeploymentInstance.new(
                     @version,
@@ -142,7 +135,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 DeploymentPage < Page
               ##
               # Initialize the DeploymentPage
@@ -178,16 +171,16 @@ 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 DeploymentContext < InstanceContext
               ##
               # Initialize the DeploymentContext
               # @param [Version] version Version that contains the resource
               # @param [String] service_sid The SID of the Service to fetch the Deployment
               #   resource from.
-              # @param [String] environment_sid The SID of the environment used by the
+              # @param [String] environment_sid The SID of the Environment used by the
               #   Deployment to fetch.
-              # @param [String] sid The SID of the Deployment resource to fetch.
+              # @param [String] sid The SID that identifies the Deployment resource to fetch.
               # @return [DeploymentContext] DeploymentContext
               def initialize(version, service_sid, environment_sid, sid)
                 super(version)
@@ -198,16 +191,10 @@ module Twilio
               end
 
               ##
-              # Fetch a DeploymentInstance
+              # Fetch the DeploymentInstance
               # @return [DeploymentInstance] Fetched DeploymentInstance
               def fetch
-                params = Twilio::Values.of({})
-
-                payload = @version.fetch(
-                    'GET',
-                    @uri,
-                    params,
-                )
+                payload = @version.fetch('GET', @uri)
 
                 DeploymentInstance.new(
                     @version,
@@ -234,7 +221,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 DeploymentInstance < InstanceResource
               ##
               # Initialize the DeploymentInstance
@@ -242,8 +229,8 @@ module Twilio
               # @param [Hash] payload payload that contains response from Twilio
               # @param [String] service_sid The SID of the Service that the Deployment resource
               #   is associated with.
-              # @param [String] environment_sid The SID of the environment for the deployment.
-              # @param [String] sid The SID of the Deployment resource to fetch.
+              # @param [String] environment_sid The SID of the Environment for the Deployment.
+              # @param [String] sid The SID that identifies the Deployment resource to fetch.
               # @return [DeploymentInstance] DeploymentInstance
               def initialize(version, payload, service_sid: nil, environment_sid: nil, sid: nil)
                 super(version)
@@ -304,13 +291,13 @@ module Twilio
               end
 
               ##
-              # @return [String] The SID of the environment for the deployment
+              # @return [String] The SID of the Environment for the Deployment
               def environment_sid
                 @properties['environment_sid']
               end
 
               ##
-              # @return [String] The SID of the build for the deployment
+              # @return [String] The SID of the Build for the deployment
               def build_sid
                 @properties['build_sid']
               end
@@ -334,7 +321,7 @@ module Twilio
               end
 
               ##
-              # Fetch a DeploymentInstance
+              # Fetch the DeploymentInstance
               # @return [DeploymentInstance] Fetched DeploymentInstance
               def fetch
                 context.fetch

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