tencentcloud-sdk-tke 3.0.1160 → 3.0.1162

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 9efa633f1fc71d234ab2757831ba8b211c881606
-  data.tar.gz: 6be5514620ae3cba2229883eb500d331b9c69086
+  metadata.gz: 30c1c5bddacbc57b60b8f52d055deedd5eae2575
+  data.tar.gz: ea917ac122fca3a698d077143f094818f30737b8
 SHA512:
-  metadata.gz: e49bb2d2b877614f92d6114a408486222cd8219e3e2916d1f347a9dc12b981b1d4c31c01ff793af6e24813f56f2db58cd88b086005a4dd83e4a639d19d55e178
-  data.tar.gz: 0b093a26436372ef624684187d9eebd8e66534bbf29655c915e254af86cb24f52930c0429e7c69fc5e2b51efa4915dae06f2f23bbb7279b754071b56dd8ae0b9
+  metadata.gz: 425d200f5b2620f0194175b9a0c48919f3c517b30978fad3e3f20356429f98dc5e66444924fc48de3df78aff3c7389aed269a9be7f0b2258aba4eeeeaf95293b
+  data.tar.gz: e64f120f57f3f5a86119429a4fa136db15ba06ec8104ba624e6d46bfb3fbb293598b0ac10cd6c63954a8230aca1e220b6d97ca98aaa596f59b392f59e868c77f

data/lib/VERSION

@@ -1 +1 @@
-3.0.1160
+3.0.1162

data/lib/tencentcloud-sdk-tke.rb

@@ -2,12 +2,12 @@
 
 require 'tencentcloud-sdk-common'
 
-require_relative 'v20180525/client'
-require_relative 'v20180525/models'
-
 require_relative 'v20220501/client'
 require_relative 'v20220501/models'
 
+require_relative 'v20180525/client'
+require_relative 'v20180525/models'
+
 module TencentCloud
   module Tke
   end

data/lib/v20180525/client.rb

@@ -4493,7 +4493,7 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 修改集群属性
+        # 修改集群属性，至少选择一个参数更新
 
         # @param request: Request instance for ModifyClusterAttribute.
         # @type request: :class:`Tencentcloud::tke::V20180525::ModifyClusterAttributeRequest`
@@ -4613,7 +4613,7 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 修改集群及节点池纬度运行时配置
+        # 修改集群及节点池维度运行时配置
 
         # @param request: Request instance for ModifyClusterRuntimeConfig.
         # @type request: :class:`Tencentcloud::tke::V20180525::ModifyClusterRuntimeConfigRequest`

data/lib/v20180525/models.rb

@@ -91,9 +91,9 @@ module TencentCloud
 
       # AddExistedInstances请求参数结构体
       class AddExistedInstancesRequest < TencentCloud::Common::AbstractModel
-        # @param ClusterId: 集群ID
+        # @param ClusterId: 集群ID（请登录 [TKE 控制台](https://console.cloud.tencent.com/tke2) 获取集群 ID ）
         # @type ClusterId: String
-        # @param InstanceIds: 实例列表，不支持竞价实例
+        # @param InstanceIds: 实例列表，不支持竞价实例（请登录 [CVM控制台](https://console.cloud.tencent.com/cvm) 获取待添加节点ID ）
         # @type InstanceIds: Array
         # @param InstanceAdvancedSettings: 实例额外需要设置参数信息(默认值)
         # @type InstanceAdvancedSettings: :class:`Tencentcloud::Tke.v20180525.models.InstanceAdvancedSettings`
@@ -206,7 +206,7 @@ module TencentCloud
         # @type ClusterId: String
         # @param NodePoolId: 节点池id
         # @type NodePoolId: String
-        # @param InstanceIds: 节点id
+        # @param InstanceIds: 节点id，获取参考 https://cloud.tencent.com/document/product/213/15728
         # @type InstanceIds: Array
 
         attr_accessor :ClusterId, :NodePoolId, :InstanceIds
@@ -652,17 +652,22 @@ module TencentCloud
 
       # CheckInstancesUpgradeAble请求参数结构体
       class CheckInstancesUpgradeAbleRequest < TencentCloud::Common::AbstractModel
-        # @param ClusterId: 集群ID
+        # @param ClusterId: 集群ID（请登录 [TKE 控制台](https://console.cloud.tencent.com/tke2) 获取集群 ID ）
         # @type ClusterId: String
         # @param InstanceIds: 节点列表，空为全部节点
         # @type InstanceIds: Array
         # @param UpgradeType: 升级类型，枚举值：reset(重装升级，支持大版本和小版本)，hot(原地滚动小版本升级)，major(原地滚动大版本升级)
         # @type UpgradeType: String
-        # @param Offset: 分页Offset
+        # @param Offset: 偏移量，默认为0。关于 Offset 的更进一步介绍请参考 API [简介](https://cloud.tencent.com/document/api/213/15688)中的相关小节。
         # @type Offset: Integer
-        # @param Limit: 分页Limit
+        # @param Limit: 返回数量，默认为20，最大值为100。关于Limit的更进一步介绍请参考 API [简介](https://cloud.tencent.com/document/api/213/15688)中的相关小节。
         # @type Limit: Integer
-        # @param Filter: 过滤
+        # @param Filter: 过滤条件列表，Name 可选值为ip、instanceId、hostname、label
+
+        # - Name 为 ip 时，Value 为待查询节点 ip
+        # - Name 为 hostname 时，Value 为待查询节点名称
+        # - Name 为 label 时，Value 为待查询 K8S 节点 label
+        # - Name 为 instanceId 时，Value 为 待查询节点 id
         # @type Filter: Array
 
         attr_accessor :ClusterId, :InstanceIds, :UpgradeType, :Offset, :Limit, :Filter
@@ -781,15 +786,15 @@ module TencentCloud
         # @type ContainerRuntime: String
         # @param CreatedTime: 创建时间
         # @type CreatedTime: String
-        # @param DeletionProtection: 删除保护开关
+        # @param DeletionProtection: 集群删除保护开关，打开：true，关闭：false
         # @type DeletionProtection: Boolean
-        # @param EnableExternalNode: 集群是否开启第三方节点支持
+        # @param EnableExternalNode: 集群是否开启第三方节点支持，开启：true，关闭：false
         # @type EnableExternalNode: Boolean
         # @param ClusterLevel: 集群等级，针对托管集群生效
         # @type ClusterLevel: String
-        # @param AutoUpgradeClusterLevel: 自动变配集群等级，针对托管集群生效
+        # @param AutoUpgradeClusterLevel: 自动变配集群等级，针对托管集群生效。开启：true，关闭：false
         # @type AutoUpgradeClusterLevel: Boolean
-        # @param QGPUShareEnable: 是否开启QGPU共享
+        # @param QGPUShareEnable: 是否开启QGPU共享，开启：true，关闭：false
         # @type QGPUShareEnable: Boolean
         # @param RuntimeVersion: 运行时版本
         # @type RuntimeVersion: String
@@ -1082,10 +1087,10 @@ module TencentCloud
         # @param MaxTotalUnreadyPercentage: 未就绪节点的最大百分比，此后CA会停止操作
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type MaxTotalUnreadyPercentage: Integer
-        # @param ScaleDownUnreadyTime: 表示未准备就绪的节点在有资格进行缩减之前应该停留多长时间
+        # @param ScaleDownUnreadyTime: 表示未准备就绪的节点在有资格进行缩减之前应该停留多少分钟
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type ScaleDownUnreadyTime: Integer
-        # @param UnregisteredNodeRemovalTime: CA删除未在Kubernetes中注册的节点之前等待的时间
+        # @param UnregisteredNodeRemovalTime: CA删除未在Kubernetes中注册的节点之前等待的分钟数
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type UnregisteredNodeRemovalTime: Integer
 
@@ -1847,9 +1852,9 @@ module TencentCloud
       class CreateBackupStorageLocationRequest < TencentCloud::Common::AbstractModel
         # @param StorageRegion: 存储仓库所属地域，比如COS广州(ap-guangzhou)
         # @type StorageRegion: String
-        # @param Bucket: 对象存储桶名称，如果是COS必须是tke-backup前缀开头
+        # @param Bucket: 对象存储桶名称，如果是COS必须是tke-backup前缀开头，字符长度是19
         # @type Bucket: String
-        # @param Name: 备份仓库名称
+        # @param Name: 备份仓库名称，字符长度为63
         # @type Name: String
         # @param Provider: 存储服务提供方，默认腾讯云
         # @type Provider: String
@@ -1939,13 +1944,13 @@ module TencentCloud
       class CreateClusterEndpointRequest < TencentCloud::Common::AbstractModel
         # @param ClusterId: 集群ID
         # @type ClusterId: String
-        # @param SubnetId: 集群端口所在的子网ID  (仅在开启非外网访问时需要填，必须为集群所在VPC内的子网)
+        # @param SubnetId: 集群端口所在的子网ID  (仅在开启非外网访问时需要填，必须为集群所在VPC内的子网)。获取方式：https://cloud.tencent.com/document/product/215/15784
         # @type SubnetId: String
         # @param IsExtranet: 是否为外网访问（TRUE 外网访问 FALSE 内网访问，默认值： FALSE）
         # @type IsExtranet: Boolean
         # @param Domain: 设置域名
         # @type Domain: String
