tencentcloud-sdk-python-cngw 3.1.181__tar.gz → 3.1.195__tar.gz

{tencentcloud_sdk_python_cngw-3.1.181 → tencentcloud_sdk_python_cngw-3.1.195}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: tencentcloud-sdk-python-cngw
-Version: 3.1.181
+Version: 3.1.195
 Summary: Tencent Cloud Cngw 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.181
+Requires-Dist: tencentcloud-sdk-python-common<4.0.0,>=3.1.195
 
 ============================
 Tencent Cloud SDK for Python

{tencentcloud_sdk_python_cngw-3.1.181 → tencentcloud_sdk_python_cngw-3.1.195}/setup.py

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

{tencentcloud_sdk_python_cngw-3.1.181 → tencentcloud_sdk_python_cngw-3.1.195}/tencentcloud/__init__.py

@@ -14,4 +14,4 @@
 # limitations under the License.
 
 
-__version__ = '3.1.181'
+__version__ = '3.1.195'

{tencentcloud_sdk_python_cngw-3.1.181 → tencentcloud_sdk_python_cngw-3.1.195}/tencentcloud/cngw/v20230418/cngw_client.py

@@ -74,6 +74,7 @@ class CngwClient(AbstractClient):
 
     def BindCloudNativeAPIGatewaySecretKey(self, request):
         r"""添加密钥与资源的引用关系接口
+        【消费者批量自动分配 API Key｜修改：内部并发/配额逻辑，字段不变】ResourceType=Consumer 时与批量预留共用实例写锁，单消费者绑定配额使用当前锁定读。仍按原 SecretKeyId、ResourceIds 绑定；消费者目标最多一个，单密钥不能同时绑定多个消费者，成功仍返回 Result=true。此入口不新增 OperationDenied.BatchKeyPending；该错误属于下述四个变更入口的保护逻辑。 完整接口清单与逐项说明：https://iwiki.woa.com/p/4042678235（第 2、2.4 节）。
 
         :param request: Request instance for BindCloudNativeAPIGatewaySecretKey.
         :type request: :class:`tencentcloud.cngw.v20230418.models.BindCloudNativeAPIGatewaySecretKeyRequest`
@@ -350,6 +351,7 @@ class CngwClient(AbstractClient):
 
     def CreateCloudNativeAPIGatewaySecretKey(self, request):
         r"""创建消费者密钥。
+        【消费者批量自动分配 API Key｜修改：内部并发/配额逻辑，字段不变】消费者密钥单条创建在事务中使用与批量预留相同的实例写锁，配额检查使用当前锁定读，避免单条与批量并发绕过配额。仍是单条创建；原 GenerateType、请求字段、既有配额错误语义及 Result.Success/ID 不变，不增加 ConsumerIds/ClientToken。 完整接口清单与逐项说明：https://iwiki.woa.com/p/4042678235（第 2、2.4 节）。
 
         :param request: Request instance for CreateCloudNativeAPIGatewaySecretKey.
         :type request: :class:`tencentcloud.cngw.v20230418.models.CreateCloudNativeAPIGatewaySecretKeyRequest`
@@ -420,6 +422,8 @@ class CngwClient(AbstractClient):
     def DeleteCloudNativeAPIGatewayConsumerGroup(self, request):
         r"""删除AI网关消费者组
 
+        同步组仅在 soft_deleted 状态且全部依赖已清理后允许手动硬删除；ConsumerGroupId 使用组织 UUID。存在配额规则时须先删除规则，单纯停用不能解除依赖。硬删除时重新校验，依赖变化可能导致删除失败。
+
         :param request: Request instance for DeleteCloudNativeAPIGatewayConsumerGroup.
         :type request: :class:`tencentcloud.cngw.v20230418.models.DeleteCloudNativeAPIGatewayConsumerGroupRequest`
         :rtype: :class:`tencentcloud.cngw.v20230418.models.DeleteCloudNativeAPIGatewayConsumerGroupResponse`
@@ -580,6 +584,7 @@ class CngwClient(AbstractClient):
 
     def DeleteCloudNativeAPIGatewaySecretKey(self, request):
         r"""删除消费者密钥（被绑定时需先解绑）。
+        【消费者批量自动分配 API Key｜修改：新增未完成批次保护，字段不变】目标密钥属于批次且对应项处于 Pending/Running/Reconciling 时，删除返回 OperationDenied.BatchKeyPending。完成后仍执行原绑定/依赖删除检查；原 GatewayId/SecretKeyId 不变，成功不新增业务 Result。删除已生成密钥不改写批次历史成功，后续批次明文读取返回逐项 ResourceNotFound.SecretKey。 完整接口清单与逐项说明：https://iwiki.woa.com/p/4042678235（第 2、2.4 节）。
 
         :param request: Request instance for DeleteCloudNativeAPIGatewaySecretKey.
         :type request: :class:`tencentcloud.cngw.v20230418.models.DeleteCloudNativeAPIGatewaySecretKeyRequest`
@@ -627,6 +632,8 @@ class CngwClient(AbstractClient):
     def DescribeCloudNativeAPIGatewayAIQuota(self, request):
         r"""查询AI网关配额
 
+        支持 ConsumerGroup 配额，返回 ConsumerGroupPath、ConsumerGroupActive 及实际用量；失效组的规则仍可查询。
+
         :param request: Request instance for DescribeCloudNativeAPIGatewayAIQuota.
         :type request: :class:`tencentcloud.cngw.v20230418.models.DescribeCloudNativeAPIGatewayAIQuotaRequest`
         :rtype: :class:`tencentcloud.cngw.v20230418.models.DescribeCloudNativeAPIGatewayAIQuotaResponse`
@@ -650,6 +657,8 @@ class CngwClient(AbstractClient):
     def DescribeCloudNativeAPIGatewayAIQuotaList(self, request):
         r"""查询AI配额配置列表
 
+        支持按 ConsumerGroup 查询组自身配额，默认仍只查询 Consumer；返回组路径、有效状态及实际用量。上下级关联配额请使用 DescribeAIGWConsumerGroupAIQuotaList。
+
         :param request: Request instance for DescribeCloudNativeAPIGatewayAIQuotaList.
         :type request: :class:`tencentcloud.cngw.v20230418.models.DescribeCloudNativeAPIGatewayAIQuotaListRequest`
         :rtype: :class:`tencentcloud.cngw.v20230418.models.DescribeCloudNativeAPIGatewayAIQuotaListResponse`
@@ -696,6 +705,8 @@ class CngwClient(AbstractClient):
     def DescribeCloudNativeAPIGatewayConsumer(self, request):
         r"""查询云原生消费者详情
 
+        组织架构扩展：保留原消费者详情与完整字段，ConsumerGroups 补齐对应组织成员关系；同步成员保持目录归属隔离。
+
         :param request: Request instance for DescribeCloudNativeAPIGatewayConsumer.
         :type request: :class:`tencentcloud.cngw.v20230418.models.DescribeCloudNativeAPIGatewayConsumerRequest`
         :rtype: :class:`tencentcloud.cngw.v20230418.models.DescribeCloudNativeAPIGatewayConsumerResponse`
@@ -719,6 +730,8 @@ class CngwClient(AbstractClient):
     def DescribeCloudNativeAPIGatewayConsumerGroup(self, request):
         r"""查询消费者组详情。
 
+        组织架构扩展：ConsumerGroupId 同时支持原 cg-* 和组织部门 UUID；保留状态、数量、时间和描述逻辑。原普通组状态为 Enable/Disable，目录部门状态为 active/disabled/soft_deleted。
+
         :param request: Request instance for DescribeCloudNativeAPIGatewayConsumerGroup.
         :type request: :class:`tencentcloud.cngw.v20230418.models.DescribeCloudNativeAPIGatewayConsumerGroupRequest`
         :rtype: :class:`tencentcloud.cngw.v20230418.models.DescribeCloudNativeAPIGatewayConsumerGroupResponse`
@@ -1155,6 +1168,8 @@ class CngwClient(AbstractClient):
 
     def DescribeCloudNativeAPIGatewaySecretKey(self, request):
         r"""查询密钥详情（SecretValue 字段会被掩码）。
+        普通版批量新建密钥的生成来源扩展：新页面按需 IncludeCreationInfo=true，省略/false 保持原响应字段。原 GenerateType 不新增 Batch；批量记录仍为 System。协议：https://iwiki.woa.com/p/4042678235。
+        【消费者批量自动分配 API Key｜修改：可选参数及可选出参】增加可选 IncludeCreationInfo（默认 false）。仅 true 且 ResourceType=Consumer 时在原 Result 增加 CredentialGenerateType、CreationSource、BatchId 三个非必返字段；省略/false 保持旧响应。原字段、SecretValue 脱敏和单条详情结构不变。 完整接口清单与逐项说明：https://iwiki.woa.com/p/4042678235（第 2、2.4 节）。
 
         :param request: Request instance for DescribeCloudNativeAPIGatewaySecretKey.
         :type request: :class:`tencentcloud.cngw.v20230418.models.DescribeCloudNativeAPIGatewaySecretKeyRequest`
@@ -1178,6 +1193,8 @@ class CngwClient(AbstractClient):
 
     def DescribeCloudNativeAPIGatewaySecretKeyList(self, request):
         r"""查询密钥列表。
+        普通版批量新建密钥的生成来源扩展：新页面按需 IncludeCreationInfo=true，省略/false 保持原响应字段。原 GenerateType 不新增 Batch；批量记录仍为 System。协议：https://iwiki.woa.com/p/4042678235。
+        【消费者批量自动分配 API Key｜修改：可选参数、可选出参及筛选】增加可选 IncludeCreationInfo（默认 false）。仅 true 且 ResourceType=Consumer 时在原 Result.SecretKeys[] 增加 CredentialGenerateType、CreationSource、BatchId 三个非必返字段；Result.TotalCount/SecretKeys 结构不变。Filters 新增 CredentialGenerateType、CreationSource，先过滤后计数分页，与是否返回来源字段独立；保留原 GenerateType 枚举和原分页上限。 完整接口清单与逐项说明：https://iwiki.woa.com/p/4042678235（第 2、2.4 节）。
 
         :param request: Request instance for DescribeCloudNativeAPIGatewaySecretKeyList.
         :type request: :class:`tencentcloud.cngw.v20230418.models.DescribeCloudNativeAPIGatewaySecretKeyListRequest`
@@ -1546,6 +1563,7 @@ class CngwClient(AbstractClient):
 
     def ModifyCloudNativeAPIGatewaySecretKey(self, request):
         r"""修改AI网关密钥
+        【消费者批量自动分配 API Key｜修改：新增未完成批次保护，字段不变】目标密钥属于批次且对应项处于 Pending/Running/Reconciling 时，编辑返回 OperationDenied.BatchKeyPending，提示等待批次完成。其他情况继续原编辑校验和行为；原 GatewayId/SecretKeyId/Name/Description 不变，成功不新增业务 Result。 完整接口清单与逐项说明：https://iwiki.woa.com/p/4042678235（第 2、2.4 节）。
 
         :param request: Request instance for ModifyCloudNativeAPIGatewaySecretKey.
         :type request: :class:`tencentcloud.cngw.v20230418.models.ModifyCloudNativeAPIGatewaySecretKeyRequest`
@@ -1638,6 +1656,7 @@ class CngwClient(AbstractClient):
 
     def UnbindCloudNativeAPIGatewaySecretKey(self, request):
         r"""解绑密钥
+        【消费者批量自动分配 API Key｜修改：新增未完成批次保护，字段不变】目标密钥属于批次且对应项处于 Pending/Running/Reconciling 时，解绑返回 OperationDenied.BatchKeyPending。完成后继续原解绑；原 GatewayId/SecretKeyId/ResourceType/ResourceIds 不变，成功不新增业务 Result。解绑不改写批次历史成功，后续批次明文读取返回逐项 OperationDenied.BindingChanged。 完整接口清单与逐项说明：https://iwiki.woa.com/p/4042678235（第 2、2.4 节）。
 
         :param request: Request instance for UnbindCloudNativeAPIGatewaySecretKey.
         :type request: :class:`tencentcloud.cngw.v20230418.models.UnbindCloudNativeAPIGatewaySecretKeyRequest`

{tencentcloud_sdk_python_cngw-3.1.181 → tencentcloud_sdk_python_cngw-3.1.195}/tencentcloud/cngw/v20230418/cngw_client_async.py

@@ -68,6 +68,7 @@ class CngwClient(AbstractClient):
     ) -> models.BindCloudNativeAPIGatewaySecretKeyResponse:
         """
         添加密钥与资源的引用关系接口
+        【消费者批量自动分配 API Key｜修改：内部并发/配额逻辑，字段不变】ResourceType=Consumer 时与批量预留共用实例写锁，单消费者绑定配额使用当前锁定读。仍按原 SecretKeyId、ResourceIds 绑定；消费者目标最多一个，单密钥不能同时绑定多个消费者，成功仍返回 Result=true。此入口不新增 OperationDenied.BatchKeyPending；该错误属于下述四个变更入口的保护逻辑。 完整接口清单与逐项说明：https://iwiki.woa.com/p/4042678235（第 2、2.4 节）。
         """
         
         kwargs = {}
@@ -284,6 +285,7 @@ class CngwClient(AbstractClient):
     ) -> models.CreateCloudNativeAPIGatewaySecretKeyResponse:
         """
         创建消费者密钥。
+        【消费者批量自动分配 API Key｜修改：内部并发/配额逻辑，字段不变】消费者密钥单条创建在事务中使用与批量预留相同的实例写锁，配额检查使用当前锁定读，避免单条与批量并发绕过配额。仍是单条创建；原 GenerateType、请求字段、既有配额错误语义及 Result.Success/ID 不变，不增加 ConsumerIds/ClientToken。 完整接口清单与逐项说明：https://iwiki.woa.com/p/4042678235（第 2、2.4 节）。
         """
         
         kwargs = {}
@@ -338,6 +340,8 @@ class CngwClient(AbstractClient):
     ) -> models.DeleteCloudNativeAPIGatewayConsumerGroupResponse:
         """
         删除AI网关消费者组
+
+        同步组仅在 soft_deleted 状态且全部依赖已清理后允许手动硬删除；ConsumerGroupId 使用组织 UUID。存在配额规则时须先删除规则，单纯停用不能解除依赖。硬删除时重新校验，依赖变化可能导致删除失败。
         """
         
         kwargs = {}
@@ -464,6 +468,7 @@ class CngwClient(AbstractClient):
     ) -> models.DeleteCloudNativeAPIGatewaySecretKeyResponse:
         """
         删除消费者密钥（被绑定时需先解绑）。
+        【消费者批量自动分配 API Key｜修改：新增未完成批次保护，字段不变】目标密钥属于批次且对应项处于 Pending/Running/Reconciling 时，删除返回 OperationDenied.BatchKeyPending。完成后仍执行原绑定/依赖删除检查；原 GatewayId/SecretKeyId 不变，成功不新增业务 Result。删除已生成密钥不改写批次历史成功，后续批次明文读取返回逐项 ResourceNotFound.SecretKey。 完整接口清单与逐项说明：https://iwiki.woa.com/p/4042678235（第 2、2.4 节）。
         """
         
         kwargs = {}
@@ -500,6 +505,8 @@ class CngwClient(AbstractClient):
     ) -> models.DescribeCloudNativeAPIGatewayAIQuotaResponse:
         """
         查询AI网关配额
+
+        支持 ConsumerGroup 配额，返回 ConsumerGroupPath、ConsumerGroupActive 及实际用量；失效组的规则仍可查询。
         """
         
         kwargs = {}
@@ -518,6 +525,8 @@ class CngwClient(AbstractClient):
     ) -> models.DescribeCloudNativeAPIGatewayAIQuotaListResponse:
         """
         查询AI配额配置列表
+
+        支持按 ConsumerGroup 查询组自身配额，默认仍只查询 Consumer；返回组路径、有效状态及实际用量。上下级关联配额请使用 DescribeAIGWConsumerGroupAIQuotaList。
         """
         
         kwargs = {}
@@ -554,6 +563,8 @@ class CngwClient(AbstractClient):
     ) -> models.DescribeCloudNativeAPIGatewayConsumerResponse:
         """
         查询云原生消费者详情
+
+        组织架构扩展：保留原消费者详情与完整字段，ConsumerGroups 补齐对应组织成员关系；同步成员保持目录归属隔离。
         """
         
         kwargs = {}
@@ -572,6 +583,8 @@ class CngwClient(AbstractClient):
     ) -> models.DescribeCloudNativeAPIGatewayConsumerGroupResponse:
         """
         查询消费者组详情。
+
+        组织架构扩展：ConsumerGroupId 同时支持原 cg-* 和组织部门 UUID；保留状态、数量、时间和描述逻辑。原普通组状态为 Enable/Disable，目录部门状态为 active/disabled/soft_deleted。
         """
         
         kwargs = {}
@@ -914,6 +927,8 @@ class CngwClient(AbstractClient):
     ) -> models.DescribeCloudNativeAPIGatewaySecretKeyResponse:
         """
         查询密钥详情（SecretValue 字段会被掩码）。
+        普通版批量新建密钥的生成来源扩展：新页面按需 IncludeCreationInfo=true，省略/false 保持原响应字段。原 GenerateType 不新增 Batch；批量记录仍为 System。协议：https://iwiki.woa.com/p/4042678235。
+        【消费者批量自动分配 API Key｜修改：可选参数及可选出参】增加可选 IncludeCreationInfo（默认 false）。仅 true 且 ResourceType=Consumer 时在原 Result 增加 CredentialGenerateType、CreationSource、BatchId 三个非必返字段；省略/false 保持旧响应。原字段、SecretValue 脱敏和单条详情结构不变。 完整接口清单与逐项说明：https://iwiki.woa.com/p/4042678235（第 2、2.4 节）。
         """
         
         kwargs = {}
@@ -932,6 +947,8 @@ class CngwClient(AbstractClient):
     ) -> models.DescribeCloudNativeAPIGatewaySecretKeyListResponse:
         """
         查询密钥列表。
+        普通版批量新建密钥的生成来源扩展：新页面按需 IncludeCreationInfo=true，省略/false 保持原响应字段。原 GenerateType 不新增 Batch；批量记录仍为 System。协议：https://iwiki.woa.com/p/4042678235。
+        【消费者批量自动分配 API Key｜修改：可选参数、可选出参及筛选】增加可选 IncludeCreationInfo（默认 false）。仅 true 且 ResourceType=Consumer 时在原 Result.SecretKeys[] 增加 CredentialGenerateType、CreationSource、BatchId 三个非必返字段；Result.TotalCount/SecretKeys 结构不变。Filters 新增 CredentialGenerateType、CreationSource，先过滤后计数分页，与是否返回来源字段独立；保留原 GenerateType 枚举和原分页上限。 完整接口清单与逐项说明：https://iwiki.woa.com/p/4042678235（第 2、2.4 节）。
         """
         
         kwargs = {}
@@ -1220,6 +1237,7 @@ class CngwClient(AbstractClient):
     ) -> models.ModifyCloudNativeAPIGatewaySecretKeyResponse:
         """
         修改AI网关密钥
+        【消费者批量自动分配 API Key｜修改：新增未完成批次保护，字段不变】目标密钥属于批次且对应项处于 Pending/Running/Reconciling 时，编辑返回 OperationDenied.BatchKeyPending，提示等待批次完成。其他情况继续原编辑校验和行为；原 GatewayId/SecretKeyId/Name/Description 不变，成功不新增业务 Result。 完整接口清单与逐项说明：https://iwiki.woa.com/p/4042678235（第 2、2.4 节）。
         """
         
         kwargs = {}
@@ -1292,6 +1310,7 @@ class CngwClient(AbstractClient):
     ) -> models.UnbindCloudNativeAPIGatewaySecretKeyResponse:
         """
         解绑密钥
+        【消费者批量自动分配 API Key｜修改：新增未完成批次保护，字段不变】目标密钥属于批次且对应项处于 Pending/Running/Reconciling 时，解绑返回 OperationDenied.BatchKeyPending。完成后继续原解绑；原 GatewayId/SecretKeyId/ResourceType/ResourceIds 不变，成功不新增业务 Result。解绑不改写批次历史成功，后续批次明文读取返回逐项 OperationDenied.BindingChanged。 完整接口清单与逐项说明：https://iwiki.woa.com/p/4042678235（第 2、2.4 节）。
         """
         
         kwargs = {}

{tencentcloud_sdk_python_cngw-3.1.181 → tencentcloud_sdk_python_cngw-3.1.195}/tencentcloud/cngw/v20230418/errorcodes.py

@@ -221,6 +221,9 @@ MISSINGPARAMETER_UPDATEERROR = 'MissingParameter.UpdateError'
 # 操作被拒绝。
 OPERATIONDENIED = 'OperationDenied'
 
+# OperationDenied.BatchKeyPending
+OPERATIONDENIED_BATCHKEYPENDING = 'OperationDenied.BatchKeyPending'
+
 # OperationDenied.LimitExceeded
 OPERATIONDENIED_LIMITEXCEEDED = 'OperationDenied.LimitExceeded'