tencentcloud-sdk-live 3.0.678 → 3.0.679

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 4b18286309209cd7ea5e2de934a637ff1812540c
-  data.tar.gz: d98e220f70ab85e66e13fe992236726dd1565178
+  metadata.gz: 2be8bf27280f64fbecff800dd6b7d6d6d43c8eb7
+  data.tar.gz: 85f2c2376f8f353ac563614f03d5ec2c80e06395
 SHA512:
-  metadata.gz: 427a608563fa8ce8122c4ebabe0de8cdfa1fa38464127e8cd41b3b08c94268d8e96ee6e184dee235d162704ffa93d56cbd924e9559d777bb57495c502333dd2e
-  data.tar.gz: fd37ee1eba05f09af1a12f75495c9e33377287d857eb097bee47c146b1439aa418e3245700c50b01cf4594f4bf3f109521a2dcf8b89f96c9be5ce7435b2c6ba7
+  metadata.gz: 7fea3b1b6704123fc5def57391dc83cee523638e5a260f7331f66be13594e6abda640e6e1a42829b76958416db43147a45b2ce0f6d0f943dadf6faa925bc983e
+  data.tar.gz: b064deb4835b43cb728a111c8378f5f15a004b6be0784dd6350a579d21bd04dccb62f1fff66cda1b7ee2d103c47c78165e9f18b7953637f466218b0e023c769b

data/lib/VERSION

@@ -1 +1 @@
-3.0.678
+3.0.679

data/lib/v20180801/client.rb

