tencentcloud-sdk-tdmq 1.0.342 → 1.0.345

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 5c3c38778e055b4fae34d711de59391c4686e78d
-  data.tar.gz: b4cda181cacd8cd9aa88dbf9e43ebb0b8db4a6aa
+  metadata.gz: a7e94dacaff7cd81e34de71b36198f027b6d0dde
+  data.tar.gz: 4831d4e115f65d447987d847ec279a33efc420aa
 SHA512:
-  metadata.gz: 6d413152291b9311dec0c7e9dc89fb3c7d672d08b67134177a78a524906d25deb821520965880c41d0d59f5c7fe12abfd079bb25c195d57fbb8f4f4eb97b72ca
-  data.tar.gz: 7fbd4c0dd46c764f953da6fc02dd65721f206ccf62a19e0f1990e02e19ad863112a7fe931c02d508dae19006b44c787545a5d008d0f008620efc99839d5132c2
+  metadata.gz: f101a92551e3fe3b7d0ab4eb2201b340832950b4916f0959ed283760bbdc1d831c838c402403104353557aa940db5de18485df4ccfacb5c8316ed8eb06a391c9
+  data.tar.gz: 71c42536602b35ac86bbf96cb19b52360284e9b2a8fd27afedea49ef6c3bce9d4270391c581ed8a5bd3f64cc2ecc33b90789e2eaea2f0cf74799231dadf83dc3

data/lib/VERSION

@@ -1 +1 @@
-1.0.342
+1.0.345

data/lib/v20200217/client.rb

@@ -2165,7 +2165,26 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 接收发送到指定 topic 中的消息
+        # 接收发送到指定 topic 中的消息，当 Topic 中没有消息但还去尝试调用该接口时，会抛出 ReceiveTimeout 的异常。
+
+        # 如何使用 BatchReceivePolicy：
+
+        # BatchReceive 接口提供了如下三个参数：
+
+        # ● MaxNumMessages: 即每次使用 BatchReceive 的时候，最多一次Receive接口返回多少条消息。
+        # ● MaxNumBytes：即每次使用 BatchReceive 的时候，最多一次Receive接口返回多大内容的消息，单位是：bytes。
+        # ● Timeout：即每次使用 BatchReceive 的时候，最多一次 Receive 接口的超时时间是多久，单位是：MS。
+
+        # 默认如果上述三个参数都不指定，即关闭 BatchReceive 的特性。如果三个参数中的任意一个参数指定的数值大于 0，即开启 BatchReceive。BatchReceive 的结束条件为到达上述三个参数中任意一个指定的阈值。
+
+        # 注意：MaxNumMessages 和 MaxNumBytes 每一次接收的最大消息同时受限于 ReceiveQueueSize 的大小，如果 ReceiveQueueSize 的大小设置为 5，MaxNumMessages 设置为10，那么一次 BatchReceive 接收的最多的消息是 5条，而不是10条。
+
+
+
+        # BatchReceivePolicy 的接口会一次性返回多条消息：
+
+        # 1. 多条消息的内容之间使用特殊字符 '###' 来进行分割，业务侧接收到消息之后，可以利用不同语言提供的 Split 工具分割不同的消息。
+        # 2. 多条消息的 MessageID 之间使用特殊字符 '###' 来进行分割，业务侧接收到消息之后，可以利用不同语言提供的 Split 工具分割不同的消息。（用于在调用 AcknowledgeMessage 接口中填入所需要的 MessageID 字段信息）
 
         # @param request: Request instance for ReceiveMessage.
         # @type request: :class:`Tencentcloud::tdmq::V20200217::ReceiveMessageRequest`

data/lib/v20200217/models.rb

@@ -1747,7 +1747,7 @@ module TencentCloud
       class CreateEnvironmentRequest < TencentCloud::Common::AbstractModel
         # @param EnvironmentId: 环境（命名空间）名称，不支持中字以及除了短线和下划线外的特殊字符且不超过16个字符。
         # @type EnvironmentId: String
-        # @param MsgTTL: 未消费消息过期时间，单位：秒，最小60，最大1296000，（15天）。
+        # @param MsgTTL: 未消费消息过期时间，单位：秒，取值范围：60秒~1天。
         # @type MsgTTL: Integer
         # @param Remark: 说明，128个字符以内。
         # @type Remark: String
@@ -2170,11 +2170,12 @@ module TencentCloud
         # @type EnvironmentId: String
         # @param TopicName: 主题名，不支持中字以及除了短线和下划线外的特殊字符且不超过64个字符。
         # @type TopicName: String
-        # @param Partitions: 0：非分区topic，无分区；非0：具体分区topic的分区数，最大不允许超过128。
+        # @param Partitions: 入参为1，即是创建非分区topic，无分区；入参大于1，表示分区topic的分区数，最大不允许超过128。
         # @type Partitions: Integer
         # @param Remark: 备注，128字符以内。
         # @type Remark: String
-        # @param TopicType: 0： 普通消息；
+        # @param TopicType: 该入参将逐步弃用，可切换至PulsarTopicType参数
+        # 0： 普通消息；
         # 1 ：全局顺序消息；
         # 2 ：局部顺序消息；
         # 3 ：重试队列；
@@ -2218,7 +2219,7 @@ module TencentCloud
         # @type EnvironmentId: String
         # @param TopicName: 主题名。
         # @type TopicName: String
-        # @param Partitions: 0：非分区topic，无分区；非0：具体分区topic的分区数。
+        # @param Partitions: 0或1：非分区topic，无分区；大于1：具体分区topic的分区数。（存量非分区主题返回0，增量非分区主题返回1）
         # @type Partitions: Integer
         # @param Remark: 备注，128字符以内。
         # 注意：此字段可能返回 null，表示取不到有效值。
@@ -2228,7 +2229,6 @@ module TencentCloud
         # 2 ：局部顺序消息；
         # 3 ：重试队列；
         # 4 ：死信队列；
-        # 5 ：事务消息。
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type TopicType: Integer
         # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
@@ -5026,12 +5026,10 @@ module TencentCloud
         # @param Limit: 返回数量，不填则默认为10，最大值为20。
         # @type Limit: Integer
         # @param TopicType: topic类型描述：
-        # 0：普通消息；
-        # 1：全局顺序消息；
-        # 2：局部顺序消息；
-        # 3：重试队列；
-        # 4：死信队列；
-        # 5：事务消息。
+        # 0：非持久非分区主题类型；
+        # 1：非持久分区主题类型；
+        # 2：持久非分区主题类型；
+        # 3：持久分区主题类型；
         # @type TopicType: Integer
         # @param ClusterId: Pulsar 集群的ID
         # @type ClusterId: String
@@ -5040,10 +5038,14 @@ module TencentCloud
         # 类型：String
         # 必选：否
         # @type Filters: Array
+        # @param TopicCreator: 创建来源：
+        # 1：用户创建
+        # 2：系统创建
+        # @type TopicCreator: Integer
 
-        attr_accessor :EnvironmentId, :TopicName, :Offset, :Limit, :TopicType, :ClusterId, :Filters
+        attr_accessor :EnvironmentId, :TopicName, :Offset, :Limit, :TopicType, :ClusterId, :Filters, :TopicCreator
         
-        def initialize(environmentid=nil, topicname=nil, offset=nil, limit=nil, topictype=nil, clusterid=nil, filters=nil)
+        def initialize(environmentid=nil, topicname=nil, offset=nil, limit=nil, topictype=nil, clusterid=nil, filters=nil, topiccreator=nil)
           @EnvironmentId = environmentid
           @TopicName = topicname
           @Offset = offset
@@ -5051,6 +5053,7 @@ module TencentCloud
           @TopicType = topictype
           @ClusterId = clusterid
           @Filters = filters
+          @TopicCreator = topiccreator
         end
 
         def deserialize(params)
@@ -5068,6 +5071,7 @@ module TencentCloud
               @Filters << filter_tmp
             end
           end
+          @TopicCreator = params['TopicCreator']
         end
       end
 
@@ -5764,7 +5768,7 @@ module TencentCloud
       class ModifyEnvironmentAttributesRequest < TencentCloud::Common::AbstractModel
         # @param EnvironmentId: 命名空间名称。
         # @type EnvironmentId: String
-        # @param MsgTTL: 未消费消息过期时间，单位：秒，最大1296000。
+        # @param MsgTTL: 未消费消息过期时间，单位：秒，范围60秒~1天。
         # @type MsgTTL: Integer
         # @param Remark: 备注，字符串最长不超过128。
         # @type Remark: String
