tencentcloud-sdk-python-tke 3.1.128__tar.gz → 3.1.134__tar.gz

{tencentcloud_sdk_python_tke-3.1.128 → tencentcloud_sdk_python_tke-3.1.134}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: tencentcloud-sdk-python-tke
-Version: 3.1.128
+Version: 3.1.134
 Summary: Tencent Cloud Tke SDK for Python
 Home-page: https://github.com/TencentCloud/tencentcloud-sdk-python
 Author: Tencent Cloud
@@ -15,7 +15,7 @@ Classifier: Programming Language :: Python :: 2.7
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.6
 Classifier: Programming Language :: Python :: 3.7
-Requires-Dist: tencentcloud-sdk-python-common<4.0.0,>=3.1.128
+Requires-Dist: tencentcloud-sdk-python-common<4.0.0,>=3.1.134
 
 ============================
 Tencent Cloud SDK for Python

{tencentcloud_sdk_python_tke-3.1.128 → tencentcloud_sdk_python_tke-3.1.134}/setup.py

@@ -8,7 +8,7 @@ ROOT = os.path.dirname(__file__)
 
 setup(
     name='tencentcloud-sdk-python-tke',
-    install_requires=["tencentcloud-sdk-python-common>=3.1.128,<4.0.0"],
+    install_requires=["tencentcloud-sdk-python-common>=3.1.134,<4.0.0"],
     
     version=tencentcloud.__version__,
     description='Tencent Cloud Tke SDK for Python',

{tencentcloud_sdk_python_tke-3.1.128 → tencentcloud_sdk_python_tke-3.1.134}/tencentcloud/__init__.py

@@ -14,4 +14,4 @@
 # limitations under the License.
 
 
-__version__ = '3.1.128'
+__version__ = '3.1.134'

{tencentcloud_sdk_python_tke-3.1.128 → tencentcloud_sdk_python_tke-3.1.134}/tencentcloud/tke/v20220501/models.py

@@ -931,25 +931,25 @@ class CreateNodePoolRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _ClusterId: 集群 ID
+        :param _ClusterId: <p>集群 ID</p>
         :type ClusterId: str
-        :param _Name: 节点池名称
+        :param _Name: <p>节点池名称</p>
         :type Name: str
-        :param _Type: 节点池类型
+        :param _Type: <p>节点池类型</p>
         :type Type: str
-        :param _Labels: 节点  Labels
+        :param _Labels: <p>节点  Labels</p>
         :type Labels: list of Label
-        :param _Taints: 节点污点
+        :param _Taints: <p>节点污点</p>
         :type Taints: list of Taint
-        :param _Tags: 节点标签
+        :param _Tags: <p>节点标签</p>
         :type Tags: list of TagSpecification
-        :param _DeletionProtection: 是否开启删除保护
+        :param _DeletionProtection: <p>是否开启删除保护</p>
         :type DeletionProtection: bool
-        :param _Unschedulable: 节点是否默认不可调度
+        :param _Unschedulable: <p>节点是否默认不可调度</p>
         :type Unschedulable: bool
-        :param _Native: 原生节点池创建参数（Type字段设置为Native时需填写）
+        :param _Native: <p>原生节点池创建参数（Type字段设置为Native时需填写）</p>
         :type Native: :class:`tencentcloud.tke.v20220501.models.CreateNativeNodePoolParam`
-        :param _Annotations: 节点 Annotation 列表
+        :param _Annotations: <p>节点 Annotation 列表</p>
         :type Annotations: list of Annotation
         """
         self._ClusterId = None
@@ -965,7 +965,7 @@ class CreateNodePoolRequest(AbstractModel):
 
     @property
     def ClusterId(self):
-        r"""集群 ID
+        r"""<p>集群 ID</p>
         :rtype: str
         """
         return self._ClusterId
@@ -976,7 +976,7 @@ class CreateNodePoolRequest(AbstractModel):
 
     @property
     def Name(self):
-        r"""节点池名称
+        r"""<p>节点池名称</p>
         :rtype: str
         """
         return self._Name
@@ -987,7 +987,7 @@ class CreateNodePoolRequest(AbstractModel):
 
     @property
     def Type(self):
-        r"""节点池类型
+        r"""<p>节点池类型</p>
         :rtype: str
         """
         return self._Type
@@ -998,7 +998,7 @@ class CreateNodePoolRequest(AbstractModel):
 
     @property
     def Labels(self):
-        r"""节点  Labels
+        r"""<p>节点  Labels</p>
         :rtype: list of Label
         """
         return self._Labels
@@ -1009,7 +1009,7 @@ class CreateNodePoolRequest(AbstractModel):
 
     @property
     def Taints(self):
-        r"""节点污点
+        r"""<p>节点污点</p>
         :rtype: list of Taint
         """
         return self._Taints
@@ -1020,7 +1020,7 @@ class CreateNodePoolRequest(AbstractModel):
 
     @property
     def Tags(self):
-        r"""节点标签
+        r"""<p>节点标签</p>
         :rtype: list of TagSpecification
         """
         return self._Tags
@@ -1031,7 +1031,7 @@ class CreateNodePoolRequest(AbstractModel):
 
     @property
     def DeletionProtection(self):
-        r"""是否开启删除保护
+        r"""<p>是否开启删除保护</p>
         :rtype: bool
         """
         return self._DeletionProtection
@@ -1042,7 +1042,7 @@ class CreateNodePoolRequest(AbstractModel):
 
     @property
     def Unschedulable(self):
-        r"""节点是否默认不可调度
+        r"""<p>节点是否默认不可调度</p>
         :rtype: bool
         """
         return self._Unschedulable
@@ -1053,7 +1053,7 @@ class CreateNodePoolRequest(AbstractModel):
 
     @property
     def Native(self):
-        r"""原生节点池创建参数（Type字段设置为Native时需填写）
+        r"""<p>原生节点池创建参数（Type字段设置为Native时需填写）</p>
         :rtype: :class:`tencentcloud.tke.v20220501.models.CreateNativeNodePoolParam`
         """
         return self._Native
@@ -1064,7 +1064,7 @@ class CreateNodePoolRequest(AbstractModel):
 
     @property
     def Annotations(self):
-        r"""节点 Annotation 列表
+        r"""<p>节点 Annotation 列表</p>
         :rtype: list of Annotation
         """
         return self._Annotations
@@ -1124,7 +1124,7 @@ class CreateNodePoolResponse(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _NodePoolId: 节点池 ID
+        :param _NodePoolId: <p>节点池 ID</p>
         :type NodePoolId: str
         :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
         :type RequestId: str
@@ -1134,7 +1134,7 @@ class CreateNodePoolResponse(AbstractModel):
 
     @property
     def NodePoolId(self):
-        r"""节点池 ID
+        r"""<p>节点池 ID</p>
         :rtype: str
         """
         return self._NodePoolId
@@ -8297,16 +8297,27 @@ class Taint(AbstractModel):
 
     def __init__(self):
         r"""
+        :param _Effect: Taint的Effect
+        :type Effect: str
         :param _Key: Taint的Key
         :type Key: str
         :param _Value: Taint的Value
         :type Value: str
-        :param _Effect: Taint的Effect
-        :type Effect: str
         """
+        self._Effect = None
         self._Key = None
         self._Value = None
-        self._Effect = None
+
+    @property
+    def Effect(self):
+        r"""Taint的Effect
+        :rtype: str
+        """
+        return self._Effect
+
+    @Effect.setter
+    def Effect(self, Effect):
+        self._Effect = Effect
 
     @property
     def Key(self):
@@ -8330,22 +8341,11 @@ class Taint(AbstractModel):
     def Value(self, Value):
         self._Value = Value
 
-    @property
-    def Effect(self):
-        r"""Taint的Effect
-        :rtype: str
-        """
-        return self._Effect
-
-    @Effect.setter
-    def Effect(self, Effect):
-        self._Effect = Effect
-
 
     def _deserialize(self, params):
+        self._Effect = params.get("Effect")
         self._Key = params.get("Key")
         self._Value = params.get("Value")
-        self._Effect = params.get("Effect")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]

{tencentcloud_sdk_python_tke-3.1.128 → tencentcloud_sdk_python_tke-3.1.134}/tencentcloud/tke/v20220501/tke_client.py

@@ -50,7 +50,96 @@ class TkeClient(AbstractClient):
 
 
     def CreateNodePool(self, request):
-        r"""创建 TKE 节点池
+        r"""**通过 CAM 策略强制节点池安全配置**
+
+        创建原生节点池（`CreateNodePool`）接口已接入 CAM 条件鉴权，会根据请求参数计算出一组**条件键（Condition Key）**并传入 CAM 鉴权。您可以在 CAM/SCP 策略中基于这些条件键配置 `deny` 规则，从而强制约束节点池的安全配置（如必须开启磁盘加密、安全加固等）。
+
+        **支持的条件键**
+
+        | 条件键 | 含义 | 取值 | 取值判定说明 |
+        |--------|------|------|-------------|
+        | `tke:NodePoolType` | 节点池类型 | `Native` / `External` | 取请求的节点池类型，未指定时默认为 `Native` |
+        | `tke:SystemDiskEncrypted` | 系统盘是否加密 | `true` / `false` | 系统盘加密属性为 `ENCRYPT`（大小写不敏感）时为 `true`，否则为 `false` |
+        | `tke:AllDataDisksEncrypted` | 所有数据盘是否都已加密 | `true` / `false` | 全部数据盘加密属性均为 `ENCRYPT` 时为 `true`；未配置数据盘时也为 `true`；只要有任一数据盘未加密即为 `false` |
+        | `tke:SecurityAgentEnabled` | 是否开启安全加固（Security Agent） | `true` / `false` | 开启安全加固时为 `true`，否则为 `false` |
+
+        > 说明：所有条件键的取值均为字符串 `"true"` / `"false"`，请在策略中使用字符串形式匹配。
+
+        **使用方式**
+
+        在 CAM 策略中使用 `bool_equal` 匹配条件键值为 `"false"`，配合 `effect: deny`，即可实现"未满足安全配置则拒绝创建节点池"的强制约束。
+
+        **示例一：强制开启安全加固**
+
+        创建节点池时若未开启安全加固（`tke:SecurityAgentEnabled = "false"`），则拒绝。
+
+        ```json
+        {
+            "version": "2.0",
+            "statement": [
+                {
+                    "effect": "deny",
+                    "action": ["tke:CreateNodePool"],
+                    "resource": ["*"],
+                    "condition": {
+                        "bool_equal": {
+                            "tke:SecurityAgentEnabled": "false"
+                        }
+                    }
+                }
+            ]
+        }
+        ```
+
+        **示例二：强制数据盘加密**
+
+        创建节点池时若存在未加密的数据盘（`tke:AllDataDisksEncrypted = "false"`），则拒绝。
+
+        ```json
+        {
+            "version": "2.0",
+            "statement": [
+                {
+                    "effect": "deny",
+                    "action": ["tke:CreateNodePool"],
+                    "resource": ["*"],
+                    "condition": {
+                        "bool_equal": {
+                            "tke:AllDataDisksEncrypted": "false"
+                        }
+                    }
+                }
+            ]
+        }
+        ```
+
+        **示例三：强制系统盘加密**
+
+        创建节点池时若系统盘未加密（`tke:SystemDiskEncrypted = "false"`），则拒绝。
+
+        ```json
+        {
+            "version": "2.0",
+            "statement": [
+                {
+                    "effect": "deny",
+                    "action": ["tke:CreateNodePool"],
+                    "resource": ["*"],
+                    "condition": {
+                        "bool_equal": {
+                            "tke:SystemDiskEncrypted": "false"
+                        }
+                    }
+                }
+            ]
+        }
+        ```
+
+        **注意事项**
+
+        - 上述条件键在**未配置任何 CAM 策略**时不会影响节点池创建，仅在您显式配置了对应 `deny` 策略时才生效。
+        - 如需同时强制多项安全配置，必须在同一策略的 `statement` 中配置多条 `deny` 规则，不能将多个条件键写入同一条 `condition`。
+        - `tke:AllDataDisksEncrypted` 在**无数据盘**场景下取值为 `true`（不存在未加密的数据盘），因此仅约束"已配置的数据盘必须加密"，不会强制要求必须挂载数据盘。
 
         :param request: Request instance for CreateNodePool.
         :type request: :class:`tencentcloud.tke.v20220501.models.CreateNodePoolRequest`

{tencentcloud_sdk_python_tke-3.1.128 → tencentcloud_sdk_python_tke-3.1.134}/tencentcloud/tke/v20220501/tke_client_async.py

@@ -49,7 +49,96 @@ class TkeClient(AbstractClient):
             opts: Dict = None,
     ) -> models.CreateNodePoolResponse:
         """
-        创建 TKE 节点池
+        **通过 CAM 策略强制节点池安全配置**
+
+        创建原生节点池（`CreateNodePool`）接口已接入 CAM 条件鉴权，会根据请求参数计算出一组**条件键（Condition Key）**并传入 CAM 鉴权。您可以在 CAM/SCP 策略中基于这些条件键配置 `deny` 规则，从而强制约束节点池的安全配置（如必须开启磁盘加密、安全加固等）。
+
+        **支持的条件键**
+
+        | 条件键 | 含义 | 取值 | 取值判定说明 |
+        |--------|------|------|-------------|
+        | `tke:NodePoolType` | 节点池类型 | `Native` / `External` | 取请求的节点池类型，未指定时默认为 `Native` |
+        | `tke:SystemDiskEncrypted` | 系统盘是否加密 | `true` / `false` | 系统盘加密属性为 `ENCRYPT`（大小写不敏感）时为 `true`，否则为 `false` |
+        | `tke:AllDataDisksEncrypted` | 所有数据盘是否都已加密 | `true` / `false` | 全部数据盘加密属性均为 `ENCRYPT` 时为 `true`；未配置数据盘时也为 `true`；只要有任一数据盘未加密即为 `false` |
+        | `tke:SecurityAgentEnabled` | 是否开启安全加固（Security Agent） | `true` / `false` | 开启安全加固时为 `true`，否则为 `false` |
+
+        > 说明：所有条件键的取值均为字符串 `"true"` / `"false"`，请在策略中使用字符串形式匹配。
+
+        **使用方式**
+
+        在 CAM 策略中使用 `bool_equal` 匹配条件键值为 `"false"`，配合 `effect: deny`，即可实现"未满足安全配置则拒绝创建节点池"的强制约束。
+
+        **示例一：强制开启安全加固**
+
+        创建节点池时若未开启安全加固（`tke:SecurityAgentEnabled = "false"`），则拒绝。
+
+        ```json
+        {
+            "version": "2.0",
+            "statement": [
+                {
+                    "effect": "deny",
+                    "action": ["tke:CreateNodePool"],
+                    "resource": ["*"],
+                    "condition": {
+                        "bool_equal": {
+                            "tke:SecurityAgentEnabled": "false"
+                        }
+                    }
+                }
+            ]
+        }
+        ```
+
+        **示例二：强制数据盘加密**
+
+        创建节点池时若存在未加密的数据盘（`tke:AllDataDisksEncrypted = "false"`），则拒绝。
+
+        ```json
+        {
+            "version": "2.0",
+            "statement": [
+                {
+                    "effect": "deny",
+                    "action": ["tke:CreateNodePool"],
+                    "resource": ["*"],
+                    "condition": {
+                        "bool_equal": {
+                            "tke:AllDataDisksEncrypted": "false"
+                        }
+                    }
+                }
+            ]
+        }
+        ```
+
+        **示例三：强制系统盘加密**
+
+        创建节点池时若系统盘未加密（`tke:SystemDiskEncrypted = "false"`），则拒绝。
+
+        ```json
+        {
+            "version": "2.0",
+            "statement": [
+                {
+                    "effect": "deny",
+                    "action": ["tke:CreateNodePool"],
+                    "resource": ["*"],
+                    "condition": {
+                        "bool_equal": {
+                            "tke:SystemDiskEncrypted": "false"
+                        }
+                    }
+                }
+            ]
+        }
+        ```
+
+        **注意事项**
+
+        - 上述条件键在**未配置任何 CAM 策略**时不会影响节点池创建，仅在您显式配置了对应 `deny` 策略时才生效。
+        - 如需同时强制多项安全配置，必须在同一策略的 `statement` 中配置多条 `deny` 规则，不能将多个条件键写入同一条 `condition`。
+        - `tke:AllDataDisksEncrypted` 在**无数据盘**场景下取值为 `true`（不存在未加密的数据盘），因此仅约束"已配置的数据盘必须加密"，不会强制要求必须挂载数据盘。
         """
         
         kwargs = {}

{tencentcloud_sdk_python_tke-3.1.128 → tencentcloud_sdk_python_tke-3.1.134}/tencentcloud_sdk_python_tke.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: tencentcloud-sdk-python-tke
-Version: 3.1.128
+Version: 3.1.134
 Summary: Tencent Cloud Tke SDK for Python
 Home-page: https://github.com/TencentCloud/tencentcloud-sdk-python
 Author: Tencent Cloud
@@ -15,7 +15,7 @@ Classifier: Programming Language :: Python :: 2.7
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.6
 Classifier: Programming Language :: Python :: 3.7
-Requires-Dist: tencentcloud-sdk-python-common<4.0.0,>=3.1.128
+Requires-Dist: tencentcloud-sdk-python-common<4.0.0,>=3.1.134
 
 ============================
 Tencent Cloud SDK for Python

tencentcloud_sdk_python_tke-3.1.134/tencentcloud_sdk_python_tke.egg-info/requires.txt

@@ -0,0 +1 @@
+tencentcloud-sdk-python-common<4.0.0,>=3.1.134

tencentcloud_sdk_python_tke-3.1.128/tencentcloud_sdk_python_tke.egg-info/requires.txt

@@ -1 +0,0 @@
-tencentcloud-sdk-python-common<4.0.0,>=3.1.128