tencentcloud-sdk-python 3.0.1482__tar.gz → 3.0.1486__tar.gz

{tencentcloud_sdk_python-3.0.1482/tencentcloud_sdk_python.egg-info → tencentcloud_sdk_python-3.0.1486}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: tencentcloud-sdk-python
-Version: 3.0.1482
+Version: 3.0.1486
 Summary: Tencent Cloud SDK for Python
 Home-page: https://github.com/TencentCloud/tencentcloud-sdk-python
 Author: Tencent Cloud

{tencentcloud_sdk_python-3.0.1482 → tencentcloud_sdk_python-3.0.1486}/tencentcloud/__init__.py

@@ -14,4 +14,4 @@
 # limitations under the License.
 
 
-__version__ = '3.0.1482'
+__version__ = '3.0.1486'

tencentcloud_sdk_python-3.0.1486/tencentcloud/ags/v20250920/ags_client.py

@@ -0,0 +1,303 @@
+# -*- coding: utf8 -*-
+# Copyright (c) 2017-2025 Tencent. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import json
+
+from tencentcloud.common.exception.tencent_cloud_sdk_exception import TencentCloudSDKException
+from tencentcloud.common.abstract_client import AbstractClient
+from tencentcloud.ags.v20250920 import models
+
+
+class AgsClient(AbstractClient):
+    _apiVersion = '2025-09-20'
+    _endpoint = 'ags.tencentcloudapi.com'
+    _service = 'ags'
+
+
+    def AcquireSandboxInstanceToken(self, request):
+        r"""获取访问沙箱工具时所需要使用的访问Token，创建沙箱实例后需调用此接口获取沙箱实例访问Token。
+        此Token可用于调用代码沙箱实例执行代码，或浏览器沙箱实例进行浏览器操作等。
+
+        :param request: Request instance for AcquireSandboxInstanceToken.
+        :type request: :class:`tencentcloud.ags.v20250920.models.AcquireSandboxInstanceTokenRequest`
+        :rtype: :class:`tencentcloud.ags.v20250920.models.AcquireSandboxInstanceTokenResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("AcquireSandboxInstanceToken", params, headers=headers)
+            response = json.loads(body)
+            model = models.AcquireSandboxInstanceTokenResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
+    def CreateAPIKey(self, request):
+        r"""创建新的API密钥，用于调用Agent Sandbox接口。相较于腾讯云Secret ID Secret Key支持调用所有接口使用，仅有部分接口支持使用API密钥调用。
+
+        :param request: Request instance for CreateAPIKey.
+        :type request: :class:`tencentcloud.ags.v20250920.models.CreateAPIKeyRequest`
+        :rtype: :class:`tencentcloud.ags.v20250920.models.CreateAPIKeyResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("CreateAPIKey", params, headers=headers)
+            response = json.loads(body)
+            model = models.CreateAPIKeyResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
+    def CreateSandboxTool(self, request):
+        r"""创建沙箱工具
+
+        :param request: Request instance for CreateSandboxTool.
+        :type request: :class:`tencentcloud.ags.v20250920.models.CreateSandboxToolRequest`
+        :rtype: :class:`tencentcloud.ags.v20250920.models.CreateSandboxToolResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("CreateSandboxTool", params, headers=headers)
+            response = json.loads(body)
+            model = models.CreateSandboxToolResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
+    def DeleteAPIKey(self, request):
+        r"""删除API密钥。注意区别于腾讯云Secret ID Secret Key，本接口删除的是Agent Sandbox专用API key。
+
+        :param request: Request instance for DeleteAPIKey.
+        :type request: :class:`tencentcloud.ags.v20250920.models.DeleteAPIKeyRequest`
+        :rtype: :class:`tencentcloud.ags.v20250920.models.DeleteAPIKeyResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("DeleteAPIKey", params, headers=headers)
+            response = json.loads(body)
+            model = models.DeleteAPIKeyResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
+    def DeleteSandboxTool(self, request):
+        r"""删除沙箱工具
+
+        :param request: Request instance for DeleteSandboxTool.
+        :type request: :class:`tencentcloud.ags.v20250920.models.DeleteSandboxToolRequest`
+        :rtype: :class:`tencentcloud.ags.v20250920.models.DeleteSandboxToolResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("DeleteSandboxTool", params, headers=headers)
+            response = json.loads(body)
+            model = models.DeleteSandboxToolResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
+    def DescribeAPIKeyList(self, request):
+        r"""获取API密钥列表，包含API密钥简略信息，包含名称、创建时间等。
+
+        :param request: Request instance for DescribeAPIKeyList.
+        :type request: :class:`tencentcloud.ags.v20250920.models.DescribeAPIKeyListRequest`
+        :rtype: :class:`tencentcloud.ags.v20250920.models.DescribeAPIKeyListResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("DescribeAPIKeyList", params, headers=headers)
+            response = json.loads(body)
+            model = models.DescribeAPIKeyListResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
+    def DescribeSandboxInstanceList(self, request):
+        r"""查询沙箱实例列表
+
+        :param request: Request instance for DescribeSandboxInstanceList.
+        :type request: :class:`tencentcloud.ags.v20250920.models.DescribeSandboxInstanceListRequest`
+        :rtype: :class:`tencentcloud.ags.v20250920.models.DescribeSandboxInstanceListResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("DescribeSandboxInstanceList", params, headers=headers)
+            response = json.loads(body)
+            model = models.DescribeSandboxInstanceListResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
+    def DescribeSandboxToolList(self, request):
+        r"""查询沙箱工具列表
+
+        :param request: Request instance for DescribeSandboxToolList.
+        :type request: :class:`tencentcloud.ags.v20250920.models.DescribeSandboxToolListRequest`
+        :rtype: :class:`tencentcloud.ags.v20250920.models.DescribeSandboxToolListResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("DescribeSandboxToolList", params, headers=headers)
+            response = json.loads(body)
+            model = models.DescribeSandboxToolListResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
+    def StartSandboxInstance(self, request):
+        r"""启动沙箱实例
+
+        :param request: Request instance for StartSandboxInstance.
+        :type request: :class:`tencentcloud.ags.v20250920.models.StartSandboxInstanceRequest`
+        :rtype: :class:`tencentcloud.ags.v20250920.models.StartSandboxInstanceResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("StartSandboxInstance", params, headers=headers)
+            response = json.loads(body)
+            model = models.StartSandboxInstanceResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
+    def StopSandboxInstance(self, request):
+        r"""停止沙箱实例
+
+        :param request: Request instance for StopSandboxInstance.
+        :type request: :class:`tencentcloud.ags.v20250920.models.StopSandboxInstanceRequest`
+        :rtype: :class:`tencentcloud.ags.v20250920.models.StopSandboxInstanceResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("StopSandboxInstance", params, headers=headers)
+            response = json.loads(body)
+            model = models.StopSandboxInstanceResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
+    def UpdateSandboxInstance(self, request):
+        r"""更新沙箱实例
+
+        :param request: Request instance for UpdateSandboxInstance.
+        :type request: :class:`tencentcloud.ags.v20250920.models.UpdateSandboxInstanceRequest`
+        :rtype: :class:`tencentcloud.ags.v20250920.models.UpdateSandboxInstanceResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("UpdateSandboxInstance", params, headers=headers)
+            response = json.loads(body)
+            model = models.UpdateSandboxInstanceResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
+    def UpdateSandboxTool(self, request):
+        r"""更新沙箱工具
+
+        :param request: Request instance for UpdateSandboxTool.
+        :type request: :class:`tencentcloud.ags.v20250920.models.UpdateSandboxToolRequest`
+        :rtype: :class:`tencentcloud.ags.v20250920.models.UpdateSandboxToolResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("UpdateSandboxTool", params, headers=headers)
+            response = json.loads(body)
+            model = models.UpdateSandboxToolResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))

tencentcloud_sdk_python-3.0.1486/tencentcloud/ags/v20250920/errorcodes.py

@@ -0,0 +1,81 @@
+# -*- coding: utf8 -*-
+# Copyright (c) 2017-2025 Tencent. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# 操作失败。
+FAILEDOPERATION = 'FailedOperation'
+
+# 重复请求（幂等性检查）
+FAILEDOPERATION_DUPLICATEREQUEST = 'FailedOperation.DuplicateRequest'
+
+# 请求正在处理中（幂等性检查）
+FAILEDOPERATION_REQUESTINPROGRESS = 'FailedOperation.RequestInProgress'
+
+# 内部错误。
+INTERNALERROR = 'InternalError'
+
+# 参数错误。
+INVALIDPARAMETER = 'InvalidParameter'
+
+# 参数取值错误。
+INVALIDPARAMETERVALUE = 'InvalidParameterValue'
+
+# InstanceIds 参数格式错误或 ID 列表超过最大数量限制
+INVALIDPARAMETERVALUE_INSTANCEIDS = 'InvalidParameterValue.InstanceIds'
+
+# 沙箱工具名称不可用，可能是已经存在
+INVALIDPARAMETERVALUE_SANDBOXTOOL = 'InvalidParameterValue.SandboxTool'
+
+# 超时时间格式错误或超过最大限制
+INVALIDPARAMETERVALUE_TIMEOUT = 'InvalidParameterValue.Timeout'
+
+# ToolIds 参数格式错误或 ID 列表超过最大数量限制
+INVALIDPARAMETERVALUE_TOOLIDS = 'InvalidParameterValue.ToolIds'
+
+# 不支持的沙箱工具类型
+INVALIDPARAMETERVALUE_TOOLTYPE = 'InvalidParameterValue.ToolType'
+
+# 账号下 API 密钥数量达到上限
+LIMITEXCEEDED_APIKEYQUOTA = 'LimitExceeded.APIKeyQuota'
+
+# 沙箱实例配额超限
+LIMITEXCEEDED_SANDBOXINSTANCE = 'LimitExceeded.SandboxInstance'
+
+# 缺少参数错误。
+MISSINGPARAMETER = 'MissingParameter'
+
+# 沙箱工具正在使用中
+RESOURCEINUSE_SANDBOXTOOL = 'ResourceInUse.SandboxTool'
+
+# 资源不存在。
+RESOURCENOTFOUND = 'ResourceNotFound'
+
+# 沙箱实例不存在
+RESOURCENOTFOUND_SANDBOXINSTANCE = 'ResourceNotFound.SandboxInstance'
+
+# 沙箱工具不存在
+RESOURCENOTFOUND_SANDBOXTOOL = 'ResourceNotFound.SandboxTool'
+
+# 沙箱工具不可用
+RESOURCEUNAVAILABLE_SANDBOXTOOL = 'ResourceUnavailable.SandboxTool'
+
+# 未授权操作。
+UNAUTHORIZEDOPERATION = 'UnauthorizedOperation'
+
+# 操作不支持。
+UNSUPPORTEDOPERATION = 'UnsupportedOperation'
+
+# 实例状态不允许修改（只有RUNNING状态的实例可以修改）
+UNSUPPORTEDOPERATION_SANDBOXINSTANCE = 'UnsupportedOperation.SandboxInstance'