-        # @param SecurityGroup: 使用的安全组，只有外网访问需要传递（开启外网访问且不使用已有clb时必传）
+        # @param SecurityGroup: 使用的安全组，只有外网访问需要传递（开启外网访问且不使用已有clb时必传）。获取方式：https://cloud.tencent.com/document/api/215/15808
         # @type SecurityGroup: String
         # @param ExtensiveParameters: 创建lb参数，只有外网访问需要设置，是一个json格式化后的字符串：{"InternetAccessible":{"InternetChargeType":"TRAFFIC_POSTPAID_BY_HOUR","InternetMaxBandwidthOut":200},"VipIsp":"","BandwidthPackageId":""}。
         # 各个参数意义：
@@ -4100,22 +4105,25 @@ module TencentCloud
 
       # DeleteClusterInstances请求参数结构体
       class DeleteClusterInstancesRequest < TencentCloud::Common::AbstractModel
-        # @param ClusterId: 集群ID
+        # @param ClusterId: 集群ID（请登录 [TKE 控制台](https://console.cloud.tencent.com/tke2) 获取集群 ID ）
         # @type ClusterId: String
-        # @param InstanceIds: 主机InstanceId列表
+        # @param InstanceIds: 主机 InstanceId 列表
         # @type InstanceIds: Array
         # @param InstanceDeleteMode: 集群实例删除时的策略：terminate（销毁实例，仅支持按量计费云主机实例） retain （仅移除，保留实例）
         # @type InstanceDeleteMode: String
         # @param ForceDelete: 是否强制删除(当节点在初始化时，可以指定参数为TRUE)
         # @type ForceDelete: Boolean
+        # @param ResourceDeleteOptions: 集群删除时资源的删除策略，目前支持CBS（默认保留CBS）
+        # @type ResourceDeleteOptions: Array
 
-        attr_accessor :ClusterId, :InstanceIds, :InstanceDeleteMode, :ForceDelete
+        attr_accessor :ClusterId, :InstanceIds, :InstanceDeleteMode, :ForceDelete, :ResourceDeleteOptions
 
-        def initialize(clusterid=nil, instanceids=nil, instancedeletemode=nil, forcedelete=nil)
+        def initialize(clusterid=nil, instanceids=nil, instancedeletemode=nil, forcedelete=nil, resourcedeleteoptions=nil)
           @ClusterId = clusterid
           @InstanceIds = instanceids
           @InstanceDeleteMode = instancedeletemode
           @ForceDelete = forcedelete
+          @ResourceDeleteOptions = resourcedeleteoptions
         end
 
         def deserialize(params)
@@ -4123,6 +4131,14 @@ module TencentCloud
           @InstanceIds = params['InstanceIds']
           @InstanceDeleteMode = params['InstanceDeleteMode']
           @ForceDelete = params['ForceDelete']
+          unless params['ResourceDeleteOptions'].nil?
+            @ResourceDeleteOptions = []
+            params['ResourceDeleteOptions'].each do |i|
+              resourcedeleteoption_tmp = ResourceDeleteOption.new
+              resourcedeleteoption_tmp.deserialize(i)
+              @ResourceDeleteOptions << resourcedeleteoption_tmp
+            end
+          end
         end
       end
 
@@ -5170,9 +5186,9 @@ module TencentCloud
 
       # DescribeAvailableClusterVersion请求参数结构体
       class DescribeAvailableClusterVersionRequest < TencentCloud::Common::AbstractModel
-        # @param ClusterId: 集群 Id。若只查询某个集群可升级的版本，需填写此项。
+        # @param ClusterId: 集群 Id。若只查询某个集群可升级的版本，需填写此项，与ClusterIds 参数二选一。
         # @type ClusterId: String
-        # @param ClusterIds: 集群 Id 列表。若查询多个集群可升级的版本，需填写此项。
+        # @param ClusterIds: 集群 Id 列表。若查询多个集群可升级的版本，需填写此项，与ClusterId 参数二选一。
         # @type ClusterIds: Array
 
         attr_accessor :ClusterId, :ClusterIds
@@ -5637,7 +5653,7 @@ module TencentCloud
 
       # DescribeClusterEndpointStatus返回参数结构体
       class DescribeClusterEndpointStatusResponse < TencentCloud::Common::AbstractModel
-        # @param Status: 查询集群访问端口状态（Created 开启成功，Creating 开启中，NotFound 未开启）
+        # @param Status: 查询集群访问端口状态（Created 开启成功，Creating 开启中，NotFound 未开启，CreateFailed 开启失败）
         # @type Status: String
         # @param ErrorMsg: 开启访问入口失败信息
         # @type ErrorMsg: String
@@ -5883,15 +5899,20 @@ module TencentCloud
 
       # DescribeClusterInstances请求参数结构体
       class DescribeClusterInstancesRequest < TencentCloud::Common::AbstractModel
-        # @param ClusterId: 集群ID
+        # @param ClusterId: 集群ID（请登录 [TKE 控制台](https://console.cloud.tencent.com/tke2) 获取集群 ID ）
         # @type ClusterId: String
         # @param Offset: 偏移量，默认为0。关于Offset的更进一步介绍请参考 API [简介](https://cloud.tencent.com/document/api/213/15688)中的相关小节。
         # @type Offset: Integer
         # @param Limit: 返回数量，默认为20，最大值为100。关于Limit的更进一步介绍请参考 API [简介](https://cloud.tencent.com/document/api/213/15688)中的相关小节。
         # @type Limit: Integer
-        # @param InstanceIds: 需要获取的节点实例Id列表。如果为空，表示拉取集群下所有节点实例。
+        # @param InstanceIds: 需要获取的节点实例 ID 列表。如果为空，表示拉取集群下所有节点实例。普通节点用 CVM ID（如 ins-1cghhuuu ），原生节点用节点池内机器 ID （如 np-1ade4uid-0a2dc ）。
         # @type InstanceIds: Array
-        # @param InstanceRole: 节点角色, MASTER, WORKER, ETCD, MASTER_ETCD,ALL, 默认为WORKER。默认为WORKER类型。
+        # @param InstanceRole: 节点角色，默认为WORKER类型
+
+        # - WOKRER 集群内常规计算节点
+        # - MASTER 独立集群控制面组件节点
+        # - ETCD 独立集群 etcd 存储节点
+        # - MASTER_ETCD 独立集群控制面、etcd 共同部署的 master 节点
         # @type InstanceRole: String
         # @param Filters: 过滤条件列表；Name的可选值为nodepool-id、nodepool-instance-type；Name为nodepool-id表示根据节点池id过滤机器，Value的值为具体的节点池id，Name为nodepool-instance-type表示节点加入节点池的方式，Value的值为MANUALLY_ADDED（手动加入节点池）、AUTOSCALING_ADDED（伸缩组扩容方式加入节点池）、ALL（手动加入节点池 和 伸缩组扩容方式加入节点池）
         # @type Filters: Array
@@ -6805,7 +6826,7 @@ module TencentCloud
         # @type Limit: Integer
         # @param Filters: · "Name":"ClusterName","Values": ["test"] 按照【集群名】进行过滤。 类型：String 必选：否 · "Name":"ClusterType","Values": ["MANAGED_CLUSTER"] 按照【集群类型】进行过滤。 类型：String 必选：否 · "Name":"ClusterStatus","Values": ["Running"] 按照【集群状态】进行过滤。 类型：String 必选：否 · "Name":"vpc-id","Values": ["vpc-2wds9k9p"] 按照【VPC】进行过滤。 类型：String 必选：否 · "Name":"tag-key","Values": ["testKey"] 按照【标签键】进行过滤。 类型：String 必选：否 · "Name":"tag-value","Values": ["testValue"] 按照【标签值】进行过滤。 类型：String 必选：否 · "Name":"Tags","Values": ["product:tke"] 按照【标签键值对】进行过滤。 类型：String 必选：否
         # @type Filters: Array
-        # @param ClusterType: 集群类型，例如：MANAGED_CLUSTER
+        # @param ClusterType: 集群类型，托管集群：MANAGED_CLUSTER，独立集群：INDEPENDENT_CLUSTER。
         # @type ClusterType: String
 
         attr_accessor :ClusterIds, :Offset, :Limit, :Filters, :ClusterType
@@ -10018,11 +10039,11 @@ module TencentCloud
       class DescribeResourceUsageResponse < TencentCloud::Common::AbstractModel
         # @param CRDUsage: CRD使用量
         # @type CRDUsage: :class:`Tencentcloud::Tke.v20180525.models.ResourceUsage`
-        # @param PodUsage: Pod使用量
+        # @param PodUsage: Pod使用量，单位：个数
         # @type PodUsage: Integer
-        # @param RSUsage: ReplicaSet使用量
+        # @param RSUsage: ReplicaSet使用量，单位：个数
         # @type RSUsage: Integer
-        # @param ConfigMapUsage: ConfigMap使用量
+        # @param ConfigMapUsage: ConfigMap使用量，单位：个数
         # @type ConfigMapUsage: Integer
         # @param OtherUsage: 其他资源使用量
         # @type OtherUsage: :class:`Tencentcloud::Tke.v20180525.models.ResourceUsage`
@@ -12106,7 +12127,7 @@ module TencentCloud
 
       # GetClusterLevelPrice请求参数结构体
       class GetClusterLevelPriceRequest < TencentCloud::Common::AbstractModel
-        # @param ClusterLevel: 集群规格，托管集群询价
+        # @param ClusterLevel: 集群规格，托管集群询价，集群等级：L20、L50、L100、L200、L500、L1000、L3000、L5000
         # @type ClusterLevel: String
 
         attr_accessor :ClusterLevel
@@ -13270,12 +13291,18 @@ module TencentCloud
         # @type Name: String
         # @param Statistics: 诊断结果统计
         # @type Statistics: Array
+        # @param StartTime: 诊断数据开始时间
+        # @type StartTime: String
+        # @param EndTime: 诊断数据结束时间
+        # @type EndTime: String
 
-        attr_accessor :Name, :Statistics
+        attr_accessor :Name, :Statistics, :StartTime, :EndTime
 
-        def initialize(name=nil, statistics=nil)
+        def initialize(name=nil, statistics=nil, starttime=nil, endtime=nil)
           @Name = name
           @Statistics = statistics
+          @StartTime = starttime
+          @EndTime = endtime
         end
 
         def deserialize(params)
@@ -13288,6 +13315,8 @@ module TencentCloud
               @Statistics << kubejarvisstatestatistic_tmp
             end
           end
+          @StartTime = params['StartTime']
+          @EndTime = params['EndTime']
         end
       end
 
@@ -13366,7 +13395,12 @@ module TencentCloud
 
       # 集群巡检统计结果
       class KubeJarvisStateStatistic < TencentCloud::Common::AbstractModel
-        # @param HealthyLevel: 诊断结果的健康水平
+        # @param HealthyLevel: 诊断结果的健康水平，健康水平取值：
+        # serious：高风险
+        # risk：中风险
+        # warn：低风险
+        # good：健康
+        # failed：诊断流程异常
         # @type HealthyLevel: String
         # @param Count: 诊断结果的统计
         # @type Count: Integer
@@ -13407,6 +13441,9 @@ module TencentCloud
       # ListClusterInspectionResultsItems请求参数结构体
       class ListClusterInspectionResultsItemsRequest < TencentCloud::Common::AbstractModel
         # @param ClusterId: 目标集群ID
+
+        # 取值可参考：
+        # [查询TKE集群列表](https://cloud.tencent.com/document/api/457/31862)
         # @type ClusterId: String
         # @param StartTime: 查询历史结果的开始时间，Unix时间戳
         # @type StartTime: String
@@ -13687,11 +13724,11 @@ module TencentCloud
         # @type ClusterId: String
         # @param ProjectId: 集群所属项目
         # @type ProjectId: Integer
-        # @param ClusterName: 集群名称
+        # @param ClusterName: 集群名称,字符长度50
         # @type ClusterName: String
         # @param ClusterDesc: 集群描述
         # @type ClusterDesc: String
-        # @param ClusterLevel: 集群等级
+        # @param ClusterLevel: 集群等级，等级类型：L20、L50、L100、L200、L500、L1000、L3000、L5000
         # @type ClusterLevel: String
         # @param AutoUpgradeClusterLevel: 自动变配集群等级
         # @type AutoUpgradeClusterLevel: :class:`Tencentcloud::Tke.v20180525.models.AutoUpgradeClusterLevel`
@@ -13909,7 +13946,7 @@ module TencentCloud
         # @type ClusterId: String
         # @param NodePoolId: 节点池ID
         # @type NodePoolId: String
-        # @param Name: 名称
+        # @param Name: 名称，最长63个字符，只能包含小写字母、数字及分隔符“_”，且必须以小写字母开头，数字或小写字母结尾
         # @type Name: String
         # @param MaxNodesNum: 最大节点数
         # @type MaxNodesNum: Integer
@@ -14049,11 +14086,11 @@ module TencentCloud
       class ModifyClusterRuntimeConfigRequest < TencentCloud::Common::AbstractModel
         # @param ClusterId: 集群ID，必填
         # @type ClusterId: String
-        # @param DstK8SVersion: 当需要修改运行时版本是根据另外的K8S版本获取时，需填写。例如升级校验有冲突后修改场景
+        # @param DstK8SVersion: 运行时版本需依据指定的Kubernetes版本进行设置。典型情况为，在升级过程中因版本冲突而需要调整运行时版本时。
         # @type DstK8SVersion: String
-        # @param ClusterRuntimeConfig: 需要修改集群运行时时填写
+        # @param ClusterRuntimeConfig: 需要修改集群运行时填写
         # @type ClusterRuntimeConfig: :class:`Tencentcloud::Tke.v20180525.models.RuntimeConfig`
-        # @param NodePoolRuntimeConfig: 需要修改节点池运行时时，填需要修改的部分
+        # @param NodePoolRuntimeConfig: 需要修改节点池运行时，填需要修改的部分
         # @type NodePoolRuntimeConfig: Array
 
         attr_accessor :ClusterId, :DstK8SVersion, :ClusterRuntimeConfig, :NodePoolRuntimeConfig
@@ -14103,7 +14140,8 @@ module TencentCloud
       class ModifyClusterTagsRequest < TencentCloud::Common::AbstractModel
         # @param ClusterId: 集群ID
         # @type ClusterId: String
-        # @param Tags: 集群标签
+        # @param Tags: 集群标签:
+        # [{"TagKey":"env","TagValue":"dev"}]}]
         # @type Tags: Array
         # @param SyncSubresource: 是否同步集群内子资源标签
         # @type SyncSubresource: Boolean
@@ -14318,7 +14356,7 @@ module TencentCloud
         # @type ClusterId: String
         # @param NodePoolId: 节点池id
         # @type NodePoolId: String
-        # @param InstanceTypes: 机型列表，主实例机型不支持修改
+        # @param InstanceTypes: 机型列表，参考 https://cloud.tencent.com/document/product/213/11518，主实例机型不支持修改
         # @type InstanceTypes: Array
 
         attr_accessor :ClusterId, :NodePoolId, :InstanceTypes
@@ -15062,11 +15100,11 @@ module TencentCloud
       class NodePoolRuntime < TencentCloud::Common::AbstractModel
         # @param NodePoolId: 节点池ID
         # @type NodePoolId: String
-        # @param RuntimeType: 运行时类型
+        # @param RuntimeType: 运行时类型，参考：https://cloud.tencent.com/document/api/457/105241
         # @type RuntimeType: String
-        # @param RuntimeVersion: 运行时版本
+        # @param RuntimeVersion: 运行时版本，参考：https://cloud.tencent.com/document/api/457/105241
         # @type RuntimeVersion: String
-        # @param NodePoolName: 节点池名称
+        # @param NodePoolName: 节点池名称，限制 255 字符
         # @type NodePoolName: String
 
         attr_accessor :NodePoolId, :RuntimeType, :RuntimeVersion, :NodePoolName
@@ -17613,9 +17651,9 @@ module TencentCloud
 
       # 集群资源使用量
       class ResourceUsage < TencentCloud::Common::AbstractModel
-        # @param Name: 资源类型
+        # @param Name: 资源类型，参考k8s 官方资源
         # @type Name: String
-        # @param Usage: 资源使用量
+        # @param Usage: 资源使用量，单位：个数
         # @type Usage: Integer
         # @param Details: 资源使用详情
         # @type Details: Array
@@ -17943,9 +17981,9 @@ module TencentCloud
 
       # 运行时配置
       class RuntimeConfig < TencentCloud::Common::AbstractModel
-        # @param RuntimeType: 运行时类型
+        # @param RuntimeType: 运行时类型，支持的类型有 docker、containerd
         # @type RuntimeType: String
-        # @param RuntimeVersion: 运行时版本
+        # @param RuntimeVersion: 运行时版本，参考：https://cloud.tencent.com/document/api/457/105241
         # @type RuntimeVersion: String
 
         attr_accessor :RuntimeType, :RuntimeVersion
@@ -18870,9 +18908,9 @@ module TencentCloud
         # @type DstVersion: String
         # @param ExtraArgs: 集群自定义参数
         # @type ExtraArgs: :class:`Tencentcloud::Tke.v20180525.models.ClusterExtraArgs`
-        # @param MaxNotReadyPercent: 可容忍的最大不可用pod数目
+        # @param MaxNotReadyPercent: 可容忍的最大不可用pod数目。默认0
         # @type MaxNotReadyPercent: Float
-        # @param SkipPreCheck: 是否跳过预检查阶段
+        # @param SkipPreCheck: 是否跳过预检查阶段，默认false
         # @type SkipPreCheck: Boolean
 
         attr_accessor :ClusterId, :DstVersion, :ExtraArgs, :MaxNotReadyPercent, :SkipPreCheck
@@ -19324,7 +19362,7 @@ module TencentCloud
 
       # UpgradeClusterInstances请求参数结构体
       class UpgradeClusterInstancesRequest < TencentCloud::Common::AbstractModel
-        # @param ClusterId: 集群ID
+        # @param ClusterId: 集群ID（请登录 [TKE 控制台](https://console.cloud.tencent.com/tke2) 获取集群 ID ）
         # @type ClusterId: String
         # @param Operation: create 表示开始一次升级任务
         # pause 表示停止任务
@@ -19336,11 +19374,12 @@ module TencentCloud
         # hot 小版本热升级
         # major 大版本原地升级
         # @type UpgradeType: String
-        # @param InstanceIds: 需要升级的节点列表
+        # @param InstanceIds: 需要升级的节点列表，可以通过控制台或 [查询待升级节点接口
+        # ](https://cloud.tencent.com/document/api/457/50366) 获取
         # @type InstanceIds: Array
         # @param ResetParam: 当节点重新加入集群时候所使用的参数，参考添加已有节点接口
         # @type ResetParam: :class:`Tencentcloud::Tke.v20180525.models.UpgradeNodeResetParam`
-        # @param SkipPreCheck: 是否忽略节点升级前检查
+        # @param SkipPreCheck: 是否忽略节点升级前检查，默认值 false
         # @type SkipPreCheck: Boolean
         # @param MaxNotReadyPercent: 最大可容忍的不可用Pod比例
         # @type MaxNotReadyPercent: Float

data/lib/v20220501/client.rb

@@ -173,6 +173,30 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 查询集群列表
+
+        # @param request: Request instance for DescribeClusters.
+        # @type request: :class:`Tencentcloud::tke::V20220501::DescribeClustersRequest`
+        # @rtype: :class:`Tencentcloud::tke::V20220501::DescribeClustersResponse`
+        def DescribeClusters(request)
+          body = send_request('DescribeClusters', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = DescribeClustersResponse.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 DescribeHealthCheckPolicies.

data/lib/v20220501/models.rb

@@ -92,6 +92,70 @@ module TencentCloud
         end
       end
 
+      # 集群信息结构体
+      class Cluster < TencentCloud::Common::AbstractModel
+        # @param ClusterId: 集群ID
+        # @type ClusterId: String
+        # @param ClusterName: 集群名称
+        # @type ClusterName: String
+        # @param ClusterDescription: 集群描述
+        # @type ClusterDescription: String
+        # @param ClusterVersion: 集群版本（默认值为1.10.5）
+        # @type ClusterVersion: String
+        # @param ClusterType: 集群类型，托管集群：MANAGED_CLUSTER，独立集群：INDEPENDENT_CLUSTER。
+        # @type ClusterType: String
+        # @param TagSpecification: 标签描述列表。
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type TagSpecification: Array
+        # @param ClusterStatus: 集群状态 (Trading 集群开通中,Creating 创建中,Running 运行中,Deleting 删除中,Idling 闲置中,Recovering 唤醒中,Upgrading 升级中,NodeUpgrading 节点升级中,RuntimeUpgrading 节点运行时升级中,MasterScaling Master扩缩容中,ClusterLevelUpgrading 调整规格中,ResourceIsolate 欠费隔离中,ResourceIsolated 欠费已隔离,ResourceReverse 冲正恢复中,Abnormal 异常)
+        # @type ClusterStatus: String
+        # @param CreatedTime: 创建时间
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type CreatedTime: String
+        # @param ClusterLevel: 集群等级，针对托管集群生效
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type ClusterLevel: String
+        # @param VpcId: 集群所在vpc的id
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type VpcId: String
+
+        attr_accessor :ClusterId, :ClusterName, :ClusterDescription, :ClusterVersion, :ClusterType, :TagSpecification, :ClusterStatus, :CreatedTime, :ClusterLevel, :VpcId
+
+        def initialize(clusterid=nil, clustername=nil, clusterdescription=nil, clusterversion=nil, clustertype=nil, tagspecification=nil, clusterstatus=nil, createdtime=nil, clusterlevel=nil, vpcid=nil)
+          @ClusterId = clusterid
+          @ClusterName = clustername
+          @ClusterDescription = clusterdescription
+          @ClusterVersion = clusterversion
+          @ClusterType = clustertype
+          @TagSpecification = tagspecification
+          @ClusterStatus = clusterstatus
+          @CreatedTime = createdtime
+          @ClusterLevel = clusterlevel
+          @VpcId = vpcid
+        end
+
+        def deserialize(params)
+          @ClusterId = params['ClusterId']
+          @ClusterName = params['ClusterName']
+          @ClusterDescription = params['ClusterDescription']
+          @ClusterVersion = params['ClusterVersion']
+          @ClusterType = params['ClusterType']
+          unless params['TagSpecification'].nil?
+            @TagSpecification = []
+            params['TagSpecification'].each do |i|
+              tagspecification_tmp = TagSpecification.new
+              tagspecification_tmp.deserialize(i)
+              @TagSpecification << tagspecification_tmp
+            end
+          end
+          @ClusterStatus = params['ClusterStatus']
+          @CreatedTime = params['CreatedTime']
+          @ClusterLevel = params['ClusterLevel']
+          @VpcId = params['VpcId']
+        end
+      end
+
       # CreateHealthCheckPolicy请求参数结构体
       class CreateHealthCheckPolicyRequest < TencentCloud::Common::AbstractModel
         # @param ClusterId: 集群ID
@@ -626,6 +690,119 @@ module TencentCloud
         end
       end
 
+      # DescribeClusters请求参数结构体
+      class DescribeClustersRequest < TencentCloud::Common::AbstractModel
+        # @param ClusterIds: 集群ID列表(为空时，
+        # 表示获取账号下所有集群)
+        # @type ClusterIds: Array
+        # @param Offset: 偏移量,默认0
+        # @type Offset: Integer
+        # @param Limit: 最大输出条数，默认20，最大为100
+        # @type Limit: Integer
+        # @param Filters: ·  ClusterName
+        #     按照【集群名】进行过滤。
+        #     类型：String
+        #     必选：否
+
+        # ·  ClusterType
+        #     按照【集群类型】进行过滤。
+        #     类型：String
+        #     必选：否
+
+        # ·  ClusterStatus
+        #     按照【集群状态】进行过滤。
+        #     类型：String
+        #     必选：否
+
+        # ·  Tags
+        #     按照【标签键值对】进行过滤。
+        #     类型：String
+        #     必选：否
+
+        # ·  vpc-id
+        #     按照【VPC】进行过滤。
+        #     类型：String
+        #     必选：否
+
+        # ·  tag-key
+        #     按照【标签键】进行过滤。
+        #     类型：String
+        #     必选：否
+
+        # ·  tag-value
+        #     按照【标签值】进行过滤。
+        #     类型：String
+        #     必选：否
+
+        # ·  tag:tag-key
+        #     按照【标签键值对】进行过滤。
+        #     类型：String
+        #     必选：否
+        # @type Filters: Array
+        # @param ClusterType: 集群类型，例如：MANAGED_CLUSTER
+        # @type ClusterType: String
+
+        attr_accessor :ClusterIds, :Offset, :Limit, :Filters, :ClusterType
+
+        def initialize(clusterids=nil, offset=nil, limit=nil, filters=nil, clustertype=nil)
+          @ClusterIds = clusterids
+          @Offset = offset
+          @Limit = limit
+          @Filters = filters
+          @ClusterType = clustertype
+        end
+
+        def deserialize(params)
+          @ClusterIds = params['ClusterIds']
+          @Offset = params['Offset']
+          @Limit = params['Limit']
+          unless params['Filters'].nil?
+            @Filters = []
+            params['Filters'].each do |i|
+              filter_tmp = Filter.new
+              filter_tmp.deserialize(i)
+              @Filters << filter_tmp
+            end
+          end
+          @ClusterType = params['ClusterType']
+        end
+      end
+
+      # DescribeClusters返回参数结构体
+      class DescribeClustersResponse < TencentCloud::Common::AbstractModel
+        # @param TotalCount: 集群总个数
+        # @type TotalCount: Integer
+        # @param Clusters: 集群信息列表
+        # @type Clusters: Array
+        # @param Errors: 错误信息集合
+        # @type Errors: Array
+        # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :TotalCount, :Clusters, :Errors, :RequestId
+
+        def initialize(totalcount=nil, clusters=nil, errors=nil, requestid=nil)
+          @TotalCount = totalcount
+          @Clusters = clusters
+          @Errors = errors
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @TotalCount = params['TotalCount']
+          unless params['Clusters'].nil?
+            @Clusters = []
+            params['Clusters'].each do |i|
+              cluster_tmp = Cluster.new
+              cluster_tmp.deserialize(i)
+              @Clusters << cluster_tmp
+            end
+          end
+          @Errors = params['Errors']
+          @RequestId = params['RequestId']
+        end
+      end
+
       # DescribeHealthCheckPolicies请求参数结构体
       class DescribeHealthCheckPoliciesRequest < TencentCloud::Common::AbstractModel
         # @param ClusterId: 集群 ID

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-tke
 version: !ruby/object:Gem::Version
-  version: 3.0.1160
+  version: 3.0.1162
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-10-28 00:00:00.000000000 Z
+date: 2025-11-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common
@@ -33,11 +33,11 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- lib/tencentcloud-sdk-tke.rb
-- lib/v20220501/models.rb
 - lib/v20220501/client.rb
-- lib/v20180525/models.rb
+- lib/v20220501/models.rb
+- lib/tencentcloud-sdk-tke.rb
 - lib/v20180525/client.rb
+- lib/v20180525/models.rb
 - lib/VERSION
 homepage: https://github.com/TencentCloud/tencentcloud-sdk-ruby
 licenses: