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

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

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

{tencentcloud_sdk_python_cngw-3.1.195 → tencentcloud_sdk_python_cngw-3.1.200}/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.195,<4.0.0"],
+    install_requires=["tencentcloud-sdk-python-common>=3.1.200,<4.0.0"],
     
     version=tencentcloud.__version__,
     description='Tencent Cloud Cngw SDK for Python',

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

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

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

@@ -74,7 +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 节）。
+        【消费者批量自动分配 API Key｜修改：内部并发/配额逻辑，字段不变】ResourceType=Consumer 时与批量预留共用实例写锁，单消费者绑定配额使用当前锁定读。仍按原 SecretKeyId、ResourceIds 绑定；消费者目标最多一个，单密钥不能同时绑定多个消费者，成功仍返回 Result=true。此入口不新增 OperationDenied.BatchKeyPending；该错误属于下述四个变更入口的保护逻辑。
 
         :param request: Request instance for BindCloudNativeAPIGatewaySecretKey.
         :type request: :class:`tencentcloud.cngw.v20230418.models.BindCloudNativeAPIGatewaySecretKeyRequest`
@@ -165,6 +165,33 @@ class CngwClient(AbstractClient):
                 raise TencentCloudSDKException(type(e).__name__, str(e))
 
 
+    def CreateAIGWCustomGuardrailPolicy(self, request):
+        r"""创建自定义外部审核策略，并把资源绑定配置同步到 Kong Route。建议先调用 DescribeAIGWCustomGuardrailCapabilities、DescribeAIGWCustomGuardrailBindableResources 和 TestAIGWCustomGuardrailPolicy。支持模型 API、MCP Streamable HTTP、A2A Agent API；当前不开放 Dify、Custom Agent、Legacy SSE MCP。请检查 Result.Success、SyncStatus、FailedResources；部分同步失败不等于策略未创建，应按返回 PolicyId 查询并处理，避免重复创建。网关需满足最低版本 3.9.6，且已安装、启用并加载 cngw-ai-custom-guardrail。创建、修改、删除要求网关处于稳定 Running 状态，升级/回滚/撤销升级期间不能修改策略。
+
+        本产品为 cngw，版本为 2023-04-18。公共参数及签名按云 API 规范配置；在 API Explorer 选择目标环境，示例正文仅为业务参数，中文诊断示例以公共参数 Language=zh-CN 为前提。响应业务字段统一位于 Response.Result，Response.RequestId 为云 API 请求 ID；HTTP 成功不代表 Result.Success=true。示例 ID、域名和鉴权值均为占位内容，须替换为实际值。
+
+        输入约束：新配置只接受 field_mapping，不再默认为 standard_v2。创建时鉴权和检测行为必须完整填写；修改为 PATCH，省略保留，显式空值不补默认值。存量 standard_v2 策略仍可查询、删除或直接停用；修改其判定配置或重新启用前需迁移到 field_mapping。条件必填由后端按完整配置校验，非法配置不写库、不下发。
+
+        :param request: Request instance for CreateAIGWCustomGuardrailPolicy.
+        :type request: :class:`tencentcloud.cngw.v20230418.models.CreateAIGWCustomGuardrailPolicyRequest`
+        :rtype: :class:`tencentcloud.cngw.v20230418.models.CreateAIGWCustomGuardrailPolicyResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("CreateAIGWCustomGuardrailPolicy", params, headers=headers)
+            response = json.loads(body)
+            model = models.CreateAIGWCustomGuardrailPolicyResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
     def CreateCloudNativeAPIGatewayAIServiceSource(self, request):
         r"""创建云原生网关AI服务来源
 
@@ -258,7 +285,7 @@ class CngwClient(AbstractClient):
 
 
     def CreateCloudNativeAPIGatewayLLMModelService(self, request):
-        r"""创建 LLM 模型服务。同一网关下 Name 唯一。
+        r"""创建指定网关实例内的 LLM 模型服务。同一网关下 Name 唯一。可为明确请求 gzip 的供应商选择是否关闭上游压缩协商。
 
         :param request: Request instance for CreateCloudNativeAPIGatewayLLMModelService.
         :type request: :class:`tencentcloud.cngw.v20230418.models.CreateCloudNativeAPIGatewayLLMModelServiceRequest`
@@ -351,7 +378,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 节）。
+        【消费者批量自动分配 API Key｜修改：内部并发/配额逻辑，字段不变】消费者密钥单条创建在事务中使用与批量预留相同的实例写锁，配额检查使用当前锁定读，避免单条与批量并发绕过配额。仍是单条创建；原 GenerateType、请求字段、既有配额错误语义及 Result.Success/ID 不变，不增加 ConsumerIds/ClientToken。
 
         :param request: Request instance for CreateCloudNativeAPIGatewaySecretKey.
         :type request: :class:`tencentcloud.cngw.v20230418.models.CreateCloudNativeAPIGatewaySecretKeyRequest`
@@ -373,6 +400,54 @@ class CngwClient(AbstractClient):
                 raise TencentCloudSDKException(type(e).__name__, str(e))
 
 
+    def CreateOrModifyCloudNativeAPIGatewayIPRestriction(self, request):
+        r"""创建或编辑云原生网关访问控制
+
+        :param request: Request instance for CreateOrModifyCloudNativeAPIGatewayIPRestriction.
+        :type request: :class:`tencentcloud.cngw.v20230418.models.CreateOrModifyCloudNativeAPIGatewayIPRestrictionRequest`
+        :rtype: :class:`tencentcloud.cngw.v20230418.models.CreateOrModifyCloudNativeAPIGatewayIPRestrictionResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("CreateOrModifyCloudNativeAPIGatewayIPRestriction", params, headers=headers)
+            response = json.loads(body)
+            model = models.CreateOrModifyCloudNativeAPIGatewayIPRestrictionResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
+    def DeleteAIGWCustomGuardrailPolicy(self, request):
+        r"""先清理该策略的 Route 插件投影，再删除策略和绑定。清理失败返回 Result.Success=false，保留策略供排障后重试；不删除绑定的模型、MCP、Agent 或审核引擎服务。网关需满足最低版本 3.9.6，且已安装、启用并加载 cngw-ai-custom-guardrail。创建、修改、删除要求网关处于稳定 Running 状态，升级/回滚/撤销升级期间不能修改策略。
+
+        本产品为 cngw，版本为 2023-04-18。公共参数及签名按云 API 规范配置；在 API Explorer 选择目标环境，示例正文仅为业务参数，中文诊断示例以公共参数 Language=zh-CN 为前提。响应业务字段统一位于 Response.Result，Response.RequestId 为云 API 请求 ID；HTTP 成功不代表 Result.Success=true。示例 ID、域名和鉴权值均为占位内容，须替换为实际值。
+
+        :param request: Request instance for DeleteAIGWCustomGuardrailPolicy.
+        :type request: :class:`tencentcloud.cngw.v20230418.models.DeleteAIGWCustomGuardrailPolicyRequest`
+        :rtype: :class:`tencentcloud.cngw.v20230418.models.DeleteAIGWCustomGuardrailPolicyResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("DeleteAIGWCustomGuardrailPolicy", params, headers=headers)
+            response = json.loads(body)
+            model = models.DeleteAIGWCustomGuardrailPolicyResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
     def DeleteCloudNativeAPIGatewayAIServiceSource(self, request):
         r"""删除云原生网关AI服务来源
 
@@ -444,6 +519,29 @@ class CngwClient(AbstractClient):
                 raise TencentCloudSDKException(type(e).__name__, str(e))
 
 
+    def DeleteCloudNativeAPIGatewayIPRestriction(self, request):
+        r"""删除云原生网关访问控制
+
+        :param request: Request instance for DeleteCloudNativeAPIGatewayIPRestriction.
+        :type request: :class:`tencentcloud.cngw.v20230418.models.DeleteCloudNativeAPIGatewayIPRestrictionRequest`
+        :rtype: :class:`tencentcloud.cngw.v20230418.models.DeleteCloudNativeAPIGatewayIPRestrictionResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("DeleteCloudNativeAPIGatewayIPRestriction", params, headers=headers)
+            response = json.loads(body)
+            model = models.DeleteCloudNativeAPIGatewayIPRestrictionResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
     def DeleteCloudNativeAPIGatewayLLMModelAPI(self, request):
         r"""删除 LLM 模型 API。
 
@@ -584,7 +682,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 节）。
+        【消费者批量自动分配 API Key｜修改：新增未完成批次保护，字段不变】目标密钥属于批次且对应项处于 Pending/Running/Reconciling 时，删除返回 OperationDenied.BatchKeyPending。完成后仍执行原绑定/依赖删除检查；原 GatewayId/SecretKeyId 不变，成功不新增业务 Result。删除已生成密钥不改写批次历史成功，后续批次明文读取返回逐项 ResourceNotFound.SecretKey。
 
         :param request: Request instance for DeleteCloudNativeAPIGatewaySecretKey.
         :type request: :class:`tencentcloud.cngw.v20230418.models.DeleteCloudNativeAPIGatewaySecretKeyRequest`
@@ -606,6 +704,131 @@ class CngwClient(AbstractClient):
                 raise TencentCloudSDKException(type(e).__name__, str(e))
 
 
+    def DescribeAIGWCustomGuardrailBindableResources(self, request):
+        r"""按一种业务资源类型分页查询绑定候选及 Route 占用情况。编辑策略时传 PolicyId 排除自身占用，选择时同时检查 Supported 和 Occupied。当前屏蔽的 Dify/Custom Agent、Legacy SSE MCP 不进入可绑定列表。创建策略时使用 ResourceId，不使用 RouteIds。
+
+        本产品为 cngw，版本为 2023-04-18。公共参数及签名按云 API 规范配置；在 API Explorer 选择目标环境，示例正文仅为业务参数，中文诊断示例以公共参数 Language=zh-CN 为前提。响应业务字段统一位于 Response.Result，Response.RequestId 为云 API 请求 ID；HTTP 成功不代表 Result.Success=true。示例 ID、域名和鉴权值均为占位内容，须替换为实际值。
+
+        :param request: Request instance for DescribeAIGWCustomGuardrailBindableResources.
+        :type request: :class:`tencentcloud.cngw.v20230418.models.DescribeAIGWCustomGuardrailBindableResourcesRequest`
+        :rtype: :class:`tencentcloud.cngw.v20230418.models.DescribeAIGWCustomGuardrailBindableResourcesResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("DescribeAIGWCustomGuardrailBindableResources", params, headers=headers)
+            response = json.loads(body)
+            model = models.DescribeAIGWCustomGuardrailBindableResourcesResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
+    def DescribeAIGWCustomGuardrailCapabilities(self, request):
+        r"""查询当前控制面支持的协议分类、业务资源类型、审核方向及限制。会校验网关版本和插件可用性。Limits 是能力说明，不等于创建/修改策略可配置的字段，也不是逐个数据面实例的实时状态。
+
+        本产品为 cngw，版本为 2023-04-18。公共参数及签名按云 API 规范配置；在 API Explorer 选择目标环境，示例正文仅为业务参数，中文诊断示例以公共参数 Language=zh-CN 为前提。响应业务字段统一位于 Response.Result，Response.RequestId 为云 API 请求 ID；HTTP 成功不代表 Result.Success=true。示例 ID、域名和鉴权值均为占位内容，须替换为实际值。
+
+        :param request: Request instance for DescribeAIGWCustomGuardrailCapabilities.
+        :type request: :class:`tencentcloud.cngw.v20230418.models.DescribeAIGWCustomGuardrailCapabilitiesRequest`
+        :rtype: :class:`tencentcloud.cngw.v20230418.models.DescribeAIGWCustomGuardrailCapabilitiesResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("DescribeAIGWCustomGuardrailCapabilities", params, headers=headers)
+            response = json.loads(body)
+            model = models.DescribeAIGWCustomGuardrailCapabilitiesResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
+    def DescribeAIGWCustomGuardrailHits(self, request):
+        r"""从网关 RuntimeEventLog 对应 CLS 主题分页查询审核记录，调用前需开启日志投递。按时间倒序返回，查询时间入参为 Unix 秒，记录 Timestamp 为 Unix 毫秒；同一流式业务请求可有多次审核记录。当前查询无导出接口的 1000 条截断限制，使用 Offset/Limit 翻页。
+
+        本产品为 cngw，版本为 2023-04-18。公共参数及签名按云 API 规范配置；在 API Explorer 选择目标环境，示例正文仅为业务参数，中文诊断示例以公共参数 Language=zh-CN 为前提。响应业务字段统一位于 Response.Result，Response.RequestId 为云 API 请求 ID；HTTP 成功不代表 Result.Success=true。示例 ID、域名和鉴权值均为占位内容，须替换为实际值。
+
+        :param request: Request instance for DescribeAIGWCustomGuardrailHits.
+        :type request: :class:`tencentcloud.cngw.v20230418.models.DescribeAIGWCustomGuardrailHitsRequest`
+        :rtype: :class:`tencentcloud.cngw.v20230418.models.DescribeAIGWCustomGuardrailHitsResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("DescribeAIGWCustomGuardrailHits", params, headers=headers)
+            response = json.loads(body)
+            model = models.DescribeAIGWCustomGuardrailHitsResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
+    def DescribeAIGWCustomGuardrailPolicy(self, request):
+        r"""查询已有策略、脱敏鉴权配置、资源绑定与配置同步状态。Result 本身就是策略对象，不是 Result.Policy。密钥不返回明文，编辑时省略 ApiKey 即可保留。
+
+        本产品为 cngw，版本为 2023-04-18。公共参数及签名按云 API 规范配置；在 API Explorer 选择目标环境，示例正文仅为业务参数，中文诊断示例以公共参数 Language=zh-CN 为前提。响应业务字段统一位于 Response.Result，Response.RequestId 为云 API 请求 ID；HTTP 成功不代表 Result.Success=true。示例 ID、域名和鉴权值均为占位内容，须替换为实际值。
+
+        :param request: Request instance for DescribeAIGWCustomGuardrailPolicy.
+        :type request: :class:`tencentcloud.cngw.v20230418.models.DescribeAIGWCustomGuardrailPolicyRequest`
+        :rtype: :class:`tencentcloud.cngw.v20230418.models.DescribeAIGWCustomGuardrailPolicyResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("DescribeAIGWCustomGuardrailPolicy", params, headers=headers)
+            response = json.loads(body)
+            model = models.DescribeAIGWCustomGuardrailPolicyResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
+    def DescribeAIGWCustomGuardrailPolicyList(self, request):
+        r"""按网关分页查询策略；Limit 必填，范围 1～100，Offset 默认 0。支持名称/描述搜索及配置过滤；同项多值 OR，不同过滤项 AND。Result.DataList 为策略数组。
+
+        本产品为 cngw，版本为 2023-04-18。公共参数及签名按云 API 规范配置；在 API Explorer 选择目标环境，示例正文仅为业务参数，中文诊断示例以公共参数 Language=zh-CN 为前提。响应业务字段统一位于 Response.Result，Response.RequestId 为云 API 请求 ID；HTTP 成功不代表 Result.Success=true。示例 ID、域名和鉴权值均为占位内容，须替换为实际值。
+
+        :param request: Request instance for DescribeAIGWCustomGuardrailPolicyList.
+        :type request: :class:`tencentcloud.cngw.v20230418.models.DescribeAIGWCustomGuardrailPolicyListRequest`
+        :rtype: :class:`tencentcloud.cngw.v20230418.models.DescribeAIGWCustomGuardrailPolicyListResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("DescribeAIGWCustomGuardrailPolicyList", params, headers=headers)
+            response = json.loads(body)
+            model = models.DescribeAIGWCustomGuardrailPolicyListResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
     def DescribeCNGWServicesWithRoutes(self, request):
         r"""查询云原生网关服务和路由列表
 
@@ -752,6 +975,29 @@ class CngwClient(AbstractClient):
                 raise TencentCloudSDKException(type(e).__name__, str(e))
 
 
+    def DescribeCloudNativeAPIGatewayIPRestriction(self, request):
+        r"""查询云原生网关访问控制
+
+        :param request: Request instance for DescribeCloudNativeAPIGatewayIPRestriction.
+        :type request: :class:`tencentcloud.cngw.v20230418.models.DescribeCloudNativeAPIGatewayIPRestrictionRequest`
+        :rtype: :class:`tencentcloud.cngw.v20230418.models.DescribeCloudNativeAPIGatewayIPRestrictionResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("DescribeCloudNativeAPIGatewayIPRestriction", params, headers=headers)
+            response = json.loads(body)
+            model = models.DescribeCloudNativeAPIGatewayIPRestrictionResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
     def DescribeCloudNativeAPIGatewayLLMModelAPI(self, request):
         r"""查询单个 LLM 模型 API 详情。
 
@@ -845,7 +1091,7 @@ class CngwClient(AbstractClient):
 
 
     def DescribeCloudNativeAPIGatewayLLMTokenUsageList(self, request):
-        r"""查询 AI 网关Token 消耗统计（消费者消费金额数据）
+        r"""查询 AI 网关 Token 用量列表。网关版本不低于 3.9.8 且 Dimension=ConsumerGroup 时，未指定节点筛选则列出 Kong CP 当前目录的全部真实节点，包含同步、自定义、禁用及保留中的软删节点，排除合成展示节点。按当前名称、节点 UUID 升序，先分页节点再查询历史指标；无调用节点仍返回，Token 与请求数补零。节点指标包含历史下属，同一请求可计入多个组行，不能逐行相加作为网关总量。 网关版本不低于 3.9.8 时，所有支持维度的消费者组筛选统一为 ConsumerGroupId / ConsumerGroupName，均按历史归属查询；旧 OrganizationNodeId / OrganizationNodeName 筛选不再接受。
 
         :param request: Request instance for DescribeCloudNativeAPIGatewayLLMTokenUsageList.
         :type request: :class:`tencentcloud.cngw.v20230418.models.DescribeCloudNativeAPIGatewayLLMTokenUsageListRequest`
@@ -868,7 +1114,7 @@ class CngwClient(AbstractClient):
 
 
     def DescribeCloudNativeAPIGatewayLLMTokenUsageStatistics(self, request):
-        r"""查询 AI 网关Token 消耗统计汇总含（消费者消费金额数据）
+        r"""查询 AI 网关 Token 用量汇总。网关版本不低于 3.9.8 且 Dimension=ConsumerGroup 时，按历史归属对日志并集去重统计；无节点筛选则查询全部成功归属且祖先集合非空的日志，不依赖当前组织目录候选。返回一份汇总，TopConsumers 为空数组。 网关版本不低于 3.9.8 时，所有支持维度的消费者组筛选统一为 ConsumerGroupId / ConsumerGroupName，均按历史归属查询；旧 OrganizationNodeId / OrganizationNodeName 筛选不再接受。
 
         :param request: Request instance for DescribeCloudNativeAPIGatewayLLMTokenUsageStatistics.
         :type request: :class:`tencentcloud.cngw.v20230418.models.DescribeCloudNativeAPIGatewayLLMTokenUsageStatisticsRequest`
@@ -1168,8 +1414,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 节）。
+        普通版批量新建密钥的生成来源扩展：新页面按需 IncludeCreationInfo=true，省略/false 保持原响应字段。原 GenerateType 不新增 Batch；批量记录仍为 System。
+        【消费者批量自动分配 API Key｜修改：可选参数及可选出参】增加可选 IncludeCreationInfo（默认 false）。仅 true 且 ResourceType=Consumer 时在原 Result 增加 CredentialGenerateType、CreationSource、BatchId 三个非必返字段；省略/false 保持旧响应。原字段、SecretValue 脱敏和单条详情结构不变。
 
         :param request: Request instance for DescribeCloudNativeAPIGatewaySecretKey.
         :type request: :class:`tencentcloud.cngw.v20230418.models.DescribeCloudNativeAPIGatewaySecretKeyRequest`
@@ -1193,8 +1439,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 节）。
+        普通版批量新建密钥的生成来源扩展：新页面按需 IncludeCreationInfo=true，省略/false 保持原响应字段。原 GenerateType 不新增 Batch；批量记录仍为 System。
+        【消费者批量自动分配 API Key｜修改：可选参数、可选出参及筛选】增加可选 IncludeCreationInfo（默认 false）。仅 true 且 ResourceType=Consumer 时在原 Result.SecretKeys[] 增加 CredentialGenerateType、CreationSource、BatchId 三个非必返字段；Result.TotalCount/SecretKeys 结构不变。Filters 新增 CredentialGenerateType、CreationSource，先过滤后计数分页，与是否返回来源字段独立；保留原 GenerateType 枚举和原分页上限。
 
         :param request: Request instance for DescribeCloudNativeAPIGatewaySecretKeyList.
         :type request: :class:`tencentcloud.cngw.v20230418.models.DescribeCloudNativeAPIGatewaySecretKeyListRequest`
@@ -1239,6 +1485,58 @@ class CngwClient(AbstractClient):
                 raise TencentCloudSDKException(type(e).__name__, str(e))
 
 
+    def ExportAIGWCustomGuardrailHits(self, request):
+        r"""从 RuntimeEventLog 对应 CLS 主题同步导出审核记录，需先开启投递。单次最多 1000 条，可选择 csv（默认）或 json；Result.Content 是 Base64 编码文件内容，不是下载链接。Truncated=true 时可能还有更多记录，请缩小时间范围分别导出。
+
+        本产品为 cngw，版本为 2023-04-18。公共参数及签名按云 API 规范配置；在 API Explorer 选择目标环境，示例正文仅为业务参数，中文诊断示例以公共参数 Language=zh-CN 为前提。响应业务字段统一位于 Response.Result，Response.RequestId 为云 API 请求 ID；HTTP 成功不代表 Result.Success=true。示例 ID、域名和鉴权值均为占位内容，须替换为实际值。
+
+        :param request: Request instance for ExportAIGWCustomGuardrailHits.
+        :type request: :class:`tencentcloud.cngw.v20230418.models.ExportAIGWCustomGuardrailHitsRequest`
+        :rtype: :class:`tencentcloud.cngw.v20230418.models.ExportAIGWCustomGuardrailHitsResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("ExportAIGWCustomGuardrailHits", params, headers=headers)
+            response = json.loads(body)
+            model = models.ExportAIGWCustomGuardrailHitsResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
+    def ModifyAIGWCustomGuardrailPolicy(self, request):
+        r"""局部修改已有策略并重新同步。省略字段保留原值，显式 false/0/[] 与省略不同；数组按整体替换，Scope 传入时替换完整范围。切换 AddressMode 时会自动清除未显式传入的另一模式地址字段；AuthType=none 会清除已有密钥并默认清空 HeaderName。请检查 Result.Success 和 FailedResources。网关需满足最低版本 3.9.6，且已安装、启用并加载 cngw-ai-custom-guardrail。创建、修改、删除要求网关处于稳定 Running 状态，升级/回滚/撤销升级期间不能修改策略。
+
+        本产品为 cngw，版本为 2023-04-18。公共参数及签名按云 API 规范配置；在 API Explorer 选择目标环境，示例正文仅为业务参数，中文诊断示例以公共参数 Language=zh-CN 为前提。响应业务字段统一位于 Response.Result，Response.RequestId 为云 API 请求 ID；HTTP 成功不代表 Result.Success=true。示例 ID、域名和鉴权值均为占位内容，须替换为实际值。
+
+        输入约束：新配置只接受 field_mapping，不再默认为 standard_v2。创建时鉴权和检测行为必须完整填写；修改为 PATCH，省略保留，显式空值不补默认值。存量 standard_v2 策略仍可查询、删除或直接停用；修改其判定配置或重新启用前需迁移到 field_mapping。条件必填由后端按完整配置校验，非法配置不写库、不下发。
+
+        :param request: Request instance for ModifyAIGWCustomGuardrailPolicy.
+        :type request: :class:`tencentcloud.cngw.v20230418.models.ModifyAIGWCustomGuardrailPolicyRequest`
+        :rtype: :class:`tencentcloud.cngw.v20230418.models.ModifyAIGWCustomGuardrailPolicyResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("ModifyAIGWCustomGuardrailPolicy", params, headers=headers)
+            response = json.loads(body)
+            model = models.ModifyAIGWCustomGuardrailPolicyResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
     def ModifyCloudNativeAPIGatewayAIServiceSource(self, request):
         r"""修改云原生网关AI服务来源
 
@@ -1332,7 +1630,7 @@ class CngwClient(AbstractClient):
 
 
     def ModifyCloudNativeAPIGatewayLLMModelService(self, request):
-        r"""修改 LLM 模型服务。
+        r"""更新指定网关实例内的 LLM 模型服务，可调整该服务向上游请求压缩响应的协商方式。
 
         :param request: Request instance for ModifyCloudNativeAPIGatewayLLMModelService.
         :type request: :class:`tencentcloud.cngw.v20230418.models.ModifyCloudNativeAPIGatewayLLMModelServiceRequest`
@@ -1563,7 +1861,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 节）。
+        【消费者批量自动分配 API Key｜修改：新增未完成批次保护，字段不变】目标密钥属于批次且对应项处于 Pending/Running/Reconciling 时，编辑返回 OperationDenied.BatchKeyPending，提示等待批次完成。其他情况继续原编辑校验和行为；原 GatewayId/SecretKeyId/Name/Description 不变，成功不新增业务 Result。
 
         :param request: Request instance for ModifyCloudNativeAPIGatewaySecretKey.
         :type request: :class:`tencentcloud.cngw.v20230418.models.ModifyCloudNativeAPIGatewaySecretKeyRequest`
@@ -1656,7 +1954,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 节）。
+        【消费者批量自动分配 API Key｜修改：新增未完成批次保护，字段不变】目标密钥属于批次且对应项处于 Pending/Running/Reconciling 时，解绑返回 OperationDenied.BatchKeyPending。完成后继续原解绑；原 GatewayId/SecretKeyId/ResourceType/ResourceIds 不变，成功不新增业务 Result。解绑不改写批次历史成功，后续批次明文读取返回逐项 OperationDenied.BindingChanged。
 
         :param request: Request instance for UnbindCloudNativeAPIGatewaySecretKey.
         :type request: :class:`tencentcloud.cngw.v20230418.models.UnbindCloudNativeAPIGatewaySecretKeyRequest`