tencentcloud-sdk-clb 3.0.1169 → 3.0.1183

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: ccc8c63928a75a1c5a90296757d496d4e88cc435
-  data.tar.gz: f36147e7a195e4ee0a047a825c0ecd7150284fa1
+  metadata.gz: ce14ce7fb36120b22b5d52ccdcb86062748c0ab7
+  data.tar.gz: 92c530466ecd8f7f97645154496ae338a402481a
 SHA512:
-  metadata.gz: 28b729f20c984914b239a24c2252bde8800ff9d23f1133cbad2edf1a2942bad0f1a544dc6000e2912e0d197f28b1371800521371df01d555cd9baea32937f248
-  data.tar.gz: 6dbf96e03b42ca596f448f7d2d67d3f39a1da65c7e20b7167c69d5fa0a16ec871a7d0a9fbd8578474918752ee47ff7543e60d04b65e78f7be2ad4b2ce4783372
+  metadata.gz: ec230868a96698301cc68f903b5986bf50f5f86751d921bbcc29b98b92bd9f779ff6392ad4e2615450c9d2976f8b5fa1558d44845b27ef576267df30c7cc7e9b
+  data.tar.gz: 9be0f2eb46f464feaef7c5a27d9ab803d24903947ae4ebfc7fb77335ce5a66abe7bb6bd833e8f3a67d17ae1b11309637d9dc982abeafc286cf916914c1199711

data/lib/VERSION

@@ -1 +1 @@
-3.0.1169
+3.0.1183

data/lib/v20180317/client.rb

@@ -1255,6 +1255,30 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 查询目标组后端服务状态。目前仅支持网关负载均衡类型的目标组支持查询后端服务状态。
+
+        # @param request: Request instance for DescribeTargetGroupInstanceStatus.
+        # @type request: :class:`Tencentcloud::clb::V20180317::DescribeTargetGroupInstanceStatusRequest`
+        # @rtype: :class:`Tencentcloud::clb::V20180317::DescribeTargetGroupInstanceStatusResponse`
+        def DescribeTargetGroupInstanceStatus(request)
+          body = send_request('DescribeTargetGroupInstanceStatus', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = DescribeTargetGroupInstanceStatusResponse.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 DescribeTargetGroupInstances.

data/lib/v20180317/models.rb

@@ -164,6 +164,32 @@ module TencentCloud
         end
       end
 
+      # 可用区转发亲和信息
+      class AvailableZoneAffinityInfo < TencentCloud::Common::AbstractModel
+        # @param Enable: 是否开启可用区转发亲和。true：开启可用区转发亲和；false：开启可用区转发亲和。
+        # @type Enable: Boolean
+        # @param ExitRatio: 可用区转发亲和失效阈值，当可用区内后端服务健康比例小于该阈值时，负载均衡会退出可用区转发亲和，转为全可用区转发。
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type ExitRatio: Integer
+        # @param ReentryRatio: 可用区转发亲和的重新生效阈值，当处于全可用区转发，且负载均衡可用区内的后端服务健康比例大于等于该阈值时，负载均衡会重新进入可用区转发亲和。
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type ReentryRatio: Integer
+
+        attr_accessor :Enable, :ExitRatio, :ReentryRatio
+
+        def initialize(enable=nil, exitratio=nil, reentryratio=nil)
+          @Enable = enable
+          @ExitRatio = exitratio
+          @ReentryRatio = reentryratio
+        end
+
+        def deserialize(params)
+          @Enable = params['Enable']
+          @ExitRatio = params['ExitRatio']
+          @ReentryRatio = params['ReentryRatio']
+        end
+      end
+
       # 监听器绑定的后端服务的详细信息
       class Backend < TencentCloud::Common::AbstractModel
         # @param Type: 后端服务的类型，可取：CVM、ENI、CCN、EVM、GLOBALROUTE、NAT、SRV等
@@ -189,10 +215,13 @@ module TencentCloud
         # @type EniId: String
         # @param Tag: 标签。
         # @type Tag: String
+        # @param Zone: 后端服务所在的可用区，如ap-guangzhou-1
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type Zone: String
 
-        attr_accessor :Type, :InstanceId, :Port, :Weight, :PublicIpAddresses, :PrivateIpAddresses, :InstanceName, :RegisteredTime, :EniId, :Tag
+        attr_accessor :Type, :InstanceId, :Port, :Weight, :PublicIpAddresses, :PrivateIpAddresses, :InstanceName, :RegisteredTime, :EniId, :Tag, :Zone
 
-        def initialize(type=nil, instanceid=nil, port=nil, weight=nil, publicipaddresses=nil, privateipaddresses=nil, instancename=nil, registeredtime=nil, eniid=nil, tag=nil)
+        def initialize(type=nil, instanceid=nil, port=nil, weight=nil, publicipaddresses=nil, privateipaddresses=nil, instancename=nil, registeredtime=nil, eniid=nil, tag=nil, zone=nil)
           @Type = type
           @InstanceId = instanceid
           @Port = port
@@ -203,6 +232,7 @@ module TencentCloud
           @RegisteredTime = registeredtime
           @EniId = eniid
           @Tag = tag
+          @Zone = zone
         end
 
         def deserialize(params)
@@ -216,6 +246,7 @@ module TencentCloud
           @RegisteredTime = params['RegisteredTime']
           @EniId = params['EniId']
           @Tag = params['Tag']
+          @Zone = params['Zone']
         end
       end
 
@@ -1286,8 +1317,8 @@ module TencentCloud
 
         attr_accessor :LogsetName, :Period, :LogsetType
         extend Gem::Deprecate
-        deprecate :Period, :none, 2025, 11
-        deprecate :Period=, :none, 2025, 11
+        deprecate :Period, :none, 2025, 12
+        deprecate :Period=, :none, 2025, 12
 
         def initialize(logsetname=nil, period=nil, logsettype=nil)
           @LogsetName = logsetname
@@ -3938,6 +3969,53 @@ module TencentCloud
         end
       end
 
+      # DescribeTargetGroupInstanceStatus请求参数结构体
+      class DescribeTargetGroupInstanceStatusRequest < TencentCloud::Common::AbstractModel
+        # @param TargetGroupId: 目标组唯一id
+        # @type TargetGroupId: String
+        # @param TargetGroupInstanceIps: 目标组绑定的后端服务ip列表
+        # @type TargetGroupInstanceIps: Array
+
+        attr_accessor :TargetGroupId, :TargetGroupInstanceIps
+
+        def initialize(targetgroupid=nil, targetgroupinstanceips=nil)
+          @TargetGroupId = targetgroupid
+          @TargetGroupInstanceIps = targetgroupinstanceips
+        end
+
+        def deserialize(params)
+          @TargetGroupId = params['TargetGroupId']
+          @TargetGroupInstanceIps = params['TargetGroupInstanceIps']
+        end
+      end
+
+      # DescribeTargetGroupInstanceStatus返回参数结构体
+      class DescribeTargetGroupInstanceStatusResponse < TencentCloud::Common::AbstractModel
+        # @param TargetGroupInstanceSet: 健康检查后端rs状态列表
+        # @type TargetGroupInstanceSet: Array
+        # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :TargetGroupInstanceSet, :RequestId
+
+        def initialize(targetgroupinstanceset=nil, requestid=nil)
+          @TargetGroupInstanceSet = targetgroupinstanceset
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          unless params['TargetGroupInstanceSet'].nil?
+            @TargetGroupInstanceSet = []
+            params['TargetGroupInstanceSet'].each do |i|
+              targetgroupinstancestatus_tmp = TargetGroupInstanceStatus.new
+              targetgroupinstancestatus_tmp.deserialize(i)
+              @TargetGroupInstanceSet << targetgroupinstancestatus_tmp
+            end
+          end
+          @RequestId = params['RequestId']
+        end
+      end
+
       # DescribeTargetGroupInstances请求参数结构体
       class DescribeTargetGroupInstancesRequest < TencentCloud::Common::AbstractModel
         # @param Filters: 过滤条件，当前支持按照 TargetGroupId，BindIP，InstanceId 多个条件组合过滤。
@@ -5514,13 +5592,15 @@ module TencentCloud
         # @type TargetCount: Integer
         # @param AssociateEndpoint: 负载均衡实例关联的Endpoint id。
         # @type AssociateEndpoint: String
+        # @param AvailableZoneAffinityInfo: 可用区转发亲和信息
+        # @type AvailableZoneAffinityInfo: :class:`Tencentcloud::Clb.v20180317.models.AvailableZoneAffinityInfo`
 
-        attr_accessor :LoadBalancerId, :LoadBalancerName, :LoadBalancerType, :Forward, :Domain, :LoadBalancerVips, :Status, :CreateTime, :StatusTime, :ProjectId, :VpcId, :OpenBgp, :Snat, :Isolation, :Log, :SubnetId, :Tags, :SecureGroups, :TargetRegionInfo, :AnycastZone, :AddressIPVersion, :NumericalVpcId, :VipIsp, :MasterZone, :BackupZoneSet, :IsolatedTime, :ExpireTime, :ChargeType, :NetworkAttributes, :PrepaidAttributes, :LogSetId, :LogTopicId, :AddressIPv6, :ExtraInfo, :IsDDos, :ConfigId, :LoadBalancerPassToTarget, :ExclusiveCluster, :IPv6Mode, :SnatPro, :SnatIps, :SlaType, :IsBlock, :IsBlockTime, :LocalBgp, :ClusterTag, :MixIpTarget, :Zones, :NfvInfo, :HealthLogSetId, :HealthLogTopicId, :ClusterIds, :AttributeFlags, :LoadBalancerDomain, :Egress, :Exclusive, :TargetCount, :AssociateEndpoint
+        attr_accessor :LoadBalancerId, :LoadBalancerName, :LoadBalancerType, :Forward, :Domain, :LoadBalancerVips, :Status, :CreateTime, :StatusTime, :ProjectId, :VpcId, :OpenBgp, :Snat, :Isolation, :Log, :SubnetId, :Tags, :SecureGroups, :TargetRegionInfo, :AnycastZone, :AddressIPVersion, :NumericalVpcId, :VipIsp, :MasterZone, :BackupZoneSet, :IsolatedTime, :ExpireTime, :ChargeType, :NetworkAttributes, :PrepaidAttributes, :LogSetId, :LogTopicId, :AddressIPv6, :ExtraInfo, :IsDDos, :ConfigId, :LoadBalancerPassToTarget, :ExclusiveCluster, :IPv6Mode, :SnatPro, :SnatIps, :SlaType, :IsBlock, :IsBlockTime, :LocalBgp, :ClusterTag, :MixIpTarget, :Zones, :NfvInfo, :HealthLogSetId, :HealthLogTopicId, :ClusterIds, :AttributeFlags, :LoadBalancerDomain, :Egress, :Exclusive, :TargetCount, :AssociateEndpoint, :AvailableZoneAffinityInfo
         extend Gem::Deprecate
-        deprecate :Log, :none, 2025, 11
-        deprecate :Log=, :none, 2025, 11
+        deprecate :Log, :none, 2025, 12
+        deprecate :Log=, :none, 2025, 12
 
-        def initialize(loadbalancerid=nil, loadbalancername=nil, loadbalancertype=nil, forward=nil, domain=nil, loadbalancervips=nil, status=nil, createtime=nil, statustime=nil, projectid=nil, vpcid=nil, openbgp=nil, snat=nil, isolation=nil, log=nil, subnetid=nil, tags=nil, securegroups=nil, targetregioninfo=nil, anycastzone=nil, addressipversion=nil, numericalvpcid=nil, vipisp=nil, masterzone=nil, backupzoneset=nil, isolatedtime=nil, expiretime=nil, chargetype=nil, networkattributes=nil, prepaidattributes=nil, logsetid=nil, logtopicid=nil, addressipv6=nil, extrainfo=nil, isddos=nil, configid=nil, loadbalancerpasstotarget=nil, exclusivecluster=nil, ipv6mode=nil, snatpro=nil, snatips=nil, slatype=nil, isblock=nil, isblocktime=nil, localbgp=nil, clustertag=nil, mixiptarget=nil, zones=nil, nfvinfo=nil, healthlogsetid=nil, healthlogtopicid=nil, clusterids=nil, attributeflags=nil, loadbalancerdomain=nil, egress=nil, exclusive=nil, targetcount=nil, associateendpoint=nil)
+        def initialize(loadbalancerid=nil, loadbalancername=nil, loadbalancertype=nil, forward=nil, domain=nil, loadbalancervips=nil, status=nil, createtime=nil, statustime=nil, projectid=nil, vpcid=nil, openbgp=nil, snat=nil, isolation=nil, log=nil, subnetid=nil, tags=nil, securegroups=nil, targetregioninfo=nil, anycastzone=nil, addressipversion=nil, numericalvpcid=nil, vipisp=nil, masterzone=nil, backupzoneset=nil, isolatedtime=nil, expiretime=nil, chargetype=nil, networkattributes=nil, prepaidattributes=nil, logsetid=nil, logtopicid=nil, addressipv6=nil, extrainfo=nil, isddos=nil, configid=nil, loadbalancerpasstotarget=nil, exclusivecluster=nil, ipv6mode=nil, snatpro=nil, snatips=nil, slatype=nil, isblock=nil, isblocktime=nil, localbgp=nil, clustertag=nil, mixiptarget=nil, zones=nil, nfvinfo=nil, healthlogsetid=nil, healthlogtopicid=nil, clusterids=nil, attributeflags=nil, loadbalancerdomain=nil, egress=nil, exclusive=nil, targetcount=nil, associateendpoint=nil, availablezoneaffinityinfo=nil)
           @LoadBalancerId = loadbalancerid
           @LoadBalancerName = loadbalancername
           @LoadBalancerType = loadbalancertype
@@ -5579,6 +5659,7 @@ module TencentCloud
           @Exclusive = exclusive
           @TargetCount = targetcount
           @AssociateEndpoint = associateendpoint
+          @AvailableZoneAffinityInfo = availablezoneaffinityinfo
         end
 
         def deserialize(params)
@@ -5679,6 +5760,10 @@ module TencentCloud
           @Exclusive = params['Exclusive']
           @TargetCount = params['TargetCount']
           @AssociateEndpoint = params['AssociateEndpoint']
+          unless params['AvailableZoneAffinityInfo'].nil?
+            @AvailableZoneAffinityInfo = AvailableZoneAffinityInfo.new
+            @AvailableZoneAffinityInfo.deserialize(params['AvailableZoneAffinityInfo'])
+          end
         end
       end
 
@@ -5809,10 +5894,13 @@ module TencentCloud
         # @param Exclusive: 0：表示非独占型实例，1：表示独占型态实例。
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type Exclusive: Integer
+        # @param AvailableZoneAffinityInfo: 可用区转发亲和信息
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type AvailableZoneAffinityInfo: :class:`Tencentcloud::Clb.v20180317.models.AvailableZoneAffinityInfo`
 
-        attr_accessor :LoadBalancerId, :LoadBalancerName, :LoadBalancerType, :Status, :Address, :AddressIPv6, :AddressIPVersion, :IPv6Mode, :Zone, :AddressIsp, :VpcId, :ProjectId, :CreateTime, :ChargeType, :NetworkAttributes, :PrepaidAttributes, :ExtraInfo, :ConfigId, :Tags, :ListenerId, :Protocol, :Port, :LocationId, :Domain, :Url, :TargetId, :TargetAddress, :TargetPort, :TargetWeight, :Isolation, :SecurityGroup, :LoadBalancerPassToTarget, :TargetHealth, :Domains, :SlaveZone, :Zones, :SniSwitch, :LoadBalancerDomain, :Egress, :AttributeFlags, :SlaType, :Exclusive
+        attr_accessor :LoadBalancerId, :LoadBalancerName, :LoadBalancerType, :Status, :Address, :AddressIPv6, :AddressIPVersion, :IPv6Mode, :Zone, :AddressIsp, :VpcId, :ProjectId, :CreateTime, :ChargeType, :NetworkAttributes, :PrepaidAttributes, :ExtraInfo, :ConfigId, :Tags, :ListenerId, :Protocol, :Port, :LocationId, :Domain, :Url, :TargetId, :TargetAddress, :TargetPort, :TargetWeight, :Isolation, :SecurityGroup, :LoadBalancerPassToTarget, :TargetHealth, :Domains, :SlaveZone, :Zones, :SniSwitch, :LoadBalancerDomain, :Egress, :AttributeFlags, :SlaType, :Exclusive, :AvailableZoneAffinityInfo
 
-        def initialize(loadbalancerid=nil, loadbalancername=nil, loadbalancertype=nil, status=nil, address=nil, addressipv6=nil, addressipversion=nil, ipv6mode=nil, zone=nil, addressisp=nil, vpcid=nil, projectid=nil, createtime=nil, chargetype=nil, networkattributes=nil, prepaidattributes=nil, extrainfo=nil, configid=nil, tags=nil, listenerid=nil, protocol=nil, port=nil, locationid=nil, domain=nil, url=nil, targetid=nil, targetaddress=nil, targetport=nil, targetweight=nil, isolation=nil, securitygroup=nil, loadbalancerpasstotarget=nil, targethealth=nil, domains=nil, slavezone=nil, zones=nil, sniswitch=nil, loadbalancerdomain=nil, egress=nil, attributeflags=nil, slatype=nil, exclusive=nil)
+        def initialize(loadbalancerid=nil, loadbalancername=nil, loadbalancertype=nil, status=nil, address=nil, addressipv6=nil, addressipversion=nil, ipv6mode=nil, zone=nil, addressisp=nil, vpcid=nil, projectid=nil, createtime=nil, chargetype=nil, networkattributes=nil, prepaidattributes=nil, extrainfo=nil, configid=nil, tags=nil, listenerid=nil, protocol=nil, port=nil, locationid=nil, domain=nil, url=nil, targetid=nil, targetaddress=nil, targetport=nil, targetweight=nil, isolation=nil, securitygroup=nil, loadbalancerpasstotarget=nil, targethealth=nil, domains=nil, slavezone=nil, zones=nil, sniswitch=nil, loadbalancerdomain=nil, egress=nil, attributeflags=nil, slatype=nil, exclusive=nil, availablezoneaffinityinfo=nil)
           @LoadBalancerId = loadbalancerid
           @LoadBalancerName = loadbalancername
           @LoadBalancerType = loadbalancertype
@@ -5855,6 +5943,7 @@ module TencentCloud
           @AttributeFlags = attributeflags
           @SlaType = slatype
           @Exclusive = exclusive
+          @AvailableZoneAffinityInfo = availablezoneaffinityinfo
         end
 
         def deserialize(params)
@@ -5916,6 +6005,10 @@ module TencentCloud
           @AttributeFlags = params['AttributeFlags']
           @SlaType = params['SlaType']
           @Exclusive = params['Exclusive']
+          unless params['AvailableZoneAffinityInfo'].nil?
+            @AvailableZoneAffinityInfo = AvailableZoneAffinityInfo.new
+            @AvailableZoneAffinityInfo.deserialize(params['AvailableZoneAffinityInfo'])
+          end
         end
       end
 
@@ -7566,10 +7659,10 @@ module TencentCloud
 
         attr_accessor :ListenerId, :Targets, :LocationId, :Domain, :Url, :Weight
         extend Gem::Deprecate
-        deprecate :Domain, :none, 2025, 11
-        deprecate :Domain=, :none, 2025, 11
-        deprecate :Url, :none, 2025, 11
-        deprecate :Url=, :none, 2025, 11
+        deprecate :Domain, :none, 2025, 12
+        deprecate :Domain=, :none, 2025, 12
+        deprecate :Url, :none, 2025, 12
+        deprecate :Url=, :none, 2025, 12
 
         def initialize(listenerid=nil, targets=nil, locationid=nil, domain=nil, url=nil, weight=nil)
           @ListenerId = listenerid
@@ -8627,6 +8720,43 @@ module TencentCloud
         end
       end
 
+      # 用于目标组后端rs健康检查状态。
+      class TargetGroupInstanceStatus < TencentCloud::Common::AbstractModel
+        # @param InstanceIp: 后端rs的IP
+        # @type InstanceIp: String
+        # @param Status: 健康检查状态，参数值及含义如下：
+        # ● on：表示探测中。
+        # ● off：表示健康检查关闭。
+        # ● health：表示健康。
+        # ● unhealth：表示异常。
+        # @type Status: String
+        # @param InstanceId: 实例ID
+        # @type InstanceId: String
+        # @param Port: 端口
+        # @type Port: Integer
+        # @param EniId: 网卡ID
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type EniId: String
+
+        attr_accessor :InstanceIp, :Status, :InstanceId, :Port, :EniId
+
+        def initialize(instanceip=nil, status=nil, instanceid=nil, port=nil, eniid=nil)
+          @InstanceIp = instanceip
+          @Status = status
+          @InstanceId = instanceid
+          @Port = port
+          @EniId = eniid
+        end
+
+        def deserialize(params)
+          @InstanceIp = params['InstanceIp']
+          @Status = params['Status']
+          @InstanceId = params['InstanceId']
+          @Port = params['Port']
+          @EniId = params['EniId']
+        end
+      end
+
       # 描述一个Target的健康信息
       class TargetHealth < TencentCloud::Common::AbstractModel
         # @param IP: Target的内网IP
@@ -8648,8 +8778,8 @@ module TencentCloud
 
         attr_accessor :IP, :Port, :HealthStatus, :TargetId, :HealthStatusDetail, :HealthStatusDetial, :TargetGroupId, :Weight
         extend Gem::Deprecate
-        deprecate :HealthStatusDetial, :none, 2025, 11
-        deprecate :HealthStatusDetial=, :none, 2025, 11
+        deprecate :HealthStatusDetial, :none, 2025, 12
+        deprecate :HealthStatusDetial=, :none, 2025, 12
 
         def initialize(ip=nil, port=nil, healthstatus=nil, targetid=nil, healthstatusdetail=nil, healthstatusdetial=nil, targetgroupid=nil, weight=nil)
           @IP = ip

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-clb
 version: !ruby/object:Gem::Version
-  version: 3.0.1169
+  version: 3.0.1183
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-11-19 00:00:00.000000000 Z
+date: 2025-12-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common
@@ -34,8 +34,8 @@ extensions: []
 extra_rdoc_files: []
 files:
 - lib/tencentcloud-sdk-clb.rb
-- lib/v20180317/client.rb
 - lib/v20180317/models.rb
+- lib/v20180317/client.rb
 - lib/VERSION
 homepage: https://github.com/TencentCloud/tencentcloud-sdk-ruby
 licenses: