tencentcloud-sdk-tke 3.0.1159 → 3.0.1161

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 1e1a5a33f55cfa2f351d506f0586c621fd2984c7
-  data.tar.gz: 8cb8737185dd576900339141e97d044899766405
+  metadata.gz: 064e957200a92a1158976661001fd1e1045d0e36
+  data.tar.gz: 1927aa77b4f4636ee45c63dde54bf6d6a2d558fb
 SHA512:
-  metadata.gz: cf259b1cb9fc7fb49c97c61cc0d586d9c4b85723e71373ec2746d2a7366bd0f0e71944a8b749d94628f7bc917561b60889b684b854f9e73a8a36fe233d318db5
-  data.tar.gz: 9b0c6d851240ca5d1022940707af83932a724b8ec614fa306647adb1f796df000074c4378ce5ddd529eed1c134102a2405d8a970fc7d7b2c150945b5db9929d4
+  metadata.gz: 2b0b1b93783c314bdb46e76964f0bfb9d68b5e36ca16b55453be1c46581f6e98ad2f4050813b1fe80b08d43752f28e2a98c28e6a2806bfc885525121f2009ef6
+  data.tar.gz: 08ae285be6418f816a802d846393dcb0b6e68d27cfb156dc79dce1d1ed9338da0a097369bb83412bf21fcf40aad2f4a8e7eb73e06e1796a02c2ee4522833ff5b

data/lib/VERSION

@@ -1 +1 @@
-3.0.1159
+3.0.1161

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
@@ -242,7 +242,7 @@ module TencentCloud
 
       # AddVpcCniSubnets请求参数结构体
       class AddVpcCniSubnetsRequest < TencentCloud::Common::AbstractModel
-        # @param ClusterId: 集群ID
+        # @param ClusterId: 集群 ID，请[登录控制台](https://console.cloud.tencent.com/tke2/cluster)在集群列表复制ID
         # @type ClusterId: String
         # @param SubnetIds: 为集群容器网络增加的子网列表
         # @type SubnetIds: Array
@@ -781,15 +781,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 +1082,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 +1847,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
@@ -1899,7 +1899,7 @@ module TencentCloud
         # @type ClusterId: String
         # @param LogsetId: CLS日志集ID
         # @type LogsetId: String
-        # @param ClusterType: 当前集群类型支持tke、eks
+        # @param ClusterType: 当前集群类型支持tke（标准集群）、eks（serverless集群）
         # @type ClusterType: String
 
         attr_accessor :LogConfig, :ClusterId, :LogsetId, :ClusterType
@@ -1939,13 +1939,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":""}。
         # 各个参数意义：
@@ -5170,9 +5170,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 +5637,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
@@ -6519,7 +6519,7 @@ module TencentCloud
 
       # DescribeClusterRoutes请求参数结构体
       class DescribeClusterRoutesRequest < TencentCloud::Common::AbstractModel
-        # @param RouteTableName: 路由表名称。
+        # @param RouteTableName: 路由表名称。与集群 ID 一致，可以到[集群控制台](https://console.cloud.tencent.com/tke2)进行复制。
         # @type RouteTableName: String
         # @param Filters: 过滤条件,当前只支持按照单个条件GatewayIP进行过滤（可选）
         # @type Filters: Array
@@ -6805,7 +6805,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
@@ -7849,7 +7849,7 @@ module TencentCloud
 
       # DescribeIPAMD请求参数结构体
       class DescribeIPAMDRequest < TencentCloud::Common::AbstractModel
-        # @param ClusterId: 集群ID
+        # @param ClusterId: 集群 ID，请[登录控制台](https://console.cloud.tencent.com/tke2/cluster)在集群列表复制ID
         # @type ClusterId: String
 
         attr_accessor :ClusterId
@@ -10018,11 +10018,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`
@@ -10060,7 +10060,7 @@ module TencentCloud
       class DescribeRouteTableConflictsRequest < TencentCloud::Common::AbstractModel
         # @param RouteTableCidrBlock: 路由表CIDR
         # @type RouteTableCidrBlock: String
-        # @param VpcId: 路由表绑定的VPC
+        # @param VpcId: 路由表绑定的VPC，请到 [VPC 控制台](https://console.cloud.tencent.com/vpc/vpc)复制 VPC ID
         # @type VpcId: String
 
         attr_accessor :RouteTableCidrBlock, :VpcId
@@ -11451,9 +11451,9 @@ module TencentCloud
       class EnableClusterAuditRequest < TencentCloud::Common::AbstractModel
         # @param ClusterId: 集群ID
         # @type ClusterId: String
-        # @param LogsetId: CLS日志集ID
+        # @param LogsetId: CLS日志集ID，可以通过cls接口或者控制台获取
         # @type LogsetId: String
-        # @param TopicId: CLS日志主题ID
+        # @param TopicId: CLS日志主题ID，可以通过cls接口或者控制台获取
         # @type TopicId: String
         # @param TopicRegion: topic所在region，默认为集群当前region
         # @type TopicRegion: String
@@ -11566,9 +11566,9 @@ module TencentCloud
       class EnableEventPersistenceRequest < TencentCloud::Common::AbstractModel
         # @param ClusterId: 集群ID
         # @type ClusterId: String
-        # @param LogsetId: cls服务的logsetID
+        # @param LogsetId: cls服务的logsetID，通过cls接口或者控制台获取
         # @type LogsetId: String
-        # @param TopicId: cls服务的topicID
+        # @param TopicId: cls服务的topicID，通过cls接口或者控制台获取
         # @type TopicId: String
         # @param TopicRegion: topic所在地域，默认为集群所在地域
         # @type TopicRegion: String
@@ -12106,7 +12106,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 +13270,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 +13294,8 @@ module TencentCloud
               @Statistics << kubejarvisstatestatistic_tmp
             end
           end
+          @StartTime = params['StartTime']
+          @EndTime = params['EndTime']
         end
       end
 
@@ -13366,7 +13374,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 +13420,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 +13703,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 +13925,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 +14065,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 +14119,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 +14335,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 +15079,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 +17630,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
@@ -17776,6 +17793,7 @@ module TencentCloud
       # 路由表冲突对象
       class RouteTableConflict < TencentCloud::Common::AbstractModel
         # @param RouteTableType: 路由表类型。
+        # 枚举值：CcsCluster、Vpc、VpcRouteTable、CcsClusterRouteTable
         # @type RouteTableType: String
         # @param RouteTableCidrBlock: 路由表CIDR。
         # @type RouteTableCidrBlock: String
@@ -17942,9 +17960,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
@@ -18869,9 +18887,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

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
@@ -1335,11 +1512,11 @@ module TencentCloud
       # 包年包月配置
       class InstanceChargePrepaid < TencentCloud::Common::AbstractModel
         # @param Period: 后付费计费周期，单位（月）：
-        # 1，2，3，4，5，，6，7， 8，9，10，11，12，24，36，48，60
+        # 1，2，3，4，5，6，7， 8，9，10，11，12，24，36，48，60
         # @type Period: Integer
         # @param RenewFlag: 预付费续费方式：
-        # - NOTIFY_AND_AUTO_RENEW：通知用户过期，且自动续费 (默认）
-        # - NOTIFY_AND_MANUAL_RENEW：通知用户过期，但不自动续费
+        # - NOTIFY_AND_AUTO_RENEW：通知用户过期，且自动续费
+        # - NOTIFY_AND_MANUAL_RENEW：通知用户过期，但不自动续费(默认)
         # - DISABLE_NOTIFY_AND_MANUAL_RENEW：不通知用户过期，也不自动续费
         # @type RenewFlag: String
 
@@ -2681,6 +2858,8 @@ module TencentCloud
         # @type InstanceTypes: Array
         # @param Replicas: 期望节点数
         # @type Replicas: Integer
+        # @param UpdateExistedNode: 是否更新存量节点
+        # @type UpdateExistedNode: Boolean
         # @param DataDisks: 数据盘列表
         # @type DataDisks: Array
         # @param KeyIds: ssh公钥id数组
@@ -2688,9 +2867,9 @@ module TencentCloud
         # @param GPUConfigs: 节点池 GPU 配置
         # @type GPUConfigs: Array
 
-        attr_accessor :Scaling, :SubnetIds, :SecurityGroupIds, :UpgradeSettings, :AutoRepair, :InstanceChargeType, :InstanceChargePrepaid, :SystemDisk, :Management, :HealthCheckPolicyName, :HostNamePattern, :KubeletArgs, :Lifecycle, :RuntimeRootDir, :EnableAutoscaling, :InstanceTypes, :Replicas, :DataDisks, :KeyIds, :GPUConfigs
+        attr_accessor :Scaling, :SubnetIds, :SecurityGroupIds, :UpgradeSettings, :AutoRepair, :InstanceChargeType, :InstanceChargePrepaid, :SystemDisk, :Management, :HealthCheckPolicyName, :HostNamePattern, :KubeletArgs, :Lifecycle, :RuntimeRootDir, :EnableAutoscaling, :InstanceTypes, :Replicas, :UpdateExistedNode, :DataDisks, :KeyIds, :GPUConfigs
 
-        def initialize(scaling=nil, subnetids=nil, securitygroupids=nil, upgradesettings=nil, autorepair=nil, instancechargetype=nil, instancechargeprepaid=nil, systemdisk=nil, management=nil, healthcheckpolicyname=nil, hostnamepattern=nil, kubeletargs=nil, lifecycle=nil, runtimerootdir=nil, enableautoscaling=nil, instancetypes=nil, replicas=nil, datadisks=nil, keyids=nil, gpuconfigs=nil)
+        def initialize(scaling=nil, subnetids=nil, securitygroupids=nil, upgradesettings=nil, autorepair=nil, instancechargetype=nil, instancechargeprepaid=nil, systemdisk=nil, management=nil, healthcheckpolicyname=nil, hostnamepattern=nil, kubeletargs=nil, lifecycle=nil, runtimerootdir=nil, enableautoscaling=nil, instancetypes=nil, replicas=nil, updateexistednode=nil, datadisks=nil, keyids=nil, gpuconfigs=nil)
           @Scaling = scaling
           @SubnetIds = subnetids
           @SecurityGroupIds = securitygroupids
@@ -2708,6 +2887,7 @@ module TencentCloud
           @EnableAutoscaling = enableautoscaling
           @InstanceTypes = instancetypes
           @Replicas = replicas
+          @UpdateExistedNode = updateexistednode
           @DataDisks = datadisks
           @KeyIds = keyids
           @GPUConfigs = gpuconfigs
@@ -2749,6 +2929,7 @@ module TencentCloud
           @EnableAutoscaling = params['EnableAutoscaling']
           @InstanceTypes = params['InstanceTypes']
           @Replicas = params['Replicas']
+          @UpdateExistedNode = params['UpdateExistedNode']
           unless params['DataDisks'].nil?
             @DataDisks = []
             params['DataDisks'].each do |i|

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-tke
 version: !ruby/object:Gem::Version
-  version: 3.0.1159
+  version: 3.0.1161
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-10-22 00:00:00.000000000 Z
+date: 2025-11-04 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/v20220501/client.rb
+- lib/v20220501/models.rb
 - lib/tencentcloud-sdk-tke.rb
-- lib/v20180525/models.rb
 - lib/v20180525/client.rb
-- lib/v20220501/models.rb
-- lib/v20220501/client.rb
+- lib/v20180525/models.rb
 - lib/VERSION
 homepage: https://github.com/TencentCloud/tencentcloud-sdk-ruby
 licenses: