tencentcloud-sdk-nodejs-ags 4.1.141

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   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.

package/README.md

@@ -0,0 +1,205 @@
+# 简介
+
+欢迎使用腾讯云开发者工具套件（SDK），Node.js SDK 4.0 是云 API 3.0 平台的配套工具。
+为方便 Node.js 开发者调试和接入腾讯云产品 API，这里向您介绍适用于 Node.js 的腾讯云开发工具包，并提供首次使用开发工具包的简单示例。让您快速获取腾讯云 Node.js SDK 并开始调用。
+
+# 依赖环境
+
+1. Node.js 10.0.0 版本及以上。
+2. 注意：部分产品需在 [腾讯云控制台](https://console.cloud.tencent.com/) 开通服务后才能使用。
+
+# 获取安装
+
+使用 SDK 需要 API 密钥，可前往 [腾讯云控制台 - 访问密钥](https://console.cloud.tencent.com/cam/capi) 页面申请，API 密钥包括 SecretID 和 SecretKey，密钥须严格保管，避免泄露。
+
+## 通过 npm 安装
+
+通过 npm 获取安装是使用 Node.js SDK 的推荐方法，关于 npm 详细可参考 [NPM 官网](https://www.npmjs.com/) 。
+
+### 安装指定产品 SDK（推荐）
+
+安装 CVM SDK：
+
+```
+npm install tencentcloud-sdk-nodejs-cvm --save
+```
+
+安装 VPC SDK：
+
+```
+npm install tencentcloud-sdk-nodejs-vpc --save
+```
+
+具体产品的缩写表请参考 [products.md](./products.md) 中的包名字段。
+
+安装指定产品 SDK 后，注意修改引入的包名：
+
+```diff
+- const tencentcloud = require("tencentcloud-sdk-nodejs")
++ const { cvm } = require("tencentcloud-sdk-nodejs-cvm")
+
+- const CvmClient = tencentcloud.cvm.v20170312.Client
++ const CvmClient = cvm.v20170312.Client
+```
+
+### 安装全产品 SDK
+
+如果项目依赖的云产品较多，可以引入全产品 SDK。
+
+```
+npm install tencentcloud-sdk-nodejs --save
+```
+
+全产品 SDK 包含所有云产品调用代码和 TypeScript 类型文件，体积偏大。对于体积敏感的场景，推荐安装指定产品 SDK。
+
+如果既希望全产品调用，又对包体积比较敏感，可以使用 Slim 版本 SDK。Slim SDK 移除类型文件，并进行了代码压缩，适合体积敏感场景使用：
+
+```
+npm install tencentcloud-sdk-slim-nodejs --save
+```
+
+## 通过源码包安装
+
+1. clone 代码到本地：
+```
+git clone https://cnb.cool/tencent/cloud/api/sdk/tencentcloud-sdk-nodejs
+# 或者
+git clone https://github.com/tencentcloud/tencentcloud-sdk-nodejs
+# 或者
+git clone https://gitee.com/tencentcloud/tencentcloud-sdk-nodejs
+```
+2. 在项目根目录执行以下命令完成构建：
+```
+npm install && npm run build
+```
+3. 打包 NPM 压缩文件，例如 `tencentcloud-sdk-nodejs-4.0.0.tgz`
+```
+npm pack
+```
+4. 安装包到你的项目里：
+```
+npm install /path/to/tencentcloud-sdk-nodejs/tencentcloud-sdk-nodejs-4.0.0.tgz
+```
+
+# 示例
+
+以云服务器产品查询可用区列表接口为例。
+
+```js
+const tencentcloud = require("tencentcloud-sdk-nodejs")
+
+// 导入对应产品模块的client models。
+const CvmClient = tencentcloud.cvm.v20170312.Client
+
+// 实例化要请求产品(以cvm为例)的client对象
+const client = new CvmClient({
+  // 为了保护密钥安全，建议将密钥设置在环境变量中或者配置文件中，请参考本文凭证管理章节。
+  // 硬编码密钥到代码中有可能随代码泄露而暴露，有安全隐患，并不推荐。
+  credential: {
+    secretId: process.env.TENCENTCLOUD_SECRET_ID,
+    secretKey: process.env.TENCENTCLOUD_SECRET_KEY,
+  },
+  // 产品地域
+  region: "ap-shanghai",
+  // 可选配置实例
+  profile: {
+    signMethod: "TC3-HMAC-SHA256", // 签名方法
+    httpProfile: {
+      reqMethod: "POST", // 请求方法
+      reqTimeout: 30, // 请求超时时间，默认60s
+      headers: {
+        // 自定义 header
+      },
+      // proxy: "http://127.0.0.1:8899" // http请求代理
+    },
+  },
+})
+// 通过client对象调用想要访问的接口（Action），需要传入请求对象（Params）以及响应回调函数
+// 即：client.Action(Params).then(res => console.log(res), err => console.error(err))
+// 如：查询云服务器可用区列表
+client.DescribeZones().then(
+  (data) => {
+    console.log(data)
+  },
+  (err) => {
+    console.error("error", err)
+  }
+)
+```
+
+在支持 TypeScript 项目中，采用如下方式调用
+
+```js
+import * as tencentcloud from "tencentcloud-sdk-nodejs"
+
+const CvmClient = tencentcloud.cvm.v20170312.Client
+
+// ...
+```
+
+实例化 `Client` 的入参支持 `clientConfig`，数据结构和说明详见 [ClientConfig](src/common/interface.ts)。
+
+## Common Client
+
+从 4.0.714 版本开始，腾讯云 Node.js SDK 支持使用泛用性的 API 调用方式(Common Client)进行请求。您只需要安装 tencentcloud-sdk-nodejs-common 包，即可向任何产品发起调用。
+
+**注意，您必须明确知道您调用的接口所需参数，否则可能会调用失败。**
+
+详细使用请参阅示例：[使用 Common Client 进行调用](examples/common)
+
+## 更多示例
+
+请参考 [examples](examples) 目录。
+
+# 相关配置
+
+## 代理
+
+如果是有代理的环境下，需要配置代理，请在创建 Client 时传入 [profile.httpProfile.proxy](src/common/interface.ts#L78) 参数，或设置系统环境变量 `http_proxy` ，否则可能无法正常调用，抛出连接超时的异常。
+
+# 凭证管理
+
+除显式传入凭证外，从 `v4.0.506` 起支持 [腾讯云实例角色](https://cloud.tencent.com/document/product/213/47668)
+
+在您为实例绑定角色后，您可以在实例中访问相关元数据接口获取临时凭证。用法可参考 [js 示例代码](./examples/cvm_role.js) 或 [ts 示例代码](./examples/cvm_role.ts)
+```javascript
+// ...
+const CvmRoleCredential = require("tencentcloud-sdk-nodejs/tencentcloud/common/cvm_role_credential").default
+
+new XxxClient({
+  // ...
+  credential: new CvmRoleCredential(),
+  // ...
+})
+```
+
+# 常见问题
+- webpack 打包出错/浏览器报错
+
+  请**务必不要**将此 SDK 直接用于 Web 前端（包括小程序等），暴露密钥在这些环境非常不安全。
+
+  正确的做法是在自己的服务端引用此 SDK，并保存好密钥，做好请求鉴权，前端再调用服务端执行业务流程。
+
+- `The "original" argument must be of type Function.`
+
+  通常是因为 Node.js 版本低于 `v10` ，或处于非 Node.js 环境，请再次确认执行环境。
+
+- 请求不通
+
+  设置环境变量 `NODE_DEBUG=http` 来开启请求日志输出来定位问题，例如：
+  ```sh
+  # MacOS
+  NODE_DEBUG=http node app.js
+  # windows cmd
+  set NODE_DEBUG=http & node app.js
+  # windows powershell
+  $env:NODE_DEBUG='http' ; node app.js
+  ```
+  如需要配置代理，请查阅 [代理](#代理)，或设置环境变量 `http_proxy`，例如：
+  ```sh
+  # MacOS
+  http_proxy=http://代理地址:代理端口 node app.js
+  ```
+
+- 整数类型值超出 JavaScript 最大安全整数
+  使用新的数据类型 `BigInt`

package/es/index.js

@@ -0,0 +1 @@
+export * from "./services";

package/es/services/ags/index.js

@@ -0,0 +1,4 @@
+import { v20250920 } from "./v20250920";
+export const ags = {
+    v20250920: v20250920,
+};

package/es/services/ags/v20250920/ags_client.js

@@ -0,0 +1,42 @@
+import * as TencentCloudCommon from "tencentcloud-sdk-nodejs-common";
+export class Client extends TencentCloudCommon.AbstractClient {
+    constructor(clientConfig) {
+        super("ags.tencentcloudapi.com", "2025-09-20", clientConfig);
+    }
+    async UpdateSandboxInstance(req, cb) {
+        return this.request("UpdateSandboxInstance", req, cb);
+    }
+    async StartSandboxInstance(req, cb) {
+        return this.request("StartSandboxInstance", req, cb);
+    }
+    async AcquireSandboxInstanceToken(req, cb) {
+        return this.request("AcquireSandboxInstanceToken", req, cb);
+    }
+    async DescribeSandboxToolList(req, cb) {
+        return this.request("DescribeSandboxToolList", req, cb);
+    }
+    async StopSandboxInstance(req, cb) {
+        return this.request("StopSandboxInstance", req, cb);
+    }
+    async DescribeAPIKeyList(req, cb) {
+        return this.request("DescribeAPIKeyList", req, cb);
+    }
+    async DescribeSandboxInstanceList(req, cb) {
+        return this.request("DescribeSandboxInstanceList", req, cb);
+    }
+    async CreateAPIKey(req, cb) {
+        return this.request("CreateAPIKey", req, cb);
+    }
+    async DeleteSandboxTool(req, cb) {
+        return this.request("DeleteSandboxTool", req, cb);
+    }
+    async DeleteAPIKey(req, cb) {
+        return this.request("DeleteAPIKey", req, cb);
+    }
+    async CreateSandboxTool(req, cb) {
+        return this.request("CreateSandboxTool", req, cb);
+    }
+    async UpdateSandboxTool(req, cb) {
+        return this.request("UpdateSandboxTool", req, cb);
+    }
+}

package/es/services/ags/v20250920/ags_models.js

@@ -0,0 +1 @@
+export {};

package/es/services/ags/v20250920/index.js

@@ -0,0 +1,6 @@
+import * as Models from "./ags_models";
+import { Client } from "./ags_client";
+export const v20250920 = {
+    Client: Client,
+    Models: Models,
+};

package/es/services/index.js

@@ -0,0 +1 @@
+export { ags } from "./ags";

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "tencentcloud-sdk-nodejs-ags",
+  "version": "4.1.141",
+  "description": "腾讯云 API NODEJS SDK",
+  "main": "./tencentcloud/index.js",
+  "module": "./es/index.js",
+  "types": "./tencentcloud/index.d.ts",
+  "scripts": {
+    "test": "mocha -t 10000",
+    "build": "concurrently 'npm:build:cjs' 'npm:build:es'",
+    "build:cjs": "tsc -p tsconfig.json",
+    "build:es": "tsc -p tsconfig.es.json",
+    "build:slim": "node ./scripts/build_slim.js",
+    "prettier": "prettier --config prettier.config.js --write 'src/**/*.{tsx,ts,jsx,js,css,json,vue}'",
+    "clean": "rimraf tencentcloud es",
+    "test:common": "vitest run"
+  },
+  "engines": {
+    "node": ">=10"
+  },
+  "files": [
+    "tencentcloud",
+    "es"
+  ],
+  "keywords": [
+    "tencentcloudapi",
+    "tencentcloud",
+    "qcloud",
+    "sdk",
+    "js",
+    "nodejs"
+  ],
+  "author": "tencentcloudapi",
+  "license": "Apache-2.0",
+  "dependencies": {
+    "tencentcloud-sdk-nodejs-common": "*",
+    "tslib": "1.13.0"
+  },
+  "directories": {
+    "example": "examples",
+    "lib": "lib"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tencentcloud/tencentcloud-sdk-nodejs"
+  },
+  "devDependencies": {
+    "@types/ini": "^4.1.1",
+    "@types/json-bigint": "^1.0.1",
+    "@types/node": "^18.0.0",
+    "@types/node-fetch": "^2.5.7",
+    "@types/uuid": "^9.0.8",
+    "@typescript-eslint/eslint-plugin": "^2.34.0",
+    "@typescript-eslint/parser": "^2.34.0",
+    "babel-eslint": "^10.0.2",
+    "chai": "^4.2.0",
+    "concurrently": "^6.5.1",
+    "esbuild": "^0.25.0",
+    "eslint": "^6.8.0",
+    "eslint-plugin-react": "^7.17.0",
+    "mocha": "^8.4.0",
+    "prettier": "^2.3.0",
+    "rimraf": "^5.0.10",
+    "ts-node": "^8.10.2",
+    "typescript": "^5.9.2",
+    "vitest": "2.1.9"
+  }
+}

package/tencentcloud/index.d.ts

@@ -0,0 +1 @@
+export * from "./services";

package/tencentcloud/index.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./services"), exports);

package/tencentcloud/services/ags/index.d.ts

@@ -0,0 +1,6 @@
+export declare const ags: {
+    v20250920: {
+        Client: typeof import("./v20250920/ags_client").Client;
+        Models: typeof import("./v20250920/ags_models");
+    };
+};

package/tencentcloud/services/ags/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ags = void 0;
+const v20250920_1 = require("./v20250920");
+exports.ags = {
+    v20250920: v20250920_1.v20250920,
+};

package/tencentcloud/services/ags/v20250920/ags_client.d.ts

@@ -0,0 +1,58 @@
+import * as TencentCloudCommon from "tencentcloud-sdk-nodejs-common";
+import { StartSandboxInstanceRequest, StopSandboxInstanceRequest, DescribeSandboxToolListResponse, CreateAPIKeyResponse, DescribeSandboxToolListRequest, CreateSandboxToolRequest, DeleteAPIKeyResponse, UpdateSandboxInstanceResponse, DeleteSandboxToolRequest, CreateAPIKeyRequest, DeleteSandboxToolResponse, StartSandboxInstanceResponse, AcquireSandboxInstanceTokenRequest, DescribeAPIKeyListResponse, DescribeSandboxInstanceListRequest, DescribeAPIKeyListRequest, UpdateSandboxInstanceRequest, CreateSandboxToolResponse, UpdateSandboxToolResponse, DeleteAPIKeyRequest, AcquireSandboxInstanceTokenResponse, StopSandboxInstanceResponse, UpdateSandboxToolRequest, DescribeSandboxInstanceListResponse } from "./ags_models";
+/**
+ * ags client
+ * @class
+ */
+export declare class Client extends TencentCloudCommon.AbstractClient {
+    constructor(clientConfig: TencentCloudCommon.ClientConfig);
+    /**
+     * 更新沙箱实例
+     */
+    UpdateSandboxInstance(req: UpdateSandboxInstanceRequest, cb?: (error: string, rep: UpdateSandboxInstanceResponse) => void): Promise<UpdateSandboxInstanceResponse>;
+    /**
+     * 启动沙箱实例
+     */
+    StartSandboxInstance(req: StartSandboxInstanceRequest, cb?: (error: string, rep: StartSandboxInstanceResponse) => void): Promise<StartSandboxInstanceResponse>;
+    /**
+       * 获取访问沙箱工具时所需要使用的访问Token，创建沙箱实例后需调用此接口获取沙箱实例访问Token。
+  此Token可用于调用代码沙箱实例执行代码，或浏览器沙箱实例进行浏览器操作等。
+       */
+    AcquireSandboxInstanceToken(req: AcquireSandboxInstanceTokenRequest, cb?: (error: string, rep: AcquireSandboxInstanceTokenResponse) => void): Promise<AcquireSandboxInstanceTokenResponse>;
+    /**
+     * 查询沙箱工具列表
+     */
+    DescribeSandboxToolList(req: DescribeSandboxToolListRequest, cb?: (error: string, rep: DescribeSandboxToolListResponse) => void): Promise<DescribeSandboxToolListResponse>;
+    /**
+     * 停止沙箱实例
+     */
+    StopSandboxInstance(req: StopSandboxInstanceRequest, cb?: (error: string, rep: StopSandboxInstanceResponse) => void): Promise<StopSandboxInstanceResponse>;
+    /**
+     * 获取API密钥列表，包含API密钥简略信息，包含名称、创建时间等。
+     */
+    DescribeAPIKeyList(req?: DescribeAPIKeyListRequest, cb?: (error: string, rep: DescribeAPIKeyListResponse) => void): Promise<DescribeAPIKeyListResponse>;
+    /**
+     * 查询沙箱实例列表
+     */
+    DescribeSandboxInstanceList(req: DescribeSandboxInstanceListRequest, cb?: (error: string, rep: DescribeSandboxInstanceListResponse) => void): Promise<DescribeSandboxInstanceListResponse>;
+    /**
+     * 创建新的API密钥，用于调用Agent Sandbox接口。相较于腾讯云Secret ID Secret Key支持调用所有接口使用，仅有部分接口支持使用API密钥调用。
+     */
+    CreateAPIKey(req: CreateAPIKeyRequest, cb?: (error: string, rep: CreateAPIKeyResponse) => void): Promise<CreateAPIKeyResponse>;
+    /**
+     * 删除沙箱工具
+     */
+    DeleteSandboxTool(req: DeleteSandboxToolRequest, cb?: (error: string, rep: DeleteSandboxToolResponse) => void): Promise<DeleteSandboxToolResponse>;
+    /**
+     * 删除API密钥。注意区别于腾讯云Secret ID Secret Key，本接口删除的是Agent Sandbox专用API key。
+     */
+    DeleteAPIKey(req: DeleteAPIKeyRequest, cb?: (error: string, rep: DeleteAPIKeyResponse) => void): Promise<DeleteAPIKeyResponse>;
+    /**
+     * 创建沙箱工具
+     */
+    CreateSandboxTool(req: CreateSandboxToolRequest, cb?: (error: string, rep: CreateSandboxToolResponse) => void): Promise<CreateSandboxToolResponse>;
+    /**
+     * 更新沙箱工具
+     */
+    UpdateSandboxTool(req: UpdateSandboxToolRequest, cb?: (error: string, rep: UpdateSandboxToolResponse) => void): Promise<UpdateSandboxToolResponse>;
+}

package/tencentcloud/services/ags/v20250920/ags_client.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Client = void 0;
+const tslib_1 = require("tslib");
+/* eslint-disable @typescript-eslint/no-unused-vars */
+/*
+ * Copyright (c) 2018 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.
+ */
+const TencentCloudCommon = tslib_1.__importStar(require("tencentcloud-sdk-nodejs-common"));
+/**
+ * ags client
+ * @class
+ */
+class Client extends TencentCloudCommon.AbstractClient {
+    constructor(clientConfig) {
+        super("ags.tencentcloudapi.com", "2025-09-20", clientConfig);
+    }
+    /**
+     * 更新沙箱实例
+     */
+    async UpdateSandboxInstance(req, cb) {
+        return this.request("UpdateSandboxInstance", req, cb);
+    }
+    /**
+     * 启动沙箱实例
+     */
+    async StartSandboxInstance(req, cb) {
+        return this.request("StartSandboxInstance", req, cb);
+    }
+    /**
+       * 获取访问沙箱工具时所需要使用的访问Token，创建沙箱实例后需调用此接口获取沙箱实例访问Token。
+  此Token可用于调用代码沙箱实例执行代码，或浏览器沙箱实例进行浏览器操作等。
+       */
+    async AcquireSandboxInstanceToken(req, cb) {
+        return this.request("AcquireSandboxInstanceToken", req, cb);
+    }
+    /**
+     * 查询沙箱工具列表
+     */
+    async DescribeSandboxToolList(req, cb) {
+        return this.request("DescribeSandboxToolList", req, cb);
+    }
+    /**
+     * 停止沙箱实例
+     */
+    async StopSandboxInstance(req, cb) {
+        return this.request("StopSandboxInstance", req, cb);
+    }
+    /**
+     * 获取API密钥列表，包含API密钥简略信息，包含名称、创建时间等。
+     */
+    async DescribeAPIKeyList(req, cb) {
+        return this.request("DescribeAPIKeyList", req, cb);
+    }
+    /**
+     * 查询沙箱实例列表
+     */
+    async DescribeSandboxInstanceList(req, cb) {
+        return this.request("DescribeSandboxInstanceList", req, cb);
+    }
+    /**
+     * 创建新的API密钥，用于调用Agent Sandbox接口。相较于腾讯云Secret ID Secret Key支持调用所有接口使用，仅有部分接口支持使用API密钥调用。
+     */
+    async CreateAPIKey(req, cb) {
+        return this.request("CreateAPIKey", req, cb);
+    }
+    /**
+     * 删除沙箱工具
+     */
+    async DeleteSandboxTool(req, cb) {
+        return this.request("DeleteSandboxTool", req, cb);
+    }
+    /**
+     * 删除API密钥。注意区别于腾讯云Secret ID Secret Key，本接口删除的是Agent Sandbox专用API key。
+     */
+    async DeleteAPIKey(req, cb) {
+        return this.request("DeleteAPIKey", req, cb);
+    }
+    /**
+     * 创建沙箱工具
+     */
+    async CreateSandboxTool(req, cb) {
+        return this.request("CreateSandboxTool", req, cb);
+    }
+    /**
+     * 更新沙箱工具
+     */
+    async UpdateSandboxTool(req, cb) {
+        return this.request("UpdateSandboxTool", req, cb);
+    }
+}
+exports.Client = Client;

package/tencentcloud/services/ags/v20250920/ags_models.d.ts

@@ -0,0 +1,489 @@
+/**
+ * StartSandboxInstance请求参数结构体
+ */
+export interface StartSandboxInstanceRequest {
+    /**
+     * 沙箱工具 ID，与 ToolName 至少有一个要填
+     */
+    ToolId?: string;
+    /**
+     * 沙箱工具名称，与 ToolId 至少有一个要填
+     */
+    ToolName?: string;
+    /**
+     * 超时时间，超过这个时间就自动回收实例。支持格式：5m、300s、1h 等，默认 5m。最小 30s，最大 24h
+     */
+    Timeout?: string;
+    /**
+     * 幂等性 Token，长度不超过 64 字符
+     */
+    ClientToken?: string;
+}
+/**
+ * 沙箱实例结构体
+ */
+export interface SandboxInstance {
+    /**
+     * 沙箱实例唯一标识符
+     */
+    InstanceId: string;
+    /**
+     * 所属沙箱工具 ID
+     */
+    ToolId: string;
+    /**
+     * 所属沙箱工具名称
+     */
+    ToolName: string;
+    /**
+     * 实例状态：STARTING（启动中）、RUNNING（运行中）、STOPPING（停止中）、STOPPED（已停止）、STOP_FAILED（停止失败）、FAILED（失败状态）
+     */
+    Status: string;
+    /**
+     * 超时时间（秒），null 表示无超时设置
+     */
+    TimeoutSeconds?: number;
+    /**
+     * 过期时间（ISO 8601 格式），null 表示无过期时间
+     */
+    ExpiresAt?: string;
+    /**
+     * 停止原因：manual（手动）、timeout（超时）、error（错误）、system（系统），仅在状态为 STOPPED、STOP_FAILED 或 FAILED 时有值。当 provider 停止失败时，状态为 STOP_FAILED，原因为 error
+     */
+    StopReason?: string;
+    /**
+     * 创建时间（ISO 8601 格式）
+     */
+    CreateTime?: string;
+    /**
+     * 更新时间（ISO 8601 格式）
+     */
+    UpdateTime?: string;
+}
+/**
+ * StopSandboxInstance请求参数结构体
+ */
+export interface StopSandboxInstanceRequest {
+    /**
+     * 沙箱实例ID
+     */
+    InstanceId: string;
+}
+/**
+ * DescribeSandboxToolList返回参数结构体
+ */
+export interface DescribeSandboxToolListResponse {
+    /**
+     * 沙箱工具列表
+     */
+    SandboxToolSet?: Array<SandboxTool>;
+    /**
+     * 符合条件的沙箱工具总数
+     */
+    TotalCount?: number;
+    /**
+     * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+     */
+    RequestId?: string;
+}
+/**
+ * CreateAPIKey返回参数结构体
+ */
+export interface CreateAPIKeyResponse {
+    /**
+     * 用户传入的API密钥名称，方便用户记忆
+     */
+    Name?: string;
+    /**
+     * 生成的API密钥，仅返回此一次，后续无法获取
+     */
+    APIKey?: string;
+    /**
+     * API密钥ID
+     */
+    KeyId?: string;
+    /**
+     * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+     */
+    RequestId?: string;
+}
+/**
+ * DescribeSandboxToolList请求参数结构体
+ */
+export interface DescribeSandboxToolListRequest {
+    /**
+     * 沙箱工具ID列表，指定要查询的工具。如果为空则查询所有工具。最大支持100个ID
+     */
+    ToolIds?: Array<string>;
+    /**
+     * 偏移量，默认为0
+     */
+    Offset?: number;
+    /**
+     * 返回数量，默认为20，最大值为100
+     */
+    Limit?: number;
+    /**
+     * 过滤条件
+     */
+    Filters?: Array<Filter>;
+}
+/**
+ * CreateSandboxTool请求参数结构体
+ */
+export interface CreateSandboxToolRequest {
+    /**
+     * 沙箱工具名称，长度 1-50 字符，支持英文、数字、下划线和连接线。同一 AppId 下沙箱工具名称必须唯一
+     */
+    ToolName: string;
+    /**
+     * 沙箱工具类型，目前支持：browser、code-interpreter
+     */
+    ToolType: string;
+    /**
+     * 网络配置
+     */
+    NetworkConfiguration: NetworkConfiguration;
+    /**
+     * 沙箱工具描述，最大长度 200 字符
+     */
+    Description?: string;
+    /**
+     * 默认超时时间，支持格式：5m、300s、1h 等，不指定则使用系统默认值（5 分钟）。最大 24 小时
+     */
+    DefaultTimeout?: string;
+    /**
+     * 标签规格，为沙箱工具绑定标签，支持多种资源类型的标签绑定
+     */
+    Tags?: Array<Tag>;
+    /**
+     * 幂等性 Token，长度不超过 64 字符
+     */
+    ClientToken?: string;
+}
+/**
+ * DeleteAPIKey返回参数结构体
+ */
+export interface DeleteAPIKeyResponse {
+    /**
+     * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+     */
+    RequestId?: string;
+}
+/**
+ * API密钥简略信息
+ */
+export interface APIKeyInfo {
+    /**
+     * API密钥名称
+     */
+    Name?: string;
+    /**
+     * API密钥ID
+     */
+    KeyId?: string;
+    /**
+     * 密钥状态。可以为API_KEY_STATUS_ACTIVE，或API_KEY_STATUS_INACTIVE
+     */
+    Status?: string;
+    /**
+     * 隐藏部分字符的API密钥，方便用户辨认
+     */
+    MaskedKey?: string;
+    /**
+     * API密钥创建时间
+     */
+    CreatedAt?: string;
+}
+/**
+ * UpdateSandboxInstance返回参数结构体
+ */
+export interface UpdateSandboxInstanceResponse {
+    /**
+     * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+     */
+    RequestId?: string;
+}
+/**
+ * DeleteSandboxTool请求参数结构体
+ */
+export interface DeleteSandboxToolRequest {
+    /**
+     * 沙箱工具ID
+     */
+    ToolId: string;
+}
+/**
+ * CreateAPIKey请求参数结构体
+ */
+export interface CreateAPIKeyRequest {
+    /**
+     * API密钥名称，方便用户记忆
+     */
+    Name?: string;
+}
+/**
+ * 沙箱网络配置
+ */
+export interface NetworkConfiguration {
+    /**
+     * 网络模式（当前支持 PUBLIC）
+     */
+    NetworkMode: string;
+}
+/**
+ * DeleteSandboxTool返回参数结构体
+ */
+export interface DeleteSandboxToolResponse {
+    /**
+     * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+     */
+    RequestId?: string;
+}
+/**
+ * 沙箱工具结构体
+ */
+export interface SandboxTool {
+    /**
+     * 沙箱工具唯一标识符
+     */
+    ToolId: string;
+    /**
+     * 沙箱工具名称，长度 1-50 字符，支持中英文、数字、下划线。同一 AppId 下沙箱工具名称必须唯一
+     */
+    ToolName?: string;
+    /**
+     * 沙箱工具类型，取值：browser（浏览器工具）、code-interpreter（代码解释器工具）、computer（计算机控制工具）、mobile（移动设备工具）
+     */
+    ToolType?: string;
+    /**
+     * 沙箱工具状态，取值：CREATING（创建中）、ACTIVE（可用）、DELETING（删除中）、FAILED（失败）
+     */
+    Status?: string;
+    /**
+     * 沙箱工具描述信息，最大长度 200 字符
+     */
+    Description?: string;
+    /**
+     * 默认超时时间，支持格式：5m、300s、1h 等，不指定则使用系统默认值（5 分钟）。最大 24 小时
+     */
+    DefaultTimeoutSeconds?: number;
+    /**
+     * 网络配置
+     */
+    NetworkConfiguration?: NetworkConfiguration;
+    /**
+     * 标签规格，包含资源标签绑定关系。用于为沙箱工具绑定标签，支持多种资源类型的标签绑定
+     */
+    Tags?: Array<Tag>;
+    /**
+     * 沙箱工具创建时间，格式：ISO8601
+     */
+    CreateTime?: string;
+    /**
+     * 沙箱工具更新时间，格式：ISO8601
+     */
+    UpdateTime?: string;
+}
+/**
+ * 过滤列表规则
+ */
+export interface Filter {
+    /**
+     * 属性名称, 若存在多个Filter时，Filter间的关系为逻辑与（AND）关系。
+     */
+    Name?: string;
+    /**
+     * 属性值, 若同一个Filter存在多个Values，同一Filter下Values间的关系为逻辑或（OR）关系。
+     */
+    Values?: Array<string>;
+}
+/**
+ * StartSandboxInstance返回参数结构体
+ */
+export interface StartSandboxInstanceResponse {
+    /**
+     * 创建的沙箱实例完整信息
+     */
+    Instance?: SandboxInstance;
+    /**
+     * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+     */
+    RequestId?: string;
+}
+/**
+ * AcquireSandboxInstanceToken请求参数结构体
+ */
+export interface AcquireSandboxInstanceTokenRequest {
+    /**
+     * 沙箱实例ID，生成的访问Token将仅可用于访问此沙箱实例
+     */
+    InstanceId: string;
+}
+/**
+ * DescribeAPIKeyList返回参数结构体
+ */
+export interface DescribeAPIKeyListResponse {
+    /**
+     * API密钥简略信息列表。
+     */
+    APIKeySet?: Array<APIKeyInfo>;
+    /**
+     * 列表中API密钥数量
+     */
+    TotalCount?: number;
+    /**
+     * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+     */
+    RequestId?: string;
+}
+/**
+ * DescribeSandboxInstanceList请求参数结构体
+ */
+export interface DescribeSandboxInstanceListRequest {
+    /**
+     * 沙箱实例ID列表，指定要查询的实例。如果为空则查询所有实例。最大支持100个ID
+     */
+    InstanceIds?: Array<string>;
+    /**
+     * 沙箱工具ID，指定时查询该沙箱模板下的实例，为空则查询所有沙箱模板的实例
+     */
+    ToolId?: string;
+    /**
+     * 偏移量，默认为0
+     */
+    Offset?: number;
+    /**
+     * 返回数量，默认为20，最大值为100
+     */
+    Limit?: number;
+    /**
+     * 过滤条件
+     */
+    Filters?: Array<Filter>;
+}
+/**
+ * DescribeAPIKeyList请求参数结构体
+ */
+export type DescribeAPIKeyListRequest = null;
+/**
+ * UpdateSandboxInstance请求参数结构体
+ */
+export interface UpdateSandboxInstanceRequest {
+    /**
+     * 沙箱实例ID
+     */
+    InstanceId: string;
+    /**
+     * 新的超时时间（从设置时开始重新计算超时），支持格式：5m、300s、1h等。最小30s，最大24h。如果不指定则保持原有超时设置
+     */
+    Timeout?: string;
+}
+/**
+ * CreateSandboxTool返回参数结构体
+ */
+export interface CreateSandboxToolResponse {
+    /**
+     * 创建的沙箱工具 ID
+     */
+    ToolId?: string;
+    /**
+     * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+     */
+    RequestId?: string;
+}
+/**
+ * UpdateSandboxTool返回参数结构体
+ */
+export interface UpdateSandboxToolResponse {
+    /**
+     * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+     */
+    RequestId?: string;
+}
+/**
+ * DeleteAPIKey请求参数结构体
+ */
+export interface DeleteAPIKeyRequest {
+    /**
+     * 需要删除的API密钥ID
+     */
+    KeyId: string;
+}
+/**
+ * AcquireSandboxInstanceToken返回参数结构体
+ */
+export interface AcquireSandboxInstanceTokenResponse {
+    /**
+     * 访问Token
+     */
+    Token?: string;
+    /**
+     * 过期时间
+     */
+    ExpiresAt?: string;
+    /**
+     * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+     */
+    RequestId?: string;
+}
+/**
+ * StopSandboxInstance返回参数结构体
+ */
+export interface StopSandboxInstanceResponse {
+    /**
+     * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+     */
+    RequestId?: string;
+}
+/**
+ * 标签
+ */
+export interface Tag {
+    /**
+     * 标签键
+     */
+    Key?: string;
+    /**
+     * 标签值
+     */
+    Value?: string;
+}
+/**
+ * UpdateSandboxTool请求参数结构体
+ */
+export interface UpdateSandboxToolRequest {
+    /**
+     * 沙箱工具ID
+     */
+    ToolId: string;
+    /**
+     * 沙箱工具描述，最大长度200字符
+     */
+    Description?: string;
+    /**
+     * 网络配置
+     */
+    NetworkConfiguration?: NetworkConfiguration;
+    /**
+     * 标签
+     */
+    Tags?: Array<Tag>;
+}
+/**
+ * DescribeSandboxInstanceList返回参数结构体
+ */
+export interface DescribeSandboxInstanceListResponse {
+    /**
+     * 沙箱实例列表
+     */
+    InstanceSet?: Array<SandboxInstance>;
+    /**
+     * 符合条件的实例总数
+     */
+    TotalCount?: number;
+    /**
+     * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+     */
+    RequestId?: string;
+}

package/tencentcloud/services/ags/v20250920/ags_models.js

@@ -0,0 +1,18 @@
+"use strict";
+/*
+ * Copyright (c) 2018 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/tencentcloud/services/ags/v20250920/index.d.ts

@@ -0,0 +1,6 @@
+import * as Models from "./ags_models";
+import { Client } from "./ags_client";
+export declare const v20250920: {
+    Client: typeof Client;
+    Models: typeof Models;
+};

package/tencentcloud/services/ags/v20250920/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.v20250920 = void 0;
+const tslib_1 = require("tslib");
+const Models = tslib_1.__importStar(require("./ags_models"));
+const ags_client_1 = require("./ags_client");
+exports.v20250920 = {
+    Client: ags_client_1.Client,
+    Models: Models,
+};

package/tencentcloud/services/index.d.ts

@@ -0,0 +1 @@
+export { ags } from "./ags";

package/tencentcloud/services/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ags = void 0;
+var ags_1 = require("./ags");
+Object.defineProperty(exports, "ags", { enumerable: true, get: function () { return ags_1.ags; } });