tencentcloud-sdk-postgres 3.0.627 → 3.0.628

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 809ff1d11b262ae906d769258cda823ddd9ebda3
-  data.tar.gz: db26f5a7238ad20c9c9b5abc290eb722ff81a864
+  metadata.gz: b2177359e6865b9bacd19a71824bb11f85a32955
+  data.tar.gz: 0dac2b70b8a96e6ea943eb526d8224dd77388c6e
 SHA512:
-  metadata.gz: 01340824e13ddc5a3316b68cfdd157aafa39af99ec3504aabad3425653917bc8505059dae897bf0e0a7d5a3fcfa2a90eeaea811ffbbeb45a5b0670a8be6a149a
-  data.tar.gz: bb444748b1f6b3706e88fd40f9c97021892d2649fc91f6c01cd8fece2f1875eb354ee0fc19ff25192a3bfcf1637c5001f69fd12c3138b28203209035794c702d
+  metadata.gz: 3e5494524d07ef2524e9e19cf369d3f40e8f9493120699ae0f891ac66e5a242be64a7740e15a2fb0c10c089fef4faa6a272a184fa24a63489cd252b29cdb5249
+  data.tar.gz: a48ded629258e649f92af2b48c9443f360362f699b8755f56481b9013de20bbd6f8b29a764c2ed748dc7fc729ba435872acf806e548089eeea5df91abdba330b

data/lib/VERSION

@@ -1 +1 @@
-3.0.627
+3.0.628

data/lib/v20170312/client.rb

@@ -823,6 +823,32 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 本接口（DescribeDBInstanceHAConfig）用于查询实例HA配置信息。其中HA配置信息包括：
+        # <li>允许备节点切换为主节点的条件配置
+        # <li>半同步实例使用同步复制或异步复制的条件配置
+
+        # @param request: Request instance for DescribeDBInstanceHAConfig.
+        # @type request: :class:`Tencentcloud::postgres::V20170312::DescribeDBInstanceHAConfigRequest`
+        # @rtype: :class:`Tencentcloud::postgres::V20170312::DescribeDBInstanceHAConfigResponse`
+        def DescribeDBInstanceHAConfig(request)
+          body = send_request('DescribeDBInstanceHAConfig', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = DescribeDBInstanceHAConfigResponse.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
+
         # 本接口（DescribeDBInstanceAttribute）用于查询实例的参数信息。
 
         # @param request: Request instance for DescribeDBInstanceParameters.
@@ -1639,6 +1665,32 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 本接口（ModifyDBInstanceHAConfig）用于修改实例HA配置信息。其中HA配置信息包括：
+        # <li>允许备节点切换为主节点的条件配置
+        # <li>半同步实例使用同步复制或异步复制的条件配置
+
+        # @param request: Request instance for ModifyDBInstanceHAConfig.
+        # @type request: :class:`Tencentcloud::postgres::V20170312::ModifyDBInstanceHAConfigRequest`
+        # @rtype: :class:`Tencentcloud::postgres::V20170312::ModifyDBInstanceHAConfigResponse`
+        def ModifyDBInstanceHAConfig(request)
+          body = send_request('ModifyDBInstanceHAConfig', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = ModifyDBInstanceHAConfigResponse.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
+
         # 本接口（ModifyDBInstanceName）用于修改postgresql实例名字。
 
         # @param request: Request instance for ModifyDBInstanceName.
@@ -2047,6 +2099,33 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 本接口（SwitchDBInstancePrimary）用于切换实例主备关系。
+        # <li>通过主动发起切换，可以验证业务能否正确处理实例主备切换的场景
+        # <li>通过使用强制切换，可以在备节点延迟不满足切换条件时，强制发起主从切换
+        # <li>只有主实例可以执行该操作
+
+        # @param request: Request instance for SwitchDBInstancePrimary.
+        # @type request: :class:`Tencentcloud::postgres::V20170312::SwitchDBInstancePrimaryRequest`
+        # @rtype: :class:`Tencentcloud::postgres::V20170312::SwitchDBInstancePrimaryResponse`
+        def SwitchDBInstancePrimary(request)
+          body = send_request('SwitchDBInstancePrimary', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = SwitchDBInstancePrimaryResponse.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
+
         # 本接口（UpgradeDBInstance）用于升级实例配置。本接口已废弃，推荐使用接口[ModifyDBInstanceSpec](https://cloud.tencent.com/document/api/409/63689)替代。
 
         # @param request: Request instance for UpgradeDBInstance.

data/lib/v20170312/models.rb

@@ -2800,6 +2800,72 @@ module TencentCloud
         end
       end
 
+      # DescribeDBInstanceHAConfig请求参数结构体
+      class DescribeDBInstanceHAConfigRequest < TencentCloud::Common::AbstractModel
+        # @param DBInstanceId: 实例ID
+        # @type DBInstanceId: String
+
+        attr_accessor :DBInstanceId
+
+        def initialize(dbinstanceid=nil)
+          @DBInstanceId = dbinstanceid
+        end
+
+        def deserialize(params)
+          @DBInstanceId = params['DBInstanceId']
+        end
+      end
+
+      # DescribeDBInstanceHAConfig返回参数结构体
+      class DescribeDBInstanceHAConfigResponse < TencentCloud::Common::AbstractModel
+        # @param SyncMode: 主从同步方式：
+        # <li>Semi-sync：半同步
+        # <li>Async：异步
+        # @type SyncMode: String
+        # @param MaxStandbyLatency: 高可用备机最大延迟数据量。备节点延迟数据量小于等于该值，且备节点延迟时间小于等于MaxStandbyLag时，可以切换为主节点。
+        # <li>单位：byte
+        # <li>参数范围：[1073741824, 322122547200]
+        # @type MaxStandbyLatency: Integer
+        # @param MaxStandbyLag: 高可用备机最大延迟时间。备节点延迟时间小于等于该值，且备节点延迟数据量小于等于MaxStandbyLatency时，可以切换为主节点。
+        # <li>单位：s
+        # <li>参数范围：[5, 10]
+        # @type MaxStandbyLag: Integer
+        # @param MaxSyncStandbyLatency: 同步备机最大延迟数据量。备机延迟数据量小于等于该值，且该备机延迟时间小于等于MaxSyncStandbyLag时，则该备机采用同步复制；否则，采用异步复制。
+        # 该参数值针对SyncMode设置为Semi-sync的实例有效。
+        # 异步实例该字段返回null。
+        # 半同步实例禁止退化为异步复制时，该字段返回null。
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type MaxSyncStandbyLatency: Integer
+        # @param MaxSyncStandbyLag: 同步备机最大延迟时间。备机延迟时间小于等于该值，且该备机延迟数据量小于等于MaxSyncStandbyLatency时，则该备机采用同步复制；否则，采用异步复制。
+        # 该参数值针对SyncMode设置为Semi-sync的实例有效。
+        # 异步实例不返回该字段。
+        # 半同步实例禁止退化为异步复制时，不返回该字段。
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type MaxSyncStandbyLag: Integer
+        # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :SyncMode, :MaxStandbyLatency, :MaxStandbyLag, :MaxSyncStandbyLatency, :MaxSyncStandbyLag, :RequestId
+
+        def initialize(syncmode=nil, maxstandbylatency=nil, maxstandbylag=nil, maxsyncstandbylatency=nil, maxsyncstandbylag=nil, requestid=nil)
+          @SyncMode = syncmode
+          @MaxStandbyLatency = maxstandbylatency
+          @MaxStandbyLag = maxstandbylag
+          @MaxSyncStandbyLatency = maxsyncstandbylatency
+          @MaxSyncStandbyLag = maxsyncstandbylag
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @SyncMode = params['SyncMode']
+          @MaxStandbyLatency = params['MaxStandbyLatency']
+          @MaxStandbyLag = params['MaxStandbyLag']
+          @MaxSyncStandbyLatency = params['MaxSyncStandbyLatency']
+          @MaxSyncStandbyLag = params['MaxSyncStandbyLag']
+          @RequestId = params['RequestId']
+        end
+      end
+
       # DescribeDBInstanceParameters请求参数结构体
       class DescribeDBInstanceParametersRequest < TencentCloud::Common::AbstractModel
         # @param DBInstanceId: 实例ID
@@ -4954,6 +5020,70 @@ module TencentCloud
         end
       end
 
+      # ModifyDBInstanceHAConfig请求参数结构体
+      class ModifyDBInstanceHAConfigRequest < TencentCloud::Common::AbstractModel
+        # @param DBInstanceId: 实例ID
+        # @type DBInstanceId: String
+        # @param SyncMode: 主从同步方式：
+        # <li>Semi-sync：半同步
+        # <li>Async：异步
+        # @type SyncMode: String
+        # @param MaxStandbyLatency: 高可用备机最大延迟数据量。备节点延迟数据量小于等于该值，且备节点延迟时间小于等于MaxStandbyLag时，可以切换为主节点。
+        # <li>单位：byte
+        # <li>参数范围：[1073741824, 322122547200]
+        # @type MaxStandbyLatency: Integer
+        # @param MaxStandbyLag: 高可用备机最大延迟时间。备节点延迟时间小于等于该值，且备节点延迟数据量小于等于MaxStandbyLatency时，可以切换为主节点。
+        # <li>单位：s
+        # <li>参数范围：[5, 10]
+        # @type MaxStandbyLag: Integer
+        # @param MaxSyncStandbyLatency: 同步备机最大延迟数据量。备机延迟数据量小于等于该值，且该备机延迟时间小于等于MaxSyncStandbyLag时，则该备机采用同步复制；否则，采用异步复制。
+        # 该参数值针对SyncMode设置为Semi-sync的实例有效。
+        # 半同步实例禁止退化为异步复制时，不设置MaxSyncStandbyLatency、MaxSyncStandbyLag。
+        # 半同步实例允许退化异步复制时，PostgreSQL 9版本的实例须设置MaxSyncStandbyLatency且不设置MaxSyncStandbyLag，PostgreSQL 10及以上版本的实例须设置MaxSyncStandbyLatency、MaxSyncStandbyLag。
+        # @type MaxSyncStandbyLatency: Integer
+        # @param MaxSyncStandbyLag: 同步备机最大延迟时间。备机延迟时间小于等于该值，且该备机延迟数据量小于等于MaxSyncStandbyLatency时，则该备机采用同步复制；否则，采用异步复制。
+        # 该参数值针对SyncMode设置为Semi-sync的实例有效。
+        # 半同步实例禁止退化为异步复制时，不设置MaxSyncStandbyLatency、MaxSyncStandbyLag。
+        # 半同步实例允许退化异步复制时，PostgreSQL 9版本的实例须设置MaxSyncStandbyLatency且不设置MaxSyncStandbyLag，PostgreSQL 10及以上版本的实例须设置MaxSyncStandbyLatency、MaxSyncStandbyLag，
+        # @type MaxSyncStandbyLag: Integer
+
+        attr_accessor :DBInstanceId, :SyncMode, :MaxStandbyLatency, :MaxStandbyLag, :MaxSyncStandbyLatency, :MaxSyncStandbyLag
+
+        def initialize(dbinstanceid=nil, syncmode=nil, maxstandbylatency=nil, maxstandbylag=nil, maxsyncstandbylatency=nil, maxsyncstandbylag=nil)
+          @DBInstanceId = dbinstanceid
+          @SyncMode = syncmode
+          @MaxStandbyLatency = maxstandbylatency
+          @MaxStandbyLag = maxstandbylag
+          @MaxSyncStandbyLatency = maxsyncstandbylatency
+          @MaxSyncStandbyLag = maxsyncstandbylag
+        end
+
+        def deserialize(params)
+          @DBInstanceId = params['DBInstanceId']
+          @SyncMode = params['SyncMode']
+          @MaxStandbyLatency = params['MaxStandbyLatency']
+          @MaxStandbyLag = params['MaxStandbyLag']
+          @MaxSyncStandbyLatency = params['MaxSyncStandbyLatency']
+          @MaxSyncStandbyLag = params['MaxSyncStandbyLag']
+        end
+      end
+
+      # ModifyDBInstanceHAConfig返回参数结构体
+      class ModifyDBInstanceHAConfigResponse < 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
+
       # ModifyDBInstanceName请求参数结构体
       class ModifyDBInstanceNameRequest < TencentCloud::Common::AbstractModel
         # @param DBInstanceId: 数据库实例ID，形如postgres-6fego161
@@ -6718,6 +6848,59 @@ module TencentCloud
         end
       end
 
+      # SwitchDBInstancePrimary请求参数结构体
+      class SwitchDBInstancePrimaryRequest < TencentCloud::Common::AbstractModel
+        # @param DBInstanceId: 实例ID
+        # @type DBInstanceId: String
+        # @param Force: 是否强制切换。强制切换时只要备节点可访问，无论主备延迟多大都会发起切换。只有SwitchTag为0时，才可使用立即切换。
+        # <li>默认：false
+        # @type Force: Boolean
+        # @param SwitchTag: 指定实例配置完成变更后的切换时间。
+        # <li>0：立即切换
+        # <li>1：指定时间切换
+        # <li>2：维护时间窗口内切换
+        # <li>默认值：0
+        # @type SwitchTag: Integer
+        # @param SwitchStartTime: 切换开始时间，时间格式：HH:MM:SS，例如：01:00:00。当SwitchTag为0或2时，该参数失效。
+        # @type SwitchStartTime: String
+        # @param SwitchEndTime: 切换截止时间，时间格式：HH:MM:SS，例如：01:30:00。当SwitchTag为0或2时，该参数失效。SwitchStartTime和SwitchEndTime时间窗口不能小于30分钟。
+        # @type SwitchEndTime: String
+
+        attr_accessor :DBInstanceId, :Force, :SwitchTag, :SwitchStartTime, :SwitchEndTime
+
+        def initialize(dbinstanceid=nil, force=nil, switchtag=nil, switchstarttime=nil, switchendtime=nil)
+          @DBInstanceId = dbinstanceid
+          @Force = force
+          @SwitchTag = switchtag
+          @SwitchStartTime = switchstarttime
+          @SwitchEndTime = switchendtime
+        end
+
+        def deserialize(params)
+          @DBInstanceId = params['DBInstanceId']
+          @Force = params['Force']
+          @SwitchTag = params['SwitchTag']
+          @SwitchStartTime = params['SwitchStartTime']
+          @SwitchEndTime = params['SwitchEndTime']
+        end
+      end
+
+      # SwitchDBInstancePrimary返回参数结构体
+      class SwitchDBInstancePrimaryResponse < 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
+
       # 实例绑定的标签信息，包含标签键TagKey和标签值TagValue
       class Tag < TencentCloud::Common::AbstractModel
         # @param TagKey: 标签键

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-postgres
 version: !ruby/object:Gem::Version
-  version: 3.0.627
+  version: 3.0.628
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-08-03 00:00:00.000000000 Z
+date: 2023-08-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common