twilio-ruby 5.39.3 → 5.40.0

data/lib/twilio-ruby/rest/supersim/v1/usage_record.rb

@@ -29,8 +29,19 @@ 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 [String] sim SID of a Sim resource. Only show UsageRecords representing
-          #   usage incurred by this Super SIM.
+          # @param [String] sim SID or unique name of a Sim resource. Only show UsageRecords
+          #   representing usage incurred by this Super SIM.
+          # @param [String] fleet SID or unique name of a Fleet resource. Only show
+          #   UsageRecords representing usage for Super SIMs belonging to this Fleet resource
+          #   at the time the usage occurred.
+          # @param [String] network SID of a Network resource. Only show UsageRecords
+          #   representing usage on this network.
+          # @param [String] iso_country Alpha-2 ISO Country Code. Only show UsageRecords
+          #   representing usage in this country.
+          # @param [usage_record.Group] group Dimension over which to aggregate usage
+          #   records. Can be: `sim`, `fleet`, `network`, `isoCountry`. Default is to not
+          #   aggregate across any of these dimensions, UsageRecords will be aggregated into
+          #   the time buckets described by the `Granularity` parameter.
           # @param [usage_record.Granularity] granularity Time-based grouping that
           #   UsageRecords should be aggregated by. Can be: `hour`, `day`, or `all`. Default
           #   is `all`. `all` returns one UsageRecord that describes the usage for the entire
@@ -48,9 +59,13 @@ 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(sim: :unset, granularity: :unset, start_time: :unset, end_time: :unset, limit: nil, page_size: nil)
+          def list(sim: :unset, fleet: :unset, network: :unset, iso_country: :unset, group: :unset, granularity: :unset, start_time: :unset, end_time: :unset, limit: nil, page_size: nil)
             self.stream(
                 sim: sim,
+                fleet: fleet,
+                network: network,
+                iso_country: iso_country,
+                group: group,
                 granularity: granularity,
                 start_time: start_time,
                 end_time: end_time,
@@ -63,8 +78,19 @@ 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 [String] sim SID of a Sim resource. Only show UsageRecords representing
-          #   usage incurred by this Super SIM.
+          # @param [String] sim SID or unique name of a Sim resource. Only show UsageRecords
+          #   representing usage incurred by this Super SIM.
+          # @param [String] fleet SID or unique name of a Fleet resource. Only show
+          #   UsageRecords representing usage for Super SIMs belonging to this Fleet resource
+          #   at the time the usage occurred.
+          # @param [String] network SID of a Network resource. Only show UsageRecords
+          #   representing usage on this network.
+          # @param [String] iso_country Alpha-2 ISO Country Code. Only show UsageRecords
+          #   representing usage in this country.
+          # @param [usage_record.Group] group Dimension over which to aggregate usage
+          #   records. Can be: `sim`, `fleet`, `network`, `isoCountry`. Default is to not
+          #   aggregate across any of these dimensions, UsageRecords will be aggregated into
+          #   the time buckets described by the `Granularity` parameter.
           # @param [usage_record.Granularity] granularity Time-based grouping that
           #   UsageRecords should be aggregated by. Can be: `hour`, `day`, or `all`. Default
           #   is `all`. `all` returns one UsageRecord that describes the usage for the entire
@@ -82,11 +108,15 @@ module Twilio
           #    but a limit is defined, stream() will attempt to read the limit with the most
           #    efficient page size, i.e. min(limit, 1000)
           # @return [Enumerable] Enumerable that will yield up to limit results
-          def stream(sim: :unset, granularity: :unset, start_time: :unset, end_time: :unset, limit: nil, page_size: nil)
+          def stream(sim: :unset, fleet: :unset, network: :unset, iso_country: :unset, group: :unset, granularity: :unset, start_time: :unset, end_time: :unset, limit: nil, page_size: nil)
             limits = @version.read_limits(limit, page_size)
 
             page = self.page(
                 sim: sim,
+                fleet: fleet,
+                network: network,
+                iso_country: iso_country,
+                group: group,
                 granularity: granularity,
                 start_time: start_time,
                 end_time: end_time,
@@ -113,8 +143,19 @@ module Twilio
           ##
           # Retrieve a single page of UsageRecordInstance records from the API.
           # Request is executed immediately.
-          # @param [String] sim SID of a Sim resource. Only show UsageRecords representing
-          #   usage incurred by this Super SIM.
+          # @param [String] sim SID or unique name of a Sim resource. Only show UsageRecords
+          #   representing usage incurred by this Super SIM.
+          # @param [String] fleet SID or unique name of a Fleet resource. Only show
+          #   UsageRecords representing usage for Super SIMs belonging to this Fleet resource
+          #   at the time the usage occurred.
+          # @param [String] network SID of a Network resource. Only show UsageRecords
+          #   representing usage on this network.
+          # @param [String] iso_country Alpha-2 ISO Country Code. Only show UsageRecords
+          #   representing usage in this country.
+          # @param [usage_record.Group] group Dimension over which to aggregate usage
+          #   records. Can be: `sim`, `fleet`, `network`, `isoCountry`. Default is to not
+          #   aggregate across any of these dimensions, UsageRecords will be aggregated into
+          #   the time buckets described by the `Granularity` parameter.
           # @param [usage_record.Granularity] granularity Time-based grouping that
           #   UsageRecords should be aggregated by. Can be: `hour`, `day`, or `all`. Default
           #   is `all`. `all` returns one UsageRecord that describes the usage for the entire
@@ -129,9 +170,13 @@ module Twilio
           # @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 UsageRecordInstance
-          def page(sim: :unset, granularity: :unset, start_time: :unset, end_time: :unset, page_token: :unset, page_number: :unset, page_size: :unset)
+          def page(sim: :unset, fleet: :unset, network: :unset, iso_country: :unset, group: :unset, granularity: :unset, start_time: :unset, end_time: :unset, page_token: :unset, page_number: :unset, page_size: :unset)
             params = Twilio::Values.of({
                 'Sim' => sim,
+                'Fleet' => fleet,
+                'Network' => network,
+                'IsoCountry' => iso_country,
+                'Group' => group,
                 'Granularity' => granularity,
                 'StartTime' => Twilio.serialize_iso8601_datetime(start_time),
                 'EndTime' => Twilio.serialize_iso8601_datetime(end_time),
@@ -211,6 +256,9 @@ module Twilio
             @properties = {
                 'account_sid' => payload['account_sid'],
                 'sim_sid' => payload['sim_sid'],
+                'network_sid' => payload['network_sid'],
+                'fleet_sid' => payload['fleet_sid'],
+                'iso_country' => payload['iso_country'],
                 'period' => payload['period'],
                 'data_upload' => payload['data_upload'].to_i,
                 'data_download' => payload['data_download'].to_i,
@@ -230,6 +278,24 @@ module Twilio
             @properties['sim_sid']
           end
 
+          ##
+          # @return [String] SID of the Network resource on which the usage occurred.
+          def network_sid
+            @properties['network_sid']
+          end
+
+          ##
+          # @return [String] SID of the Fleet resource on which the usage occurred.
+          def fleet_sid
+            @properties['fleet_sid']
+          end
+
+          ##
+          # @return [String] Alpha-2 ISO Country Code of the country the usage occurred in.
+          def iso_country
+            @properties['iso_country']
+          end
+
           ##
           # @return [Hash] The time period for which the usage is reported.
           def period

data/lib/twilio-ruby/rest/video/v1/room/room_participant/room_participant_subscribe_rule.rb

@@ -12,8 +12,6 @@ module Twilio
       class V1 < Version
         class RoomContext < InstanceContext
           class ParticipantContext < InstanceContext
-            ##
-            # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
             class SubscribeRulesList < ListResource
               ##
               # Initialize the SubscribeRulesList
@@ -71,8 +69,6 @@ module Twilio
               end
             end
 
-            ##
-            # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
             class SubscribeRulesPage < Page
               ##
               # Initialize the SubscribeRulesPage
@@ -107,8 +103,6 @@ module Twilio
               end
             end
 
-            ##
-            # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
             class SubscribeRulesInstance < InstanceResource
               ##
               # Initialize the SubscribeRulesInstance

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

@@ -31,10 +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 date that the record ended, given as GMT in [ISO
-            #   8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.
-            # @param [Time] start The date that the Data Session started, given as GMT in [ISO
-            #   8601](https://www.iso.org/iso-8601-date-and-time-format.html) 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
@@ -42,18 +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 date that the record ended, given as GMT in [ISO
-            #   8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.
-            # @param [Time] start The date that the Data Session started, given as GMT in [ISO
-            #   8601](https://www.iso.org/iso-8601-date-and-time-format.html) 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
@@ -61,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
@@ -86,18 +78,12 @@ module Twilio
             ##
             # Retrieve a single page of DataSessionInstance records from the API.
             # Request is executed immediately.
-            # @param [Time] end_ The date that the record ended, given as GMT in [ISO
-            #   8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.
-            # @param [Time] start The date that the Data Session started, given as GMT in [ISO
-            #   8601](https://www.iso.org/iso-8601-date-and-time-format.html) 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
             # @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,

data/lib/twilio-ruby/version.rb

@@ -1,3 +1,3 @@
 module Twilio
-    VERSION = '5.39.3'
+    VERSION = '5.40.0'
 end

data/spec/integration/events/v1/sink/sink_test_spec.rb

@@ -0,0 +1,42 @@
+##
+# This code was generated by
+# \ / _    _  _|   _  _
+#  | (_)\/(_)(_|\/| |(/_  v1.0.0
+#       /       /
+#
+# frozen_string_literal: true
+
+require 'spec_helper.rb'
+
+describe 'SinkTest' do
+  it "can create" do
+    @holodeck.mock(Twilio::Response.new(500, ''))
+
+    expect {
+      @client.events.v1.sinks('DGXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX') \
+                       .sink_test.create()
+    }.to raise_exception(Twilio::REST::TwilioError)
+
+    expect(
+    @holodeck.has_request?(Holodeck::Request.new(
+        method: 'post',
+        url: 'https://events.twilio.com/v1/Sinks/DGXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Test',
+    ))).to eq(true)
+  end
+
+  it "receives create responses" do
+    @holodeck.mock(Twilio::Response.new(
+        201,
+      %q[
+      {
+          "result": "valid"
+      }
+      ]
+    ))
+
+    actual = @client.events.v1.sinks('DGXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX') \
+                              .sink_test.create()
+
+    expect(actual).to_not eq(nil)
+  end
+end

data/spec/integration/events/v1/sink/sink_validate_spec.rb

@@ -0,0 +1,44 @@
+##
+# This code was generated by
+# \ / _    _  _|   _  _
+#  | (_)\/(_)(_|\/| |(/_  v1.0.0
+#       /       /
+#
+# frozen_string_literal: true
+
+require 'spec_helper.rb'
+
+describe 'SinkValidate' do
+  it "can create" do
+    @holodeck.mock(Twilio::Response.new(500, ''))
+
+    expect {
+      @client.events.v1.sinks('DGXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX') \
+                       .sink_validate.create(test_id: 'test_id')
+    }.to raise_exception(Twilio::REST::TwilioError)
+
+    values = {'TestId' => 'test_id', }
+    expect(
+    @holodeck.has_request?(Holodeck::Request.new(
+        method: 'post',
+        url: 'https://events.twilio.com/v1/Sinks/DGXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Validate',
+        data: values,
+    ))).to eq(true)
+  end
+
+  it "receives create responses" do
+    @holodeck.mock(Twilio::Response.new(
+        201,
+      %q[
+      {
+          "result": "valid"
+      }
+      ]
+    ))
+
+    actual = @client.events.v1.sinks('DGXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX') \
+                              .sink_validate.create(test_id: 'test_id')
+
+    expect(actual).to_not eq(nil)
+  end
+end

data/spec/integration/events/v1/sink_spec.rb

@@ -0,0 +1,217 @@
+##
+# This code was generated by
+# \ / _    _  _|   _  _
+#  | (_)\/(_)(_|\/| |(/_  v1.0.0
+#       /       /
+#
+# frozen_string_literal: true
+
+require 'spec_helper.rb'
+
+describe 'Sink' do
+  it "can fetch" do
+    @holodeck.mock(Twilio::Response.new(500, ''))
+
+    expect {
+      @client.events.v1.sinks('DGXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX').fetch()
+    }.to raise_exception(Twilio::REST::TwilioError)
+
+    expect(
+    @holodeck.has_request?(Holodeck::Request.new(
+        method: 'get',
+        url: 'https://events.twilio.com/v1/Sinks/DGXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX',
+    ))).to eq(true)
+  end
+
+  it "receives fetch responses" do
+    @holodeck.mock(Twilio::Response.new(
+        200,
+      %q[
+      {
+          "status": "initialized",
+          "sink_configuration": {},
+          "description": "description",
+          "sid": "DGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+          "date_created": "2015-07-30T20:00:00Z",
+          "sink_type": "kinesis",
+          "date_updated": "2015-07-30T20:00:00Z",
+          "url": "https://events.twilio.com/v1/Sinks/DGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+          "links": {
+              "sink_test": "https://events.twilio.com/v1/Sinks/DGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Test",
+              "sink_validate": "https://events.twilio.com/v1/Sinks/DGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Validate"
+          }
+      }
+      ]
+    ))
+
+    actual = @client.events.v1.sinks('DGXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX').fetch()
+
+    expect(actual).to_not eq(nil)
+  end
+
+  it "can create" do
+    @holodeck.mock(Twilio::Response.new(500, ''))
+
+    expect {
+      @client.events.v1.sinks.create(description: 'description', sink_configuration: {}, sink_type: 'kinesis')
+    }.to raise_exception(Twilio::REST::TwilioError)
+
+    values = {
+        'Description' => 'description',
+        'SinkConfiguration' => Twilio.serialize_object({}),
+        'SinkType' => 'kinesis',
+    }
+    expect(
+    @holodeck.has_request?(Holodeck::Request.new(
+        method: 'post',
+        url: 'https://events.twilio.com/v1/Sinks',
+        data: values,
+    ))).to eq(true)
+  end
+
+  it "receives create responses" do
+    @holodeck.mock(Twilio::Response.new(
+        201,
+      %q[
+      {
+          "status": "initialized",
+          "sink_configuration": {
+              "arn": "4242",
+              "role_arn": "abc123",
+              "external_id": "010101"
+          },
+          "description": "description",
+          "sid": "DGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+          "date_created": "2015-07-30T20:00:00Z",
+          "sink_type": "kinesis",
+          "date_updated": "2015-07-30T20:00:00Z",
+          "url": "https://events.twilio.com/v1/Sinks/DGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+          "links": {
+              "sink_test": "https://events.twilio.com/v1/Sinks/DGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Test",
+              "sink_validate": "https://events.twilio.com/v1/Sinks/DGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Validate"
+          }
+      }
+      ]
+    ))
+
+    actual = @client.events.v1.sinks.create(description: 'description', sink_configuration: {}, sink_type: 'kinesis')
+
+    expect(actual).to_not eq(nil)
+  end
+
+  it "can delete" do
+    @holodeck.mock(Twilio::Response.new(500, ''))
+
+    expect {
+      @client.events.v1.sinks('DGXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX').delete()
+    }.to raise_exception(Twilio::REST::TwilioError)
+
+    expect(
+    @holodeck.has_request?(Holodeck::Request.new(
+        method: 'delete',
+        url: 'https://events.twilio.com/v1/Sinks/DGXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX',
+    ))).to eq(true)
+  end
+
+  it "receives delete responses" do
+    @holodeck.mock(Twilio::Response.new(
+        204,
+      nil,
+    ))
+
+    actual = @client.events.v1.sinks('DGXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX').delete()
+
+    expect(actual).to eq(true)
+  end
+
+  it "can read" do
+    @holodeck.mock(Twilio::Response.new(500, ''))
+
+    expect {
+      @client.events.v1.sinks.list()
+    }.to raise_exception(Twilio::REST::TwilioError)
+
+    expect(
+    @holodeck.has_request?(Holodeck::Request.new(
+        method: 'get',
+        url: 'https://events.twilio.com/v1/Sinks',
+    ))).to eq(true)
+  end
+
+  it "receives read_empty responses" do
+    @holodeck.mock(Twilio::Response.new(
+        200,
+      %q[
+      {
+          "sinks": [],
+          "meta": {
+              "page": 0,
+              "page_size": 10,
+              "first_page_url": "https://events.twilio.com/v1/Sinks?PageSize=10&Page=0",
+              "previous_page_url": null,
+              "url": "https://events.twilio.com/v1/Sinks?PageSize=10&Page=0",
+              "next_page_url": null,
+              "key": "sinks"
+          }
+      }
+      ]
+    ))
+
+    actual = @client.events.v1.sinks.list()
+
+    expect(actual).to_not eq(nil)
+  end
+
+  it "receives read_results responses" do
+    @holodeck.mock(Twilio::Response.new(
+        200,
+      %q[
+      {
+          "sinks": [
+              {
+                  "status": "initialized",
+                  "sink_configuration": {},
+                  "description": "A Sink",
+                  "sid": "DGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+                  "date_created": "2015-07-30T20:00:00Z",
+                  "sink_type": "kinesis",
+                  "date_updated": "2015-07-30T20:00:00Z",
+                  "url": "https://events.twilio.com/v1/Sinks/DGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+                  "links": {
+                      "sink_test": "https://events.twilio.com/v1/Sinks/DGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Test",
+                      "sink_validate": "https://events.twilio.com/v1/Sinks/DGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Validate"
+                  }
+              },
+              {
+                  "status": "initialized",
+                  "sink_configuration": {},
+                  "description": "ANOTHER Sink",
+                  "sid": "DGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaab",
+                  "date_created": "2015-07-30T20:00:00Z",
+                  "sink_type": "kinesis",
+                  "date_updated": "2015-07-30T20:00:00Z",
+                  "url": "https://events.twilio.com/v1/Sinks/DGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaab",
+                  "links": {
+                      "sink_test": "https://events.twilio.com/v1/Sinks/DGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaab/Test",
+                      "sink_validate": "https://events.twilio.com/v1/Sinks/DGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaab/Validate"
+                  }
+              }
+          ],
+          "meta": {
+              "page": 0,
+              "page_size": 50,
+              "first_page_url": "https://events.twilio.com/v1/Sinks?PageSize=50&Page=0",
+              "previous_page_url": null,
+              "url": "https://events.twilio.com/v1/Sinks?PageSize=50&Page=0",
+              "next_page_url": null,
+              "key": "sinks"
+          }
+      }
+      ]
+    ))
+
+    actual = @client.events.v1.sinks.list()
+
+    expect(actual).to_not eq(nil)
+  end
+end