@cloudbase/manager-node 5.6.6 → 5.6.8

package/CHANGELOG.md

@@ -1,3 +1,16 @@
+## @cloudbase/manager-node v5.6.7 版本发布 🚀(2026-08-05)
+
+- 新增 describeServerManageTask 及版本详情/回滚/删除接口
+
+---
+
+## @cloudbase/manager-node v5.6.6 版本发布 🚀(2026-07-31)
+
+- 新增 uploadCode 新增 onPhase 分步计时回调
+- 优化 标记 HTTP Service (CloudBaseGW) 模块自 v5.0.0 起废弃，并添加迁移指引
+
+---
+
 ## @cloudbase/manager-node v5.6.5 版本发布 🚀(2026-07-28)
 
 - 新增 PostgreSQL 数据库迁移相关 API 与类型定义

package/lib/cloudrun/index.js

@@ -88,6 +88,34 @@ class CloudRunService {
             throw new Error(`云托管代码下载地址为空（请求ID: ${cloudBaseBuildServiceRes.RequestId}）`);
         }
     }
+    /**
+     * 查询服务管理任务信息
+     * @param {Object} params 查询参数
+     * @param {string} params.serverName 服务名
+     * @param {number} [params.taskId=0] 任务 ID，传 0 表示查询该服务当前最新的任务
+     * @param {string} [params.operatorRemark] 操作标识
+     * @returns {Promise<{ IsExist?: boolean; Task?: IServerManageTaskInfo; RequestId?: string }>} 任务是否存在及任务信息
+     */
+    async describeServerManageTask(params) {
+        var _a;
+        const envConfig = this.environment.lazyEnvironmentConfig;
+        return this.tcbrService.request('DescribeServerManageTask', Object.assign({ EnvId: envConfig.EnvId, ServerName: params.serverName, TaskId: (_a = params.taskId) !== null && _a !== void 0 ? _a : 0 }, (params.operatorRemark ? { OperatorRemark: params.operatorRemark } : {})));
+    }
+    /**
+     * 查询发布单信息（DescribeReleaseOrder）
+     * @param {IDescribeReleaseOrderParams} params 查询参数
+     * @returns {Promise<IDescribeReleaseOrderResponse>} 发布单详情
+     */
+    async describeReleaseOrder(params) {
+        var _a, _b;
+        const envConfig = this.environment.lazyEnvironmentConfig;
+        const serverName = (_a = params === null || params === void 0 ? void 0 : params.ServerName) === null || _a === void 0 ? void 0 : _a.trim();
+        const status = (_b = params === null || params === void 0 ? void 0 : params.Status) === null || _b === void 0 ? void 0 : _b.trim();
+        if (!serverName) {
+            throw new Error('Missing required parameters: ServerName');
+        }
+        return this.tcbrService.request('DescribeReleaseOrder', Object.assign({ EnvId: envConfig.EnvId, ServerName: serverName }, (status ? { Status: status } : {})));
+    }
     /**
      * 获取云托管服务列表
      * @param {Object} [params] 查询参数
@@ -197,6 +225,78 @@ class CloudRunService {
             OperateType: 'go_back',
         });
     }
+    /**
+     * 回滚版本（SubmitServerRollback）
+     * @param {ISubmitServerRollbackParams} params 回滚参数（服务名、当前版本名、目标回滚版本名）
+     * @returns {Promise<ISubmitServerRollbackResponse>} 返回任务 ID 和请求 ID
+     */
+    async submitServerRollback(params) {
+        var _a, _b, _c, _d;
+        const envConfig = this.environment.lazyEnvironmentConfig;
+        const serverName = (_a = params === null || params === void 0 ? void 0 : params.ServerName) === null || _a === void 0 ? void 0 : _a.trim();
+        const currentVersionName = (_b = params === null || params === void 0 ? void 0 : params.CurrentVersionName) === null || _b === void 0 ? void 0 : _b.trim();
+        const rollbackVersionName = (_c = params === null || params === void 0 ? void 0 : params.RollbackVersionName) === null || _c === void 0 ? void 0 : _c.trim();
+        const operatorRemark = (_d = params === null || params === void 0 ? void 0 : params.OperatorRemark) === null || _d === void 0 ? void 0 : _d.trim();
+        if (!serverName) {
+            throw new Error('Missing required parameters: ServerName');
+        }
+        if (!currentVersionName) {
+            throw new Error('Missing required parameters: CurrentVersionName');
+        }
+        if (!rollbackVersionName) {
+            throw new Error('Missing required parameters: RollbackVersionName');
+        }
+        return this.tcbrService.request('SubmitServerRollback', Object.assign({ EnvId: envConfig.EnvId, ServerName: serverName, CurrentVersionName: currentVersionName, RollbackVersionName: rollbackVersionName }, (operatorRemark ? { OperatorRemark: operatorRemark } : {})));
+    }
+    /**
+     * 批量删除版本
+     * @param {IDeleteCloudRunVersionsParams} params 删除参数
+     * @returns {Promise<IDeleteCloudRunVersionsResponse>} 删除结果
+     */
+    async deleteCloudRunVersions(params) {
+        var _a;
+        const envConfig = this.environment.lazyEnvironmentConfig;
+        const operatorRemark = (_a = params === null || params === void 0 ? void 0 : params.OperatorRemark) === null || _a === void 0 ? void 0 : _a.trim();
+        if (!Array.isArray(params === null || params === void 0 ? void 0 : params.SimpleVersions) || params.SimpleVersions.length === 0) {
+            throw new Error('Missing required parameters: SimpleVersions');
+        }
+        const simpleVersions = params.SimpleVersions.map((item, index) => {
+            var _a, _b, _c;
+            const serverName = (_a = item === null || item === void 0 ? void 0 : item.ServerName) === null || _a === void 0 ? void 0 : _a.trim();
+            const versionName = (_b = item === null || item === void 0 ? void 0 : item.VersionName) === null || _b === void 0 ? void 0 : _b.trim();
+            if (!serverName) {
+                throw new Error(`Invalid SimpleVersions[${index}].ServerName`);
+            }
+            if (!versionName) {
+                throw new Error(`Invalid SimpleVersions[${index}].VersionName`);
+            }
+            return {
+                EnvId: ((_c = item === null || item === void 0 ? void 0 : item.EnvId) === null || _c === void 0 ? void 0 : _c.trim()) || envConfig.EnvId,
+                ServerName: serverName,
+                VersionName: versionName
+            };
+        });
+        return this.tcbrService.request('DeleteCloudRunVersions', Object.assign({ EnvId: envConfig.EnvId, IsDeleteServer: params.IsDeleteServer, IsDeleteImage: params.IsDeleteImage, SimpleVersions: simpleVersions }, (operatorRemark ? { OperatorRemark: operatorRemark } : {})));
+    }
+    /**
+     * 查询版本详情
+     * @param {IDescribeVersionDetailParams} params 查询参数（服务名、版本名、可选渠道）
+     * @returns {Promise<IDescribeVersionDetailResponse>} 版本详情
+     */
+    async describeVersionDetail(params) {
+        var _a, _b, _c;
+        const envConfig = this.environment.lazyEnvironmentConfig;
+        const serverName = (_a = params === null || params === void 0 ? void 0 : params.ServerName) === null || _a === void 0 ? void 0 : _a.trim();
+        const versionName = (_b = params === null || params === void 0 ? void 0 : params.VersionName) === null || _b === void 0 ? void 0 : _b.trim();
+        const channel = (_c = params === null || params === void 0 ? void 0 : params.Channel) === null || _c === void 0 ? void 0 : _c.trim();
+        if (!serverName) {
+            throw new Error('Missing required parameters: ServerName');
+        }
+        if (!versionName) {
+            throw new Error('Missing required parameters: VersionName');
+        }
+        return this.tcbrService.request('DescribeVersionDetail', Object.assign({ EnvId: envConfig.EnvId, ServerName: serverName, VersionName: versionName }, (channel ? { Channel: channel } : {})));
+    }
     /**
      *查询云托管服务详情
      * @param {Object} params 查询参数
@@ -433,6 +533,12 @@ __decorate([
 __decorate([
     (0, utils_1.preLazy)()
 ], CloudRunService.prototype, "download", null);
+__decorate([
+    (0, utils_1.preLazy)()
+], CloudRunService.prototype, "describeServerManageTask", null);
+__decorate([
+    (0, utils_1.preLazy)()
+], CloudRunService.prototype, "describeReleaseOrder", null);
 __decorate([
     (0, utils_1.preLazy)()
 ], CloudRunService.prototype, "list", null);
@@ -445,6 +551,15 @@ __decorate([
 __decorate([
     (0, utils_1.preLazy)()
 ], CloudRunService.prototype, "rollback", null);
+__decorate([
+    (0, utils_1.preLazy)()
+], CloudRunService.prototype, "submitServerRollback", null);
+__decorate([
+    (0, utils_1.preLazy)()
+], CloudRunService.prototype, "deleteCloudRunVersions", null);
+__decorate([
+    (0, utils_1.preLazy)()
+], CloudRunService.prototype, "describeVersionDetail", null);
 __decorate([
     (0, utils_1.preLazy)()
 ], CloudRunService.prototype, "detail", null);

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@cloudbase/manager-node",
-    "version": "5.6.6",
+    "version": "5.6.8",
     "description": "The node manage service api for cloudbase.",
     "main": "lib/index.js",
     "scripts": {

package/types/cloudrun/index.d.ts

@@ -1,6 +1,6 @@
 import { Environment } from '../environment';
 import { IResponseInfo } from '../interfaces';
-import { CloudrunServerType, ICloudrunDetailResponse, ICloudrunListResponse, ICloudrunServerBaseConfig, ICreateVpcInfo, IBuildLogResponse, IProcessLogResponse, IDiffConfigItem, ITemplate, ReleaseTypeEnum, IDescribeCloudRunDeployRecordResponse } from './type';
+import { CloudrunServerType, ICloudrunDetailResponse, ICloudrunListResponse, ICloudrunServerBaseConfig, ICreateVpcInfo, IBuildLogResponse, IProcessLogResponse, IDiffConfigItem, ITemplate, ReleaseTypeEnum, IServerManageTaskInfo, IDescribeReleaseOrderParams, IDescribeReleaseOrderResponse, IDescribeCloudRunDeployRecordResponse, IDescribeVersionDetailParams, IDescribeVersionDetailResponse, ISubmitServerRollbackParams, ISubmitServerRollbackResponse, IDeleteCloudRunVersionsParams, IDeleteCloudRunVersionsResponse } from './type';
 /**
  * 云托管服务管理类
  * 提供云托管服务的初始化、下载、列表查询和删除等功能
@@ -41,6 +41,29 @@ export declare class CloudRunService {
         serverName: string;
         targetPath: string;
     }): Promise<void>;
+    /**
+     * 查询服务管理任务信息
+     * @param {Object} params 查询参数
+     * @param {string} params.serverName 服务名
+     * @param {number} [params.taskId=0] 任务 ID，传 0 表示查询该服务当前最新的任务
+     * @param {string} [params.operatorRemark] 操作标识
+     * @returns {Promise<{ IsExist?: boolean; Task?: IServerManageTaskInfo; RequestId?: string }>} 任务是否存在及任务信息
+     */
+    describeServerManageTask(params: {
+        serverName: string;
+        taskId?: number;
+        operatorRemark?: string;
+    }): Promise<{
+        IsExist?: boolean;
+        Task?: IServerManageTaskInfo;
+        RequestId?: string;
+    }>;
+    /**
+     * 查询发布单信息（DescribeReleaseOrder）
+     * @param {IDescribeReleaseOrderParams} params 查询参数
+     * @returns {Promise<IDescribeReleaseOrderResponse>} 发布单详情
+     */
+    describeReleaseOrder(params: IDescribeReleaseOrderParams): Promise<IDescribeReleaseOrderResponse>;
     /**
      * 获取云托管服务列表
      * @param {Object} [params] 查询参数
@@ -82,6 +105,24 @@ export declare class CloudRunService {
     rollback(serverName: string): Promise<{
         RequestId?: string;
     }>;
+    /**
+     * 回滚版本（SubmitServerRollback）
+     * @param {ISubmitServerRollbackParams} params 回滚参数（服务名、当前版本名、目标回滚版本名）
+     * @returns {Promise<ISubmitServerRollbackResponse>} 返回任务 ID 和请求 ID
+     */
+    submitServerRollback(params: ISubmitServerRollbackParams): Promise<ISubmitServerRollbackResponse>;
+    /**
+     * 批量删除版本
+     * @param {IDeleteCloudRunVersionsParams} params 删除参数
+     * @returns {Promise<IDeleteCloudRunVersionsResponse>} 删除结果
+     */
+    deleteCloudRunVersions(params: IDeleteCloudRunVersionsParams): Promise<IDeleteCloudRunVersionsResponse>;
+    /**
+     * 查询版本详情
+     * @param {IDescribeVersionDetailParams} params 查询参数（服务名、版本名、可选渠道）
+     * @returns {Promise<IDescribeVersionDetailResponse>} 版本详情
+     */
+    describeVersionDetail(params: IDescribeVersionDetailParams): Promise<IDescribeVersionDetailResponse>;
     /**
      *查询云托管服务详情
      * @param {Object} params 查询参数

package/types/cloudrun/type.d.ts

@@ -426,6 +426,158 @@ export interface IReleaseOrderInfo {
     CreateTime?: string;
     IsReleasing?: boolean;
 }
+/**
+ * DescribeReleaseOrder 请求参数
+ */
+export interface IDescribeReleaseOrderParams {
+    /** 服务名 */
+    ServerName: string;
+    /** 发布单状态（可选） */
+    Status?: string;
+}
+/**
+ * DescribeReleaseOrder 响应
+ */
+export interface IDescribeReleaseOrderResponse {
+    /** 是否存在发布单 */
+    IsExist?: boolean;
+    /** 发布单详情 */
+    ReleaseOrderInfo?: IReleaseOrderInfo;
+    /** 上一次成功发布时间 */
+    LastReleasedSuccessTime?: string;
+    /** 请求 ID */
+    RequestId: string;
+}
+/**
+ * DescribeVersionDetail 请求参数
+ */
+export interface IDescribeVersionDetailParams {
+    /** 服务名 */
+    ServerName: string;
+    /** 版本名 */
+    VersionName: string;
+    /** 可选渠道 */
+    Channel?: string;
+}
+/**
+ * BuildPacksInfo（CreateCloudRunServer / DescribeVersionDetail / UpdateCloudRunServer）
+ */
+export interface IBuildPacksInfo {
+    /** 基础镜像 */
+    BaseImage: string;
+    /** 启动命令 */
+    EntryPoint: string;
+    /** 语言 */
+    RepoLanguage: string;
+    /** 上传文件名 */
+    UploadFilename: string;
+    /** 语言版本 */
+    LanguageVersion?: string;
+}
+/**
+ * DescribeVersionDetail 响应
+ */
+export interface IDescribeVersionDetailResponse {
+    Name: string;
+    Port: number;
+    Cpu: number;
+    Mem: number;
+    MinNum: number;
+    MaxNum: number;
+    PolicyDetails: ICloudrunHpaPolicy[];
+    Dockerfile: string;
+    BuildDir: string;
+    EnvParams: string;
+    Status: string;
+    CreatedTime: string;
+    UpdatedTime: string;
+    LogPath: string;
+    EntryPoint: string | null;
+    Cmd: string | null;
+    VpcConf: IVpcConf | null;
+    VolumesConf: IVolumeConf[] | null;
+    BuildPacks: IBuildPacksInfo | null;
+    RequestId: string;
+}
+/**
+ * SubmitServerRollback 请求参数
+ */
+export interface ISubmitServerRollbackParams {
+    /** 服务名 */
+    ServerName: string;
+    /** 当前版本名 */
+    CurrentVersionName: string;
+    /** 目标回滚版本名 */
+    RollbackVersionName: string;
+    /** 操作标识 */
+    OperatorRemark?: string;
+}
+/**
+ * SubmitServerRollback 响应
+ */
+export interface ISubmitServerRollbackResponse {
+    /** 任务 ID */
+    TaskId: number;
+    /** 请求 ID */
+    RequestId: string;
+}
+/**
+ * DeleteCloudRunVersions 版本信息
+ */
+export interface ISimpleVersion {
+    /** 环境 ID（可选，不传时由 SDK 自动注入当前环境） */
+    EnvId?: string;
+    /** 服务名 */
+    ServerName: string;
+    /** 版本名 */
+    VersionName: string;
+}
+/**
+ * DeleteCloudRunVersions 请求参数
+ */
+export interface IDeleteCloudRunVersionsParams {
+    /** 是否删除服务（仅最后一个版本时生效） */
+    IsDeleteServer: boolean;
+    /** 是否删除镜像（仅删除服务时生效） */
+    IsDeleteImage: boolean;
+    /** 待删除版本列表 */
+    SimpleVersions: ISimpleVersion[];
+    /** 操作标识 */
+    OperatorRemark?: string;
+}
+/**
+ * FailDeleteVersions（删除失败版本信息）
+ */
+export interface IFailDeleteVersions {
+    /** 删除失败版本信息 */
+    Version: ISimpleVersion;
+    /** 删除失败错误码 */
+    ErrorCode: number;
+    /** 删除失败错误信息 */
+    ErrorMsg: string;
+    /** 删除操作 RequestId */
+    RequestId: string;
+}
+/**
+ * SuccessDeleteVersions（删除成功的版本信息）
+ */
+export interface ISuccessDeleteVersions {
+    /** 版本简化信息 */
+    Version: ISimpleVersion;
+    /** 删除版本的 RequestId */
+    RequestId: string;
+    /** 删除版本结果 */
+    Result: string;
+}
+/**
+ * DeleteCloudRunVersions 响应
+ */
+export interface IDeleteCloudRunVersionsResponse {
+    Result: 'succ' | 'fail' | 'partial' | string;
+    FailVersions: IFailDeleteVersions[];
+    SuccessVersions: ISuccessDeleteVersions[];
+    RequestId: string;
+}
 /**
  * DescribeCloudRunDeployRecord 单条部署记录
  */