@cloudbase/manager-node 5.8.8-beta.0 → 5.8.9-beta.0

package/lib/storage/index.js

@@ -11,6 +11,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.StorageService = exports.md5File = void 0;
+exports.collectBatchDeleteFailures = collectBatchDeleteFailures;
 const fs_1 = __importDefault(require("fs"));
 const util_1 = __importDefault(require("util"));
 const path_1 = __importDefault(require("path"));
@@ -34,6 +35,23 @@ const DEFAULT_MD5_PARALLEL = 20;
 const CONSISTENT_DEPLOY_BACKUP_PREFIX = '.cloudbase-backup/';
 var helper_2 = require("./helper");
 Object.defineProperty(exports, "md5File", { enumerable: true, get: function () { return helper_2.md5File; } });
+/**
+ * 整理 storage.batchDeleteFile 的逐文件删除结果，取出失败项并回填对应的 cloudPath
+ *
+ * 该接口逐文件返回 code，未失败的文件已经删除成功。把结果汇总成一条错误消息会丢掉逐项信息，
+ * 调用方无法区分「删掉了哪些」和「哪些本来就不存在」，因此保留结构化失败列表。
+ * 接口未保证 delete_list 与入参同序，这里按 fileID 反查。
+ */
+function collectBatchDeleteFailures(deleteList, fileIdList, cloudPathList) {
+    const cloudPathByFileId = new Map(fileIdList.map((fileId, index) => [fileId, cloudPathList[index]]));
+    return (deleteList || [])
+        .filter(item => item.code !== 'SUCCESS')
+        .map(item => ({
+        fileId: item.fileID,
+        cloudPath: cloudPathByFileId.get(item.fileID),
+        code: item.code
+    }));
+}
 class StorageService {
     constructor(environment) {
         this.environment = environment;
@@ -1152,11 +1170,12 @@ class StorageService {
             },
             method: 'POST'
         });
-        const failedList = res.data.delete_list
-            .filter(item => item.code !== 'SUCCESS')
-            .map(item => `${item.fileID} : ${item.code}`);
-        if (failedList.length) {
-            throw new error_1.CloudBaseError(`部分删除文件失败：${JSON.stringify(failedList)}`);
+        const failed = collectBatchDeleteFailures(res.data.delete_list, fileIdList, cloudPathList);
+        if (failed.length) {
+            const failedList = failed.map(item => `${item.fileId} : ${item.code}`);
+            throw new error_1.CloudBaseError(`部分删除文件失败：${JSON.stringify(failedList)}`, {
+                meta: { failed, total: cloudPathList.length }
+            });
         }
     }
     /**

package/lib/utils/storage-config.js

@@ -32,7 +32,7 @@ function toLogicalPath(basePath, key) {
 }
 /**
  * 解析环境的有效云存储配置
- * 共享桶环境（Storages[0].Bucket 为空且 ExternalStorage.Enabled 为 true）下，桶名、地域、BasePath 从 ExternalStorage 读取；
+ * 共享桶环境（Storages[0].ExternalStorage.Enabled 为 true）下，BasePath 从 ExternalStorage 读取，桶名、地域在顶层为空时回退到 ExternalStorage；
  * 普通环境保持读取 Storages[0].Bucket / Region，basePath 为空串
  */
 function resolveStorageConfig(envConfig) {
@@ -54,18 +54,24 @@ function resolveStorageConfig(envConfig) {
 }
 /**
  * 按共享桶规则解析有效桶，云存储（Storages）与静态托管（DescribeStaticStore）共用
- * bucket 为空且 externalStorage.Enabled 为 true 时使用 ExternalStorage，否则使用环境自有桶，basePath 为空串
+ *
+ * 是否共享桶只看 ExternalStorage.Enabled，不看顶层 Bucket 是否为空：
+ * 目前线上共享桶环境的顶层 Bucket 均返回空串，但接口定义并未保证这一点，
+ * 若后端回填桶名而 basePath 仍按「Bucket 为空」判定，文件会静默写到桶根目录，
+ * 造成同一共享桶内跨环境污染。因此 basePath 只由 Enabled + BasePath 决定，
+ * 桶名则优先用顶层 Bucket，为空时回退到 ExternalStorage.BucketName。
  */
 function resolveBucketConfig(options) {
     const { envId, bucket, region, externalStorage } = options;
-    if (!bucket && (externalStorage === null || externalStorage === void 0 ? void 0 : externalStorage.Enabled) === true) {
+    if ((externalStorage === null || externalStorage === void 0 ? void 0 : externalStorage.Enabled) === true) {
+        const effectiveBucket = bucket || externalStorage.BucketName;
         // 线上存在已启用外部存储但未返回桶名的环境，继续执行会在 COS 调用时报 missing param Bucket
-        if (!externalStorage.BucketName) {
+        if (!effectiveBucket) {
             throw new error_1.CloudBaseError(`环境 ${envId} 已启用外部存储（ExternalStorage），但未返回存储桶名称（BucketName），无法访问存储桶，请联系平台检查该环境的共享桶配置`);
         }
         return {
-            bucket: externalStorage.BucketName,
-            region: externalStorage.Region,
+            bucket: effectiveBucket,
+            region: region || externalStorage.Region,
             basePath: externalStorage.BasePath || ''
         };
     }

package/package.json

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

package/types/env/index.d.ts

@@ -1,6 +1,6 @@
 import { Environment } from '../environment';
 import { IResponseInfo, AuthDomain, EnvInfo, LoginConfigItem, ICheckTcbServiceRes, ICreatePostpayRes, EnvBillingInfoItem, PriceResult } from '../interfaces';
-import { CalculatePackageCreatePriceParams, CalculatePackageRenewPriceParams, CalculatePackageModifyPriceParams, DescribeHttpServiceRouteParams, DescribeHttpServiceRouteRes, VerifyHttpServiceRouteParams, VerifyHttpServiceRouteRes, CreateHttpServiceRouteParams, CreateHttpServiceRouteRes, ModifyHttpServiceRouteParams, ModifyHttpServiceRouteRes, DeleteHttpServiceRouteParams, DeleteHttpServiceRouteRes, BindCustomDomainParams, BindCustomDomainRes, DeleteCustomDomainParams, DeleteCustomDomainRes, DescribeCertificatesParams, DescribeCertificatesRes } from './type';
+import { CalculatePackageCreatePriceParams, CalculatePackageRenewPriceParams, CalculatePackageModifyPriceParams, DescribeHttpServiceRouteParams, DescribeHttpServiceRouteRes, VerifyHttpServiceRouteParams, VerifyHttpServiceRouteRes, CreateHttpServiceRouteParams, CreateHttpServiceRouteRes, ModifyHttpServiceRouteParams, ModifyHttpServiceRouteRes, DeleteHttpServiceRouteParams, DeleteHttpServiceRouteRes, PurgeHttpServiceCacheParams, PurgeHttpServiceCacheRes, DescribeHttpServiceCachePurgeTaskParams, DescribeHttpServiceCachePurgeTaskRes, BindCustomDomainParams, BindCustomDomainRes, DeleteCustomDomainParams, DeleteCustomDomainRes, DescribeCertificatesParams, DescribeCertificatesRes } from './type';
 import { CreateBillingDealParams, CreateEnvParams, BaasPackageInfo, DescribeBaasPackageListParams, ModifyEnvPlanParams, RenewEnvParams, DestroyEnvParams, DescribeEnvsParams, DescribeEnvInfoParams, DescribeEnvInfoResponse, DescribeEnvAccountCircleParams, DescribeEnvAccountCircleRes, DescribeCreditsUsageDetailParams, EnvPkgCreditsUsage } from '../interfaces/tcb.interface';
 type SOURCE = 'miniapp' | 'qcloud';
 interface IDeleteDomainRes {
@@ -928,6 +928,21 @@ export declare class EnvService {
      * @returns {Promise<DeleteHttpServiceRouteRes>}
      */
     deleteHttpServiceRoute(params: DeleteHttpServiceRouteParams): Promise<DeleteHttpServiceRouteRes>;
+    /**
+     * 清除HTTP访问服务域名缓存
+     * 支持 CDN 和 EO 两种缓存类型。CDN 仅支持 PURGE_URL 刷新方式；PURGE_PREFIX / PURGE_HOST 仅 EO 支持
+     * 清除缓存后会生成任务ID，可通过 DescribeHTTPServiceCachePurgeTask 查询任务进度和详细信息
+     * @param {PurgeHttpServiceCacheParams} params 清除缓存参数
+     * @returns {Promise<PurgeHttpServiceCacheRes>}
+     */
+    purgeHttpServiceCache(params: PurgeHttpServiceCacheParams): Promise<PurgeHttpServiceCacheRes>;
+    /**
+     * 查询HTTP访问服务域名缓存清除任务详情
+     * 通过 purgeHttpServiceCache 清除域名缓存后，可传入任务ID查询清除任务状态、时间、缓存类型等信息；也可不传任务ID查询历史任务记录
+     * @param {DescribeHttpServiceCachePurgeTaskParams} params 查询参数
+     * @returns {Promise<DescribeHttpServiceCachePurgeTaskRes>}
+     */
+    describeHttpServiceCachePurgeTask(params: DescribeHttpServiceCachePurgeTaskParams): Promise<DescribeHttpServiceCachePurgeTaskRes>;
     /**
      * 绑定自定义域名到HTTP访问服务
      * 底层调用 CreateHTTPServiceRoute API，专用于域名绑定场景

package/types/env/type.d.ts

@@ -215,11 +215,62 @@ export interface HTTPServiceHeadersHandler {
     ResponseHeadersToAdd?: HTTPServiceHeaderToAdd[];
     ResponseHeadersToRemove?: string[];
 }
+/**
+ * HTTPService 缓存配置（域名维度）
+ */
+export interface HTTPServiceCacheSet {
+    Rules?: HTTPServiceCacheRule[];
+}
+/**
+ * HTTPService 缓存规则条目
+ */
+export interface HTTPServiceCacheRule {
+    Description?: string;
+    Enable?: boolean;
+    Condition: HTTPServiceRuleCondition;
+    Actions: HTTPServiceCacheAction[];
+}
+/**
+ * HTTPService 缓存规则匹配条件
+ */
+export interface HTTPServiceRuleCondition {
+    Target?: 'url_path' | 'file_extension' | 'full_uri';
+    MatchType?: 'prefix' | 'suffix' | 'contains' | 'exact';
+    Values?: string[];
+}
+/**
+ * HTTPService 缓存动作（Type 与被设置的子字段必须一一对应）
+ */
+export interface HTTPServiceCacheAction {
+    Type?: 'Cache' | 'CacheKey';
+    Cache?: HTTPServiceCacheParams;
+    CacheKey?: HTTPServiceCacheKeyParams;
+}
+/**
+ * HTTPService 缓存参数（节点缓存 + 浏览器缓存）
+ * FollowOrigin / NoCache / (CacheTime||MaxAgeTime) 三者互斥，必须开启其一
+ */
+export interface HTTPServiceCacheParams {
+    FollowOrigin?: boolean;
+    NoCache?: boolean;
+    CacheTime?: number;
+    MaxAgeTime?: number;
+}
+/**
+ * 自定义缓存键参数。约束：FullURLCache=on 与 QueryStringSwitch=on 互斥
+ */
+export interface HTTPServiceCacheKeyParams {
+    FullURLCache?: 'on' | 'off';
+    QueryStringSwitch?: 'on' | 'off';
+    QueryStringAction?: 'includeCustom' | 'excludeCustom';
+    QueryStringValues?: string[];
+}
 /**
  * HTTP访问服务路由扩展字段
  */
 export interface HTTPServiceExtension {
     HeadersHandler?: HTTPServiceHeadersHandler;
+    Cache?: HTTPServiceCacheSet;
     [key: string]: unknown;
 }
 /**
@@ -245,14 +296,15 @@ export interface HTTPServiceRoute {
 export interface HTTPServiceDomain {
     Domain: string;
     DomainType: 'HTTPSERVICE' | 'CBR' | 'ANYSERVICE' | 'AI_AGENT' | 'VM' | 'INTEGRATION_CALLBACK';
-    AccessType: 'DIRECT' | 'CDN' | 'CUSTOM' | 'EO';
+    AccessType: 'DIRECT' | 'CDN' | 'CUSTOM' | 'EO' | 'NONE';
     CertId: string;
     Protocol: 'HTTP_AND_HTTPS' | 'HTTP_TO_HTTPS' | 'HTTPS_TO_HTTP';
     Cname: string;
     IsDefault: boolean;
     Enable: boolean;
-    Status: 'PROCESSING' | 'FAIL' | 'SUCCESS';
-    DNSStatus: 'OK' | 'INVALID';
+    Status: 'PROCESSING' | 'FAIL' | 'EO_PENDING_VERIFICATION' | 'SUCCESS';
+    DNSStatus: 'OK' | 'EMPTY' | 'INVALID';
+    PlatformCnameDNSStatus?: 'OK' | 'EMPTY' | 'INVALID';
     Routes?: HTTPServiceRoute[];
     Extension?: HTTPServiceExtension;
     CreateTime: string;
@@ -303,7 +355,7 @@ export interface HTTPServiceRouteParam {
  */
 export interface HTTPServiceDomainParam {
     Domain: string;
-    AccessType?: 'DIRECT' | 'CDN' | 'CUSTOM' | 'EO';
+    AccessType?: 'DIRECT' | 'CDN' | 'CUSTOM' | 'EO' | 'NONE';
     CertId?: string;
     Protocol?: 'HTTP' | 'HTTPS' | 'HTTP_AND_HTTPS' | 'HTTP_TO_HTTPS' | 'HTTPS_TO_HTTP';
     CustomCname?: string;
@@ -414,6 +466,62 @@ export interface DeleteHttpServiceRouteParams {
 export interface DeleteHttpServiceRouteRes {
     RequestId: string;
 }
+/**
+ * PurgeHTTPServiceCache 请求参数
+ * 用于清除HTTP访问服务域名缓存，支持 CDN 和 EO 两种缓存类型
+ */
+export interface PurgeHttpServiceCacheParams {
+    EnvId: string;
+    Domain: string;
+    CacheType: 'CDN' | 'EO';
+    PurgeType: 'PURGE_URL' | 'PURGE_PREFIX' | 'PURGE_HOST';
+    Targets: string[];
+}
+/**
+ * PurgeHTTPServiceCache 返回结果
+ */
+export interface PurgeHttpServiceCacheRes {
+    CacheType: 'CDN' | 'EO';
+    TaskId: string;
+    RequestId: string;
+}
+/**
+ * 缓存清除任务详情
+ */
+export interface HTTPServiceCachePurgeTask {
+    TaskId: string;
+    CacheType: 'CDN' | 'EO';
+    Status: 'PROCESSING' | 'SUCCESS' | 'FAILED' | 'TIMEOUT' | 'CANCELED';
+    PurgeType: 'PURGE_URL' | 'PURGE_PREFIX' | 'PURGE_HOST';
+    Method: 'INVALIDATE' | 'DELETE';
+    Targets: string[];
+    FailReason?: string;
+    CreateTime: string;
+    UpdateTime: string;
+}
+/**
+ * DescribeHTTPServiceCachePurgeTask 请求参数
+ * 用于查询HTTPService域名缓存清除任务详情
+ */
+export interface DescribeHttpServiceCachePurgeTaskParams {
+    EnvId: string;
+    Domain: string;
+    CacheType: 'CDN' | 'EO';
+    TaskId?: string;
+    PurgeType?: 'PURGE_URL' | 'PURGE_PREFIX' | 'PURGE_HOST';
+    StartTime?: string;
+    EndTime?: string;
+    Offset?: number;
+    Limit?: number;
+}
+/**
+ * DescribeHTTPServiceCachePurgeTask 返回结果
+ */
+export interface DescribeHttpServiceCachePurgeTaskRes {
+    Tasks: HTTPServiceCachePurgeTask[];
+    TotalCount: number;
+    RequestId: string;
+}
 /**
  * 绑定自定义域名的域名参数
  * 与 HTTPServiceDomainParam 类似，但不包含 Routes（绑定域名场景）

package/types/environment.d.ts

@@ -21,6 +21,7 @@ import { SandboxService } from './sandbox';
 import { AiModelService } from './aiModel';
 import { MonitorService } from './monitor';
 import { IntegrationService } from './integration';
+import { PlatformService } from './platform';
 export declare class Environment {
     inited: boolean;
     cloudBaseContext: CloudBaseContext;
@@ -47,6 +48,7 @@ export declare class Environment {
     private aiModelService;
     private monitorService;
     private integrationService;
+    private platformService;
     constructor(context: CloudBaseContext, envId: string);
     lazyInit(): Promise<any>;
     getEnvId(): string;
@@ -75,6 +77,10 @@ export declare class Environment {
     getAiModelService(): AiModelService;
     getMonitorService(): MonitorService;
     getIntegrationService(): IntegrationService;
+    /**
+     * 获取平台版套餐服务
+     */
+    getPlatformService(): PlatformService;
     getCommonService(serviceType: string, serviceVersion: any): CommonService;
     getServicesEnvInfo(): Promise<any>;
     getAuthConfig(): {

package/types/error.d.ts

@@ -4,6 +4,7 @@ interface Options {
     code?: string | number;
     requestId?: string;
     action?: string;
+    meta?: Record<string, any>;
 }
 export declare class CloudBaseError extends Error {
     readonly exit: number;
@@ -13,6 +14,7 @@ export declare class CloudBaseError extends Error {
     readonly code: string | number;
     readonly requestId: string;
     readonly action: string;
+    readonly meta: Record<string, any> | undefined;
     constructor(message: string, options?: Options);
 }
 export {};

package/types/index.d.ts

@@ -23,6 +23,7 @@ import { CloudAppService } from './cloudApp';
 import { AiModelService } from './aiModel';
 import { IntegrationService } from './integration';
 import { MonitorService } from './monitor';
+import { PlatformService } from './platform';
 import { ProjectValidator } from './projectValidator';
 import { DeployOrchestrator } from './deploy/DeployOrchestrator';
 import { resolveBuildCommand as frameworkResolveBuildCommand, resolveHostingOutputDir as frameworkResolveHostingOutputDir, buildHostingItem as frameworkBuildHostingItem } from './deploy/framework';
@@ -113,6 +114,11 @@ declare class CloudBase {
      * 提供指标查询能力
      */
     get monitor(): MonitorService;
+    /**
+     * 平台版套餐服务
+     * 提供平台版套餐查询、环境管理、资源用量及 HTTP 访问服务路由等能力
+     */
+    get platform(): PlatformService;
     get docs(): DocsService;
     get projectValidator(): ProjectValidator;
     getProjectValidator(): ProjectValidator;

package/types/platform/index.d.ts

@@ -0,0 +1,133 @@
+import { Environment } from '../environment';
+import { CreatePlatformEnvParams, CreatePlatformEnvRes, CreatePlatformHTTPServiceRouteParams, CreatePlatformHTTPServiceRouteRes, DescribePlatformAccountCircleParams, DescribePlatformAccountCircleRes, DescribePlatformCreditsUsageDetailParams, DescribePlatformCreditsUsageDetailRes, DescribePlatformCreditsUsageParams, DescribePlatformCreditsUsageRes, DescribePlatformEnvCreditsRankingParams, DescribePlatformEnvCreditsRankingRes, DescribePlatformEnvUsageParams, DescribePlatformEnvUsageRes, DescribePlatformHTTPServiceRouteParams, DescribePlatformHTTPServiceRouteRes, DescribePlatformPackageListParams, DescribePlatformPackageListRes, DescribePlatformsParams, DescribePlatformsRes, DeletePlatformHTTPServiceRouteParams, DeletePlatformHTTPServiceRouteRes, DestroyPlatformEnvParams, DestroyPlatformEnvRes, ModifyPlatformEnvParams, ModifyPlatformEnvRes, ModifyPlatformHTTPServiceRouteParams, ModifyPlatformHTTPServiceRouteRes, VerifyPlatformHTTPServiceRouteParams, VerifyPlatformHTTPServiceRouteRes } from './type';
+/**
+ * 平台版服务
+ * 提供平台版套餐查询、资源用量统计、环境生命周期管理及 HTTP 访问服务路由管理能力
+ */
+export declare class PlatformService {
+    private environment;
+    private envId;
+    private cloudService;
+    constructor(environment: Environment);
+    /**
+     * 查询在售的平台版套餐列表
+     * 返回当前可购买的平台版套餐，包括计费下单配置（BillTags）、套餐规格（Spec）等商品信息，
+     * 用于购买前的套餐查询，不涉及用户已购资源。
+     * @param {DescribePlatformPackageListParams} params 查询参数，可通过 PackageId 查询指定套餐
+     * @returns {Promise<DescribePlatformPackageListRes>} 在售套餐列表
+     */
+    describePlatformPackageList(params?: DescribePlatformPackageListParams): Promise<DescribePlatformPackageListRes>;
+    /**
+     * 查询当前账号下的平台版资源实例列表
+     * 返回已购平台版资源的计费信息（购买与过期时间、计费状态、自动续费），
+     * 以及存储、日志、静态托管等底层资源明细。
+     * @param {DescribePlatformsParams} params 查询参数，PlatformIds 指定实例（缺省分页返回全部），Limit 取值 [10, 100]
+     * @returns {Promise<DescribePlatformsRes>} 平台版资源列表及总数
+     * @throws {CloudBaseError} Limit 非法时抛出，须为 10 至 100 的整数
+     */
+    describePlatforms(params?: DescribePlatformsParams): Promise<DescribePlatformsRes>;
+    /**
+     * 查询平台版资源当前所处的计费周期
+     * 平台版资源点按月结算，计费周期自购买日起算，每个周期各享有一笔抵扣额度。
+     * 例如 2026-01-05 购买 3 个月（2026-04-05 到期），则三个周期分别为
+     * 01-05 ~ 02-05、02-06 ~ 03-05、03-06 ~ 04-05。
+     * @param {DescribePlatformAccountCircleParams} params 查询参数，WithHistoryCircle 为 true 时附带返回最近两个历史周期
+     * @returns {Promise<DescribePlatformAccountCircleRes>} 当前周期起止时间及是否过期
+     */
+    describePlatformAccountCircle(params: DescribePlatformAccountCircleParams): Promise<DescribePlatformAccountCircleRes>;
+    /**
+     * 查询平台版资源的资源点用量汇总
+     * 返回指定时间范围内的资源点用量统计，包括套餐内抵扣、资源包抵扣、
+     * 按量上报、原价消耗四类总量的每日明细。
+     * @param {DescribePlatformCreditsUsageParams} params 查询参数，StartDate/EndDate 格式为 'YYYY-MM-DD'
+     * @returns {Promise<DescribePlatformCreditsUsageRes>} 四类用量总量及每日明细
+     */
+    describePlatformCreditsUsage(params: DescribePlatformCreditsUsageParams): Promise<DescribePlatformCreditsUsageRes>;
+    /**
+     * 查询平台版资源的资源点用量明细
+     * 按模块（Usages）→ 指标（MetricUsageDetail）→ 每日明细（ValueDetailList）三个层级，
+     * 返回各模块的资源点用量及原始用量明细。
+     * @param {DescribePlatformCreditsUsageDetailParams} params 查询参数，Modules 指定查询的模块（如 FLEXDB、SCF、AI、COS 等）
+     * @returns {Promise<DescribePlatformCreditsUsageDetailRes>} 各模块的用量明细数据
+     */
+    describePlatformCreditsUsageDetail(params: DescribePlatformCreditsUsageDetailParams): Promise<DescribePlatformCreditsUsageDetailRes>;
+    /**
+     * 查询平台版下各环境的资源点用量排行
+     * 按 TimeRange 指定的时间范围返回各环境的资源点用量排序，
+     * 排行数据由后台定时计算，可能存在小时级延迟。
+     * @param {DescribePlatformEnvCreditsRankingParams} params 查询参数，TimeRange 缺省为 Today（近 1 天）
+     * @returns {Promise<DescribePlatformEnvCreditsRankingRes>} 环境用量排行列表及分页信息
+     */
+    describePlatformEnvCreditsRanking(params?: DescribePlatformEnvCreditsRankingParams): Promise<DescribePlatformEnvCreditsRankingRes>;
+    /**
+     * 查询平台版环境内各资源类型的用量
+     * 按资源类型（存储、函数、数据库等）返回各指标的用量及按日明细，
+     * 包括资源点用量与原始用量值及对应单位。
+     * @param {DescribePlatformEnvUsageParams} params 查询参数，EnvId 缺省时使用当前环境，ResourceTypes 指定资源类型
+     * @returns {Promise<DescribePlatformEnvUsageRes>} 资源用量明细及资源点总量
+     */
+    describePlatformEnvUsage(params: DescribePlatformEnvUsageParams): Promise<DescribePlatformEnvUsageRes>;
+    /**
+     * 创建平台版环境
+     * 在已购平台版资源下开通新环境。
+     * @param {CreatePlatformEnvParams} params 创建参数，ReqKey 为幂等键，可用于防止重复创建
+     * @returns {Promise<CreatePlatformEnvRes>} 新创建环境的 EnvId
+     */
+    createPlatformEnv(params: CreatePlatformEnvParams): Promise<CreatePlatformEnvRes>;
+    /**
+     * 修改平台版环境状态
+     * 支持启用/禁用环境，以及云存储（Storage）、FlexDB 资源的状态变更，未传入的资源不做更新。
+     * @param {ModifyPlatformEnvParams} params 修改参数，EnvId 缺省时使用当前环境
+     * @returns {Promise<ModifyPlatformEnvRes>} 环境的最终状态
+     * @throws {CloudBaseError} Status 非法时抛出，仅支持 ENABLE / DISABLE
+     */
+    modifyPlatformEnv(params: ModifyPlatformEnvParams): Promise<ModifyPlatformEnvRes>;
+    /**
+     * 删除平台版环境
+     * 删除操作不可逆，须显式指定目标环境 ID。
+     * @param {DestroyPlatformEnvParams} params 删除参数，EnvId 为必填
+     * @returns {Promise<DestroyPlatformEnvRes>} 请求执行结果
+     */
+    destroyPlatformEnv(params: DestroyPlatformEnvParams): Promise<DestroyPlatformEnvRes>;
+    /**
+     * 校验 HTTP 访问服务路由配置（预检）
+     * 创建路由前的只读预检，覆盖域名归属权、证书、配额、路由冲突、域名占用等检查项，
+     * 不创建任何资源。Passed 为 true 时可调用 createPlatformHttpServiceRoute 正式创建；
+     * 为 false 时根据各检查项的 Code 定位并修正问题。
+     * 预检通过不代表创建必然成功，但预检不通过则创建必然失败。
+     * @param {VerifyPlatformHTTPServiceRouteParams} params 校验参数，包含待校验的域名路由信息
+     * @returns {Promise<VerifyPlatformHTTPServiceRouteRes>} 整体校验结果及各检查项明细
+     */
+    verifyPlatformHttpServiceRoute(params: VerifyPlatformHTTPServiceRouteParams): Promise<VerifyPlatformHTTPServiceRouteRes>;
+    /**
+     * 创建 HTTP 访问服务路由
+     * 不传 Domain.Routes 时仅创建域名信息。域名与路由均为异步下发，创建后需调用
+     * describePlatformHttpServiceRoute 轮询域名状态，直到 SUCCESS 或 FAIL（FAIL 可删除后重新创建）；
+     * 下发完成前访问域名可能返回 404 或 HTTPS 握手失败。
+     * @param {CreatePlatformHTTPServiceRouteParams} params 创建参数
+     * @returns {Promise<CreatePlatformHTTPServiceRouteRes>} 域名归属权验证指引（归属校验未通过时返回）
+     */
+    createPlatformHttpServiceRoute(params: CreatePlatformHTTPServiceRouteParams): Promise<CreatePlatformHTTPServiceRouteRes>;
+    /**
+     * 修改 HTTP 访问服务路由
+     * 增量更新，对应字段未传入则不修改。
+     * @param {ModifyPlatformHTTPServiceRouteParams} params 修改参数，包含目标域名及待更新的路由信息
+     * @returns {Promise<ModifyPlatformHTTPServiceRouteRes>} 请求执行结果
+     */
+    modifyPlatformHttpServiceRoute(params: ModifyPlatformHTTPServiceRouteParams): Promise<ModifyPlatformHTTPServiceRouteRes>;
+    /**
+     * 删除 HTTP 访问服务路由
+     * Paths 为空时删除域名及其下全部路由，非空时仅删除指定路径的路由。
+     * @param {DeletePlatformHTTPServiceRouteParams} params 删除参数，Paths 缺省时删除整个域名
+     * @returns {Promise<DeletePlatformHTTPServiceRouteRes>} 请求执行结果
+     */
+    deletePlatformHttpServiceRoute(params: DeletePlatformHTTPServiceRouteParams): Promise<DeletePlatformHTTPServiceRouteRes>;
+    /**
+     * 查询 HTTP 访问服务路由
+     * 返回各域名及其路由信息列表、自定义接入的源站域名及域名总数，
+     * 支持按 Domain、Path、DomainType、UpstreamResourceType 过滤及分页。
+     * @param {DescribePlatformHTTPServiceRouteParams} params 查询参数，Limit 默认 20、最大 1000
+     * @returns {Promise<DescribePlatformHTTPServiceRouteRes>} 域名路由列表及域名总数
+     */
+    describePlatformHttpServiceRoute(params: DescribePlatformHTTPServiceRouteParams): Promise<DescribePlatformHTTPServiceRouteRes>;
+}