twilio-ruby 5.15.1 → 5.58.1

data/lib/twilio-ruby/rest/wireless/v1/sim/data_session.rb

@@ -3,7 +3,7 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
-# 
+#
 # frozen_string_literal: true
 
 module Twilio
@@ -15,9 +15,9 @@ module Twilio
             ##
             # Initialize the DataSessionList
             # @param [Version] version Version that contains the resource
-            # @param [String] sim_sid The unique id of the
-            #   [SIM](https://www.twilio.com/docs/api/wireless/rest-api/sim) resource that this
-            #   Data Session is for.
+            # @param [String] sim_sid The SID of the {Sim
+            #   resource}[https://www.twilio.com/docs/wireless/api/sim-resource] that the Data
+            #   Session is for.
             # @return [DataSessionList] DataSessionList
             def initialize(version, sim_sid: nil)
               super(version)
@@ -31,8 +31,6 @@ module Twilio
             # Lists DataSessionInstance records from the API as a list.
             # Unlike stream(), this operation is eager and will load `limit` records into
             # memory before returning.
-            # @param [Time] end_ The end
-            # @param [Time] start The start
             # @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
@@ -40,16 +38,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(end_: :unset, start: :unset, limit: nil, page_size: nil)
-              self.stream(end_: end_, start: start, limit: limit, page_size: page_size).entries
+            def list(limit: nil, page_size: nil)
+              self.stream(limit: limit, page_size: page_size).entries
             end
 
             ##
             # Streams DataSessionInstance records from the API as an Enumerable.
             # This operation lazily loads records as efficiently as possible until the limit
             # is reached.
-            # @param [Time] end_ The end
-            # @param [Time] start The start
             # @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
@@ -57,10 +53,10 @@ 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(end_: :unset, start: :unset, limit: nil, page_size: nil)
+            def stream(limit: nil, page_size: nil)
               limits = @version.read_limits(limit, page_size)
 
-              page = self.page(end_: end_, start: start, page_size: limits[:page_size], )
+              page = self.page(page_size: limits[:page_size], )
 
               @version.stream(page, limit: limits[:limit], page_limit: limits[:page_limit])
             end
@@ -82,25 +78,19 @@ module Twilio
             ##
             # Retrieve a single page of DataSessionInstance records from the API.
             # Request is executed immediately.
-            # @param [Time] end_ The end
-            # @param [Time] start The start
             # @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 DataSessionInstance
-            def page(end_: :unset, start: :unset, page_token: :unset, page_number: :unset, page_size: :unset)
+            def page(page_token: :unset, page_number: :unset, page_size: :unset)
               params = Twilio::Values.of({
-                  'End' => Twilio.serialize_iso8601_datetime(end_),
-                  'Start' => Twilio.serialize_iso8601_datetime(start),
                   'PageToken' => page_token,
                   'Page' => page_number,
                   'PageSize' => page_size,
               })
-              response = @version.page(
-                  'GET',
-                  @uri,
-                  params
-              )
+
+              response = @version.page('GET', @uri, params: params)
+
               DataSessionPage.new(@version, response, @solution)
             end
 
@@ -158,9 +148,9 @@ module Twilio
             # Initialize the DataSessionInstance
             # @param [Version] version Version that contains the resource
             # @param [Hash] payload payload that contains response from Twilio
-            # @param [String] sim_sid The unique id of the
-            #   [SIM](https://www.twilio.com/docs/api/wireless/rest-api/sim) resource that this
-            #   Data Session is for.
+            # @param [String] sim_sid The SID of the {Sim
+            #   resource}[https://www.twilio.com/docs/wireless/api/sim-resource] that the Data
+            #   Session is for.
             # @return [DataSessionInstance] DataSessionInstance
             def initialize(version, payload, sim_sid: nil)
               super(version)
@@ -182,99 +172,106 @@ module Twilio
                   'last_updated' => Twilio.deserialize_iso8601_datetime(payload['last_updated']),
                   'start' => Twilio.deserialize_iso8601_datetime(payload['start']),
                   'end_' => Twilio.deserialize_iso8601_datetime(payload['end']),
+                  'imei' => payload['imei'],
               }
             end
 
             ##
-            # @return [String] The unique id of the Data Session resource that this Data Record is for.
+            # @return [String] The unique string that identifies the resource
             def sid
               @properties['sid']
             end
 
             ##
-            # @return [String] The unique id of the SIM resource that this Data Session is for.
+            # @return [String] The SID of the Sim resource that the Data Session is for
             def sim_sid
               @properties['sim_sid']
             end
 
             ##
-            # @return [String] The unique id of the Account that the SIM belongs to.
+            # @return [String] The SID of the Account that created the resource
             def account_sid
               @properties['account_sid']
             end
 
             ##
-            # @return [String] The generation of wireless technology that the device was attached to the cellular tower using.
+            # @return [String] The generation of wireless technology that the device was using
             def radio_link
               @properties['radio_link']
             end
 
             ##
-            # @return [String] The 'mobile country code' is the unique id of the home country where the Data Session took place.
+            # @return [String] The 'mobile country code' is the unique ID of the home country where the Data Session took place
             def operator_mcc
               @properties['operator_mcc']
             end
 
             ##
-            # @return [String] The 'mobile network code' is the unique id specific to the mobile operator network where the Data Session took place.
+            # @return [String] The 'mobile network code' is the unique ID specific to the mobile operator network where the Data Session took place
             def operator_mnc
               @properties['operator_mnc']
             end
 
             ##
-            # @return [String] The three letter country code representing where the device's Data Session took place.
+            # @return [String] The three letter country code representing where the device's Data Session took place
             def operator_country
               @properties['operator_country']
             end
 
             ##
-            # @return [String] The friendly name of the mobile operator network that the SIM-connected device is attached to.
+            # @return [String] The friendly name of the mobile operator network that the SIM-connected device is attached to
             def operator_name
               @properties['operator_name']
             end
 
             ##
-            # @return [String] The unique id of the cellular tower that the device was attached to at the moment when the Data Session was last updated.
+            # @return [String] The unique ID of the cellular tower that the device was attached to at the moment when the Data Session was last updated
             def cell_id
               @properties['cell_id']
             end
 
             ##
-            # @return [Hash] An object representing the estimated location where the device's Data Session took place.
+            # @return [Hash] An object with the estimated location where the device's Data Session took place
             def cell_location_estimate
               @properties['cell_location_estimate']
             end
 
             ##
-            # @return [String] The number of packets uploaded by the device between the start time and when the Data Session was last updated.
+            # @return [String] The number of packets uploaded by the device between the start time and when the Data Session was last updated
             def packets_uploaded
               @properties['packets_uploaded']
             end
 
             ##
-            # @return [String] The number of packets downloaded by the device between the start time and when the Data Session was last updated.
+            # @return [String] The number of packets downloaded by the device between the start time and when the Data Session was last updated
             def packets_downloaded
               @properties['packets_downloaded']
             end
 
             ##
-            # @return [Time] The date that this resource was last updated, given as GMT in ISO 8601 format.
+            # @return [Time] The date that the resource was last updated, given as GMT in ISO 8601 format
             def last_updated
               @properties['last_updated']
             end
 
             ##
-            # @return [Time] The date that this Data Session started, given as GMT in ISO 8601 format.
+            # @return [Time] The date that the Data Session started, given as GMT in ISO 8601 format
             def start
               @properties['start']
             end
 
             ##
-            # @return [Time] The date that this record ended, given as GMT in ISO 8601 format.
+            # @return [Time] The date that the record ended, given as GMT in ISO 8601 format
             def end_
               @properties['end_']
             end
 
+            ##
+            # @return [String] The unique ID of the device using the SIM to connect
+            def imei
+              @properties['imei']
+            end
+
             ##
             # Provide a user friendly representation
             def to_s

data/lib/twilio-ruby/rest/wireless/v1/sim/usage_record.rb

@@ -3,7 +3,7 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
-# 
+#
 # frozen_string_literal: true
 
 module Twilio
@@ -15,9 +15,9 @@ module Twilio
             ##
             # Initialize the UsageRecordList
             # @param [Version] version Version that contains the resource
-            # @param [String] sim_sid The unique id of the
-            #   [SIM](https://www.twilio.com/docs/api/wireless/rest-api/sim) resource that this
-            #   Usage Record is for.
+            # @param [String] sim_sid The SID of the {Sim
+            #   resource}[https://www.twilio.com/docs/wireless/api/sim-resource] that this Usage
+            #   Record is for.
             # @return [UsageRecordList] UsageRecordList
             def initialize(version, sim_sid: nil)
               super(version)
@@ -31,13 +31,15 @@ module Twilio
             # Lists UsageRecordInstance records from the API as a list.
             # Unlike stream(), this operation is eager and will load `limit` records into
             # memory before returning.
-            # @param [Time] end_ Only include usage that has occurred on or before this date.
-            #   Format is [ISO 8601](http://www.iso.org/iso/home/standards/iso8601.htm).
-            # @param [Time] start Only include usage that has occurred on or after this date.
-            #   Format is [ISO 8601](http://www.iso.org/iso/home/standards/iso8601.htm).
-            # @param [usage_record.Granularity] granularity The time-based grouping that
-            #   results are aggregated by. Valid values are `daily`, `hourly`, `all`. `all` will
-            #   return one Usage Record for the entire period.
+            # @param [Time] end_ Only include usage that occurred on or before this date,
+            #   specified in {ISO 8601}[https://www.iso.org/iso-8601-date-and-time-format.html].
+            #   The default is the current time.
+            # @param [Time] start Only include usage that has occurred on or after this date,
+            #   specified in {ISO 8601}[https://www.iso.org/iso-8601-date-and-time-format.html].
+            #   The default is one month before the `end` parameter value.
+            # @param [usage_record.Granularity] granularity How to summarize the usage by
+            #   time. Can be: `daily`, `hourly`, or `all`. The default is `all`. A value of
+            #   `all` returns one Usage Record that describes the usage for the entire period.
             # @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
@@ -59,13 +61,15 @@ module Twilio
             # Streams UsageRecordInstance records from the API as an Enumerable.
             # This operation lazily loads records as efficiently as possible until the limit
             # is reached.