@@ -1243,6 +1243,34 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 返回正在直播中的流列表。适用于推流成功后查询在线流信息。
+
+        # 注意：
+        # 1. 该接口仅提供辅助查询在线流列表功能，业务重要场景不可强依赖该接口。
+        # 2. 该接口仅适用于流数少于2万路的情况，对于流数较大用户请联系售后。
+
+        # @param request: Request instance for DescribeBackupStreamList.
+        # @type request: :class:`Tencentcloud::live::V20180801::DescribeBackupStreamListRequest`
+        # @rtype: :class:`Tencentcloud::live::V20180801::DescribeBackupStreamListResponse`
+        def DescribeBackupStreamList(request)
+          body = send_request('DescribeBackupStreamList', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = DescribeBackupStreamListResponse.new
+            model.deserialize(response['Response'])
+            model
+          else
+            code = response['Response']['Error']['Code']
+            message = response['Response']['Error']['Message']
+            reqid = response['Response']['RequestId']
+            raise TencentCloud::Common::TencentCloudSDKException.new(code, message, reqid)
+          end
+        rescue TencentCloud::Common::TencentCloudSDKException => e
+          raise e
+        rescue StandardError => e
+          raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
+        end
+
         # 直播播放带宽和流量数据查询。
 
         # @param request: Request instance for DescribeBillBandwidthAndFluxList.
@@ -3091,6 +3119,31 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 启用择优调度。
+        # 注意：流维度的择优调度，当主备流结束后自动失效。
+
+        # @param request: Request instance for EnableOptimalSwitching.
+        # @type request: :class:`Tencentcloud::live::V20180801::EnableOptimalSwitchingRequest`
+        # @rtype: :class:`Tencentcloud::live::V20180801::EnableOptimalSwitchingResponse`
+        def EnableOptimalSwitching(request)
+          body = send_request('EnableOptimalSwitching', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = EnableOptimalSwitchingResponse.new
+            model.deserialize(response['Response'])
+            model
+          else
+            code = response['Response']['Error']['Code']
+            message = response['Response']['Error']['Message']
+            reqid = response['Response']['RequestId']
+            raise TencentCloud::Common::TencentCloudSDKException.new(code, message, reqid)
+          end
+        rescue TencentCloud::Common::TencentCloudSDKException => e
+          raise e
+        rescue StandardError => e
+          raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
+        end
+
         # 停止使用某个直播域名。
 
         # @param request: Request instance for ForbidLiveDomain.
@@ -3701,6 +3754,30 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 调用该接口实现切换当前播放所使用的主备流。
+
+        # @param request: Request instance for SwitchBackupStream.
+        # @type request: :class:`Tencentcloud::live::V20180801::SwitchBackupStreamRequest`
+        # @rtype: :class:`Tencentcloud::live::V20180801::SwitchBackupStreamResponse`
+        def SwitchBackupStream(request)
+          body = send_request('SwitchBackupStream', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = SwitchBackupStreamResponse.new
+            model.deserialize(response['Response'])
+            model
+          else
+            code = response['Response']['Error']['Code']
+            message = response['Response']['Error']['Message']
+            reqid = response['Response']['RequestId']
+            raise TencentCloud::Common::TencentCloudSDKException.new(code, message, reqid)
+          end
+        rescue TencentCloud::Common::TencentCloudSDKException => e
+          raise e
+        rescue StandardError => e
+          raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
+        end
+
         # 解绑域名证书
 
         # @param request: Request instance for UnBindLiveDomainCert.

data/lib/v20180801/models.rb

@@ -260,6 +260,96 @@ module TencentCloud
         end
       end
 
+      # 主备流详细信息。
+      class BackupStreamDetailData < TencentCloud::Common::AbstractModel
+        # @param DomainName: 推流域名。
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type DomainName: String
+        # @param AppName: 推流路径。
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type AppName: String
+        # @param PublishTime:  UTC 格式，例如：2018-06-29T19:00:00Z。
+        # 注意：和北京时间相差8小时。
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type PublishTime: String
+        # @param UpstreamSequence: 推流唯一标识。
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type UpstreamSequence: String
+        # @param SourceFrom: 推流来源。示例：
+        # 直推流；
+        # 拉流转推(1234)；
+        # 注意：拉流转推来源括号中为拉流转推的任务
+        #  ID。
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type SourceFrom: String
+        # @param MasterFlag: 主备标识。
+        # 当前流为主流：1，
+        # 当前流为备流: 0。
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type MasterFlag: Integer
+
+        attr_accessor :DomainName, :AppName, :PublishTime, :UpstreamSequence, :SourceFrom, :MasterFlag
+
+        def initialize(domainname=nil, appname=nil, publishtime=nil, upstreamsequence=nil, sourcefrom=nil, masterflag=nil)
+          @DomainName = domainname
+          @AppName = appname
+          @PublishTime = publishtime
+          @UpstreamSequence = upstreamsequence
+          @SourceFrom = sourcefrom
+          @MasterFlag = masterflag
+        end
+
+        def deserialize(params)
+          @DomainName = params['DomainName']
+          @AppName = params['AppName']
+          @PublishTime = params['PublishTime']
+          @UpstreamSequence = params['UpstreamSequence']
+          @SourceFrom = params['SourceFrom']
+          @MasterFlag = params['MasterFlag']
+        end
+      end
+
+      # 主备流分组信息。
+      class BackupStreamGroupInfo < TencentCloud::Common::AbstractModel
+        # @param StreamName: 流名称。
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type StreamName: String
+        # @param BackupList: 主备流信息。
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type BackupList: Array
+        # @param OptimalEnable: 是否对该流开启了择优调度。
+        # 0 - 未开启。
+        # 1 - 已开启。
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type OptimalEnable: Integer
+        # @param HostGroupName: 域名分组的分组名称。
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type HostGroupName: String
+
+        attr_accessor :StreamName, :BackupList, :OptimalEnable, :HostGroupName
+
+        def initialize(streamname=nil, backuplist=nil, optimalenable=nil, hostgroupname=nil)
+          @StreamName = streamname
+          @BackupList = backuplist
+          @OptimalEnable = optimalenable
+          @HostGroupName = hostgroupname
+        end
+
+        def deserialize(params)
+          @StreamName = params['StreamName']
+          unless params['BackupList'].nil?
+            @BackupList = []
+            params['BackupList'].each do |i|
+              backupstreamdetaildata_tmp = BackupStreamDetailData.new
+              backupstreamdetaildata_tmp.deserialize(i)
+              @BackupList << backupstreamdetaildata_tmp
+            end
+          end
+          @OptimalEnable = params['OptimalEnable']
+          @HostGroupName = params['HostGroupName']
+        end
+      end
+
       # 带宽信息
       class BandwidthInfo < TencentCloud::Common::AbstractModel
         # @param Time: 返回格式：
@@ -3437,6 +3527,50 @@ module TencentCloud
         end
       end
 
+      # DescribeBackupStreamList请求参数结构体
+      class DescribeBackupStreamListRequest < TencentCloud::Common::AbstractModel
+        # @param StreamName: 流名称，用于精确查询。
+        # @type StreamName: String
+
+        attr_accessor :StreamName
+
+        def initialize(streamname=nil)
+          @StreamName = streamname
+        end
+
+        def deserialize(params)
+          @StreamName = params['StreamName']
+        end
+      end
+
+      # DescribeBackupStreamList返回参数结构体
+      class DescribeBackupStreamListResponse < TencentCloud::Common::AbstractModel
+        # @param StreamInfoList: 主备流分组信息列表。
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type StreamInfoList: Array
+        # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :StreamInfoList, :RequestId
+
+        def initialize(streaminfolist=nil, requestid=nil)
+          @StreamInfoList = streaminfolist
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          unless params['StreamInfoList'].nil?
+            @StreamInfoList = []
+            params['StreamInfoList'].each do |i|
+              backupstreamgroupinfo_tmp = BackupStreamGroupInfo.new
+              backupstreamgroupinfo_tmp.deserialize(i)
+              @StreamInfoList << backupstreamgroupinfo_tmp
+            end
+          end
+          @RequestId = params['RequestId']
+        end
+      end
+
       # DescribeBillBandwidthAndFluxList请求参数结构体
       class DescribeBillBandwidthAndFluxListRequest < TencentCloud::Common::AbstractModel
         # @param StartTime: 起始时间点，接口查询支持两种时间格式：
@@ -8134,6 +8268,48 @@ module TencentCloud
         end
       end
 
+      # EnableOptimalSwitching请求参数结构体
+      class EnableOptimalSwitchingRequest < TencentCloud::Common::AbstractModel
+        # @param StreamName: 针对该流 ID 启用择优调度。
+        # @type StreamName: String
+        # @param EnableSwitch: 启用开关，默认为启用。
+        # 0 - 禁用。
+        # 1 - 启用。
+        # @type EnableSwitch: Integer
+        # @param HostGroupName: 要启用自动择优的流所属的域名分组名称。
+        # @type HostGroupName: String
+
+        attr_accessor :StreamName, :EnableSwitch, :HostGroupName
+
+        def initialize(streamname=nil, enableswitch=nil, hostgroupname=nil)
+          @StreamName = streamname
+          @EnableSwitch = enableswitch
+          @HostGroupName = hostgroupname
+        end
+
+        def deserialize(params)
+          @StreamName = params['StreamName']
+          @EnableSwitch = params['EnableSwitch']
+          @HostGroupName = params['HostGroupName']
+        end
+      end
+
+      # EnableOptimalSwitching返回参数结构体
+      class EnableOptimalSwitchingResponse < TencentCloud::Common::AbstractModel
+        # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :RequestId
+
+        def initialize(requestid=nil)
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @RequestId = params['RequestId']
+        end
+      end
+
       # flv格式特殊配置
       class FlvSpecialParam < TencentCloud::Common::AbstractModel
         # @param UploadInRecording: 是否开启边录边传，仅flv格式有效。
@@ -11729,6 +11905,50 @@ module TencentCloud
         end
       end
 
+      # SwitchBackupStream请求参数结构体
+      class SwitchBackupStreamRequest < TencentCloud::Common::AbstractModel
+        # @param PushDomainName: 推流域名。
+        # @type PushDomainName: String
+        # @param AppName: 应用名称。
+        # @type AppName: String
+        # @param StreamName: 流名称。
+        # @type StreamName: String
+        # @param UpstreamSequence: 查询接口获取到该流所有在推的上行 Sequence。指定要切到的目标上行 Sequence。
+        # @type UpstreamSequence: String
+
+        attr_accessor :PushDomainName, :AppName, :StreamName, :UpstreamSequence
+
+        def initialize(pushdomainname=nil, appname=nil, streamname=nil, upstreamsequence=nil)
+          @PushDomainName = pushdomainname
+          @AppName = appname
+          @StreamName = streamname
+          @UpstreamSequence = upstreamsequence
+        end
+
+        def deserialize(params)
+          @PushDomainName = params['PushDomainName']
+          @AppName = params['AppName']
+          @StreamName = params['StreamName']
+          @UpstreamSequence = params['UpstreamSequence']
+        end
+      end
+
+      # SwitchBackupStream返回参数结构体
+      class SwitchBackupStreamResponse < TencentCloud::Common::AbstractModel
+        # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :RequestId
+
+        def initialize(requestid=nil)
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @RequestId = params['RequestId']
+        end
+      end
+
       # 直播拉流任务状态信息。
       class TaskStatusInfo < TencentCloud::Common::AbstractModel
         # @param FileUrl: 当前使用的源 URL。

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-live
 version: !ruby/object:Gem::Version
-  version: 3.0.678
+  version: 3.0.679
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-10-17 00:00:00.000000000 Z
+date: 2023-10-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common
@@ -33,9 +33,9 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- lib/tencentcloud-sdk-live.rb
 - lib/v20180801/models.rb
 - lib/v20180801/client.rb
+- lib/tencentcloud-sdk-live.rb
 - lib/VERSION
 homepage: https://github.com/TencentCloud/tencentcloud-sdk-ruby
 licenses: