twilio-ruby 5.6.0 → 5.33.0

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

@@ -3,6 +3,8 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
+#
+# frozen_string_literal: true
 
 module Twilio
   module REST
@@ -25,9 +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 The log_level
-          # @param [Date] start_date The start_date
-          # @param [Date] end_date The end_date
+          # @param [String] log_level Only show alerts for this log-level.  Can be: `error`,
+          #   `warning`, `notice`, or `debug`.
+          # @param [Date] 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 [Date] 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
@@ -49,9 +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 The log_level
-          # @param [Date] start_date The start_date
-          # @param [Date] end_date The end_date
+          # @param [String] log_level Only show alerts for this log-level.  Can be: `error`,
+          #   `warning`, `notice`, or `debug`.
+          # @param [Date] 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 [Date] 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
@@ -79,7 +91,7 @@ module Twilio
           def each
             limits = @version.read_limits
 
-            page = self.page(page_size: limits[:page_size])
+            page = self.page(page_size: limits[:page_size], )
 
             @version.stream(page,
                             limit: limits[:limit],
@@ -89,9 +101,14 @@ module Twilio
           ##
           # Retrieve a single page of AlertInstance records from the API.
           # Request is executed immediately.
-          # @param [String] log_level The log_level
-          # @param [Date] start_date The start_date
-          # @param [Date] end_date The end_date
+          # @param [String] log_level Only show alerts for this log-level.  Can be: `error`,
+          #   `warning`, `notice`, or `debug`.
+          # @param [Date] 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 [Date] 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
@@ -152,7 +169,7 @@ module Twilio
           # @param [Hash] payload Payload response from the API
           # @return [AlertInstance] AlertInstance
           def get_instance(payload)
-            AlertInstance.new(@version, payload)
+            AlertInstance.new(@version, payload, )
           end
 
           ##
@@ -166,13 +183,13 @@ 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)
 
             # Path Solution
-            @solution = {sid: sid}
+            @solution = {sid: sid, }
             @uri = "/Alerts/#{@solution[:sid]}"
           end
 
@@ -188,19 +205,19 @@ module Twilio
                 params,
             )
 
-            AlertInstance.new(@version, payload, sid: @solution[:sid])
+            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
@@ -211,7 +228,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)
@@ -229,17 +246,19 @@ 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
             @instance_context = nil
-            @params = {'sid' => sid || @properties['sid']}
+            @params = {'sid' => sid || @properties['sid'], }
           end
 
           ##
@@ -248,113 +267,125 @@ module Twilio
           # @return [AlertContext] AlertContext for this AlertInstance
           def context
             unless @instance_context
-              @instance_context = AlertContext.new(@version, @params['sid'])
+              @instance_context = AlertContext.new(@version, @params['sid'], )
             end
             @instance_context
           end
 
           ##
-          # @return [String] The account_sid
+          # @return [String] The SID of the Account that created the resource
           def account_sid
             @properties['account_sid']
           end
 
           ##
-          # @return [String] The alert_text
+          # @return [String] The text of the alert
           def alert_text
             @properties['alert_text']
           end
 
           ##
-          # @return [String] The api_version
+          # @return [String] The API version used when the alert was generated
           def api_version
             @properties['api_version']
           end
 
           ##
-          # @return [Time] The date_created
+          # @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_generated
+          # @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 date_updated
+          # @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] The error_code
+          # @return [String] The error code for the condition that generated the alert
           def error_code
             @properties['error_code']
           end
 
           ##
-          # @return [String] The log_level
+          # @return [String] The log level
           def log_level
             @properties['log_level']
           end
 
           ##
-          # @return [String] The more_info
+          # @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] The request_method
+          # @return [String] The method used by the request that generated the alert
           def request_method
             @properties['request_method']
           end
 
           ##
-          # @return [String] The request_url
+          # @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 resource_sid
+          # @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] The sid
+          # @return [String] The unique string that identifies the resource
           def sid
             @properties['sid']
           end
 
           ##
-          # @return [String] The url
+          # @return [String] The absolute URL of the Alert resource
           def url
             @properties['url']
           end
 
+          ##
+          # @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
+
           ##
           # Fetch a AlertInstance
           # @return [AlertInstance] Fetched AlertInstance
@@ -362,13 +393,6 @@ module Twilio
             context.fetch
           end
 
-          ##
-          # Deletes the AlertInstance
-          # @return [Boolean] true if delete succeeds, true otherwise
-          def delete
-            context.delete
-          end
-
           ##
           # Provide a user friendly representation
           def to_s

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

@@ -3,6 +3,8 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
+#
+# frozen_string_literal: true
 
 module Twilio
   module REST
@@ -25,12 +27,21 @@ module Twilio
           # Lists EventInstance records from the API as a list.
           # Unlike stream(), this operation is eager and will load `limit` records into
           # memory before returning.
-          # @param [String] actor_sid The actor_sid
-          # @param [String] event_type The event_type
-          # @param [String] resource_sid The resource_sid
-          # @param [String] source_ip_address The source_ip_address
-          # @param [Date] start_date The start_date
-          # @param [Date] end_date The end_date
+          # @param [String] actor_sid Only include events initiated by this Actor. Useful
+          #   for auditing actions taken by specific users or API credentials.
+          # @param [String] event_type Only include events of this [Event
+          #   Type](https://www.twilio.com/docs/usage/monitor-events#event-types).
+          # @param [String] resource_sid Only include events that refer to this resource.
+          #   Useful for discovering the history of a specific resource.
+          # @param [String] source_ip_address Only include events that originated from this
+          #   IP address. Useful for tracking suspicious activity originating from the API or
+          #   the Twilio Console.
+          # @param [Time] start_date Only include events that occurred on or after this
+          #   date. Specify the date in GMT and [ISO
+          #   8601](https://en.wikipedia.org/wiki/ISO_8601) format.
+          # @param [Time] end_date Only include events that occurred on or before this date.
+          #   Specify the date in GMT and [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)
+          #   format.
           # @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
@@ -55,12 +66,21 @@ module Twilio
           # Streams EventInstance records from the API as an Enumerable.
           # This operation lazily loads records as efficiently as possible until the limit
           # is reached.
-          # @param [String] actor_sid The actor_sid
-          # @param [String] event_type The event_type
-          # @param [String] resource_sid The resource_sid
-          # @param [String] source_ip_address The source_ip_address
-          # @param [Date] start_date The start_date
-          # @param [Date] end_date The end_date
+          # @param [String] actor_sid Only include events initiated by this Actor. Useful
+          #   for auditing actions taken by specific users or API credentials.
+          # @param [String] event_type Only include events of this [Event
+          #   Type](https://www.twilio.com/docs/usage/monitor-events#event-types).
+          # @param [String] resource_sid Only include events that refer to this resource.
+          #   Useful for discovering the history of a specific resource.
+          # @param [String] source_ip_address Only include events that originated from this
+          #   IP address. Useful for tracking suspicious activity originating from the API or
+          #   the Twilio Console.
+          # @param [Time] start_date Only include events that occurred on or after this
+          #   date. Specify the date in GMT and [ISO
+          #   8601](https://en.wikipedia.org/wiki/ISO_8601) format.
+          # @param [Time] end_date Only include events that occurred on or before this date.
+          #   Specify the date in GMT and [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)
+          #   format.
           # @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
@@ -91,7 +111,7 @@ module Twilio
           def each
             limits = @version.read_limits
 
-            page = self.page(page_size: limits[:page_size])
+            page = self.page(page_size: limits[:page_size], )
 
             @version.stream(page,
                             limit: limits[:limit],
@@ -101,12 +121,21 @@ module Twilio
           ##
           # Retrieve a single page of EventInstance records from the API.
           # Request is executed immediately.
-          # @param [String] actor_sid The actor_sid
-          # @param [String] event_type The event_type
-          # @param [String] resource_sid The resource_sid
-          # @param [String] source_ip_address The source_ip_address
-          # @param [Date] start_date The start_date
-          # @param [Date] end_date The end_date
+          # @param [String] actor_sid Only include events initiated by this Actor. Useful
+          #   for auditing actions taken by specific users or API credentials.
+          # @param [String] event_type Only include events of this [Event
+          #   Type](https://www.twilio.com/docs/usage/monitor-events#event-types).
+          # @param [String] resource_sid Only include events that refer to this resource.
+          #   Useful for discovering the history of a specific resource.
+          # @param [String] source_ip_address Only include events that originated from this
+          #   IP address. Useful for tracking suspicious activity originating from the API or
+          #   the Twilio Console.
+          # @param [Time] start_date Only include events that occurred on or after this
+          #   date. Specify the date in GMT and [ISO
+          #   8601](https://en.wikipedia.org/wiki/ISO_8601) format.
+          # @param [Time] end_date Only include events that occurred on or before this date.
+          #   Specify the date in GMT and [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)
+          #   format.
           # @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
@@ -117,8 +146,8 @@ module Twilio
                 'EventType' => event_type,
                 'ResourceSid' => resource_sid,
                 'SourceIpAddress' => source_ip_address,
-                '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,
@@ -170,7 +199,7 @@ module Twilio
           # @param [Hash] payload Payload response from the API
           # @return [EventInstance] EventInstance
           def get_instance(payload)
-            EventInstance.new(@version, payload)
+            EventInstance.new(@version, payload, )
           end
 
           ##
@@ -184,13 +213,13 @@ module Twilio
           ##
           # Initialize the EventContext
           # @param [Version] version Version that contains the resource
-          # @param [String] sid The sid
+          # @param [String] sid The SID of the Event resource to fetch.
           # @return [EventContext] EventContext
           def initialize(version, sid)
             super(version)
 
             # Path Solution
-            @solution = {sid: sid}
+            @solution = {sid: sid, }
             @uri = "/Events/#{@solution[:sid]}"
           end
 
@@ -206,7 +235,7 @@ module Twilio
                 params,
             )
 
-            EventInstance.new(@version, payload, sid: @solution[:sid])
+            EventInstance.new(@version, payload, sid: @solution[:sid], )
           end
 
           ##
@@ -215,6 +244,13 @@ module Twilio
             context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
             "#<Twilio.Monitor.V1.EventContext #{context}>"
           end
+
+          ##
+          # Provide a detailed, user friendly representation
+          def inspect
+            context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+            "#<Twilio.Monitor.V1.EventContext #{context}>"
+          end
         end
 
         class EventInstance < InstanceResource
@@ -222,7 +258,7 @@ module Twilio
           # Initialize the EventInstance
           # @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 Event resource to fetch.
           # @return [EventInstance] EventInstance
           def initialize(version, payload, sid: nil)
             super(version)
@@ -247,7 +283,7 @@ module Twilio
 
             # Context
             @instance_context = nil
-            @params = {'sid' => sid || @properties['sid']}
+            @params = {'sid' => sid || @properties['sid'], }
           end
 
           ##
@@ -256,91 +292,91 @@ module Twilio
           # @return [EventContext] EventContext for this EventInstance
           def context
             unless @instance_context
-              @instance_context = EventContext.new(@version, @params['sid'])
+              @instance_context = EventContext.new(@version, @params['sid'], )
             end
             @instance_context
           end
 
           ##
-          # @return [String] The account_sid
+          # @return [String] The SID of the Account that created the resource
           def account_sid
             @properties['account_sid']
           end
 
           ##
-          # @return [String] The actor_sid
+          # @return [String] The SID of the actor that caused the event, if available
           def actor_sid
             @properties['actor_sid']
           end
 
           ##
-          # @return [String] The actor_type
+          # @return [String] The type of actor that caused the event
           def actor_type
             @properties['actor_type']
           end
 
           ##
-          # @return [String] The description
+          # @return [String] A description of the event
           def description
             @properties['description']
           end
 
           ##
-          # @return [Hash] The event_data
+          # @return [Hash] A JSON string that represents an object with additional data about the event
           def event_data
             @properties['event_data']
           end
 
           ##
-          # @return [Time] The event_date
+          # @return [Time] The ISO 8601 date and time in GMT when the event was recorded
           def event_date
             @properties['event_date']
           end
 
           ##
-          # @return [String] The event_type
+          # @return [String] The event's type
           def event_type
             @properties['event_type']
           end
 
           ##
-          # @return [String] The resource_sid
+          # @return [String] The SID of the resource that was affected
           def resource_sid
             @properties['resource_sid']
           end
 
           ##
-          # @return [String] The resource_type
+          # @return [String] The type of resource that was affected
           def resource_type
             @properties['resource_type']
           end
 
           ##
-          # @return [String] The sid
+          # @return [String] The unique string that identifies the resource
           def sid
             @properties['sid']
           end
 
           ##
-          # @return [String] The source
+          # @return [String] The originating system or interface that caused the event
           def source
             @properties['source']
           end
 
           ##
-          # @return [String] The source_ip_address
+          # @return [String] The IP address of the source
           def source_ip_address
             @properties['source_ip_address']
           end
 
           ##
-          # @return [String] The url
+          # @return [String] The absolute URL of the resource that was affected
           def url
             @properties['url']
           end
 
           ##
-          # @return [String] The links
+          # @return [String] The absolute URLs of related resources
           def links
             @properties['links']
           end

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

@@ -3,6 +3,8 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
+#
+# frozen_string_literal: true
 
 module Twilio
   module REST
@@ -18,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)
@@ -32,7 +34,7 @@ module Twilio
         end
 
         ##
-        # @param [String] sid The sid
+        # @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.rb

@@ -3,6 +3,8 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
+#
+# frozen_string_literal: true
 
 module Twilio
   module REST
@@ -27,7 +29,8 @@ module Twilio
       end
 
       ##
-      # @param [String] sid The sid
+      # @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)
@@ -35,7 +38,8 @@ module Twilio
       end
 
       ##
-      # @param [String] sid The sid
+      # @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)