-            # @param [Time] end_ Only include usage that has occurred on or before this date.
-            #   Format is [ISO 8601](http://www.iso.org/iso/home/standards/iso8601.htm).
-            # @param [Time] start Only include usage that has occurred on or after this date.
-            #   Format is [ISO 8601](http://www.iso.org/iso/home/standards/iso8601.htm).
-            # @param [usage_record.Granularity] granularity The time-based grouping that
-            #   results are aggregated by. Valid values are `daily`, `hourly`, `all`. `all` will
-            #   return one Usage Record for the entire period.
+            # @param [Time] end_ Only include usage that occurred on or before this date,
+            #   specified in {ISO 8601}[https://www.iso.org/iso-8601-date-and-time-format.html].
+            #   The default is the current time.
+            # @param [Time] start Only include usage that has occurred on or after this date,
+            #   specified in {ISO 8601}[https://www.iso.org/iso-8601-date-and-time-format.html].
+            #   The default is one month before the `end` parameter value.
+            # @param [usage_record.Granularity] granularity How to summarize the usage by
+            #   time. Can be: `daily`, `hourly`, or `all`. The default is `all`. A value of
+            #   `all` returns one Usage Record that describes the usage for the entire period.
             # @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
@@ -98,13 +102,15 @@ module Twilio
             ##
             # Retrieve a single page of UsageRecordInstance records from the API.
             # Request is executed immediately.
-            # @param [Time] end_ Only include usage that has occurred on or before this date.
-            #   Format is [ISO 8601](http://www.iso.org/iso/home/standards/iso8601.htm).
-            # @param [Time] start Only include usage that has occurred on or after this date.
-            #   Format is [ISO 8601](http://www.iso.org/iso/home/standards/iso8601.htm).
-            # @param [usage_record.Granularity] granularity The time-based grouping that
-            #   results are aggregated by. Valid values are `daily`, `hourly`, `all`. `all` will
-            #   return one Usage Record for the entire period.
+            # @param [Time] end_ Only include usage that occurred on or before this date,
+            #   specified in {ISO 8601}[https://www.iso.org/iso-8601-date-and-time-format.html].
+            #   The default is the current time.
+            # @param [Time] start Only include usage that has occurred on or after this date,
+            #   specified in {ISO 8601}[https://www.iso.org/iso-8601-date-and-time-format.html].
+            #   The default is one month before the `end` parameter value.
+            # @param [usage_record.Granularity] granularity How to summarize the usage by
+            #   time. Can be: `daily`, `hourly`, or `all`. The default is `all`. A value of
+            #   `all` returns one Usage Record that describes the usage for the entire period.
             # @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
@@ -118,11 +124,9 @@ module Twilio
                   'Page' => page_number,
                   'PageSize' => page_size,
               })
-              response = @version.page(
-                  'GET',
-                  @uri,
-                  params
-              )
+
+              response = @version.page('GET', @uri, params: params)
+
               UsageRecordPage.new(@version, response, @solution)
             end
 
@@ -180,9 +184,9 @@ module Twilio
             # Initialize the UsageRecordInstance
             # @param [Version] version Version that contains the resource
             # @param [Hash] payload payload that contains response from Twilio
-            # @param [String] sim_sid The unique id of the
-            #   [SIM](https://www.twilio.com/docs/api/wireless/rest-api/sim) resource that this
-            #   Usage Record is for.
+            # @param [String] sim_sid The SID of the {Sim
+            #   resource}[https://www.twilio.com/docs/wireless/api/sim-resource] that this Usage
+            #   Record is for.
             # @return [UsageRecordInstance] UsageRecordInstance
             def initialize(version, payload, sim_sid: nil)
               super(version)
@@ -198,31 +202,31 @@ module Twilio
             end
 
             ##
-            # @return [String] The unique id of the SIM resource that this Usage Record is for.
+            # @return [String] The SID of the Sim resource that this Usage Record is for
             def sim_sid
               @properties['sim_sid']
             end
 
             ##
-            # @return [String] The unique id of the Account that the SIM belongs to.
+            # @return [String] The SID of the Account that created the resource
             def account_sid
               @properties['account_sid']
             end
 
             ##
-            # @return [Hash] The time period for which usage is reported.
+            # @return [Hash] The time period for which the usage is reported
             def period
               @properties['period']
             end
 
             ##
-            # @return [Hash] An object representing the Commands usage for the SIM over the period.
+            # @return [Hash] An object that describes the SIM's usage of Commands during the specified period
             def commands
               @properties['commands']
             end
 
             ##
-            # @return [Hash] An object representing the Data usage for the SIM over the period.
+            # @return [Hash] An object that describes the SIM's data usage during the specified period
             def data
               @properties['data']
             end

data/lib/twilio-ruby/rest/wireless/v1/sim.rb

@@ -3,7 +3,7 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
-# 
+#
 # frozen_string_literal: true
 
 module Twilio
@@ -27,12 +27,15 @@ module Twilio
           # Lists SimInstance records from the API as a list.
           # Unlike stream(), this operation is eager and will load `limit` records into
           # memory before returning.
-          # @param [sim.Status] status Only return Sims with this status.
-          # @param [String] iccid Return Sims with this Iccid. Currently this should be a
-          #   list with maximum size 1.
-          # @param [String] rate_plan Only return Sims with this Rate Plan.
-          # @param [String] e_id The e_id
-          # @param [String] sim_registration_code The sim_registration_code
+          # @param [sim.Status] status Only return Sim resources with this status.
+          # @param [String] iccid Only return Sim resources with this ICCID. This will
+          #   return a list with a maximum size of 1.
+          # @param [String] rate_plan The SID or unique name of a {RatePlan
+          #   resource}[https://www.twilio.com/docs/wireless/api/rateplan-resource]. Only
+          #   return Sim resources assigned to this RatePlan resource.
+          # @param [String] e_id Deprecated.
+          # @param [String] sim_registration_code Only return Sim resources with this
+          #   registration code. This will return a list with a maximum size of 1.
           # @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
