@cloudbase/manager-node 5.1.1 → 5.2.0-beta.0

package/types/sandbox/index.d.ts

@@ -0,0 +1,98 @@
+import { Environment } from '../environment';
+import { UpdateSandboxToolOptions, UpdateSandboxToolResp, DescribeSandboxToolListOptions, DescribeSandboxToolListResp, CreateSandboxToolOptions, CreateSandboxToolResp, DeleteSandboxToolOptions, DeleteSandboxToolResp, ResumeSandboxInstanceOptions, ResumeSandboxInstanceResp, PauseSandboxInstanceOptions, PauseSandboxInstanceResp, UpdateSandboxInstanceOptions, UpdateSandboxInstanceResp, StopSandboxInstanceOptions, StopSandboxInstanceResp, StartSandboxInstanceOptions, StartSandboxInstanceResp, DescribeSandboxInstanceListOptions, DescribeSandboxInstanceListResp, AcquireSandboxInstanceTokenOptions, AcquireSandboxInstanceTokenResp, DescribeAPIKeyListResp, CreateAPIKeyOptions, CreateAPIKeyResp, DeleteAPIKeyOptions, DeleteAPIKeyResp } from './types';
+export declare class SandboxService {
+    private environment;
+    private agsService;
+    constructor(environment: Environment);
+    /**
+     * 更新沙箱工具
+     * 更新指定沙箱工具的描述、网络配置、标签和自定义配置等信息。
+     * @param {UpdateSandboxToolOptions} options 更新参数
+     * @returns {Promise<UpdateSandboxToolResp>}
+     */
+    updateSandboxTool(options: UpdateSandboxToolOptions): Promise<UpdateSandboxToolResp>;
+    /**
+     * 查询沙箱工具列表
+     * @param {DescribeSandboxToolListOptions} options 查询参数
+     * @returns {Promise<DescribeSandboxToolListResp>}
+     */
+    describeSandboxToolList(options?: DescribeSandboxToolListOptions): Promise<DescribeSandboxToolListResp>;
+    /**
+     * 创建沙箱工具
+     * @param {CreateSandboxToolOptions} options 创建参数
+     * @returns {Promise<CreateSandboxToolResp>}
+     */
+    createSandboxTool(options: CreateSandboxToolOptions): Promise<CreateSandboxToolResp>;
+    /**
+     * 删除沙箱工具
+     * @param {DeleteSandboxToolOptions} options 删除参数
+     * @returns {Promise<DeleteSandboxToolResp>}
+     */
+    deleteSandboxTool(options: DeleteSandboxToolOptions): Promise<DeleteSandboxToolResp>;
+    /**
+     * 恢复沙箱实例
+     * @param {ResumeSandboxInstanceOptions} options 恢复参数
+     * @returns {Promise<ResumeSandboxInstanceResp>}
+     */
+    resumeSandboxInstance(options: ResumeSandboxInstanceOptions): Promise<ResumeSandboxInstanceResp>;
+    /**
+     * 暂停沙箱实例
+     * @param {PauseSandboxInstanceOptions} options 暂停参数
+     * @returns {Promise<PauseSandboxInstanceResp>}
+     */
+    pauseSandboxInstance(options: PauseSandboxInstanceOptions): Promise<PauseSandboxInstanceResp>;
+    /**
+     * 更新沙箱实例
+     * 更新指定沙箱实例的超时时间和元数据等信息。
+     * @param {UpdateSandboxInstanceOptions} options 更新参数
+     * @returns {Promise<UpdateSandboxInstanceResp>}
+     */
+    updateSandboxInstance(options: UpdateSandboxInstanceOptions): Promise<UpdateSandboxInstanceResp>;
+    /**
+     * 停止沙箱实例
+     * @param {StopSandboxInstanceOptions} options 停止参数
+     * @returns {Promise<StopSandboxInstanceResp>}
+     */
+    stopSandboxInstance(options: StopSandboxInstanceOptions): Promise<StopSandboxInstanceResp>;
+    /**
+     * 启动沙箱实例
+     * @param {StartSandboxInstanceOptions} options 启动参数
+     * @returns {Promise<StartSandboxInstanceResp>}
+     */
+    startSandboxInstance(options: StartSandboxInstanceOptions): Promise<StartSandboxInstanceResp>;
+    /**
+     * 查询沙箱实例列表
+     * @param {DescribeSandboxInstanceListOptions} options 查询参数
+     * @returns {Promise<DescribeSandboxInstanceListResp>}
+     */
+    describeSandboxInstanceList(options?: DescribeSandboxInstanceListOptions): Promise<DescribeSandboxInstanceListResp>;
+    /**
+     * 获取沙箱实例访问 Token
+     * 获取访问沙箱工具时所需要使用的访问 Token，创建沙箱实例后需调用此接口获取沙箱实例访问 Token。
+     * 此 Token 可用于调用代码沙箱实例执行代码，或浏览器沙箱实例进行浏览器操作等。
+     * @param {AcquireSandboxInstanceTokenOptions} options 请求参数
+     * @returns {Promise<AcquireSandboxInstanceTokenResp>}
+     */
+    acquireSandboxInstanceToken(options: AcquireSandboxInstanceTokenOptions): Promise<AcquireSandboxInstanceTokenResp>;
+    /**
+     * 获取 API 密钥列表
+     * 获取 API 密钥简略信息列表，包含名称、创建时间等。
+     * @returns {Promise<DescribeAPIKeyListResp>}
+     */
+    describeAPIKeyList(): Promise<DescribeAPIKeyListResp>;
+    /**
+     * 创建 API 密钥
+     * 创建新的 API 密钥，用于调用 Agent Sandbox 接口。
+     * 注意：生成的 APIKey 仅在此次响应中返回，后续无法再次获取，请妥善保管。
+     * @param {CreateAPIKeyOptions} options 创建参数
+     * @returns {Promise<CreateAPIKeyResp>}
+     */
+    createAPIKey(options?: CreateAPIKeyOptions): Promise<CreateAPIKeyResp>;
+    /**
+     * 删除 API 密钥
+     * 注意：本接口删除的是 Agent Sandbox 专用 API Key，区别于腾讯云 Secret ID / Secret Key。
+     * @param {DeleteAPIKeyOptions} options 删除参数
+     * @returns {Promise<DeleteAPIKeyResp>}
+     */
+    deleteAPIKey(options: DeleteAPIKeyOptions): Promise<DeleteAPIKeyResp>;
+}

package/types/sandbox/types.d.ts

@@ -0,0 +1,618 @@
+/**
+ * 标签
+ */
+export interface Tag {
+    /** 标签键 */
+    Key?: string;
+    /** 标签值 */
+    Value?: string;
+}
+/**
+ * 沙箱实例元数据项
+ * 被如下接口引用：DescribeSandboxInstanceList, StartSandboxInstance, UpdateSandboxInstance
+ */
+export interface MetadataVar {
+    /** 沙箱元数据名 */
+    Name?: string;
+    /** 沙箱元数据值 */
+    Value?: string;
+}
+/**
+ * VPC 网络相关配置
+ * 被如下接口引用：CreateSandboxTool, DescribeSandboxToolList, UpdateSandboxTool
+ */
+export interface VPCConfig {
+    /** VPC 子网 ID 列表 */
+    SubnetIds?: string[];
+    /** 安全组 ID 列表 */
+    SecurityGroupIds?: string[];
+}
+/**
+ * 沙箱网络配置
+ * 被如下接口引用：CreateSandboxTool, DescribeSandboxToolList, UpdateSandboxTool
+ */
+export interface NetworkConfiguration {
+    /** 网络模式（当前支持 PUBLIC, VPC, SANDBOX） */
+    NetworkMode: string;
+    /** VPC 网络相关配置 */
+    VpcConfig?: VPCConfig;
+}
+/**
+ * 环境变量
+ */
+export interface EnvVar {
+    /** 环境变量名称 */
+    Name: string;
+    /** 环境变量值 */
+    Value: string;
+}
+/**
+ * 端口配置
+ */
+export interface PortConfiguration {
+    /** 端口名 */
+    Name?: string;
+    /** 端口 */
+    Port?: number;
+    /** 协议 */
+    Protocol?: string;
+}
+/**
+ * 资源配置
+ */
+export interface ResourceConfiguration {
+    /** CPU 资源量，示例值： 500m */
+    CPU?: number;
+    /** 内存规格，示例值： 1Gi */
+    Memory?: string;
+}
+/**
+ * HTTP GET 探测动作配置
+ */
+export interface HttpGetAction {
+    /** 路径 */
+    Path?: string;
+    /** 端口 */
+    Port?: number;
+    /** 协议 */
+    Scheme?: string;
+}
+/**
+ * 健康检查探针配置
+ */
+export interface ProbeConfiguration {
+    /** HTTP GET 探测配置 */
+    HttpGet?: HttpGetAction;
+    /** 健康检查就绪超时（毫秒） */
+    ReadyTimeoutMs?: number;
+    /** 健康检查单次探测超时（毫秒） */
+    ProbeTimeoutMs?: number;
+    /** 健康检查间隔（毫秒） */
+    ProbePeriodMs?: number;
+    /** 健康检查成功阈值 */
+    SuccessThreshold?: number;
+    /** 健康检查失败阈值 */
+    FailureThreshold?: number;
+}
+/**
+ * 沙箱自定义 DNS 配置
+ */
+export interface DNSConfig {
+    /** DNS 服务器地址，需要有效 IP 地址，默认值：10.0.0.1 */
+    Servers: string[];
+    /** 搜索域（对应 resolv.conf 的 search 指令） */
+    Searches?: string[];
+    /** 配置项（对应 resolv.conf 选项） */
+    Options?: string[];
+}
+/**
+ * 沙箱自定义配置
+ * 被如下接口引用：CreateSandboxTool, StartSandboxInstance, UpdateSandboxTool
+ */
+export interface CustomConfiguration {
+    /** 镜像地址 */
+    Image?: string;
+    /** 镜像仓库类型：enterprise、personal */
+    ImageRegistryType?: string;
+    /** 启动命令 */
+    Command?: string[];
+    /** 启动参数 */
+    Args?: string[];
+    /** 环境变量 */
+    Env?: EnvVar[];
+    /** 端口配置 */
+    Ports?: PortConfiguration[];
+    /** 资源配置 */
+    Resources?: ResourceConfiguration;
+    /** 探针配置 */
+    Probe?: ProbeConfiguration;
+    /** 沙箱 DNS 配置 */
+    DNSConfig?: DNSConfig;
+}
+/**
+ * UpdateSandboxTool 请求参数
+ */
+export interface UpdateSandboxToolOptions {
+    /** 沙箱工具 ID，如 sdt-dibk4rra */
+    toolId: string;
+    /** 沙箱工具描述，最大长度 200 字符 */
+    description?: string;
+    /** 网络配置 */
+    networkConfiguration?: NetworkConfiguration;
+    /** 标签 */
+    tags?: Tag[];
+    /** 沙箱工具自定义配置 */
+    customConfiguration?: CustomConfiguration;
+}
+/**
+ * UpdateSandboxTool 返回结果
+ */
+export interface UpdateSandboxToolResp {
+    /** 唯一请求 ID */
+    RequestId: string;
+}
+/**
+ * 过滤列表规则
+ * 被如下接口引用：DescribeSandboxInstanceList, DescribeSandboxToolList
+ */
+export interface Filter {
+    /** 属性名称，若存在多个 Filter 时，Filter 间的关系为逻辑与（AND） */
+    Name?: string;
+    /** 属性值，若同一个 Filter 存在多个 Values，同一 Filter 下 Values 间的关系为逻辑或（OR） */
+    Values?: string[];
+}
+/**
+ * 对象存储桶挂载配置
+ * 被如下接口引用：CreateSandboxTool, DescribeSandboxToolList
+ */
+export interface CosStorageSource {
+    /** 对象存储访问域名 */
+    Endpoint?: string;
+    /** 对象存储桶名称 */
+    BucketName?: string;
+    /** 对象存储桶路径，必须为以 / 起始的绝对路径 */
+    BucketPath?: string;
+}
+/**
+ * 镜像卷挂载源配置
+ * 被如下接口引用：CreateSandboxTool, DescribeSandboxToolList
+ */
+export interface ImageStorageSource {
+    /** 镜像地址 */
+    Reference?: string;
+    /** 镜像仓库类型：enterprise、personal */
+    ImageRegistryType?: string;
+    /** 镜像内部的路径 */
+    SubPath?: string;
+    /** 镜像 Digest，请求时无需传入 */
+    Digest?: string;
+}
+/**
+ * 文件存储配置
+ * 被如下接口引用：CreateSandboxTool, DescribeSandboxToolList
+ */
+export interface CfsStorageSource {
+    /** CFS 资源 ID */
+    FileSystemId?: string;
+    /** CFS 挂载路径 */
+    Path?: string;
+}
+/**
+ * 挂载存储配置
+ * 被如下接口引用：CreateSandboxTool, DescribeSandboxToolList
+ */
+export interface StorageSource {
+    /** 对象存储桶配置 */
+    Cos?: CosStorageSource;
+    /** 镜像卷配置 */
+    Image?: ImageStorageSource;
+    /** 文件存储配置 */
+    Cfs?: CfsStorageSource;
+}
+/**
+ * 沙箱工具中实例存储挂载配置
+ * 被如下接口引用：CreateSandboxTool, DescribeSandboxToolList
+ */
+export interface StorageMount {
+    /** 存储挂载配置名称 */
+    Name?: string;
+    /** 存储配置 */
+    StorageSource?: StorageSource;
+    /** 沙箱实例本地挂载路径 */
+    MountPath?: string;
+    /** 存储挂载读写权限配置，默认为 false */
+    ReadOnly?: boolean;
+}
+/**
+ * 沙箱自定义配置详细信息（响应用，与写入用的 CustomConfiguration 区分）
+ * 被如下接口引用：DescribeSandboxInstanceList, DescribeSandboxToolList, StartSandboxInstance
+ */
+export interface CustomConfigurationDetail {
+    /** 镜像地址 */
+    Image?: string;
+    /** 镜像仓库类型：TCR、CCR */
+    ImageRegistryType?: string;
+    /** 镜像 Digest */
+    ImageDigest?: string;
+    /** 启动命令 */
+    Command?: string[];
+    /** 启动参数 */
+    Args?: string[];
+    /** 环境变量 */
+    Env?: EnvVar[];
+    /** 端口配置 */
+    Ports?: PortConfiguration[];
+    /** 资源配置 */
+    Resources?: ResourceConfiguration;
+    /** 探针配置 */
+    Probe?: ProbeConfiguration;
+    /** 沙箱 DNS 配置 */
+    DNSConfig?: DNSConfig;
+}
+/**
+ * CLS 日志推送配置
+ * 被如下接口引用：CreateSandboxTool, DescribeSandboxToolList
+ */
+export interface CLSConfig {
+    /** 沙箱工具日志推送所使用的 CLS 日志主题 ID */
+    TopicId?: string;
+}
+/**
+ * 沙箱工具日志采集相关配置
+ * 被如下接口引用：CreateSandboxTool, DescribeSandboxToolList
+ */
+export interface LogConfiguration {
+    /** 日志推送 CLS 的配置 */
+    CLSConfig?: CLSConfig;
+}
+/**
+ * 沙箱工具结构体
+ * 被如下接口引用：DescribeSandboxToolList
+ */
+export interface SandboxTool {
+    /** 沙箱工具唯一标识符 */
+    ToolId: string;
+    /** 沙箱工具名称，长度 1-50 字符 */
+    ToolName?: string;
+    /** 沙箱工具类型：browser、code-interpreter、computer、mobile */
+    ToolType?: string;
+    /** 沙箱工具状态：CREATING、ACTIVE、DELETING、FAILED */
+    Status?: string;
+    /** 沙箱工具描述信息，最大长度 200 字符 */
+    Description?: string;
+    /** 默认超时时间（秒） */
+    DefaultTimeoutSeconds?: number;
+    /** 网络配置 */
+    NetworkConfiguration?: NetworkConfiguration;
+    /** 标签 */
+    Tags?: Tag[];
+    /** 创建时间，格式：ISO8601 */
+    CreateTime?: string;
+    /** 更新时间，格式：ISO8601 */
+    UpdateTime?: string;
+    /** 沙箱工具绑定角色 ARN */
+    RoleArn?: string;
+    /** 实例存储挂载配置 */
+    StorageMounts?: StorageMount[];
+    /** 沙箱工具自定义配置 */
+    CustomConfiguration?: CustomConfigurationDetail;
+    /** 日志推送相关配置 */
+    LogConfiguration?: LogConfiguration;
+    /** 用于说明沙箱工具处于该状态的原因 */
+    StatusReason?: string;
+}
+/**
+ * DescribeSandboxToolList 请求参数
+ */
+export interface DescribeSandboxToolListOptions {
+    /** 沙箱工具 ID 列表，为空则查询所有，最大支持 100 个 */
+    toolIds?: string[];
+    /** 偏移量，默认为 0 */
+    offset?: number;
+    /** 返回数量，默认为 20，最大值为 100 */
+    limit?: number;
+    /** 过滤条件 */
+    filters?: Filter[];
+}
+/**
+ * DescribeSandboxToolList 返回结果
+ */
+export interface DescribeSandboxToolListResp {
+    /** 沙箱工具列表 */
+    SandboxToolSet: SandboxTool[];
+    /** 符合条件的沙箱工具总数 */
+    TotalCount: number;
+    /** 唯一请求 ID */
+    RequestId: string;
+}
+/**
+ * CreateSandboxTool 请求参数
+ */
+export interface CreateSandboxToolOptions {
+    /** 沙箱工具名称，长度 1-50 字符，支持英文、数字、下划线和连接线。同一 AppId 下名称必须唯一 */
+    toolName: string;
+    /** 沙箱工具类型：browser、code-interpreter、custom */
+    toolType: string;
+    /** 网络配置 */
+    networkConfiguration: NetworkConfiguration;
+    /** 沙箱工具描述，最大长度 200 字符 */
+    description?: string;
+    /** 默认超时时间，支持格式：5m、300s、1h 等，不指定则使用系统默认值（5 分钟），最大 24 小时 */
+    defaultTimeout?: string;
+    /** 标签 */
+    tags?: Tag[];
+    /** 幂等性 Token，长度不超过 64 字符 */
+    clientToken?: string;
+    /** 角色 ARN */
+    roleArn?: string;
+    /** 沙箱工具存储配置 */
+    storageMounts?: StorageMount[];
+    /** 沙箱工具自定义配置 */
+    customConfiguration?: CustomConfiguration;
+    /** 沙箱工具日志推送相关配置 */
+    logConfiguration?: LogConfiguration;
+}
+/**
+ * CreateSandboxTool 返回结果
+ */
+export interface CreateSandboxToolResp {
+    /** 创建的沙箱工具 ID */
+    ToolId: string;
+    /** 唯一请求 ID */
+    RequestId: string;
+}
+/**
+ * DeleteSandboxTool 请求参数
+ */
+export interface DeleteSandboxToolOptions {
+    /** 沙箱工具 ID，如 sdt-dibk4rra */
+    toolId: string;
+}
+/**
+ * DeleteSandboxTool 返回结果
+ */
+export interface DeleteSandboxToolResp {
+    /** 唯一请求 ID */
+    RequestId: string;
+}
+/**
+ * ResumeSandboxInstance 请求参数
+ */
+export interface ResumeSandboxInstanceOptions {
+    /** 沙箱实例 ID，如 4729e19d67fb4ba38854dbbfc63c72e9 */
+    instanceId: string;
+}
+/**
+ * ResumeSandboxInstance 返回结果
+ */
+export interface ResumeSandboxInstanceResp {
+    /** 唯一请求 ID */
+    RequestId: string;
+}
+/**
+ * PauseSandboxInstance 请求参数
+ */
+export interface PauseSandboxInstanceOptions {
+    /** 沙箱实例 ID，如 4729e19d67fb4ba38854dbbfc63c72e9 */
+    instanceId: string;
+}
+/**
+ * PauseSandboxInstance 返回结果
+ */
+export interface PauseSandboxInstanceResp {
+    /** 唯一请求 ID */
+    RequestId: string;
+}
+/**
+ * UpdateSandboxInstance 请求参数
+ */
+export interface UpdateSandboxInstanceOptions {
+    /** 沙箱实例 ID，如 953e15d3655e4daab120b885c908edf7 */
+    instanceId: string;
+    /** 新的超时时间（从设置时重新计算），支持格式：5m、300s、1h 等。最小 30s，最大 24h。不指定则保持原有设置 */
+    timeout?: string;
+    /** 沙箱实例元数据 */
+    metadata?: MetadataVar[];
+}
+/**
+ * UpdateSandboxInstance 返回结果
+ */
+export interface UpdateSandboxInstanceResp {
+    /** 唯一请求 ID */
+    RequestId: string;
+}
+/**
+ * StopSandboxInstance 请求参数
+ */
+export interface StopSandboxInstanceOptions {
+    /** 沙箱实例 ID，如 12345678123412341234123456789abc */
+    instanceId: string;
+}
+/**
+ * StopSandboxInstance 返回结果
+ */
+export interface StopSandboxInstanceResp {
+    /** 唯一请求 ID */
+    RequestId: string;
+}
+/**
+ * 沙箱实例存储挂载配置可选项，用于覆盖沙箱工具的存储配置的部分选项
+ * 被如下接口引用：DescribeSandboxInstanceList, StartSandboxInstance
+ */
+export interface MountOption {
+    /** 指定沙箱工具中的存储配置名称 */
+    Name?: string;
+    /** 沙箱实例本地挂载路径（可选），默认继承工具中的存储配置 */
+    MountPath?: string;
+    /** 沙箱实例存储挂载子路径（可选） */
+    SubPath?: string;
+    /** 沙箱实例存储挂载读写权限（可选），默认继承工具存储配置 */
+    ReadOnly?: boolean;
+}
+/**
+ * 沙箱实例结构体
+ * 被如下接口引用：DescribeSandboxInstanceList, StartSandboxInstance
+ */
+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 时有值 */
+    StopReason?: string;
+    /** 创建时间（ISO 8601 格式） */
+    CreateTime?: string;
+    /** 更新时间（ISO 8601 格式） */
+    UpdateTime?: string;
+    /** 存储挂载选项 */
+    MountOptions?: MountOption[];
+    /** 沙箱实例自定义配置 */
+    CustomConfiguration?: CustomConfigurationDetail;
+    /** 网络模式：PUBLIC、SANDBOX、INTERNAL_SERVICE 等 */
+    NetworkMode?: string;
+    /** 沙箱实例元数据 */
+    Metadata?: MetadataVar[];
+}
+/**
+ * StartSandboxInstance 请求参数
+ */
+export interface StartSandboxInstanceOptions {
+    /** 沙箱工具 ID，与 toolName 至少有一个要填 */
+    toolId?: string;
+    /** 沙箱工具名称，与 toolId 至少有一个要填 */
+    toolName?: string;
+    /** 超时时间，支持格式：5m、300s、1h 等，默认 5m。最小 30s，最大 24h */
+    timeout?: string;
+    /** 幂等性 Token，长度不超过 64 字符 */
+    clientToken?: string;
+    /** 沙箱实例存储挂载配置 */
+    mountOptions?: MountOption[];
+    /** 沙箱实例自定义配置 */
+    customConfiguration?: CustomConfiguration;
+    /** 沙箱访问认证模式：DEFAULT（跟随系统策略）、TOKEN（Token认证）、NONE（免认证），默认 DEFAULT */
+    authMode?: string;
+    /** 沙箱元数据 */
+    metadata?: MetadataVar[];
+}
+/**
+ * StartSandboxInstance 返回结果
+ */
+export interface StartSandboxInstanceResp {
+    /** 创建的沙箱实例完整信息 */
+    Instance: SandboxInstance;
+    /** 唯一请求 ID */
+    RequestId: string;
+}
+/**
+ * DescribeSandboxInstanceList 请求参数
+ */
+export interface DescribeSandboxInstanceListOptions {
+    /** 沙箱实例 ID 列表，为空则查询所有，最大支持 100 个 */
+    instanceIds?: string[];
+    /** 沙箱工具 ID，指定时查询该工具下的实例，为空则查询所有 */
+    toolId?: string;
+    /** 偏移量，默认为 0 */
+    offset?: number;
+    /** 返回数量，默认为 20，最大值为 100 */
+    limit?: number;
+    /** 过滤条件 */
+    filters?: Filter[];
+}
+/**
+ * DescribeSandboxInstanceList 返回结果
+ */
+export interface DescribeSandboxInstanceListResp {
+    /** 沙箱实例列表 */
+    InstanceSet: SandboxInstance[];
+    /** 符合条件的实例总数 */
+    TotalCount: number;
+    /** 唯一请求 ID */
+    RequestId: string;
+}
+/**
+ * AcquireSandboxInstanceToken 请求参数
+ */
+export interface AcquireSandboxInstanceTokenOptions {
+    /** 沙箱实例 ID，生成的访问 Token 将仅可用于访问此沙箱实例 */
+    instanceId: string;
+}
+/**
+ * AcquireSandboxInstanceToken 返回结果
+ */
+export interface AcquireSandboxInstanceTokenResp {
+    /** 访问 Token */
+    Token: string;
+    /** 过期时间（ISO 8601 格式） */
+    ExpiresAt: string;
+    /** 唯一请求 ID */
+    RequestId: string;
+}
+/**
+ * API 密钥简略信息
+ * 被如下接口引用：DescribeAPIKeyList
+ */
+export interface APIKeyInfo {
+    /** API 密钥名称 */
+    Name?: string;
+    /** API 密钥 ID */
+    KeyId?: string;
+    /** 密钥状态：API_KEY_STATUS_ACTIVE、API_KEY_STATUS_INACTIVE */
+    Status?: string;
+    /** 隐藏部分字符的 API 密钥，方便用户辨认 */
+    MaskedKey?: string;
+    /** API 密钥创建时间（ISO 8601 格式） */
+    CreatedAt?: string;
+}
+/**
+ * DescribeAPIKeyList 返回结果
+ */
+export interface DescribeAPIKeyListResp {
+    /** API 密钥简略信息列表 */
+    APIKeySet: APIKeyInfo[];
+    /** 列表中 API 密钥数量 */
+    TotalCount: number;
+    /** 唯一请求 ID */
+    RequestId: string;
+}
+/**
+ * CreateAPIKey 请求参数
+ */
+export interface CreateAPIKeyOptions {
+    /** API 密钥名称，方便用户记忆 */
+    name?: string;
+}
+/**
+ * CreateAPIKey 返回结果
+ */
+export interface CreateAPIKeyResp {
+    /** 用户传入的 API 密钥名称 */
+    Name: string;
+    /** 生成的 API 密钥，仅返回此一次，后续无法获取 */
+    APIKey: string;
+    /** API 密钥 ID */
+    KeyId: string;
+    /** 唯一请求 ID */
+    RequestId: string;
+}
+/**
+ * DeleteAPIKey 请求参数
+ */
+export interface DeleteAPIKeyOptions {
+    /** 需要删除的 API 密钥 ID，如 ark-2wsxdr5t */
+    keyId: string;
+}
+/**
+ * DeleteAPIKey 返回结果
+ */
+export interface DeleteAPIKeyResp {
+    /** 唯一请求 ID */
+    RequestId: string;
+}