tencentcloud-sdk-python-ags 3.0.1485__tar.gz

tencentcloud_sdk_python_ags-3.0.1485/PKG-INFO

@@ -0,0 +1,46 @@
+Metadata-Version: 2.1
+Name: tencentcloud-sdk-python-ags
+Version: 3.0.1485
+Summary: Tencent Cloud Ags SDK for Python
+Home-page: https://github.com/TencentCloud/tencentcloud-sdk-python
+Author: Tencent Cloud
+Maintainer-email: tencentcloudapi@tencent.com
+License: Apache License 2.0
+Platform: any
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python
+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.0.1485
+
+============================
+Tencent Cloud SDK for Python
+============================
+
+Tencent Cloud Python Ags SDK is the official software development kit, which allows Python developers to write software that makes use of Tencent Cloud services like CVM and CBS.
+The SDK works on Python versions:
+
+   * 2.7 and greater, including 3.x
+
+Quick Start
+-----------
+
+First, install the library:
+
+.. code-block:: sh
+
+    $ pip install tencentcloud-sdk-python-common
+    $ pip install tencentcloud-sdk-python-ags
+
+or download source code from github and install:
+
+.. code-block:: sh
+
+    $ git clone https://github.com/tencentcloud/tencentcloud-sdk-python.git
+    $ cd tencentcloud-sdk-python
+    $ python package.py --components common ags
+

tencentcloud_sdk_python_ags-3.0.1485/README.rst

@@ -0,0 +1,27 @@
+============================
+Tencent Cloud SDK for Python
+============================
+
+Tencent Cloud Python Ags SDK is the official software development kit, which allows Python developers to write software that makes use of Tencent Cloud services like CVM and CBS.
+The SDK works on Python versions:
+
+   * 2.7 and greater, including 3.x
+
+Quick Start
+-----------
+
+First, install the library:
+
+.. code-block:: sh
+
+    $ pip install tencentcloud-sdk-python-common
+    $ pip install tencentcloud-sdk-python-ags
+
+or download source code from github and install:
+
+.. code-block:: sh
+
+    $ git clone https://github.com/tencentcloud/tencentcloud-sdk-python.git
+    $ cd tencentcloud-sdk-python
+    $ python package.py --components common ags
+

tencentcloud_sdk_python_ags-3.0.1485/setup.cfg

@@ -0,0 +1,7 @@
+[bdist_wheel]
+universal = 1
+
+[egg_info]
+tag_build = 
+tag_date = 0
+

tencentcloud_sdk_python_ags-3.0.1485/setup.py

@@ -0,0 +1,32 @@
+#!/usr/bin/env python
+import os
+from setuptools import setup, find_packages
+
+import tencentcloud
+
+ROOT = os.path.dirname(__file__)
+
+setup(
+    name='tencentcloud-sdk-python-ags',
+    install_requires=["tencentcloud-sdk-python-common>=3.0.1485,<4.0.0"],
+    version=tencentcloud.__version__,
+    description='Tencent Cloud Ags SDK for Python',
+    long_description=open('README.rst').read(),
+    author='Tencent Cloud',
+    url='https://github.com/TencentCloud/tencentcloud-sdk-python',
+    maintainer_email="tencentcloudapi@tencent.com",
+    scripts=[],
+    packages=find_packages(exclude=["tests*"]),
+    license="Apache License 2.0",
+    platforms='any',
+    classifiers=[
+        'Development Status :: 5 - Production/Stable',
+        'Intended Audience :: Developers',
+        'License :: OSI Approved :: Apache Software License',
+        'Programming Language :: Python',
+        'Programming Language :: Python :: 2.7',
+        'Programming Language :: Python :: 3',
+        'Programming Language :: Python :: 3.6',
+        'Programming Language :: Python :: 3.7',
+    ],
+)

tencentcloud_sdk_python_ags-3.0.1485/tencentcloud/__init__.py

@@ -0,0 +1,17 @@
+# -*- coding: utf-8 -*-
+# Copyright 1999-2018 Tencent Ltd.
+#
+# 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.
+
+
+__version__ = '3.0.1485'

tencentcloud_sdk_python_ags-3.0.1485/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_ags-3.0.1485/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'