@@ -56,12 +59,15 @@ module Twilio
           # Streams SimInstance records from the API as an Enumerable.
           # This operation lazily loads records as efficiently as possible until the limit
           # is reached.
-          # @param [sim.Status] status Only return Sims with this status.
-          # @param [String] iccid Return Sims with this Iccid. Currently this should be a
-          #   list with maximum size 1.
-          # @param [String] rate_plan Only return Sims with this Rate Plan.
-          # @param [String] e_id The e_id
-          # @param [String] sim_registration_code The sim_registration_code
+          # @param [sim.Status] status Only return Sim resources with this status.
+          # @param [String] iccid Only return Sim resources with this ICCID. This will
+          #   return a list with a maximum size of 1.
+          # @param [String] rate_plan The SID or unique name of a {RatePlan
+          #   resource}[https://www.twilio.com/docs/wireless/api/rateplan-resource]. Only
+          #   return Sim resources assigned to this RatePlan resource.
+          # @param [String] e_id Deprecated.
+          # @param [String] sim_registration_code Only return Sim resources with this
+          #   registration code. This will return a list with a maximum size of 1.
           # @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
@@ -101,12 +107,15 @@ module Twilio
           ##
           # Retrieve a single page of SimInstance records from the API.
           # Request is executed immediately.
-          # @param [sim.Status] status Only return Sims with this status.
-          # @param [String] iccid Return Sims with this Iccid. Currently this should be a
-          #   list with maximum size 1.
-          # @param [String] rate_plan Only return Sims with this Rate Plan.
-          # @param [String] e_id The e_id
-          # @param [String] sim_registration_code The sim_registration_code
+          # @param [sim.Status] status Only return Sim resources with this status.
+          # @param [String] iccid Only return Sim resources with this ICCID. This will
+          #   return a list with a maximum size of 1.
+          # @param [String] rate_plan The SID or unique name of a {RatePlan
+          #   resource}[https://www.twilio.com/docs/wireless/api/rateplan-resource]. Only
+          #   return Sim resources assigned to this RatePlan resource.
+          # @param [String] e_id Deprecated.
+          # @param [String] sim_registration_code Only return Sim resources with this
+          #   registration code. This will return a list with a maximum size of 1.
           # @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
@@ -122,11 +131,9 @@ module Twilio
                 'Page' => page_number,
                 'PageSize' => page_size,
             })
-            response = @version.page(
-                'GET',
-                @uri,
-                params
-            )
+
+            response = @version.page('GET', @uri, params: params)
+
             SimPage.new(@version, response, @solution)
           end
 
@@ -183,7 +190,7 @@ module Twilio
           ##
           # Initialize the SimContext
           # @param [Version] version Version that contains the resource
-          # @param [String] sid The sid
+          # @param [String] sid The SID or the `unique_name` of the Sim resource to fetch.
           # @return [SimContext] SimContext
           def initialize(version, sid)
             super(version)
@@ -198,68 +205,71 @@ module Twilio
           end
 
           ##
-          # Fetch a SimInstance
+          # Fetch the SimInstance
           # @return [SimInstance] Fetched SimInstance
           def fetch
-            params = Twilio::Values.of({})
-
-            payload = @version.fetch(
-                'GET',
-                @uri,
-                params,
-            )
+            payload = @version.fetch('GET', @uri)
 
             SimInstance.new(@version, payload, sid: @solution[:sid], )
           end
 
           ##
           # Update the SimInstance
-          # @param [String] unique_name A user-provided string that uniquely identifies this
-          #   resource as an alternative to the `Sid`.
-          # @param [String] callback_method The HTTP method Twilio will use when making a
-          #   request to the callback URL (valid options are GET or POST). Defaults to POST.
-          # @param [String] callback_url Twilio will make a request to this URL when the Sim
-          #   has finished updating. In the case of a transition from the Sim's `new` status
-          #   to its `ready` status, or from any status to its `deactivated` status, you will
-          #   receive two callbacks. One when the Sim moves to its intermediary status
-          #   (`ready` or `deactivated`), and a second when it transitions to its final status
-          #   (`active` or `canceled`).
-          # @param [String] friendly_name A user-provided string that identifies this
-          #   resource. Non-unique.
-          # @param [String] rate_plan The Sid or UniqueName of the
-          #   [RatePlan](https://www.twilio.com/docs/api/wireless/rest-api/rate-plan) that
-          #   this Sim should use. *Note:* the RatePlan of a Sim can only be modified when the
-          #   Sim has a `suspended` or `deactivated` status.
-          # @param [sim.Status] status A string representing the status of the Sim. Valid
-          #   options depend on the current state of the Sim, but may include `ready`,
-          #   `active`, `suspended` or `deactivated`.
-          # @param [String] commands_callback_method A string representing the HTTP method
-          #   to use when making a request to `CommandsCallbackUrl`.  Can be one of `POST` or
-          #   `GET`. Defaults to `POST`.
-          # @param [String] commands_callback_url The URL that will receive a webhook when
-          #   this Sim originates a
-          #   [Command](https://www.twilio.com/docs/api/wireless/rest-api/command). Your
+          # @param [String] unique_name An application-defined string that uniquely
+          #   identifies the resource. It can be used in place of the `sid` in the URL path to
+          #   address the resource.
+          # @param [String] callback_method The HTTP method we should use to call
+          #   `callback_url`. Can be: `POST` or `GET`. The default is `POST`.
+          # @param [String] callback_url The URL we should call using the `callback_url`
+          #   when the SIM has finished updating. When the SIM transitions from `new` to
+          #   `ready` or from any status to `deactivated`, we call this URL when the status
+          #   changes to an intermediate status (`ready` or `deactivated`) and again when the
+          #   status changes to its final status (`active` or `canceled`).
+          # @param [String] friendly_name A descriptive string that you create to describe
+          #   the Sim resource. It does not need to be unique.
+          # @param [String] rate_plan The SID or unique name of the {RatePlan
+          #   resource}[https://www.twilio.com/docs/wireless/api/rateplan-resource] to which
+          #   the Sim resource should be assigned.
+          # @param [sim.Status] status The new status of the Sim resource. Can be: `ready`,
+          #   `active`, `suspended`, or `deactivated`.
+          # @param [String] commands_callback_method The HTTP method we should use to call
+          #   `commands_callback_url`. Can be: `POST` or `GET`. The default is `POST`.
+          # @param [String] commands_callback_url The URL we should call using the
+          #   `commands_callback_method` when the SIM sends a
+          #   {Command}[https://www.twilio.com/docs/wireless/api/command-resource]. Your
           #   server should respond with an HTTP status code in the 200 range; any response
-          #   body will be ignored.
-          # @param [String] sms_fallback_method The HTTP method Twilio will use when
-          #   requesting the sms_fallback_url. Either `GET` or `POST`.
-          # @param [String] sms_fallback_url The URL that Twilio will request if an error
-          #   occurs retrieving or executing the TwiML requested by `sms_url`.
-          # @param [String] sms_method The HTTP method Twilio will use when requesting the
-          #   above Url. Either `GET` or `POST`.
-          # @param [String] sms_url The URL Twilio will request when the SIM-connected
-          #   device sends an SMS message that is not a
-          #   [Command](https://www.twilio.com/docs/api/wireless/rest-api/command).
-          # @param [String] voice_fallback_method The HTTP method Twilio will use when
-          #   requesting the voice_fallback_url. Either `GET` or `POST`.
-          # @param [String] voice_fallback_url The URL that Twilio will request if an error
-          #   occurs retrieving or executing the TwiML requested by `voice_url`.
-          # @param [String] voice_method The HTTP method Twilio will use when requesting the
-          #   above Url. Either `GET` or `POST`.
-          # @param [String] voice_url The URL Twilio will request when the SIM-connected
-          #   device makes a call.
+          #   body is ignored.
+          # @param [String] sms_fallback_method The HTTP method we should use to call
+          #   `sms_fallback_url`. Can be: `GET` or `POST`. Default is `POST`.
+          # @param [String] sms_fallback_url The URL we should call using the
+          #   `sms_fallback_method` when an error occurs while retrieving or executing the
+          #   TwiML requested from `sms_url`.
+          # @param [String] sms_method The HTTP method we should use to call `sms_url`. Can
+          #   be: `GET` or `POST`. Default is `POST`.
+          # @param [String] sms_url The URL we should call using the `sms_method` when the
+          #   SIM-connected device sends an SMS message that is not a
+          #   {Command}[https://www.twilio.com/docs/wireless/api/command-resource].
+          # @param [String] voice_fallback_method The HTTP method we should use to call
+          #   `voice_fallback_url`. Can be: `GET` or `POST`.
+          # @param [String] voice_fallback_url The URL we should call using the
+          #   `voice_fallback_method` when an error occurs while retrieving or executing the
+          #   TwiML requested from `voice_url`.
+          # @param [String] voice_method The HTTP method we should use when we call
+          #   `voice_url`. Can be: `GET` or `POST`.
+          # @param [String] voice_url The URL we should call using the `voice_method` when
+          #   the SIM-connected device makes a voice call.
+          # @param [sim.ResetStatus] reset_status Initiate a connectivity reset on the SIM.
+          #   Set to `resetting` to initiate a connectivity reset on the SIM. No other value
+          #   is valid.
+          # @param [String] account_sid The SID of the
+          #   {Account}[https://www.twilio.com/docs/iam/api/account] to which the Sim resource
+          #   should belong. The Account SID can only be that of the requesting Account or
+          #   that of a {Subaccount}[https://www.twilio.com/docs/iam/api/subaccounts] of the
+          #   requesting Account. Only valid when the Sim resource's status is `new`. For more
+          #   information, see the {Move SIMs between Subaccounts
+          #   documentation}[https://www.twilio.com/docs/wireless/api/sim-resource#move-sims-between-subaccounts].
           # @return [SimInstance] Updated SimInstance
-          def update(unique_name: :unset, callback_method: :unset, callback_url: :unset, friendly_name: :unset, rate_plan: :unset, status: :unset, commands_callback_method: :unset, commands_callback_url: :unset, sms_fallback_method: :unset, sms_fallback_url: :unset, sms_method: :unset, sms_url: :unset, voice_fallback_method: :unset, voice_fallback_url: :unset, voice_method: :unset, voice_url: :unset)
+          def update(unique_name: :unset, callback_method: :unset, callback_url: :unset, friendly_name: :unset, rate_plan: :unset, status: :unset, commands_callback_method: :unset, commands_callback_url: :unset, sms_fallback_method: :unset, sms_fallback_url: :unset, sms_method: :unset, sms_url: :unset, voice_fallback_method: :unset, voice_fallback_url: :unset, voice_method: :unset, voice_url: :unset, reset_status: :unset, account_sid: :unset)
             data = Twilio::Values.of({
                 'UniqueName' => unique_name,
                 'CallbackMethod' => callback_method,
@@ -277,17 +287,22 @@ module Twilio
                 'VoiceFallbackUrl' => voice_fallback_url,
                 'VoiceMethod' => voice_method,
                 'VoiceUrl' => voice_url,
+                'ResetStatus' => reset_status,
+                'AccountSid' => account_sid,
             })
 
-            payload = @version.update(
-                'POST',
-                @uri,
-                data: data,
-            )
+            payload = @version.update('POST', @uri, data: data)
 
             SimInstance.new(@version, payload, sid: @solution[:sid], )
           end
 
+          ##
+          # Delete the SimInstance
+          # @return [Boolean] true if delete succeeds, false otherwise
+          def delete
+             @version.delete('DELETE', @uri)
+          end
+
           ##
           # Access the usage_records
           # @return [UsageRecordList]
@@ -318,6 +333,13 @@ module Twilio
             context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
             "#<Twilio.Wireless.V1.SimContext #{context}>"
           end
+
+          ##
+          # Provide a detailed, user friendly representation
+          def inspect
+            context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+            "#<Twilio.Wireless.V1.SimContext #{context}>"
+          end
         end
 
         class SimInstance < InstanceResource
@@ -325,7 +347,7 @@ module Twilio
           # Initialize the SimInstance
           # @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 or the `unique_name` of the Sim resource to fetch.
           # @return [SimInstance] SimInstance
           def initialize(version, payload, sid: nil)
             super(version)
@@ -340,6 +362,7 @@ module Twilio
                 'iccid' => payload['iccid'],
                 'e_id' => payload['e_id'],
                 'status' => payload['status'],
+                'reset_status' => payload['reset_status'],
                 'commands_callback_url' => payload['commands_callback_url'],
                 'commands_callback_method' => payload['commands_callback_method'],
                 'sms_fallback_method' => payload['sms_fallback_method'],
@@ -374,145 +397,151 @@ module Twilio
           end
 
           ##
-          # @return [String] A 34 character string that uniquely identifies this resource.
+          # @return [String] The unique string that identifies the Sim resource
           def sid
             @properties['sid']
           end
 
           ##
-          # @return [String] A user-provided string that uniquely identifies this resource as an alternative to the sid.
+          # @return [String] An application-defined string that uniquely identifies the resource
           def unique_name
             @properties['unique_name']
           end
 
           ##
-          # @return [String] The unique id of the Account that this Sim belongs to.
+          # @return [String] The SID of the Account to which the Sim resource belongs
           def account_sid
             @properties['account_sid']
           end
 
           ##
-          # @return [String] The unique ID of the Rate Plan configured for this Sim.
+          # @return [String] The SID of the RatePlan resource to which the Sim resource is assigned.
           def rate_plan_sid
             @properties['rate_plan_sid']
           end
 
           ##
-          # @return [String] A user-provided string that identifies this resource.
+          # @return [String] The string that you assigned to describe the Sim resource
           def friendly_name
             @properties['friendly_name']
           end
 
           ##
-          # @return [String] The ICCID associated with the SIM.
+          # @return [String] The ICCID associated with the SIM
           def iccid
             @properties['iccid']
           end
 
           ##
-          # @return [String] The e_id
+          # @return [String] Deprecated
           def e_id
             @properties['e_id']
           end
 
           ##
-          # @return [sim.Status] A string representing the status of the Sim.
+          # @return [sim.Status] The status of the Sim resource
           def status
             @properties['status']
           end
 
           ##
-          # @return [String] The URL that will receive a webhook when this Sim originates a machine-to-machine Command.
+          # @return [sim.ResetStatus] The connectivity reset status of the SIM
+          def reset_status
+            @properties['reset_status']
+          end
+
+          ##
+          # @return [String] The URL we call when the SIM originates a machine-to-machine Command
           def commands_callback_url
             @properties['commands_callback_url']
           end
 
           ##
-          # @return [String] A string representing the HTTP method to use when making a request to commands_callback_url.
+          # @return [String] The HTTP method we use to call commands_callback_url
           def commands_callback_method
             @properties['commands_callback_method']
           end
 
           ##
-          # @return [String] The HTTP method Twilio will use when requesting the sms_fallback_url.
+          # @return [String] The HTTP method we use to call sms_fallback_url
           def sms_fallback_method
             @properties['sms_fallback_method']
           end
 
           ##
-          # @return [String] The URL that Twilio will request if an error occurs retrieving or executing the TwiML requested by sms_url.
+          # @return [String] The URL we call when an error occurs while retrieving or executing the TwiML requested from the sms_url
           def sms_fallback_url
             @properties['sms_fallback_url']
           end
 
           ##
-          # @return [String] The HTTP method Twilio will use when requesting the above Url.
+          # @return [String] The HTTP method we use to call sms_url
           def sms_method
             @properties['sms_method']
           end
 
           ##
-          # @return [String] The URL Twilio will request when the SIM-connected device send an SMS that is not a Command.
+          # @return [String] The URL we call when the SIM-connected device sends an SMS message that is not a Command
           def sms_url
             @properties['sms_url']
           end
 
           ##
-          # @return [String] The HTTP method Twilio will use when requesting the voice_fallback_url.
+          # @return [String] The HTTP method we use to call voice_fallback_url
           def voice_fallback_method
             @properties['voice_fallback_method']
           end
 
           ##
-          # @return [String] The URL that Twilio will request if an error occurs retrieving or executing the TwiML requested by voice_url.
+          # @return [String] The URL we call when an error occurs while retrieving or executing the TwiML requested from voice_url
           def voice_fallback_url
             @properties['voice_fallback_url']
           end
 
           ##
-          # @return [String] The HTTP method Twilio will use when requesting the above Url.
+          # @return [String] The HTTP method we use to call voice_url
           def voice_method
             @properties['voice_method']
           end
 
           ##
-          # @return [String] The URL Twilio will request when the SIM-connected device makes a call.
+          # @return [String] The URL we call when the SIM-connected device makes a voice call
           def voice_url
             @properties['voice_url']
           end
 
           ##
-          # @return [Time] The date that this resource was created, given as GMT 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 that this resource was last updated, given as GMT in ISO 8601 format.
+          # @return [Time] The ISO 8601 date and time in GMT when the Sim resource was last updated
           def date_updated
             @properties['date_updated']
           end
 
           ##
-          # @return [String] The URL for this resource.
+          # @return [String] The absolute URL of the resource
           def url
             @properties['url']
           end
 
           ##
-          # @return [String] Each Sim instance resource supports a few subresources, listed here for convenience.
+          # @return [String] The URLs of related subresources
           def links
             @properties['links']
           end
 
           ##
-          # @return [String] The ip_address
+          # @return [String] Deprecated
           def ip_address
             @properties['ip_address']
           end
 
           ##
-          # Fetch a SimInstance
+          # Fetch the SimInstance
           # @return [SimInstance] Fetched SimInstance
           def fetch
             context.fetch
@@ -520,52 +549,61 @@ module Twilio
 
           ##
           # Update the SimInstance
-          # @param [String] unique_name A user-provided string that uniquely identifies this
-          #   resource as an alternative to the `Sid`.
-          # @param [String] callback_method The HTTP method Twilio will use when making a
-          #   request to the callback URL (valid options are GET or POST). Defaults to POST.
-          # @param [String] callback_url Twilio will make a request to this URL when the Sim
-          #   has finished updating. In the case of a transition from the Sim's `new` status
-          #   to its `ready` status, or from any status to its `deactivated` status, you will
-          #   receive two callbacks. One when the Sim moves to its intermediary status
-          #   (`ready` or `deactivated`), and a second when it transitions to its final status
-          #   (`active` or `canceled`).
-          # @param [String] friendly_name A user-provided string that identifies this
-          #   resource. Non-unique.
-          # @param [String] rate_plan The Sid or UniqueName of the
-          #   [RatePlan](https://www.twilio.com/docs/api/wireless/rest-api/rate-plan) that
-          #   this Sim should use. *Note:* the RatePlan of a Sim can only be modified when the
-          #   Sim has a `suspended` or `deactivated` status.
-          # @param [sim.Status] status A string representing the status of the Sim. Valid
-          #   options depend on the current state of the Sim, but may include `ready`,
-          #   `active`, `suspended` or `deactivated`.
-          # @param [String] commands_callback_method A string representing the HTTP method
-          #   to use when making a request to `CommandsCallbackUrl`.  Can be one of `POST` or
-          #   `GET`. Defaults to `POST`.
-          # @param [String] commands_callback_url The URL that will receive a webhook when
-          #   this Sim originates a
-          #   [Command](https://www.twilio.com/docs/api/wireless/rest-api/command). Your
+          # @param [String] unique_name An application-defined string that uniquely
+          #   identifies the resource. It can be used in place of the `sid` in the URL path to
+          #   address the resource.
+          # @param [String] callback_method The HTTP method we should use to call
+          #   `callback_url`. Can be: `POST` or `GET`. The default is `POST`.
+          # @param [String] callback_url The URL we should call using the `callback_url`
+          #   when the SIM has finished updating. When the SIM transitions from `new` to
+          #   `ready` or from any status to `deactivated`, we call this URL when the status
+          #   changes to an intermediate status (`ready` or `deactivated`) and again when the
+          #   status changes to its final status (`active` or `canceled`).
+          # @param [String] friendly_name A descriptive string that you create to describe
+          #   the Sim resource. It does not need to be unique.
+          # @param [String] rate_plan The SID or unique name of the {RatePlan
+          #   resource}[https://www.twilio.com/docs/wireless/api/rateplan-resource] to which
+          #   the Sim resource should be assigned.
+          # @param [sim.Status] status The new status of the Sim resource. Can be: `ready`,
+          #   `active`, `suspended`, or `deactivated`.
+          # @param [String] commands_callback_method The HTTP method we should use to call
+          #   `commands_callback_url`. Can be: `POST` or `GET`. The default is `POST`.
+          # @param [String] commands_callback_url The URL we should call using the
+          #   `commands_callback_method` when the SIM sends a
+          #   {Command}[https://www.twilio.com/docs/wireless/api/command-resource]. Your
           #   server should respond with an HTTP status code in the 200 range; any response
