@cloudbase/manager-node 5.5.2-beta.0 → 5.5.2

package/lib/talosSandbox/type.js

@@ -1,3 +0,0 @@
-"use strict";
-// ==================== CreateSandbox ====================
-Object.defineProperty(exports, "__esModule", { value: true });

package/types/talosSandbox/index.d.ts

@@ -1,182 +0,0 @@
-import { Environment } from '../environment';
-import { CreateSandboxOptions, CreateSandboxResp, ListSandboxesOptions, ListedSandbox, GetSandboxLogsOptions, SandboxLogsV2Response, GetSandboxesMetricsOptions, SandboxesWithMetrics, GetSandboxDetailOptions, SandboxDetail, DestroySandboxOptions, ListSandboxSnapshotsOptions, SandboxSnapshotList, CreateSandboxSnapshotOptions, SandboxSnapshot, ListAllSnapshotsOptions, PauseSandboxOptions, CloneSandboxOptions, CloneSandboxResponse, ConnectSandboxOptions, GetSandboxMetricsOptions, SandboxMetrics, UpdateSandboxTimeoutOptions, RefreshSandboxTTLOptions, ListTemplatesOptions, Template, CreateTemplateOptions, GetTemplateOptions, DeleteTemplateOptions, UpdateTemplateOptions, GetTemplateByAliasOptions, UpdateTemplateImageOptions, TemplateImageUpdateResponse } from './type';
-export * from './type';
-export declare class TalosSandboxService {
-    private environment;
-    constructor(environment: Environment);
-    /**
-     * 创建沙箱
-     * 从指定模板/池分配一个预热实例并创建沙箱，支持 CBS 和 s3-hybrid 池类型
-     * @param {CreateSandboxOptions} options 创建参数
-     * @returns {Promise<CreateSandboxResp>}
-     */
-    createSandbox(options: CreateSandboxOptions): Promise<CreateSandboxResp>;
-    /**
-     * 列出沙箱（支持状态过滤和分页）
-     * @param {ListSandboxesOptions} options 查询参数
-     * @returns {Promise<ListedSandbox[]>}
-     */
-    listSandboxes(options?: ListSandboxesOptions): Promise<ListedSandbox[]>;
-    /**
-     * 获取沙箱日志（V2）
-     * @param {GetSandboxLogsOptions} options 查询参数
-     * @returns {Promise<SandboxLogsV2Response>}
-     */
-    getSandboxLogs(options: GetSandboxLogsOptions): Promise<SandboxLogsV2Response>;
-    /**
-     * 获取多个沙箱的指标数据
-     * @param {GetSandboxesMetricsOptions} options 查询参数
-     * @returns {Promise<SandboxesWithMetrics>}
-     */
-    getSandboxesMetrics(options: GetSandboxesMetricsOptions): Promise<SandboxesWithMetrics>;
-    /**
-     * 获取沙箱详情
-     * @param {GetSandboxDetailOptions} options 查询参数
-     * @returns {Promise<SandboxDetail>}
-     */
-    getSandboxDetail(options: GetSandboxDetailOptions): Promise<SandboxDetail>;
-    /**
-     * 销毁沙箱
-     * 对于运行中的沙箱：终止实例并删除磁盘
-     * 对于已暂停的沙箱：回收暂存实例、终止并删除磁盘
-     * @param {DestroySandboxOptions} options 请求参数
-     * @returns {Promise<void>}
-     */
-    destroySandbox(options: DestroySandboxOptions): Promise<void>;
-    /**
-     * 获取沙箱快照列表
-     * 非 s3-hybrid 类型的沙箱始终返回 { latest: null, history: [] }
-     * @param {ListSandboxSnapshotsOptions} options 请求参数
-     * @returns {Promise<SandboxSnapshotList>}
-     */
-    listSandboxSnapshots(options: ListSandboxSnapshotsOptions): Promise<SandboxSnapshotList>;
-    /**
-     * 创建沙箱快照（rsync）
-     * 对沙箱的 /workspace 执行 rsync 快照，不会暂停沙箱。
-     * 每个沙箱有冷却时间限制（当前 5 分钟），仅 s3-hybrid 池支持。
-     * @param {CreateSandboxSnapshotOptions} options 请求参数
-     * @returns {Promise<SandboxSnapshot>}
-     */
-    createSandboxSnapshot(options: CreateSandboxSnapshotOptions): Promise<SandboxSnapshot>;
-    /**
-     * 列出所有快照
-     * 可按沙箱 ID 过滤，返回跨沙箱的快照列表
-     * @param {ListAllSnapshotsOptions} options 查询参数
-     * @returns {Promise<SandboxSnapshot[]>}
-     */
-    listAllSnapshots(options?: ListAllSnapshotsOptions): Promise<SandboxSnapshot[]>;
-    /**
-     * 暂停沙箱
-     * CBS 池：通过 CXM 暂存实例，分离磁盘，清除实例绑定
-     * S3-hybrid 池：分离 S3 磁盘，标记实例为 DIRTY，入队重镜像任务
-     * @param {PauseSandboxOptions} options 请求参数
-     * @returns {Promise<void>}
-     */
-    pauseSandbox(options: PauseSandboxOptions): Promise<void>;
-    /**
-     * 克隆沙箱
-     * 异步操作：返回 202 和 PENDING 状态的占位沙箱。
-     * 调用方需轮询 GET /sandboxes/{id} 直到状态变为 RUNNING 或 FAILED。
-     * 源沙箱必须为 SUSPENDED 状态且拥有 DETACHED 的 DATA_S3 磁盘。
-     * @param {CloneSandboxOptions} options 请求参数
-     * @returns {Promise<CloneSandboxResponse>}
-     */
-    cloneSandbox(options: CloneSandboxOptions): Promise<CloneSandboxResponse>;
-    /**
-     * 连接沙箱（若已暂停则自动恢复）
-     * 如果沙箱正在运行，返回 200；如果沙箱已暂停，会自动恢复并返回 201
-     * @param {ConnectSandboxOptions} options 请求参数
-     * @returns {Promise<CreateSandboxResp>}
-     */
-    connectSandbox(options: ConnectSandboxOptions): Promise<CreateSandboxResp>;
-    /**
-     * 获取单个沙箱的资源指标
-     * 从沙箱的 envd 代理获取实时指标（CPU、内存、磁盘）。
-     * 如果沙箱已暂停或 envd 不可达，会返回合成的默认值。
-     * @param {GetSandboxMetricsOptions} options 查询参数
-     * @returns {Promise<SandboxMetrics[]>}
-     */
-    getSandboxMetrics(options: GetSandboxMetricsOptions): Promise<SandboxMetrics[]>;
-    /**
-     * 更新沙箱超时时间
-     * EndAt 时间根据 created_at + timeout_seconds 重新计算，timeout 为 0 表示永不过期
-     * @param {UpdateSandboxTimeoutOptions} options 请求参数
-     * @returns {Promise<void>}
-     */
-    updateSandboxTimeout(options: UpdateSandboxTimeoutOptions): Promise<void>;
-    /**
-     * 刷新沙箱 TTL
-     * 通过 POST /sandboxes/{sandboxID}/refreshes 续期沙箱存活时间
-     * @param {RefreshSandboxTTLOptions} options 请求参数
-     * @returns {Promise<void>}
-     */
-    refreshSandboxTTL(options: RefreshSandboxTTLOptions): Promise<void>;
-    /**
-     * 列出所有模板
-     * 可选按团队 ID 过滤
-     * @param {ListTemplatesOptions} options 查询参数
-     * @returns {Promise<Template[]>}
-     */
-    listTemplates(options?: ListTemplatesOptions): Promise<Template[]>;
-    /**
-     * 创建新模板
-     * 异步触发模板构建，立即返回 202 与模板基础信息；
-     * 实际构建状态需通过其他接口查询
-     * @param {CreateTemplateOptions} options 请求参数
-     * @returns {Promise<Template>}
-     */
-    createTemplate(options?: CreateTemplateOptions): Promise<Template>;
-    /**
-     * 根据模板 ID 获取模板详情
-     * @param {GetTemplateOptions} options 请求参数
-     * @returns {Promise<Template>}
-     */
-    getTemplate(options: GetTemplateOptions): Promise<Template>;
-    /**
-     * 删除模板
-     * 成功时服务端返回 204 No Content
-     * @param {DeleteTemplateOptions} options 请求参数
-     * @returns {Promise<void>}
-     */
-    deleteTemplate(options: DeleteTemplateOptions): Promise<void>;
-    /**
-     * 更新模板
-     * 当前仅支持修改 public 字段；服务端成功时返回 200 无 body
-     * @param {UpdateTemplateOptions} options 请求参数
-     * @returns {Promise<void>}
-     */
-    updateTemplate(options: UpdateTemplateOptions): Promise<void>;
-    /**
-     * 根据别名获取模板详情
-     * @param {GetTemplateByAliasOptions} options 请求参数
-     * @returns {Promise<Template>}
-     */
-    getTemplateByAlias(options: GetTemplateByAliasOptions): Promise<Template>;
-    /**
-     * 触发模板镜像滚动更新
-     * 服务端会对绑定该模板的所有活跃 Pool 触发独立的镜像滚动；
-     * 每个 Pool 的成功/失败结果汇总在 results 中返回。
-     * 注意：当前版本不强制 team 级隔离。
-     * @param {UpdateTemplateImageOptions} options 请求参数
-     * @returns {Promise<TemplateImageUpdateResponse>}
-     */
-    updateTemplateImage(options: UpdateTemplateImageOptions): Promise<TemplateImageUpdateResponse>;
-    /**
-     * 校验 rollout 配置中的数值字段
-     *   - batch_percent: 1-100
-     *   - batch_interval_s: >= 0
-     *   - max_failure_percent_per_batch: 1-100
-     *   - min_failures_to_trigger: >= 1
-     *   - stuck_timeout_s: >= 60
-     */
-    private validateRolloutConfig;
-    /**
-     * 解析鉴权 Token 并返回对应的 Header
-     * 优先使用调用方传入，其次从环境变量 TALOS_TOKEN 读取
-     * 按前缀自动识别 Header 类型：
-     *   - admin_talos_*  → { 'X-Admin-Token': token }
-     *   - talos_*        → { 'X-API-Key': token }
-     *   - sk_talos_*     → { 'Authorization': `Bearer ${token}` }
-     */
-    private resolveAuthHeader;
-}