@cloudbase/manager-node 4.10.1 → 4.10.3-beta.0

package/lib/function/index.js

@@ -23,90 +23,202 @@ function isNodeFunction(runtime) {
     // 不严格限制
     return runtime === 'Nodejs10.15' || runtime === 'Nodejs8.9' || (runtime === null || runtime === void 0 ? void 0 : runtime.includes('Nodejs'));
 }
-// 解析函数配置，换成请求参数
+/**
+ * 构建镜像配置对象
+ * @param imageConfig 镜像配置
+ * @returns 构建好的镜像配置对象
+ */
+function buildImageConfig(imageConfig) {
+    // 先转换大小写
+    const config = toPascalCaseKeys(imageConfig);
+    // 再补充默认值
+    return Object.assign({ ImageType: 'enterprise', ImagePort: 9000 }, config);
+}
+/**
+ * 递归转换对象的 key 从 camelCase 到 PascalCase
+ */
+function toPascalCaseKeys(obj) {
+    if (obj === null || obj === undefined)
+        return obj;
+    if (Array.isArray(obj))
+        return obj.map(item => toPascalCaseKeys(item));
+    if (typeof obj !== 'object')
+        return obj;
+    const result = {};
+    for (const key of Object.keys(obj)) {
+        // 通用规则：首字母大写
+        const pascalKey = key.charAt(0).toUpperCase() + key.slice(1);
+        result[pascalKey] = toPascalCaseKeys(obj[key]);
+    }
+    return result;
+}
+/**
+ * 将布尔值转换为 API 需要的 'TRUE'/'FALSE' 字符串
+ * 支持 boolean | string | undefined 输入
+ * @param value 输入值
+ * @returns 'TRUE' | 'FALSE' | undefined
+ */
+function toBooleanString(value) {
+    if (value === undefined)
+        return undefined;
+    // 已经是字符串格式
+    if (value === 'TRUE' || value === 'FALSE')
+        return value;
+    // 字符串 'true'/'false' 兼容
+    if (typeof value === 'string') {
+        return value.toUpperCase() === 'TRUE' ? 'TRUE' : 'FALSE';
+    }
+    // 布尔值转换
+    return value ? 'TRUE' : 'FALSE';
+}
+/**
+ * 大小写不敏感获取对象字段值
+ * @param obj 目标对象
+ * @param fieldName 字段名（任意大小写）
+ * @returns 字段值，找不到返回 undefined
+ */
+function getFieldIgnoreCase(obj, fieldName) {
+    if (!obj || typeof obj !== 'object')
+        return undefined;
+    const lowerFieldName = fieldName.toLowerCase();
+    for (const key of Object.keys(obj)) {
+        if (key.toLowerCase() === lowerFieldName) {
+            return obj[key];
+        }
+    }
+    return undefined;
+}
+// 解析函数配置，换成请求参数（用于 CreateFunction）
 function configToParams(options) {
-    var _a, _b, _c, _d, _e, _f, _g;
-    const { func, codeSecret, baseParams } = options;
-    let installDependency;
-    // Node 函数默认安装依赖
-    installDependency = isNodeFunction(func.runtime) ? 'TRUE' : 'FALSE';
-    // 是否安装依赖，选项可以覆盖
-    if (typeof func.installDependency !== 'undefined') {
-        installDependency = func.installDependency ? 'TRUE' : 'FALSE';
-    }
-    // 转换环境变量
-    const envVariables = Object.keys(func.envVariables || {}).map(key => ({
-        Key: key,
-        Value: func.envVariables[key]
-    }));
-    // 当不存在 L5 配置时，不修改 L5 状态，否则根据 true/false 进行修改
-    const l5Enable = typeof (func === null || func === void 0 ? void 0 : func.l5) === 'undefined' ? null : (func === null || func === void 0 ? void 0 : func.l5) ? 'TRUE' : 'FALSE';
-    const params = Object.assign(Object.assign({}, baseParams), { FunctionName: func.name, 
-        // 不可选择
-        L5Enable: l5Enable });
-    // 函数绑定的角色
-    params.Role = func.role || params.Role;
-    // 修复参数存在 undefined 字段时，会出现鉴权失败的情况
-    // Environment 为覆盖式修改，不保留已有字段
-    envVariables.length && (params.Environment = { Variables: envVariables });
-    // 处理入口
-    params.Handler = func.handler || 'index.main';
-    // 默认超时时间为 10S
-    params.Timeout = Number(func.timeout) || 10;
-    // 默认运行环境 Nodejs8.9
-    params.Runtime = func.runtime || 'Nodejs8.9';
+    var _a, _b, _c;
+    const { func, codeSecret, baseParams = {} } = options;
+    // 白名单：只有这些字段会被透传到 API（大小写不敏感）
+    // 参考 SCF API 文档：https://cloud.tencent.com/document/product/583/18586
+    // key: 小写用于匹配，value: PascalCase 用于输出
+    const AUTO_CONVERT_FIELDS = {
+        // 基础配置
+        'description': 'Description',
+        'memorysize': 'MemorySize',
+        'timeout': 'Timeout',
+        'runtime': 'Runtime',
+        'type': 'Type', // Event/HTTP
+        'role': 'Role',
+        // 日志配置
+        'clslogsetid': 'ClsLogsetId',
+        'clstopicid': 'ClsTopicId',
+        // 高级配置
+        'deadletterconfig': 'DeadLetterConfig',
+        'publicnetconfig': 'PublicNetConfig',
+        'cfsconfig': 'CfsConfig',
+        'inittimeout': 'InitTimeout',
+        'tags': 'Tags',
+        // 注意：asyncRunEnable/traceEnable/autoDeployClsTopicIndex/autoCreateClsTopic/dnsCache
+        // 需要 'TRUE'/'FALSE' 字符串，在特殊处理阶段处理
+        'protocoltype': 'ProtocolType', // WS
+        'intranetconfig': 'IntranetConfig',
+    };
+    let params = Object.assign(Object.assign({}, baseParams), { FunctionName: func.name });
+    // 第一阶段：白名单字段自动转换（大小写不敏感，统一输出 PascalCase）
+    for (const key of Object.keys(func)) {
+        const lowerKey = key.toLowerCase();
+        const pascalKey = AUTO_CONVERT_FIELDS[lowerKey];
+        if (!pascalKey || func[key] === undefined)
+            continue;
+        params[pascalKey] = toPascalCaseKeys(func[key]);
+    }
+    // 第二阶段：特殊处理字段
+    // 1. 安装依赖标志（支持 boolean | string）
+    if (func.installDependency !== undefined) {
+        params.InstallDependency = toBooleanString(func.installDependency);
+    }
+    // 2. L5 配置 - 当不存在时不修改，否则根据 true/false 进行修改
+    if (func.l5 !== undefined) {
+        params.L5Enable = toBooleanString(func.l5);
+    }
+    else {
+        params.L5Enable = null;
+    }
+    // 3. 需要 'TRUE'/'FALSE' 字符串的布尔字段统一处理（大小写不敏感）
+    // key: 小写用于匹配，value: PascalCase 用于输出
+    const BOOLEAN_STRING_FIELDS = {
+        'asyncrunenable': 'AsyncRunEnable', // 异步属性
+        'traceenable': 'TraceEnable', // 事件追踪
+        'autodeployclstopicindex': 'AutoDeployClsTopicIndex', // 自动创建 CLS 索引
+        'autocreateclstopic': 'AutoCreateClsTopic', // 自动创建 CLS 主题
+        'dnscache': 'DnsCache', // Dns 缓存
+    };
+    for (const key of Object.keys(func)) {
+        const lowerKey = key.toLowerCase();
+        const pascalKey = BOOLEAN_STRING_FIELDS[lowerKey];
+        if (pascalKey && func[key] !== undefined) {
+            params[pascalKey] = toBooleanString(func[key]);
+        }
+    }
+    // 5. 环境变量 - 为覆盖式修改，不保留已有字段
+    if (func.envVariables && Object.keys(func.envVariables).length > 0) {
+        params.Environment = {
+            Variables: Object.keys(func.envVariables).map(key => ({
+                Key: key,
+                Value: func.envVariables[key]
+            }))
+        };
+    }
+    // 4. 函数角色（如果白名单已处理则跳过）
+    if (!params.Role && func.role) {
+        params.Role = func.role;
+    }
+    // 5. VPC 配置
     if (((_a = func === null || func === void 0 ? void 0 : func.vpc) === null || _a === void 0 ? void 0 : _a.subnetId) !== undefined && ((_b = func === null || func === void 0 ? void 0 : func.vpc) === null || _b === void 0 ? void 0 : _b.vpcId) !== undefined) {
-        // VPC 网络
         params.VpcConfig = {
-            SubnetId: (_c = func === null || func === void 0 ? void 0 : func.vpc) === null || _c === void 0 ? void 0 : _c.subnetId,
-            VpcId: (_d = func === null || func === void 0 ? void 0 : func.vpc) === null || _d === void 0 ? void 0 : _d.vpcId
+            SubnetId: func.vpc.subnetId,
+            VpcId: func.vpc.vpcId
         };
     }
-    // 运行内存
-    params.MemorySize = func.memorySize || 256;
-    // 自动安装依赖
-    params.InstallDependency = installDependency;
-    // 代码保护
-    if (codeSecret || func.codeSecret) {
-        params.CodeSecret = codeSecret || func.codeSecret;
-    }
-    // 函数层
-    if ((_e = func === null || func === void 0 ? void 0 : func.layers) === null || _e === void 0 ? void 0 : _e.length) {
-        const transformLayers = func.layers.map(item => ({
+    // 6. 函数层
+    if ((_c = func === null || func === void 0 ? void 0 : func.layers) === null || _c === void 0 ? void 0 : _c.length) {
+        params.Layers = func.layers.map(item => ({
             LayerName: item.name,
             LayerVersion: item.version
         }));
-        params.Layers = transformLayers;
     }
-    // HTTP 云函数类型
-    if ((func === null || func === void 0 ? void 0 : func.type) === 'HTTP') {
-        params.Type = 'HTTP';
-        // WebSocket 协议支持
-        if ((func === null || func === void 0 ? void 0 : func.protocolType) === 'WS') {
-            params.ProtocolType = 'WS';
-            // 协议参数，直接透传或使用默认值
-            // 参考文档：https://cloud.tencent.com/document/api/583/17244#ProtocolParams
-            const idleTimeOut = (_g = (_f = func === null || func === void 0 ? void 0 : func.protocolParams) === null || _f === void 0 ? void 0 : _f.wsParams) === null || _g === void 0 ? void 0 : _g.idleTimeOut;
+    // 7. 代码保护
+    if (codeSecret || func.codeSecret) {
+        params.CodeSecret = codeSecret || func.codeSecret;
+    }
+    // 8. 协议参数（WebSocket，大小写不敏感）
+    const protocolParams = getFieldIgnoreCase(func, 'protocolParams');
+    if (protocolParams) {
+        const wsParams = getFieldIgnoreCase(protocolParams, 'wsParams');
+        if (wsParams) {
             params.ProtocolParams = {
-                WSParams: {
-                    IdleTimeOut: typeof idleTimeOut === 'number' ? idleTimeOut : 15
-                }
+                WSParams: toPascalCaseKeys(wsParams)
             };
         }
-        // 多并发配置
-        // 参考文档：https://cloud.tencent.com/document/api/583/17244#InstanceConcurrencyConfig
-        if (func === null || func === void 0 ? void 0 : func.instanceConcurrencyConfig) {
-            params.InstanceConcurrencyConfig = {
-                DynamicEnabled: func.instanceConcurrencyConfig.dynamicEnabled || 'FALSE',
-                MaxConcurrency: func.instanceConcurrencyConfig.maxConcurrency || 10
-            };
+    }
+    // 9. HTTP 云函数特殊处理（type 字段大小写不敏感）
+    const funcType = getFieldIgnoreCase(func, 'type');
+    if ((funcType === null || funcType === void 0 ? void 0 : funcType.toUpperCase()) === 'HTTP') {
+        params.Type = 'HTTP';
+        // 多并发配置 - 仅 HTTP 函数支持（大小写不敏感）
+        const instanceConcurrencyConfig = getFieldIgnoreCase(func, 'instanceConcurrencyConfig');
+        if (instanceConcurrencyConfig) {
+            const config = toPascalCaseKeys(instanceConcurrencyConfig);
+            // DynamicEnabled 需要特殊处理为 'TRUE'/'FALSE'
+            if (config.DynamicEnabled !== undefined) {
+                config.DynamicEnabled = toBooleanString(config.DynamicEnabled);
+            }
+            params.InstanceConcurrencyConfig = config;
         }
     }
-    // 云函数描述
-    if (func === null || func === void 0 ? void 0 : func.description) {
-        params.Description = func.description;
+    // 10. 镜像配置（用于镜像部署，大小写不敏感）
+    const imageConfig = getFieldIgnoreCase(func, 'imageConfig');
+    if (imageConfig) {
+        params.Code = params.Code || {};
+        params.Code.ImageConfig = buildImageConfig(imageConfig);
     }
-    return params;
+    // 第三阶段：统一应用默认值
+    const runtime = params.Runtime || 'Nodejs18.15';
+    return Object.assign({ Handler: func.handler || 'index.main', Timeout: 10, Runtime: 'Nodejs18.15', MemorySize: 256, InstallDependency: isNodeFunction(runtime) ? 'TRUE' : 'FALSE' }, params);
 }
 class FunctionService {
     constructor(environment) {
@@ -123,12 +235,11 @@ class FunctionService {
      * @memberof FunctionService
      */
     async updateFunctionIncrementalCode(funcParam) {
-        const { env, namespace } = this.getFunctionConfig();
+        const { namespace } = this.getFunctionConfig();
         const { functionRootPath, func, deleteFiles, addFiles } = funcParam;
         const { name, runtime } = func;
         const params = {
             FunctionName: name,
-            EnvId: env,
             Namespace: namespace
         };
         let packer;
@@ -153,7 +264,7 @@ class FunctionService {
             }
             params.AddFiles = base64;
         }
-        return this.tcbService.request('UpdateFunctionIncrementalCode', params);
+        return this.scfService.request('UpdateFunctionIncrementalCode', params);
     }
     /**
      * 创建云函数
@@ -161,31 +272,49 @@ class FunctionService {
      * @returns {(Promise<IResponseInfo | ICreateFunctionRes>)}
      */
     async createFunction(funcParam) {
-        const { env } = this.getFunctionConfig();
+        var _a, _b, _c;
+        const { namespace } = this.getFunctionConfig();
         const { func, functionRootPath, force = false, base64Code, codeSecret, functionPath, deployMode } = funcParam;
         const funcName = func.name;
         const params = configToParams({
             func,
             codeSecret,
             baseParams: {
-                EnvId: env,
+                Namespace: namespace,
                 Role: 'TCB_QcsRole',
                 Stamp: 'MINI_QCBASE'
             }
         });
-        params.Code = await this.getCodeParams({
-            func,
-            base64Code,
-            functionPath,
-            functionRootPath,
-            deployMode
-        }, params.InstallDependency);
+        // 根据部署方式处理 Code 参数
+        // 优先使用显式指定的 deployMode，如果未指定但存在 imageConfig 则认为是镜像部署
+        const isImageDeploy = deployMode === 'image' || (!deployMode && ((_a = params.Code) === null || _a === void 0 ? void 0 : _a.ImageConfig));
+        if (isImageDeploy) {
+            // 镜像部署：Code 参数已在 configToParams 中通过 imageConfig 设置
+            if (!((_c = (_b = params.Code) === null || _b === void 0 ? void 0 : _b.ImageConfig) === null || _c === void 0 ? void 0 : _c.ImageUri)) {
+                throw new error_1.CloudBaseError('镜像部署需要配置 imageConfig.imageUri');
+            }
+            // 镜像部署的特殊配置
+            // 镜像函数不需要 Handler
+            delete params.Handler;
+            // 镜像函数不需要安装依赖
+            delete params.InstallDependency;
+        }
+        else {
+            // 代码部署：通过 getCodeParams 获取代码参数
+            params.Code = await this.getCodeParams({
+                func,
+                base64Code,
+                functionPath,
+                functionRootPath,
+                deployMode
+            }, params.InstallDependency);
+        }
         const { TopicId, LogsetId } = this.getClsServiceConfig();
         params.ClsTopicId = TopicId;
         params.ClsLogsetId = LogsetId;
         try {
             // 创建云函数
-            const res = await this.tcbService.request('CreateFunction', params);
+            const res = await this.scfService.request('CreateFunction', params);
             // 等待函数状态正常
             await this.waitFunctionActive(funcName, codeSecret);
             // 创建函数触发器、失败自动重试
@@ -203,13 +332,14 @@ class FunctionService {
             const functionExist = e.code === 'ResourceInUse.FunctionName' || e.code === 'ResourceInUse.Function';
             // 已存在同名函数，强制更新
             if (functionExist && force) {
-                // 1. 更新函数配置和代码，同名函数可能存在 codeSecret，先修改代码，清除 codeSecret
+                // 1. 更新函数代码（通过 deployMode 区分镜像部署和代码部署）
                 const codeRes = await this.updateFunctionCode({
                     func,
                     base64Code,
                     functionPath,
                     functionRootPath,
-                    codeSecret: codeSecret
+                    codeSecret: codeSecret,
+                    deployMode: isImageDeploy ? 'image' : undefined
                 });
                 // 等待函数状态正常
                 await this.waitFunctionActive(funcName, codeSecret);
@@ -254,9 +384,9 @@ class FunctionService {
      */
     async getFunctionList(limit = 20, offset = 0) {
         // 获取Function 环境配置
-        const { env } = this.getFunctionConfig();
-        const res = await this.tcbService.request('ListFunctions', {
-            EnvId: env,
+        const { namespace } = this.getFunctionConfig();
+        const res = await this.scfService.request('ListFunctions', {
+            Namespace: namespace,
             Limit: limit,
             Offset: offset
         });
@@ -270,9 +400,9 @@ class FunctionService {
      */
     async listFunctions(limit = 20, offset = 0) {
         // 获取Function 环境配置
-        const { env } = this.getFunctionConfig();
-        const res = await this.tcbService.request('ListFunctions', {
-            EnvId: env,
+        const { namespace } = this.getFunctionConfig();
+        const res = await this.scfService.request('ListFunctions', {
+            Namespace: namespace,
             Limit: limit,
             Offset: offset
         });
@@ -303,8 +433,8 @@ class FunctionService {
         const { envId } = options;
         while (true) {
             try {
-                const res = await this.tcbService.request('ListFunctions', {
-                    EnvId: envId,
+                const res = await this.scfService.request('ListFunctions', {
+                    Namespace: envId,
                     Limit: pageSize,
                     Offset: currentOffset
                 });
@@ -387,17 +517,16 @@ class FunctionService {
      * @returns {Promise<Record<string, string>>}
      */
     async getFunctionDetail(name, codeSecret) {
-        const { env } = this.getFunctionConfig();
+        const { namespace } = this.getFunctionConfig();
         const params = {
             FunctionName: name,
-            EnvId: env,
             ShowCode: 'TRUE',
-            Namespace: env
+            Namespace: namespace
         };
         if (codeSecret) {
             params.CodeSecret = codeSecret;
         }
-        const data = await this.tcbService.request('GetFunction', params);
+        const data = await this.scfService.request('GetFunction', params);
         // 解析 VPC 配置
         const { VpcId = '', SubnetId = '' } = data.VpcConfig || {};
         if (VpcId && SubnetId) {
@@ -574,67 +703,110 @@ class FunctionService {
      * @returns {Promise<IResponseInfo>}
      */
     async updateFunctionConfig(func) {
-        var _a, _b, _c, _d, _e, _f, _g;
+        var _a, _b, _c;
         const { namespace } = this.getFunctionConfig();
-        const envVariables = Object.keys(func.envVariables || {}).map(key => ({
-            Key: key,
-            Value: func.envVariables[key]
-        }));
-        // 当不存在 L5 配置时，不修改 L5 状态，否则根据 true/false 进行修改
-        const l5Enable = typeof func.l5 === 'undefined' ? null : func.l5 ? 'TRUE' : 'FALSE';
+        // UpdateFunctionConfiguration API 白名单（大小写不敏感）
+        // 参考：https://cloud.tencent.com/document/product/583/18580
+        // 注意：Runtime, Handler, Code, Type, ProtocolType 只能在 CreateFunction 时指定
+        // key: 小写用于匹配，value: PascalCase 用于输出
+        const UPDATE_CONFIG_FIELDS = {
+            'description': 'Description',
+            'memorysize': 'MemorySize',
+            'timeout': 'Timeout',
+            'role': 'Role',
+            // 日志配置
+            'clslogsetid': 'ClsLogsetId',
+            'clstopicid': 'ClsTopicId',
+            // 高级配置
+            'deadletterconfig': 'DeadLetterConfig',
+            'publicnetconfig': 'PublicNetConfig',
+            'cfsconfig': 'CfsConfig',
+            'inittimeout': 'InitTimeout',
+            // 注意：asyncRunEnable/traceEnable/autoDeployClsTopicIndex/autoCreateClsTopic
+            // 只能在 CreateFunction 时设置，UpdateFunctionConfiguration 不支持
+            // 注意：dnsCache 需要 'TRUE'/'FALSE' 字符串，在特殊处理阶段处理
+            'intranetconfig': 'IntranetConfig',
+        };
+        // 构建参数
         const params = {
-            FunctionName: func.name,
             Namespace: namespace,
-            L5Enable: l5Enable
+            FunctionName: func.name
         };
-        if (func === null || func === void 0 ? void 0 : func.description) {
-            params.Description = func.description;
+        // 白名单字段自动转换（大小写不敏感，统一输出 PascalCase）
+        for (const key of Object.keys(func)) {
+            const lowerKey = key.toLowerCase();
+            const pascalKey = UPDATE_CONFIG_FIELDS[lowerKey];
+            if (!pascalKey || func[key] === undefined)
+                continue;
+            params[pascalKey] = toPascalCaseKeys(func[key]);
+        }
+        // 特殊处理：安装依赖标志（支持 boolean | string）
+        if (func.installDependency !== undefined) {
+            params.InstallDependency = toBooleanString(func.installDependency);
+        }
+        // 特殊处理：L5 配置（支持 boolean | string）
+        if (func.l5 !== undefined) {
+            params.L5Enable = toBooleanString(func.l5);
+        }
+        // 特殊处理：DnsCache（支持 boolean | string，大小写不敏感）
+        // 注意：asyncRunEnable/traceEnable/autoDeployClsTopicIndex/autoCreateClsTopic
+        // 只能在 CreateFunction 时设置，UpdateFunctionConfiguration 不支持这些参数
+        const dnsCacheValue = getFieldIgnoreCase(func, 'dnsCache');
+        if (dnsCacheValue !== undefined) {
+            params.DnsCache = toBooleanString(dnsCacheValue);
         }
-        // 修复参数存在 undefined 字段时，会出现鉴权失败的情况
-        // Environment 为覆盖式修改，不保留已有字段
-        envVariables.length && (params.Environment = { Variables: envVariables });
-        // 不设默认超时时间，防止覆盖已有配置
-        func.timeout && (params.Timeout = func.timeout);
-        // 运行时
-        func.runtime && (params.Runtime = func.runtime);
+        // 特殊处理：Publish - 是否同时发布新版本（支持 boolean | string，大小写不敏感）
+        const publishValue = getFieldIgnoreCase(func, 'publish');
+        if (publishValue !== undefined) {
+            params.Publish = toBooleanString(publishValue);
+        }
+        // 特殊处理：环境变量
+        if (func.envVariables && Object.keys(func.envVariables).length > 0) {
+            params.Environment = {
+                Variables: Object.keys(func.envVariables).map(key => ({
+                    Key: key,
+                    Value: func.envVariables[key]
+                }))
+            };
+        }
+        // 特殊处理：VPC 配置
         if (((_a = func === null || func === void 0 ? void 0 : func.vpc) === null || _a === void 0 ? void 0 : _a.subnetId) !== undefined && ((_b = func === null || func === void 0 ? void 0 : func.vpc) === null || _b === void 0 ? void 0 : _b.vpcId) !== undefined) {
-            // VPC 网络
             params.VpcConfig = {
-                SubnetId: (_c = func === null || func === void 0 ? void 0 : func.vpc) === null || _c === void 0 ? void 0 : _c.subnetId,
-                VpcId: (_d = func === null || func === void 0 ? void 0 : func.vpc) === null || _d === void 0 ? void 0 : _d.vpcId
+                SubnetId: func.vpc.subnetId,
+                VpcId: func.vpc.vpcId
             };
         }
-        // 内存
-        func.memorySize && (params.MemorySize = func.memorySize);
-        // Node 函数默认安装依赖
-        isNodeFunction(func.runtime) && (params.InstallDependency = 'TRUE');
-        // 是否安装依赖，选项可以覆盖
-        if (typeof func.installDependency !== 'undefined') {
-            params.InstallDependency = func.installDependency ? 'TRUE' : 'FALSE';
-        }
-        // 函数层
-        if ((_e = func === null || func === void 0 ? void 0 : func.layers) === null || _e === void 0 ? void 0 : _e.length) {
-            const transformLayers = func.layers.map(item => ({
+        // 特殊处理：函数层
+        if ((_c = func === null || func === void 0 ? void 0 : func.layers) === null || _c === void 0 ? void 0 : _c.length) {
+            params.Layers = func.layers.map(item => ({
                 LayerName: item.name,
                 LayerVersion: item.version
             }));
-            params.Layers = transformLayers;
         }
-        // WebSocket 协议支持（仅 HTTP 函数）
-        if (func === null || func === void 0 ? void 0 : func.protocolParams) {
-            const idleTimeOut = (_g = (_f = func === null || func === void 0 ? void 0 : func.protocolParams) === null || _f === void 0 ? void 0 : _f.wsParams) === null || _g === void 0 ? void 0 : _g.idleTimeOut;
-            params.ProtocolParams = {
-                WSParams: {
-                    IdleTimeOut: typeof idleTimeOut === 'number' ? idleTimeOut : 15
-                }
-            };
+        // 特殊处理：HTTP 函数多并发配置（大小写不敏感）
+        const instanceConcurrencyConfig = getFieldIgnoreCase(func, 'instanceConcurrencyConfig');
+        if (instanceConcurrencyConfig) {
+            const config = toPascalCaseKeys(instanceConcurrencyConfig);
+            // DynamicEnabled 需要特殊处理为 'TRUE'/'FALSE'
+            if (config.DynamicEnabled !== undefined) {
+                config.DynamicEnabled = toBooleanString(config.DynamicEnabled);
+            }
+            params.InstanceConcurrencyConfig = config;
         }
-        // 多并发配置（仅 HTTP 函数）
-        if (func === null || func === void 0 ? void 0 : func.instanceConcurrencyConfig) {
-            params.InstanceConcurrencyConfig = {
-                DynamicEnabled: func.instanceConcurrencyConfig.dynamicEnabled || 'FALSE',
-                MaxConcurrency: func.instanceConcurrencyConfig.maxConcurrency || 10
-            };
+        // 特殊处理：HTTP 函数协议参数（WebSocket，大小写不敏感）
+        const protocolParams = getFieldIgnoreCase(func, 'protocolParams');
+        if (protocolParams) {
+            const wsParams = getFieldIgnoreCase(protocolParams, 'wsParams');
+            if (wsParams) {
+                params.ProtocolParams = {
+                    WSParams: toPascalCaseKeys(wsParams)
+                };
+            }
+        }
+        // 特殊处理：忽略系统日志上报（Boolean 类型，直接传递，大小写不敏感）
+        const ignoreSysLogValue = getFieldIgnoreCase(func, 'ignoreSysLog');
+        if (ignoreSysLogValue !== undefined) {
+            params.IgnoreSysLog = ignoreSysLogValue;
         }
         try {
             // 如果函数配置中包含触发器，则更新触发器
@@ -665,13 +837,38 @@ class FunctionService {
     async updateFunctionCode(funcParam) {
         const { func, functionRootPath, base64Code, codeSecret, functionPath, deployMode } = funcParam;
         const funcName = func.name;
-        const { env } = this.getFunctionConfig();
+        const { namespace } = this.getFunctionConfig();
+        // 镜像部署：使用镜像配置更新函数代码
+        if (deployMode === 'image') {
+            const params = {
+                FunctionName: funcName,
+                Namespace: namespace,
+                Code: {
+                    ImageConfig: buildImageConfig(func.imageConfig)
+                }
+            };
+            if (!params.Code.ImageConfig.ImageUri) {
+                throw new error_1.CloudBaseError('镜像部署需要配置 imageConfig.imageUri');
+            }
+            try {
+                // 等待函数状态正常
+                await this.waitFunctionActive(funcName, codeSecret);
+                return await this.scfService.request('UpdateFunctionCode', params);
+            }
+            catch (e) {
+                throw new error_1.CloudBaseError(`[${funcName}] 函数代码更新失败：${e.message}`, {
+                    code: e.code,
+                    requestId: e.requestId
+                });
+            }
+        }
+        // 代码部署：原有逻辑
         let installDependency;
         // Node 函数默认安装依赖
         installDependency = isNodeFunction(func.runtime) ? 'TRUE' : 'FALSE';
-        // 是否安装依赖，选项可以覆盖
-        if (typeof func.installDependency !== 'undefined') {
-            installDependency = func.installDependency ? 'TRUE' : 'FALSE';
+        // 是否安装依赖，选项可以覆盖（支持 boolean | string）
+        if (func.installDependency !== undefined) {
+            installDependency = toBooleanString(func.installDependency);
         }
         const codeParams = await this.getCodeParams({
             func,
@@ -682,7 +879,7 @@ class FunctionService {
         }, installDependency);
         const params = {
             FunctionName: funcName,
-            EnvId: env,
+            Namespace: namespace,
             Handler: func.handler || 'index.main',
             InstallDependency: installDependency,
             Code: codeParams
@@ -694,7 +891,7 @@ class FunctionService {
             // 等待函数状态正常
             await this.waitFunctionActive(funcName, codeSecret);
             // 更新云函数代码
-            const res = await this.tcbService.request('UpdateFunctionCode', params);
+            const res = await this.scfService.request('UpdateFunctionCode', params);
             if (installDependency && func.isWaitInstall === true) {
                 await this.waitFunctionActive(funcName, codeSecret);
             }
@@ -1078,7 +1275,8 @@ class FunctionService {
                     if (Status === constant_1.SCF_STATUS.CREATE_FAILED) {
                         const errorDetails = (StatusReasons === null || StatusReasons === void 0 ? void 0 : StatusReasons.map(item => `[${item.ErrorCode}] ${item.ErrorMessage}`).join('\n')) || '';
                         const errorMsg = `云函数创建失败${StatusDesc ? `\n状态描述: ${StatusDesc}` : ''}${errorDetails ? `\n失败信息: ${errorDetails}` : ''}`;
-                        throw new error_1.CloudBaseError(errorMsg, { requestId: RequestId });
+                        // 注意：这里不传递 RequestId，因为这是 GetFunction 的 RequestId，不是导致失败的 CreateFunction/UpdateFunctionCode 的 RequestId
+                        throw new error_1.CloudBaseError(errorMsg);
                     }
                     // 函数状态正常
                     clearInterval(ticker);
@@ -1258,7 +1456,12 @@ class FunctionService {
                 // 清理临时文件
                 await packer.clean();
                 if (err) {
-                    reject(new error_1.CloudBaseError(`COS 上传失败: ${err.message || err}`));
+                    // 保留完整的错误信息（避免原始错误丢失）
+                    const errorMessage = err.message || err.error || String(err);
+                    const errorCode = err.code || err.statusCode || '';
+                    reject(new error_1.CloudBaseError(`COS 上传失败: ${errorMessage}${errorCode ? ` (${errorCode})` : ''}`, {
+                        code: errorCode
+                    }));
                 }
                 else {
                     resolve(data);
@@ -1311,7 +1514,16 @@ class FunctionService {
             headers
         });
         if (!response.ok) {
-            throw new error_1.CloudBaseError(`上传失败: ${response.status} ${response.statusText}`);
+            // 尝试获取响应体中的错误信息
+            let errorDetail = '';
+            try {
+                const responseText = await response.text();
+                errorDetail = responseText ? ` - ${responseText}` : '';
+            }
+            catch (e) {
+                // 忽略响应体解析错误
+            }
+            throw new error_1.CloudBaseError(`上传失败: ${response.status} ${response.statusText}${errorDetail}`);
         }
         // 清理临时文件
         await packer.clean();

package/lib/storage/index.js

@@ -623,15 +623,25 @@ class StorageService {
      * PRIVATE：仅创建者及管理员可读写
      * ADMINWRITE：所有用户可读，仅管理员可写
      * ADMINONLY：仅管理员可读写
-     * @returns
+     * CUSTOM：自定义安全规则
+     * @returns {Promise<{ acl: AclType, rule?: IStorageAclRule }>}
      */
     async getStorageAcl() {
         const { bucket, env } = this.getStorageConfig();
-        const res = await this.tcbService.request('DescribeStorageACL', {
+        const res = await this.tcbService.request('DescribeStorageSafeRule', {
             EnvId: env,
             Bucket: bucket
         });
-        return res.AclTag;
+        const result = { acl: res.AclTag };
+        if (res.AclTag === 'CUSTOM' && res.Rule) {
+            try {
+                result.rule = JSON.parse(res.Rule);
+            }
+            catch (_a) {
+                // Rule 可能不是 JSON 格式，忽略解析错误
+            }
+        }
+        return result;
     }
     /**
      * 设置文件存储权限
@@ -639,20 +649,38 @@ class StorageService {
      * PRIVATE：仅创建者及管理员可读写
      * ADMINWRITE：所有用户可读，仅管理员可写
      * ADMINONLY：仅管理员可读写
-     * @param {string} acl
+     * CUSTOM：自定义安全规则（需要传入 rule 参数）
+     * @param {AclType} acl 权限类型
+     * @param {IStorageAclRule} [rule] 自定义安全规则，当 acl 为 CUSTOM 时必填
      * @returns
+     * @example
+     * // 设置简易权限
+     * await storage.setStorageAcl('READONLY')
+     *
+     * // 设置自定义安全规则
+     * await storage.setStorageAcl('CUSTOM', {
+     *     read: true,
+     *     write: 'resource.openid == auth.uid'
+     * })
      */
-    async setStorageAcl(acl) {
-        const validAcl = ['READONLY', 'PRIVATE', 'ADMINWRITE', 'ADMINONLY'];
+    async setStorageAcl(acl, rule) {
+        const validAcl = ['READONLY', 'PRIVATE', 'ADMINWRITE', 'ADMINONLY', 'CUSTOM'];
         if (!validAcl.includes(acl)) {
-            throw new error_1.CloudBaseError('非法的权限类型');
+            throw new error_1.CloudBaseError(`非法的权限类型: "${acl}", 有效值: ${validAcl.join(', ')}`);
+        }
+        if (acl === 'CUSTOM' && !rule) {
+            throw new error_1.CloudBaseError('使用 CUSTOM 权限类型时，必须提供 rule 参数');
         }
         const { bucket, env } = this.getStorageConfig();
-        return this.tcbService.request('ModifyStorageACL', {
+        const params = {
             EnvId: env,
             Bucket: bucket,
             AclTag: acl
-        });
+        };
+        if (acl === 'CUSTOM' && rule) {
+            params.Rule = JSON.stringify(rule);
+        }
+        return this.tcbService.request('ModifyStorageSafeRule', params);
     }
     /**
      * 遍历云端文件夹

package/package.json

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

package/types/function/index.d.ts

@@ -6,7 +6,7 @@ export interface IFunctionCode {
     functionRootPath?: string;
     base64Code?: string;
     functionPath?: string;
-    deployMode?: 'cos' | 'zip';
+    deployMode?: 'cos' | 'zip' | 'image';
 }
 export interface ICreateFunctionParam {
     func: ICloudFunction & {
@@ -17,7 +17,7 @@ export interface ICreateFunctionParam {
     base64Code?: string;
     functionPath?: string;
     codeSecret?: string;
-    deployMode?: 'cos' | 'zip';
+    deployMode?: 'cos' | 'zip' | 'image';
 }
 export interface IUpdateFunctionCodeParam {
     func: ICloudFunction;
@@ -25,7 +25,7 @@ export interface IUpdateFunctionCodeParam {
     functionRootPath?: string;
     base64Code?: string;
     codeSecret?: string;
-    deployMode?: 'cos' | 'zip';
+    deployMode?: 'cos' | 'zip' | 'image';
 }
 export interface IUpdateFunctionIncrementalCodeParam {
     func: ICloudFunction;
@@ -36,7 +36,7 @@ export interface IUpdateFunctionIncrementalCodeParam {
 export interface ICreateFunctionRes {
     triggerRes: IResponseInfo;
     configRes: IResponseInfo;
-    codeRes: IResponseInfo;
+    codeRes?: IResponseInfo;
 }
 export interface IFunctionLayerOptions {
     contentPath?: string;

package/types/function/types.d.ts

@@ -185,28 +185,40 @@ export interface IFunctionCode {
     TempCosObjectName?: string;
     ZipFile?: string;
     CosTimestamp?: string;
+    ImageConfig?: {
+        ImageType?: string;
+        ImageUri?: string;
+        RegistryId?: string;
+        EntryPoint?: string;
+        Command?: string;
+        Args?: string;
+        ContainerImageAccelerate?: boolean;
+        ImagePort?: number;
+        CommandList?: string[];
+        ArgsList?: string[];
+    };
 }
 export interface ILayerVersionItem {
     LayerName: string;
     LayerVersion: number;
 }
 export interface IFunctionUpdateAttribute {
-    Code: IFunctionCode;
-    Description: string;
+    Code?: IFunctionCode;
+    Description?: string;
     FunctionName: string;
-    MemorySize: number;
-    Timeout: number;
-    UseGpu: 'FALSE' | 'TRUE';
-    Namespace: string;
-    Environment: {
+    MemorySize?: number;
+    Timeout?: number;
+    UseGpu?: 'FALSE' | 'TRUE';
+    Namespace?: string;
+    Environment?: {
         Variables: IEnvVariable[];
     };
-    VpcConfig: {
+    VpcConfig?: {
         VpcId: string;
         SubnetId: string;
     };
     InstallDependency?: 'FALSE' | 'TRUE';
-    PublicNetConfig: {
+    PublicNetConfig?: {
         PublicNetStatus: string;
         EipConfig: {
             EipStatus: string;
@@ -216,4 +228,20 @@ export interface IFunctionUpdateAttribute {
     Layers?: ILayerVersionItem[];
     ClsLogsetId?: string;
     ClsTopicId?: string;
+    Runtime?: string;
+    Handler?: string;
+    Role?: string;
+    L5Enable?: string | null;
+    CodeSecret?: string;
+    Type?: string;
+    ProtocolType?: string;
+    ProtocolParams?: {
+        WSParams?: {
+            IdleTimeOut?: number;
+        };
+    };
+    InstanceConcurrencyConfig?: {
+        DynamicEnabled?: 'FALSE' | 'TRUE';
+        MaxConcurrency?: number;
+    };
 }

package/types/interfaces/function.interface.d.ts

@@ -12,8 +12,15 @@ export interface ICloudFunctionConfig {
     envVariables?: Record<string, string | number | boolean>;
     runtime?: string;
     vpc?: IFunctionVPC;
-    installDependency?: boolean;
-    l5?: boolean;
+    installDependency?: boolean | 'TRUE' | 'FALSE';
+    l5?: boolean | 'TRUE' | 'FALSE';
+    asyncRunEnable?: boolean | 'TRUE' | 'FALSE';
+    traceEnable?: boolean | 'TRUE' | 'FALSE';
+    autoDeployClsTopicIndex?: boolean | 'TRUE' | 'FALSE';
+    autoCreateClsTopic?: boolean | 'TRUE' | 'FALSE';
+    dnsCache?: boolean | 'TRUE' | 'FALSE';
+    publish?: boolean | 'TRUE' | 'FALSE';
+    ignoreSysLog?: boolean;
     memorySize?: number;
     role?: string;
 }
@@ -21,6 +28,18 @@ export interface LayerVersionSimple {
     LayerName: string;
     LayerVersion: number;
 }
+export interface IFunctionImageConfig {
+    imageType: 'enterprise' | 'personal';
+    imageUri: string;
+    registryId?: string;
+    entryPoint?: string;
+    command?: string;
+    args?: string;
+    containerImageAccelerate?: boolean;
+    imagePort?: number;
+    commandList?: string[];
+    argsList?: string[];
+}
 export interface ICloudFunction extends ICloudFunctionConfig {
     name: string;
     description?: string;
@@ -32,8 +51,13 @@ export interface ICloudFunction extends ICloudFunctionConfig {
         };
     };
     instanceConcurrencyConfig?: {
-        dynamicEnabled?: 'FALSE';
+        dynamicEnabled?: boolean | 'TRUE' | 'FALSE';
         maxConcurrency?: number;
+        instanceIsolationEnabled?: boolean | 'TRUE' | 'FALSE';
+        type?: string;
+        mixNodeConfig?: any;
+        sessionConfig?: any;
+        [key: string]: any;
     };
     handler?: string;
     codeSecret?: string;
@@ -44,6 +68,7 @@ export interface ICloudFunction extends ICloudFunctionConfig {
         version: number;
     }[];
     triggers?: ICloudFunctionTrigger[];
+    imageConfig?: IFunctionImageConfig;
 }
 export interface ICloudFunctionV2 {
     name: string;

package/types/storage/index.d.ts

@@ -59,7 +59,13 @@ export interface IGetBucketOpions {
     marker?: string;
     maxKeys?: number;
 }
-export type AclType = 'READONLY' | 'PRIVATE' | 'ADMINWRITE' | 'ADMINONLY';
+export type AclType = 'READONLY' | 'PRIVATE' | 'ADMINWRITE' | 'ADMINONLY' | 'CUSTOM';
+export interface IStorageAclRule {
+    /** 读权限规则，true 表示所有用户可读，字符串表示自定义规则表达式 */
+    read: boolean | string;
+    /** 写权限规则，true 表示所有用户可写，字符串表示自定义规则表达式 */
+    write: boolean | string;
+}
 type OnProgress = (progressData: IProgressData) => void;
 type OnFileFinish = (error: Error, res: any, fileData: any) => void;
 export declare class StorageService {
@@ -220,19 +226,34 @@ export declare class StorageService {
      * PRIVATE：仅创建者及管理员可读写
      * ADMINWRITE：所有用户可读，仅管理员可写
      * ADMINONLY：仅管理员可读写
-     * @returns
+     * CUSTOM：自定义安全规则
+     * @returns {Promise<{ acl: AclType, rule?: IStorageAclRule }>}
      */
-    getStorageAcl(): Promise<AclType>;
+    getStorageAcl(): Promise<{
+        acl: AclType;
+        rule?: IStorageAclRule;
+    }>;
     /**
      * 设置文件存储权限
      * READONLY：所有用户可读，仅创建者和管理员可写
      * PRIVATE：仅创建者及管理员可读写
      * ADMINWRITE：所有用户可读，仅管理员可写
      * ADMINONLY：仅管理员可读写
-     * @param {string} acl
+     * CUSTOM：自定义安全规则（需要传入 rule 参数）
+     * @param {AclType} acl 权限类型
+     * @param {IStorageAclRule} [rule] 自定义安全规则，当 acl 为 CUSTOM 时必填
      * @returns
-     */
-    setStorageAcl(acl: AclType): Promise<IResponseInfo>;
+     * @example
+     * // 设置简易权限
+     * await storage.setStorageAcl('READONLY')
+     *
+     * // 设置自定义安全规则
+     * await storage.setStorageAcl('CUSTOM', {
+     *     read: true,
+     *     write: 'resource.openid == auth.uid'
+     * })
+     */
+    setStorageAcl(acl: AclType, rule?: IStorageAclRule): Promise<IResponseInfo>;
     /**
      * 遍历云端文件夹
      * @param {string} prefix