@@ -6357,14 +6361,23 @@ module TencentCloud
         # @type ReceiverQueueSize: Integer
         # @param SubInitialPosition: 默认值为：Latest。用作判定consumer初始接收消息的位置，可选参数为：Earliest, Latest
         # @type SubInitialPosition: String
+        # @param MaxNumMessages: 用于设置BatchReceivePolicy，指在一次batch中最多接收多少条消息，默认是 0。即不开启BatchReceivePolicy
+        # @type MaxNumMessages: Integer
+        # @param MaxNumBytes: 用于设置BatchReceivePolicy，指在一次batch中最多接收的消息体有多大，单位是 bytes。默认是 0，即不开启BatchReceivePolicy
+        # @type MaxNumBytes: Integer
+        # @param Timeout: 用于设置BatchReceivePolicy，指在一次batch消息的接收z中最多等待的超时时间，单位是毫秒。默认是 0，即不开启BatchReceivePolicy
+        # @type Timeout: Integer
 
-        attr_accessor :Topic, :SubscriptionName, :ReceiverQueueSize, :SubInitialPosition
+        attr_accessor :Topic, :SubscriptionName, :ReceiverQueueSize, :SubInitialPosition, :MaxNumMessages, :MaxNumBytes, :Timeout
         
-        def initialize(topic=nil, subscriptionname=nil, receiverqueuesize=nil, subinitialposition=nil)
+        def initialize(topic=nil, subscriptionname=nil, receiverqueuesize=nil, subinitialposition=nil, maxnummessages=nil, maxnumbytes=nil, timeout=nil)
           @Topic = topic
           @SubscriptionName = subscriptionname
           @ReceiverQueueSize = receiverqueuesize
           @SubInitialPosition = subinitialposition
+          @MaxNumMessages = maxnummessages
+          @MaxNumBytes = maxnumbytes
+          @Timeout = timeout
         end
 
         def deserialize(params)
@@ -6372,6 +6385,9 @@ module TencentCloud
           @SubscriptionName = params['SubscriptionName']
           @ReceiverQueueSize = params['ReceiverQueueSize']
           @SubInitialPosition = params['SubInitialPosition']
+          @MaxNumMessages = params['MaxNumMessages']
+          @MaxNumBytes = params['MaxNumBytes']
+          @Timeout = params['Timeout']
         end
       end
 
@@ -6389,17 +6405,25 @@ module TencentCloud
         # @param SubName: 返回订阅者的名字，用来创建 ack consumer时使用
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type SubName: String
+        # @param MessageIDList: BatchReceivePolicy 一次性返回的多条消息的 MessageID，用 ‘###’ 来区分不同的 MessageID
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type MessageIDList: String
+        # @param MessagesPayload: BatchReceivePolicy 一次性返回的多条消息的消息内容，用 ‘###’ 来区分不同的消息内容
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type MessagesPayload: String
         # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         # @type RequestId: String
 
-        attr_accessor :MessageID, :MessagePayload, :AckTopic, :ErrorMsg, :SubName, :RequestId
+        attr_accessor :MessageID, :MessagePayload, :AckTopic, :ErrorMsg, :SubName, :MessageIDList, :MessagesPayload, :RequestId
         
-        def initialize(messageid=nil, messagepayload=nil, acktopic=nil, errormsg=nil, subname=nil, requestid=nil)
+        def initialize(messageid=nil, messagepayload=nil, acktopic=nil, errormsg=nil, subname=nil, messageidlist=nil, messagespayload=nil, requestid=nil)
           @MessageID = messageid
           @MessagePayload = messagepayload
           @AckTopic = acktopic
           @ErrorMsg = errormsg
           @SubName = subname
+          @MessageIDList = messageidlist
+          @MessagesPayload = messagespayload
           @RequestId = requestid
         end
 
@@ -6409,6 +6433,8 @@ module TencentCloud
           @AckTopic = params['AckTopic']
           @ErrorMsg = params['ErrorMsg']
           @SubName = params['SubName']
+          @MessageIDList = params['MessageIDList']
+          @MessagesPayload = params['MessagesPayload']
           @RequestId = params['RequestId']
         end
       end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-tdmq
 version: !ruby/object:Gem::Version
-  version: 1.0.342
+  version: 1.0.345
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-06-26 00:00:00.000000000 Z
+date: 2022-06-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common