twilio-ruby 5.20.0 → 5.47.0

data/lib/twilio-ruby/rest/messaging/v1/use_case.rb

@@ -0,0 +1,198 @@
+##
+# This code was generated by
+# \ / _    _  _|   _  _
+#  | (_)\/(_)(_|\/| |(/_  v1.0.0
+#       /       /
+#
+# frozen_string_literal: true
+
+module Twilio
+  module REST
+    class Messaging < Domain
+      class V1 < Version
+        ##
+        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
+        class UseCaseList < ListResource
+          ##
+          # Initialize the UseCaseList
+          # @param [Version] version Version that contains the resource
+          # @return [UseCaseList] UseCaseList
+          def initialize(version)
+            super(version)
+
+            # Path Solution
+            @solution = {}
+            @uri = "/a2p/UseCases"
+          end
+
+          ##
+          # Lists UseCaseInstance records from the API as a list.
+          # Unlike stream(), this operation is eager and will load `limit` records into
+          # memory before returning.
+          # @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
+          #    not set will use the default value of 50 records.  If no page_size is defined
+          #    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(limit: nil, page_size: nil)
+            self.stream(limit: limit, page_size: page_size).entries
+          end
+
+          ##
+          # Streams UseCaseInstance records from the API as an Enumerable.
+          # This operation lazily loads records as efficiently as possible until the limit
+          # is reached.
+          # @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
+          #    not set will use the default value of 50 records. If no page_size is defined
+          #    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(limit: nil, page_size: nil)
+            limits = @version.read_limits(limit, page_size)
+
+            page = self.page(page_size: limits[:page_size], )
+
+            @version.stream(page, limit: limits[:limit], page_limit: limits[:page_limit])
+          end
+
+          ##
+          # When passed a block, yields UseCaseInstance records from the API.
+          # This operation lazily loads records as efficiently as possible until the limit
+          # is reached.
+          def each
+            limits = @version.read_limits
+
+            page = self.page(page_size: limits[:page_size], )
+
+            @version.stream(page,
+                            limit: limits[:limit],
+                            page_limit: limits[:page_limit]).each {|x| yield x}
+          end
+
+          ##
+          # Retrieve a single page of UseCaseInstance records from the API.
+          # Request is executed immediately.
+          # @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 UseCaseInstance
+          def page(page_token: :unset, page_number: :unset, page_size: :unset)
+            params = Twilio::Values.of({
+                'PageToken' => page_token,
+                'Page' => page_number,
+                'PageSize' => page_size,
+            })
+
+            response = @version.page('GET', @uri, params: params)
+
+            UseCasePage.new(@version, response, @solution)
+          end
+
+          ##
+          # Retrieve a single page of UseCaseInstance records from the API.
+          # Request is executed immediately.
+          # @param [String] target_url API-generated URL for the requested results page
+          # @return [Page] Page of UseCaseInstance
+          def get_page(target_url)
+            response = @version.domain.request(
+                'GET',
+                target_url
+            )
+            UseCasePage.new(@version, response, @solution)
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            '#<Twilio.Messaging.V1.UseCaseList>'
+          end
+        end
+
+        ##
+        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
+        class UseCasePage < Page
+          ##
+          # Initialize the UseCasePage
+          # @param [Version] version Version that contains the resource
+          # @param [Response] response Response from the API
+          # @param [Hash] solution Path solution for the resource
+          # @return [UseCasePage] UseCasePage
+          def initialize(version, response, solution)
+            super(version, response)
+
+            # Path Solution
+            @solution = solution
+          end
+
+          ##
+          # Build an instance of UseCaseInstance
+          # @param [Hash] payload Payload response from the API
+          # @return [UseCaseInstance] UseCaseInstance
+          def get_instance(payload)
+            UseCaseInstance.new(@version, payload, )
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            '<Twilio.Messaging.V1.UseCasePage>'
+          end
+        end
+
+        ##
+        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
+        class UseCaseInstance < InstanceResource
+          ##
+          # Initialize the UseCaseInstance
+          # @param [Version] version Version that contains the resource
+          # @param [Hash] payload payload that contains response from Twilio
+          # @return [UseCaseInstance] UseCaseInstance
+          def initialize(version, payload)
+            super(version)
+
+            # Marshaled Properties
+            @properties = {
+                'name' => payload['name'],
+                'code' => payload['code'],
+                'description' => payload['description'],
+            }
+          end
+
+          ##
+          # @return [String] Human readable name
+          def name
+            @properties['name']
+          end
+
+          ##
+          # @return [String] Unique Use Case code
+          def code
+            @properties['code']
+          end
+
+          ##
+          # @return [String] Description of Use Case
+          def description
+            @properties['description']
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            "<Twilio.Messaging.V1.UseCaseInstance>"
+          end
+
+          ##
+          # Provide a detailed, user friendly representation
+          def inspect
+            "<Twilio.Messaging.V1.UseCaseInstance>"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/twilio-ruby/rest/monitor.rb

@@ -3,7 +3,7 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
-# 
+#
 # frozen_string_literal: true
 
 module Twilio
@@ -29,7 +29,8 @@ module Twilio
       end
 
       ##
-      # @param [String] sid A 34 character string that uniquely identifies this Alert.
+      # @param [String] sid The unique string that we created to identify the Alert
+      #   resource.
       # @return [Twilio::REST::Monitor::V1::AlertInstance] if sid was passed.
       # @return [Twilio::REST::Monitor::V1::AlertList]
       def alerts(sid=:unset)
@@ -37,7 +38,8 @@ module Twilio
       end
 
       ##
-      # @param [String] sid A 34 character string that uniquely identifies this event.
+      # @param [String] sid The unique string that we created to identify the Event
+      #   resource.
       # @return [Twilio::REST::Monitor::V1::EventInstance] if sid was passed.
       # @return [Twilio::REST::Monitor::V1::EventList]
       def events(sid=:unset)

data/lib/twilio-ruby/rest/monitor/v1.rb

@@ -3,7 +3,7 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
-# 
+#
 # frozen_string_literal: true
 
 module Twilio
@@ -20,7 +20,7 @@ module Twilio
         end
 
         ##
-        # @param [String] sid The sid
+        # @param [String] sid The SID of the Alert resource to fetch.
         # @return [Twilio::REST::Monitor::V1::AlertContext] if sid was passed.
         # @return [Twilio::REST::Monitor::V1::AlertList]
         def alerts(sid=:unset)
@@ -34,7 +34,7 @@ module Twilio
         end
 
         ##
-        # @param [String] sid A 34 character string that uniquely identifies this event.
+        # @param [String] sid The SID of the Event resource to fetch.
         # @return [Twilio::REST::Monitor::V1::EventContext] if sid was passed.
         # @return [Twilio::REST::Monitor::V1::EventList]
         def events(sid=:unset)

data/lib/twilio-ruby/rest/monitor/v1/alert.rb

@@ -3,7 +3,7 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
-# 
+#
 # frozen_string_literal: true
 
 module Twilio
@@ -27,18 +27,14 @@ module Twilio
           # Lists AlertInstance records from the API as a list.
           # Unlike stream(), this operation is eager and will load `limit` records into
           # memory before returning.
-          # @param [String] log_level Only show alerts for this log-level.  One of 'error',
-          #   'warning', 'notice', or 'debug'.
-          # @param [Date] start_date Only show Alerts on or after this date.  Useful in
-          #   combination with `EndDate` to define a date-range of Alerts.  Input is a [UTC
-          #   ISO 8601 Timestamp](http://en.wikipedia.org/wiki/ISO_8601#UTC), but time of day
-          #   is ignored by the filter. Queries for Alerts older than 30 days are not
-          #   supported.
-          # @param [Date] end_date Only show Alerts on or before this date.  Useful in
-          #   combination with `StartDate` to define a date-range of Alerts.  Input is a [UTC
-          #   ISO 8601 Timestamp](http://en.wikipedia.org/wiki/ISO_8601#UTC), but time of day
-          #   is ignored by the filter. Queries for Alerts older than 30 days are not
-          #   supported.
+          # @param [String] log_level Only show alerts for this log-level.  Can be: `error`,
+          #   `warning`, `notice`, or `debug`.
+          # @param [Time] start_date Only include alerts that occurred on or after this date
+          #   and time. Specify the date and time in GMT and format as `YYYY-MM-DD` or
+          #   `YYYY-MM-DDThh:mm:ssZ`. Queries for alerts older than 30 days are not supported.
+          # @param [Time] end_date Only include alerts that occurred on or before this date
+          #   and time. Specify the date and time in GMT and format as `YYYY-MM-DD` or
+          #   `YYYY-MM-DDThh:mm:ssZ`. Queries for alerts older than 30 days are not supported.
           # @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
@@ -60,18 +56,14 @@ module Twilio
           # Streams AlertInstance records from the API as an Enumerable.
           # This operation lazily loads records as efficiently as possible until the limit
           # is reached.
-          # @param [String] log_level Only show alerts for this log-level.  One of 'error',
-          #   'warning', 'notice', or 'debug'.
-          # @param [Date] start_date Only show Alerts on or after this date.  Useful in
-          #   combination with `EndDate` to define a date-range of Alerts.  Input is a [UTC
-          #   ISO 8601 Timestamp](http://en.wikipedia.org/wiki/ISO_8601#UTC), but time of day
-          #   is ignored by the filter. Queries for Alerts older than 30 days are not
-          #   supported.
-          # @param [Date] end_date Only show Alerts on or before this date.  Useful in
-          #   combination with `StartDate` to define a date-range of Alerts.  Input is a [UTC
-          #   ISO 8601 Timestamp](http://en.wikipedia.org/wiki/ISO_8601#UTC), but time of day
-          #   is ignored by the filter. Queries for Alerts older than 30 days are not
-          #   supported.
+          # @param [String] log_level Only show alerts for this log-level.  Can be: `error`,
+          #   `warning`, `notice`, or `debug`.
+          # @param [Time] start_date Only include alerts that occurred on or after this date
+          #   and time. Specify the date and time in GMT and format as `YYYY-MM-DD` or
+          #   `YYYY-MM-DDThh:mm:ssZ`. Queries for alerts older than 30 days are not supported.
+          # @param [Time] end_date Only include alerts that occurred on or before this date
+          #   and time. Specify the date and time in GMT and format as `YYYY-MM-DD` or
+          #   `YYYY-MM-DDThh:mm:ssZ`. Queries for alerts older than 30 days are not supported.
           # @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
@@ -109,18 +101,14 @@ module Twilio
           ##
           # Retrieve a single page of AlertInstance records from the API.
           # Request is executed immediately.
-          # @param [String] log_level Only show alerts for this log-level.  One of 'error',
-          #   'warning', 'notice', or 'debug'.
-          # @param [Date] start_date Only show Alerts on or after this date.  Useful in
-          #   combination with `EndDate` to define a date-range of Alerts.  Input is a [UTC
-          #   ISO 8601 Timestamp](http://en.wikipedia.org/wiki/ISO_8601#UTC), but time of day
-          #   is ignored by the filter. Queries for Alerts older than 30 days are not
-          #   supported.
-          # @param [Date] end_date Only show Alerts on or before this date.  Useful in
-          #   combination with `StartDate` to define a date-range of Alerts.  Input is a [UTC
-          #   ISO 8601 Timestamp](http://en.wikipedia.org/wiki/ISO_8601#UTC), but time of day
-          #   is ignored by the filter. Queries for Alerts older than 30 days are not
-          #   supported.
+          # @param [String] log_level Only show alerts for this log-level.  Can be: `error`,
+          #   `warning`, `notice`, or `debug`.
+          # @param [Time] start_date Only include alerts that occurred on or after this date
+          #   and time. Specify the date and time in GMT and format as `YYYY-MM-DD` or
+          #   `YYYY-MM-DDThh:mm:ssZ`. Queries for alerts older than 30 days are not supported.
+          # @param [Time] end_date Only include alerts that occurred on or before this date
+          #   and time. Specify the date and time in GMT and format as `YYYY-MM-DD` or
+          #   `YYYY-MM-DDThh:mm:ssZ`. Queries for alerts older than 30 days are not supported.
           # @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
@@ -128,17 +116,15 @@ module Twilio
           def page(log_level: :unset, start_date: :unset, end_date: :unset, page_token: :unset, page_number: :unset, page_size: :unset)
             params = Twilio::Values.of({
                 'LogLevel' => log_level,
-                'StartDate' => Twilio.serialize_iso8601_date(start_date),
-                'EndDate' => Twilio.serialize_iso8601_date(end_date),
+                '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)
+
             AlertPage.new(@version, response, @solution)
           end
 
@@ -195,7 +181,7 @@ module Twilio
           ##
           # Initialize the AlertContext
           # @param [Version] version Version that contains the resource
-          # @param [String] sid The sid
+          # @param [String] sid The SID of the Alert resource to fetch.
           # @return [AlertContext] AlertContext
           def initialize(version, sid)
             super(version)
@@ -206,30 +192,24 @@ module Twilio
           end
 
           ##
-          # Fetch a AlertInstance
+          # Fetch the AlertInstance
           # @return [AlertInstance] Fetched AlertInstance
           def fetch
-            params = Twilio::Values.of({})
-
-            payload = @version.fetch(
-                'GET',
-                @uri,
-                params,
-            )
+            payload = @version.fetch('GET', @uri)
 
             AlertInstance.new(@version, payload, sid: @solution[:sid], )
           end
 
           ##
-          # Deletes the AlertInstance
-          # @return [Boolean] true if delete succeeds, true otherwise
-          def delete
-            @version.delete('delete', @uri)
+          # Provide a user friendly representation
+          def to_s
+            context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+            "#<Twilio.Monitor.V1.AlertContext #{context}>"
           end
 
           ##
-          # Provide a user friendly representation
-          def to_s
+          # Provide a detailed, user friendly representation
+          def inspect
             context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
             "#<Twilio.Monitor.V1.AlertContext #{context}>"
           end
@@ -240,7 +220,7 @@ module Twilio
           # Initialize the AlertInstance
           # @param [Version] version Version that contains the resource
           # @param [Hash] payload payload that contains response from Twilio
-          # @param [String] sid The sid
+          # @param [String] sid The SID of the Alert resource to fetch.
           # @return [AlertInstance] AlertInstance
           def initialize(version, payload, sid: nil)
             super(version)
@@ -258,12 +238,14 @@ module Twilio
                 'more_info' => payload['more_info'],
                 'request_method' => payload['request_method'],
                 'request_url' => payload['request_url'],
-                'resource_sid' => payload['resource_sid'],
-                'sid' => payload['sid'],
-                'url' => payload['url'],
                 'request_variables' => payload['request_variables'],
+                'resource_sid' => payload['resource_sid'],
                 'response_body' => payload['response_body'],
                 'response_headers' => payload['response_headers'],
+                'sid' => payload['sid'],
+                'url' => payload['url'],
+                'request_headers' => payload['request_headers'],
+                'service_sid' => payload['service_sid'],
             }
 
             # Context
@@ -283,119 +265,124 @@ module Twilio
           end
 
           ##
-          # @return [String] The unique id of the Account responsible for this alert.
+          # @return [String] The SID of the Account that created the resource
           def account_sid
             @properties['account_sid']
           end
 
           ##
-          # @return [String] The text of the alert.
+          # @return [String] The text of the alert
           def alert_text
             @properties['alert_text']
           end
 
           ##
-          # @return [String] The version of the Twilio API in use when this alert was generated.
+          # @return [String] The API version used when the alert was generated
           def api_version
             @properties['api_version']
           end
 
           ##
-          # @return [Time] The date that this resource was created, given in ISO 8601 format.
+          # @return [Time] The ISO 8601 date and time in GMT when the resource was created
           def date_created
             @properties['date_created']
           end
 
           ##
-          # @return [Time] The date the alert was actually generated, given in ISO 8601 format.
+          # @return [Time] The date and time when the alert was generated specified in ISO 8601 format
           def date_generated
             @properties['date_generated']
           end
 
           ##
-          # @return [Time] The most recent date that this resource was updated, given in ISO 8601 format.
+          # @return [Time] The ISO 8601 date and time in GMT when the resource was last updated
           def date_updated
             @properties['date_updated']
           end
 
           ##
-          # @return [String] A unique error code for the error condition.
+          # @return [String] The error code for the condition that generated the alert
           def error_code
             @properties['error_code']
           end
 
           ##
-          # @return [String] A string representing the log level.
+          # @return [String] The log level
           def log_level
             @properties['log_level']
           end
 
           ##
-          # @return [String] A URL for more information about the error condition.
+          # @return [String] The URL of the page in our Error Dictionary with more information about the error condition
           def more_info
             @properties['more_info']
           end
 
           ##
-          # @return [String] If the Alert was generated by a request Twilio made to your server, this will be the request method used when Twilio made the request to your server.
+          # @return [String] The method used by the request that generated the alert
           def request_method
             @properties['request_method']
           end
 
           ##
-          # @return [String] If the Alert was generated by a request Twilio made to your server, this will be the URL on your server that generated the alert.
+          # @return [String] The URL of the request that generated the alert
           def request_url
             @properties['request_url']
           end
 
           ##
-          # @return [String] The request_variables
+          # @return [String] The variables passed in the request that generated the alert
           def request_variables
             @properties['request_variables']
           end
 
           ##
-          # @return [String] The unique ID of the resource for which the Alert was generated.
+          # @return [String] The SID of the resource for which the alert was generated
           def resource_sid
             @properties['resource_sid']
           end
 
           ##
-          # @return [String] The response_body
+          # @return [String] The response body of the request that generated the alert
           def response_body
             @properties['response_body']
           end
 
           ##
-          # @return [String] The response_headers
+          # @return [String] The response headers of the request that generated the alert
           def response_headers
             @properties['response_headers']
           end
 
           ##
-          # @return [String] A 34 character string that uniquely identifies this Alert.
+          # @return [String] The unique string that identifies the resource
           def sid
             @properties['sid']
           end
 
           ##
-          # @return [String] The absolute URL for this resource.
+          # @return [String] The absolute URL of the Alert resource
           def url
             @properties['url']
           end
 
           ##
-          # Fetch a AlertInstance
-          # @return [AlertInstance] Fetched AlertInstance
-          def fetch
-            context.fetch
+          # @return [String] The request headers of the request that generated the alert
+          def request_headers
+            @properties['request_headers']
+          end
+
+          ##
+          # @return [String] The SID of the service or resource that generated the alert
+          def service_sid
+            @properties['service_sid']
           end
 
           ##
-          # Deletes the AlertInstance
-          # @return [Boolean] true if delete succeeds, true otherwise
-          def delete
-            context.delete
+          # Fetch the AlertInstance
+          # @return [AlertInstance] Fetched AlertInstance
+          def fetch
+            context.fetch
           end
 
           ##