-          #   body will be ignored.
-          # @param [String] sms_fallback_method The HTTP method Twilio will use when
-          #   requesting the sms_fallback_url. Either `GET` or `POST`.
-          # @param [String] sms_fallback_url The URL that Twilio will request if an error
-          #   occurs retrieving or executing the TwiML requested by `sms_url`.
-          # @param [String] sms_method The HTTP method Twilio will use when requesting the
-          #   above Url. Either `GET` or `POST`.
-          # @param [String] sms_url The URL Twilio will request when the SIM-connected
-          #   device sends an SMS message that is not a
-          #   [Command](https://www.twilio.com/docs/api/wireless/rest-api/command).
-          # @param [String] voice_fallback_method The HTTP method Twilio will use when
-          #   requesting the voice_fallback_url. Either `GET` or `POST`.
-          # @param [String] voice_fallback_url The URL that Twilio will request if an error
-          #   occurs retrieving or executing the TwiML requested by `voice_url`.
-          # @param [String] voice_method The HTTP method Twilio will use when requesting the
-          #   above Url. Either `GET` or `POST`.
-          # @param [String] voice_url The URL Twilio will request when the SIM-connected
-          #   device makes a call.
+          #   body is ignored.
+          # @param [String] sms_fallback_method The HTTP method we should use to call
+          #   `sms_fallback_url`. Can be: `GET` or `POST`. Default is `POST`.
+          # @param [String] sms_fallback_url The URL we should call using the
+          #   `sms_fallback_method` when an error occurs while retrieving or executing the
+          #   TwiML requested from `sms_url`.
+          # @param [String] sms_method The HTTP method we should use to call `sms_url`. Can
+          #   be: `GET` or `POST`. Default is `POST`.
+          # @param [String] sms_url The URL we should call using the `sms_method` when the
+          #   SIM-connected device sends an SMS message that is not a
+          #   {Command}[https://www.twilio.com/docs/wireless/api/command-resource].
+          # @param [String] voice_fallback_method The HTTP method we should use to call
+          #   `voice_fallback_url`. Can be: `GET` or `POST`.
+          # @param [String] voice_fallback_url The URL we should call using the
+          #   `voice_fallback_method` when an error occurs while retrieving or executing the
+          #   TwiML requested from `voice_url`.
+          # @param [String] voice_method The HTTP method we should use when we call
+          #   `voice_url`. Can be: `GET` or `POST`.
+          # @param [String] voice_url The URL we should call using the `voice_method` when
+          #   the SIM-connected device makes a voice call.
+          # @param [sim.ResetStatus] reset_status Initiate a connectivity reset on the SIM.
+          #   Set to `resetting` to initiate a connectivity reset on the SIM. No other value
+          #   is valid.
+          # @param [String] account_sid The SID of the
+          #   {Account}[https://www.twilio.com/docs/iam/api/account] to which the Sim resource
+          #   should belong. The Account SID can only be that of the requesting Account or
+          #   that of a {Subaccount}[https://www.twilio.com/docs/iam/api/subaccounts] of the
+          #   requesting Account. Only valid when the Sim resource's status is `new`. For more
+          #   information, see the {Move SIMs between Subaccounts
+          #   documentation}[https://www.twilio.com/docs/wireless/api/sim-resource#move-sims-between-subaccounts].
           # @return [SimInstance] Updated SimInstance
-          def update(unique_name: :unset, callback_method: :unset, callback_url: :unset, friendly_name: :unset, rate_plan: :unset, status: :unset, commands_callback_method: :unset, commands_callback_url: :unset, sms_fallback_method: :unset, sms_fallback_url: :unset, sms_method: :unset, sms_url: :unset, voice_fallback_method: :unset, voice_fallback_url: :unset, voice_method: :unset, voice_url: :unset)
+          def update(unique_name: :unset, callback_method: :unset, callback_url: :unset, friendly_name: :unset, rate_plan: :unset, status: :unset, commands_callback_method: :unset, commands_callback_url: :unset, sms_fallback_method: :unset, sms_fallback_url: :unset, sms_method: :unset, sms_url: :unset, voice_fallback_method: :unset, voice_fallback_url: :unset, voice_method: :unset, voice_url: :unset, reset_status: :unset, account_sid: :unset)
             context.update(
                 unique_name: unique_name,
                 callback_method: callback_method,
@@ -583,9 +621,18 @@ module Twilio
                 voice_fallback_url: voice_fallback_url,
                 voice_method: voice_method,
                 voice_url: voice_url,
+                reset_status: reset_status,
+                account_sid: account_sid,
             )
           end
 
+          ##
+          # Delete the SimInstance
+          # @return [Boolean] true if delete succeeds, false otherwise
+          def delete
+            context.delete
+          end
+
           ##
           # Access the usage_records
           # @return [usage_records] usage_records