tencentcloud-sdk-mqtt 3.0.1013 → 3.0.1015

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 1993b168dd61441459b259367af6595fced25793
-  data.tar.gz: b9294249558d42caf01a91b57e4d7224fb2ac016
+  metadata.gz: 9f2b66726638d03730c699d7b4f416bcb1490c6d
+  data.tar.gz: 52c0e3ed8dd51db1cc052bdf73cc75352b72bbec
 SHA512:
-  metadata.gz: a674f37c87c2bf6a750ad7108026e1b9fa72700ede46cbebe1b2eb3fa2dca89c41baa0e53c4c52cc7fd954c5403a2d9e36c15d17d4cb70cb5e16683305fd204b
-  data.tar.gz: 6ec6b77afcc21adef3aa344f4bb706d400eded7d847146156a7c4987ecf875c91be3c2799f5787e7f6a3811e1867a2c6c42e8dadd25467904c3296e4ad1a06bd
+  metadata.gz: bc4fa4a3683d4c91aca5f3da668153d3006a28b9040d14d98bf4424834736ada5246430f4af60932b5b0f1f1af2431e5674b5d6fa2ae42615ff350f9a5bf78b1
+  data.tar.gz: fce1e5cae2a2aeaf8be0fb37d56c72cb49ef6458b49c6f65e630386bec942afd51ad8ac96605df54ff52a9999bb11303532b8781fb084a559b4f3229584c481a

data/lib/VERSION

@@ -1 +1 @@
-3.0.1013
+3.0.1015

data/lib/v20240516/client.rb

@@ -605,6 +605,30 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 查询 MQTT 客户端详情
+
+        # @param request: Request instance for DescribeClientList.
+        # @type request: :class:`Tencentcloud::mqtt::V20240516::DescribeClientListRequest`
+        # @rtype: :class:`Tencentcloud::mqtt::V20240516::DescribeClientListResponse`
+        def DescribeClientList(request)
+          body = send_request('DescribeClientList', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = DescribeClientListResponse.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 DescribeDeviceCertificate.
@@ -677,6 +701,30 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 查询MQTT实例公网接入点
+
+        # @param request: Request instance for DescribeInsVPCEndpoints.
+        # @type request: :class:`Tencentcloud::mqtt::V20240516::DescribeInsVPCEndpointsRequest`
+        # @rtype: :class:`Tencentcloud::mqtt::V20240516::DescribeInsVPCEndpointsResponse`
+        def DescribeInsVPCEndpoints(request)
+          body = send_request('DescribeInsVPCEndpoints', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = DescribeInsVPCEndpointsResponse.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 DescribeInstance.
@@ -730,6 +778,30 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 查询消息列表，如查询死信，请设置ConsumerGroup参数
+
+        # @param request: Request instance for DescribeMessageList.
+        # @type request: :class:`Tencentcloud::mqtt::V20240516::DescribeMessageListRequest`
+        # @rtype: :class:`Tencentcloud::mqtt::V20240516::DescribeMessageListResponse`
+        def DescribeMessageList(request)
+          body = send_request('DescribeMessageList', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = DescribeMessageListResponse.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 DescribeProductSKUList.
@@ -754,6 +826,30 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 查询共享订阅消息堆积量
+
+        # @param request: Request instance for DescribeSharedSubscriptionLag.
+        # @type request: :class:`Tencentcloud::mqtt::V20240516::DescribeSharedSubscriptionLagRequest`
+        # @rtype: :class:`Tencentcloud::mqtt::V20240516::DescribeSharedSubscriptionLagResponse`
+        def DescribeSharedSubscriptionLag(request)
+          body = send_request('DescribeSharedSubscriptionLag', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = DescribeSharedSubscriptionLagResponse.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
+
         # 查询mqtt主题详情
 
         # @param request: Request instance for DescribeTopic.

data/lib/v20240516/models.rb

@@ -1322,6 +1322,57 @@ module TencentCloud
         end
       end
 
+      # DescribeClientList请求参数结构体
+      class DescribeClientListRequest < TencentCloud::Common::AbstractModel
+        # @param InstanceId: 实例ID
+        # @type InstanceId: String
+        # @param ClientId: 客户端名
+        # @type ClientId: String
+        # @param Number: 客户端数量限制,最大1024，默认1024
+        # @type Number: String
+
+        attr_accessor :InstanceId, :ClientId, :Number
+
+        def initialize(instanceid=nil, clientid=nil, number=nil)
+          @InstanceId = instanceid
+          @ClientId = clientid
+          @Number = number
+        end
+
+        def deserialize(params)
+          @InstanceId = params['InstanceId']
+          @ClientId = params['ClientId']
+          @Number = params['Number']
+        end
+      end
+
+      # DescribeClientList返回参数结构体
+      class DescribeClientListResponse < TencentCloud::Common::AbstractModel
+        # @param Clients: 客户端列表
+        # @type Clients: Array
+        # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :Clients, :RequestId
+
+        def initialize(clients=nil, requestid=nil)
+          @Clients = clients
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          unless params['Clients'].nil?
+            @Clients = []
+            params['Clients'].each do |i|
+              mqttclientinfo_tmp = MQTTClientInfo.new
+              mqttclientinfo_tmp.deserialize(i)
+              @Clients << mqttclientinfo_tmp
+            end
+          end
+          @RequestId = params['RequestId']
+        end
+      end
+
       # DescribeDeviceCertificate请求参数结构体
       class DescribeDeviceCertificateRequest < TencentCloud::Common::AbstractModel
         # @param DeviceCertificateSn: 设备证书sn
@@ -1560,6 +1611,49 @@ module TencentCloud
         end
       end
 
+      # DescribeInsVPCEndpoints请求参数结构体
+      class DescribeInsVPCEndpointsRequest < TencentCloud::Common::AbstractModel
+        # @param InstanceId: 实例ID
+        # @type InstanceId: String
+
+        attr_accessor :InstanceId
+
+        def initialize(instanceid=nil)
+          @InstanceId = instanceid
+        end
+
+        def deserialize(params)
+          @InstanceId = params['InstanceId']
+        end
+      end
+
+      # DescribeInsVPCEndpoints返回参数结构体
+      class DescribeInsVPCEndpointsResponse < TencentCloud::Common::AbstractModel
+        # @param Endpoints: 接入点
+        # @type Endpoints: Array
+        # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :Endpoints, :RequestId
+
+        def initialize(endpoints=nil, requestid=nil)
+          @Endpoints = endpoints
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          unless params['Endpoints'].nil?
+            @Endpoints = []
+            params['Endpoints'].each do |i|
+              mqttendpointitem_tmp = MQTTEndpointItem.new
+              mqttendpointitem_tmp.deserialize(i)
+              @Endpoints << mqttendpointitem_tmp
+            end
+          end
+          @RequestId = params['RequestId']
+        end
+      end
+
       # DescribeInstanceList请求参数结构体
       class DescribeInstanceListRequest < TencentCloud::Common::AbstractModel
         # @param Filters: 查询条件列表,支持以下子弹
@@ -1765,6 +1859,83 @@ module TencentCloud
         end
       end
 
+      # DescribeMessageList请求参数结构体
+      class DescribeMessageListRequest < TencentCloud::Common::AbstractModel
+        # @param InstanceId: 实例ID
+        # @type InstanceId: String
+        # @param Topic: 主题
+        # @type Topic: String
+        # @param StartTime: 开始时间
+        # @type StartTime: Integer
+        # @param EndTime: 结束时间
+        # @type EndTime: Integer
+        # @param TaskRequestId: 请求任务id
+        # @type TaskRequestId: String
+        # @param Offset: 查询起始位置
+        # @type Offset: Integer
+        # @param Limit: 查询结果限制数量
+        # @type Limit: Integer
+
+        attr_accessor :InstanceId, :Topic, :StartTime, :EndTime, :TaskRequestId, :Offset, :Limit
+
+        def initialize(instanceid=nil, topic=nil, starttime=nil, endtime=nil, taskrequestid=nil, offset=nil, limit=nil)
+          @InstanceId = instanceid
+          @Topic = topic
+          @StartTime = starttime
+          @EndTime = endtime
+          @TaskRequestId = taskrequestid
+          @Offset = offset
+          @Limit = limit
+        end
+
+        def deserialize(params)
+          @InstanceId = params['InstanceId']
+          @Topic = params['Topic']
+          @StartTime = params['StartTime']
+          @EndTime = params['EndTime']
+          @TaskRequestId = params['TaskRequestId']
+          @Offset = params['Offset']
+          @Limit = params['Limit']
+        end
+      end
+
+      # DescribeMessageList返回参数结构体
+      class DescribeMessageListResponse < TencentCloud::Common::AbstractModel
+        # @param TotalCount: 查询总数
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type TotalCount: Integer
+        # @param Data: 消息记录列表
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type Data: Array
+        # @param TaskRequestId: 请求任务id
+        # @type TaskRequestId: String
+        # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :TotalCount, :Data, :TaskRequestId, :RequestId
+
+        def initialize(totalcount=nil, data=nil, taskrequestid=nil, requestid=nil)
+          @TotalCount = totalcount
+          @Data = data
+          @TaskRequestId = taskrequestid
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @TotalCount = params['TotalCount']
+          unless params['Data'].nil?
+            @Data = []
+            params['Data'].each do |i|
+              mqttmessageitem_tmp = MQTTMessageItem.new
+              mqttmessageitem_tmp.deserialize(i)
+              @Data << mqttmessageitem_tmp
+            end
+          end
+          @TaskRequestId = params['TaskRequestId']
+          @RequestId = params['RequestId']
+        end
+      end
+
       # DescribeProductSKUList请求参数结构体
       class DescribeProductSKUListRequest < TencentCloud::Common::AbstractModel
 
@@ -1809,6 +1980,46 @@ module TencentCloud
         end
       end
 
+      # DescribeSharedSubscriptionLag请求参数结构体
+      class DescribeSharedSubscriptionLagRequest < TencentCloud::Common::AbstractModel
+        # @param InstanceId: 集群id
+        # @type InstanceId: String
+        # @param SharedSubscription: 共享订阅表达式
+        # @type SharedSubscription: String
+
+        attr_accessor :InstanceId, :SharedSubscription
+
+        def initialize(instanceid=nil, sharedsubscription=nil)
+          @InstanceId = instanceid
+          @SharedSubscription = sharedsubscription
+        end
+
+        def deserialize(params)
+          @InstanceId = params['InstanceId']
+          @SharedSubscription = params['SharedSubscription']
+        end
+      end
+
+      # DescribeSharedSubscriptionLag返回参数结构体
+      class DescribeSharedSubscriptionLagResponse < TencentCloud::Common::AbstractModel
+        # @param Lag: 堆积值
+        # @type Lag: Integer
+        # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :Lag, :RequestId
+
+        def initialize(lag=nil, requestid=nil)
+          @Lag = lag
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @Lag = params['Lag']
+          @RequestId = params['RequestId']
+        end
+      end
+
       # DescribeTopicList请求参数结构体
       class DescribeTopicListRequest < TencentCloud::Common::AbstractModel
         # @param InstanceId: 实例ID
@@ -2160,6 +2371,98 @@ module TencentCloud
         end
       end
 
+      # MQTT客户端信息
+      class MQTTClientInfo < TencentCloud::Common::AbstractModel
+        # @param ClientId: 客户端唯一标识
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type ClientId: String
+        # @param ClientAddress: 客户端网络地址
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type ClientAddress: String
+        # @param ProtocolVersion: MQTT 协议版本，4 表示 MQTT 3.1.1
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type ProtocolVersion: Integer
+        # @param Keepalive: 保持连接时间，单位：秒
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type Keepalive: Integer
+        # @param ConnectionStatus: 连接状态，CONNECTED 已连接，DISCONNECTED 未连接
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type ConnectionStatus: String
+        # @param CreateTime: 客户端创建时间
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type CreateTime: Integer
+        # @param ConnectTime: 上次建立连接时间
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type ConnectTime: Integer
+        # @param DisconnectTime: 上次断开连接时间，仅对持久会话（cleanSession=false）并且客户端当前未连接时有意义
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type DisconnectTime: Integer
+        # @param MQTTClientSubscriptions: 客户端的订阅列表
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type MQTTClientSubscriptions: Array
+
+        attr_accessor :ClientId, :ClientAddress, :ProtocolVersion, :Keepalive, :ConnectionStatus, :CreateTime, :ConnectTime, :DisconnectTime, :MQTTClientSubscriptions
+
+        def initialize(clientid=nil, clientaddress=nil, protocolversion=nil, keepalive=nil, connectionstatus=nil, createtime=nil, connecttime=nil, disconnecttime=nil, mqttclientsubscriptions=nil)
+          @ClientId = clientid
+          @ClientAddress = clientaddress
+          @ProtocolVersion = protocolversion
+          @Keepalive = keepalive
+          @ConnectionStatus = connectionstatus
+          @CreateTime = createtime
+          @ConnectTime = connecttime
+          @DisconnectTime = disconnecttime
+          @MQTTClientSubscriptions = mqttclientsubscriptions
+        end
+
+        def deserialize(params)
+          @ClientId = params['ClientId']
+          @ClientAddress = params['ClientAddress']
+          @ProtocolVersion = params['ProtocolVersion']
+          @Keepalive = params['Keepalive']
+          @ConnectionStatus = params['ConnectionStatus']
+          @CreateTime = params['CreateTime']
+          @ConnectTime = params['ConnectTime']
+          @DisconnectTime = params['DisconnectTime']
+          unless params['MQTTClientSubscriptions'].nil?
+            @MQTTClientSubscriptions = []
+            params['MQTTClientSubscriptions'].each do |i|
+              mqttclientsubscription_tmp = MQTTClientSubscription.new
+              mqttclientsubscription_tmp.deserialize(i)
+              @MQTTClientSubscriptions << mqttclientsubscription_tmp
+            end
+          end
+        end
+      end
+
+      # MQTT 订阅关系
+      class MQTTClientSubscription < TencentCloud::Common::AbstractModel
+        # @param TopicFilter: topic 订阅
+        # @type TopicFilter: String
+        # @param Qos: 服务质量等级
+        # @type Qos: Integer
+        # @param Lag: 堆积数量
+        # @type Lag: Integer
+        # @param Inflight: 投递未确认数量
+        # @type Inflight: Integer
+
+        attr_accessor :TopicFilter, :Qos, :Lag, :Inflight
+
+        def initialize(topicfilter=nil, qos=nil, lag=nil, inflight=nil)
+          @TopicFilter = topicfilter
+          @Qos = qos
+          @Lag = lag
+          @Inflight = inflight
+        end
+
+        def deserialize(params)
+          @TopicFilter = params['TopicFilter']
+          @Qos = params['Qos']
+          @Lag = params['Lag']
+          @Inflight = params['Inflight']
+        end
+      end
+
       # MQTTEndpoint
       class MQTTEndpointItem < TencentCloud::Common::AbstractModel
         # @param Type: 类型
@@ -2325,6 +2628,63 @@ module TencentCloud
         end
       end
 
+      # 消息记录
+      class MQTTMessageItem < TencentCloud::Common::AbstractModel
+        # @param MsgId: 消息ID
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type MsgId: String
+        # @param Tags: 消息tag
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type Tags: String
+        # @param Keys: 消息key
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type Keys: String
+        # @param ProducerAddr: 客户端地址
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type ProducerAddr: String
+        # @param ProduceTime: 消息发送时间
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type ProduceTime: String
+        # @param DeadLetterResendTimes: 死信重发次数
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type DeadLetterResendTimes: Integer
+        # @param DeadLetterResendSuccessTimes: 死信重发成功次数
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type DeadLetterResendSuccessTimes: Integer
+        # @param SubTopic: 子topic
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type SubTopic: String
+        # @param Qos: 消息质量等级
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type Qos: String
+
+        attr_accessor :MsgId, :Tags, :Keys, :ProducerAddr, :ProduceTime, :DeadLetterResendTimes, :DeadLetterResendSuccessTimes, :SubTopic, :Qos
+
+        def initialize(msgid=nil, tags=nil, keys=nil, produceraddr=nil, producetime=nil, deadletterresendtimes=nil, deadletterresendsuccesstimes=nil, subtopic=nil, qos=nil)
+          @MsgId = msgid
+          @Tags = tags
+          @Keys = keys
+          @ProducerAddr = produceraddr
+          @ProduceTime = producetime
+          @DeadLetterResendTimes = deadletterresendtimes
+          @DeadLetterResendSuccessTimes = deadletterresendsuccesstimes
+          @SubTopic = subtopic
+          @Qos = qos
+        end
+
+        def deserialize(params)
+          @MsgId = params['MsgId']
+          @Tags = params['Tags']
+          @Keys = params['Keys']
+          @ProducerAddr = params['ProducerAddr']
+          @ProduceTime = params['ProduceTime']
+          @DeadLetterResendTimes = params['DeadLetterResendTimes']
+          @DeadLetterResendSuccessTimes = params['DeadLetterResendSuccessTimes']
+          @SubTopic = params['SubTopic']
+          @Qos = params['Qos']
+        end
+      end
+
       # MQTT 主题详情
       class MQTTTopicItem < TencentCloud::Common::AbstractModel
         # @param InstanceId: 实例 ID

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-mqtt
 version: !ruby/object:Gem::Version
-  version: 3.0.1013
+  version: 3.0.1015
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-03-07 00:00:00.000000000 Z
+date: 2025-03-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common