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

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>;
+}

package/types/platform/type.d.ts

@@ -0,0 +1,525 @@
+/**
+ * 平台版套餐相关接口类型定义
+ */
+import { CircleTime, MetricUsage } from '../interfaces/tcb.interface';
+import { HTTPServiceDomain, HTTPServiceDomainParam, HTTPServiceRouteFilter, OwnershipVerificationInfo, VerifyHttpServiceRouteCheckItem } from '../env/type';
+/**
+ * 平台版环境配置（资源状态变更）
+ * 用于云存储（Storage）、FlexDB（文档型数据库）等资源的状态更新
+ */
+export interface PlatformEnvResource {
+    /** 资源状态（为空或不传则不更新）。ENABLE：正常 / DISABLE：彻底禁用 / READONLY：只读 */
+    Status?: 'ENABLE' | 'DISABLE' | 'READONLY';
+}
+/**
+ * ModifyPlatformEnv 请求参数
+ */
+export interface ModifyPlatformEnvParams {
+    /** 环境ID（可选，不传则自动使用当前环境 ID） */
+    EnvId?: string;
+    /** 环境状态。ENABLE：启用环境 / DISABLE：禁用环境 */
+    Status?: 'ENABLE' | 'DISABLE';
+    /** 云存储信息变更（不传或为空则不更新） */
+    Storage?: PlatformEnvResource;
+    /** FlexDB（文档型数据库）状态更新（为空或不传则不更新） */
+    FlexDB?: PlatformEnvResource;
+}
+/**
+ * ModifyPlatformEnv 返回结果
+ */
+export interface ModifyPlatformEnvRes {
+    /** 最终状态，如 manualLimited */
+    Status?: string;
+    /** 唯一请求 ID */
+    RequestId: string;
+}
+/**
+ * 平台版套餐信息
+ */
+export interface PlatformPackageInfo {
+    /** 套餐id */
+    PackageId?: string;
+    /** 套餐名称 */
+    Name?: string;
+    /** 计费下单参数（JSON 字符串） */
+    BillTags?: string;
+    /** 套餐规格信息（JSON 字符串） */
+    Spec?: string;
+    /** 套餐描述信息 */
+    Description?: string;
+    /** 套餐数字id */
+    Id?: number;
+}
+/**
+ * DescribePlatformPackageList 请求参数
+ */
+export interface DescribePlatformPackageListParams {
+    /** 平台版套餐id */
+    PackageId?: string;
+}
+/**
+ * DescribePlatformPackageList 返回结果
+ */
+export interface DescribePlatformPackageListRes {
+    /** 平台版套餐列表 */
+    PackageList: PlatformPackageInfo[];
+    /** 唯一请求 ID */
+    RequestId: string;
+}
+/**
+ * 平台版资源项信息（平台版套餐下的具体资源，如日志、云存储、静态托管）
+ */
+export interface PlatFormResourceInfo {
+    /** 资源类型。log：日志 / storage：云存储 / hosting：静态托管 */
+    ResType?: string;
+    /** 资源唯一标识 */
+    ResName?: string;
+    /** 资源详细信息（JSON 字符串） */
+    Detail?: string;
+    /** 资源状态。0：正常 / 5：初始化中 */
+    Status?: number;
+    /** 资源id */
+    PlatformId?: number;
+    /** 对应平台资源id */
+    Id?: number;
+}
+/**
+ * 平台版资源信息
+ */
+export interface PlatformInfo {
+    /** 平台版套餐id */
+    PlatformId?: string;
+    /** 套餐别名 */
+    Alias?: string;
+    /** 套餐id */
+    PackageId?: string;
+    /** 计费状态。normal：正常 / isolated：已隔离 / destroyed：已销毁 */
+    BillStatus?: string;
+    /** 套餐资源状态。0：可用 / 5：发货中 */
+    Status?: number;
+    /** 资源配置（JSON 字符串） */
+    Spec?: string;
+    /** 购买时间，格式 'YYYY-MM-DD HH:mm:ss' */
+    BillTime?: string;
+    /** 套餐过期时间，格式 'YYYY-MM-DD HH:mm:ss' */
+    ExpireTime?: string;
+    /** 是否自动续费。0：未设置 / 1：自动续费 / 2：设置为到期不续费 */
+    IsAutoRenew?: number;
+    /** 资源信息列表 */
+    Resources?: PlatFormResourceInfo[];
+    /** 所属地域。ap-shanghai：上海 / ap-singapore：新加坡 */
+    Region?: string;
+}
+/**
+ * DescribePlatforms 请求参数
+ */
+export interface DescribePlatformsParams {
+    /** 平台版套餐id列表（不指定则分页返回当前账号下所有平台版资源） */
+    PlatformIds?: string[];
+    /** 分页限制，取值范围 [10, 100]，默认 10 */
+    Limit?: number;
+    /** 分页偏移量，默认 0 */
+    Offset?: number;
+}
+/**
+ * DescribePlatforms 返回结果
+ */
+export interface DescribePlatformsRes {
+    /** 平台版资源列表 */
+    PlatformList: PlatformInfo[];
+    /** 总数 */
+    Total?: number;
+    /** 唯一请求 ID */
+    RequestId: string;
+}
+/**
+ * DescribePlatformAccountCircle 请求参数
+ */
+export interface DescribePlatformAccountCircleParams {
+    /** 平台版资源id */
+    PlatformId: string;
+    /** false 仅返回当前套餐周期，true 返回当前周期以及上个、上上个周期 */
+    WithHistoryCircle?: boolean;
+}
+/**
+ * DescribePlatformAccountCircle 返回结果
+ */
+export interface DescribePlatformAccountCircleRes {
+    /** 套餐计费周期开始时间 */
+    StartTime: string;
+    /** 套餐计费周期结束时间 */
+    EndTime: string;
+    /** 依次为当前套餐的上个、上上个历史周期（开始时间不早于下单时间，可能不足两个周期） */
+    HistoryTime?: CircleTime[];
+    /** 套餐当前是否过期 */
+    Expired?: boolean;
+    /** 唯一请求 ID */
+    RequestId: string;
+}
+/**
+ * 平台版每日资源点消耗数据
+ */
+export interface PlatformCreditsUsageDaily {
+    /** 日期 */
+    Date?: string;
+    /** 资源点套餐内用量 */
+    DeductValue?: number;
+    /** 资源点资源包用量 */
+    PackageDeductValue?: number;
+    /** 资源点按量用量 */
+    ReportValue?: number;
+    /** 资源点原价消耗 */
+    OriginCredits?: number;
+}
+/**
+ * DescribePlatformCreditsUsage 请求参数
+ */
+export interface DescribePlatformCreditsUsageParams {
+    /** 开始日期，格式 'YYYY-MM-DD' */
+    StartDate: string;
+    /** 结束日期，格式 'YYYY-MM-DD' */
+    EndDate: string;
+    /** 平台版资源id */
+    PlatformId: string;
+}
+/**
+ * DescribePlatformCreditsUsage 返回结果
+ */
+export interface DescribePlatformCreditsUsageRes {
+    /** 资源点套餐内抵扣总量 */
+    DeductValueCount?: number;
+    /** 资源点资源包抵扣总量 */
+    PackageDeductValueCount?: number;
+    /** 资源点按量上报总量 */
+    ReportValueCount?: number;
+    /** 资源点原价消耗总量 */
+    OriginCreditsCount?: number;
+    /** 每日资源点用量列表 */
+    DailyList?: PlatformCreditsUsageDaily[];
+    /** 唯一请求 ID */
+    RequestId: string;
+}
+/**
+ * 模块内平台版资源点用量及原始用量数据
+ */
+export interface PlatformPkgCreditsUsage {
+    /** 平台版资源id */
+    PlatformId?: string;
+    /** 模块 */
+    Module?: string;
+    /** module 总资源点用量 */
+    CreditsValue?: number;
+    /** 指标用量明细 */
+    MetricUsageDetail?: MetricUsage[];
+    /** 资源点套餐内用量 */
+    DeductValue?: number;
+    /** 资源点资源包用量 */
+    PackageDeductValue?: number;
+    /** 资源点按量用量 */
+    ReportValue?: number;
+    /** 资源点原价消耗 */
+    OriginCredits?: number;
+}
+/**
+ * DescribePlatformCreditsUsageDetail 请求参数
+ */
+export interface DescribePlatformCreditsUsageDetailParams {
+    /** 模块列表。枚举值：
+     * FLEXDB 文档数据库 / TDSQL MYSQL数据库 / SCF 云函数 / AI 大模型 / EKS 云托管 /
+     * COS 云存储 / HOSTING 静态托管 / Auth 用户权限 / APIInvocation API调用 /
+     * HTTPInvocation HTTP调用 / VM 主机 / Workflow 工作流 / Other 其他 /
+     * PostgreSQL PostgreSQL / Token Token */
+    Modules: string[];
+    /** 开始日期，格式 'YYYY-MM-DD' */
+    StartDate: string;
+    /** 结束日期，格式 'YYYY-MM-DD' */
+    EndDate: string;
+    /** 是否需要每日用量明细 */
+    NeedUsageDetails: boolean;
+    /** 平台版资源id */
+    PlatformId: string;
+}
+/**
+ * DescribePlatformCreditsUsageDetail 返回结果
+ */
+export interface DescribePlatformCreditsUsageDetailRes {
+    /** 用量数据 */
+    Usages: PlatformPkgCreditsUsage[];
+    /** 唯一请求 ID */
+    RequestId: string;
+}
+/**
+ * 每日用量详情
+ */
+export interface DailyUsageList {
+    /** 资源点用量 */
+    Credits?: number;
+    /** 资源点用量日期，格式 'YYYY-MM-DD' */
+    Date?: string;
+    /** 原始资源用量 */
+    UsageValue?: number;
+}
+/**
+ * 平台版指标用量信息
+ */
+export interface PlatformMetricUsageItem {
+    /** 指标名称 */
+    MetricName?: string;
+    /** 原始资源类型。如 COS：对象存储 */
+    OriginalResourceType?: string;
+    /** 原始指标名 */
+    OriginalMetricName?: string;
+    /** 资源用量 */
+    UsageValue?: number;
+    /** 资源用量单位，如 MB、Count */
+    UsageUnit?: string;
+    /** 资源点 */
+    Credits?: number;
+    /** 用量按日明细列表 */
+    DailyUsageList?: DailyUsageList[];
+}
+/**
+ * 平台版资源用量信息
+ */
+export interface PlatformResUsageItem {
+    /** 资源类型。Storage：云存储 / Function：云函数 / Database：数据库 / HOSTING：静态托管 /
+     * Log：日志 / Gateway：网关 / Cloudrun：云托管 / Token：Token / EO：EdgeOne */
+    ResourceType?: string;
+    /** 该资源类型的资源点总量 */
+    TotalCredits?: number;
+    /** 指标用量信息 */
+    Metrics?: PlatformMetricUsageItem[];
+}
+/**
+ * DescribePlatformEnvUsage 请求参数
+ */
+export interface DescribePlatformEnvUsageParams {
+    /** 环境ID（可选，不传则自动使用当前环境 ID） */
+    EnvId?: string;
+    /** 查询用量起始时间，格式 'YYYY-MM-DD' */
+    StartDate?: string;
+    /** 查询用量结束时间，格式 'YYYY-MM-DD' */
+    EndDate?: string;
+    /** 资源类型。Storage：云存储 / Function：云函数 / Database：数据库 / HOSTING：静态托管 /
+     * Log：日志 / Gateway：网关 / Cloudrun：云托管 / Token：Token / EO：EdgeOne */
+    ResourceTypes?: string[];
+    /** 是否展示用量明细 */
+    NeedUsageDetails?: boolean;
+}
+/**
+ * DescribePlatformEnvUsage 返回结果
+ */
+export interface DescribePlatformEnvUsageRes {
+    /** 资源用量信息 */
+    Resources?: PlatformResUsageItem[];
+    /** 资源点总量 */
+    TotalCredits?: number;
+    /** 资源点取整倍数 */
+    CreditsScale?: number;
+    /** 唯一请求 ID */
+    RequestId: string;
+}
+/**
+ * 环境资源点排行项
+ */
+export interface EnvCreditsRank {
+    /** 环境id */
+    EnvId?: string;
+    /** 总资源点用量 */
+    TotalCredits?: number;
+    /** 资源点从上往下排行序号 */
+    Rank?: number;
+}
+/**
+ * DescribePlatformEnvCreditsRanking 请求参数
+ */
+export interface DescribePlatformEnvCreditsRankingParams {
+    /** 平台版资源id */
+    PlatformId?: string;
+    /** 查询时间范围。Today：近1天 / Recent7Days：近7天 / CurrentCycle：当前计费周期 /
+     * PreviousCycle：上一个计费周期 / Previous2Cycle：上两个计费周期。默认 Today */
+    TimeRange?: string;
+    /** 每页条数，默认 50 */
+    PageSize?: number;
+    /** 分页 offset */
+    AfterRank?: number;
+}
+/**
+ * DescribePlatformEnvCreditsRanking 返回结果
+ */
+export interface DescribePlatformEnvCreditsRankingRes {
+    /** 查询时间范围。Recent7Days：近7天 / Recent30Days：近30天 / CurrentCycle：当前计费周期 /
+     * PreviousCycle：上一个计费周期 / Previous2Cycle：上两个计费周期 */
+    TimeRange?: string;
+    /** 起始时间，格式 'YYYY-MM-DD HH:mm:ss' */
+    StartTime?: string;
+    /** 结束时间，格式 'YYYY-MM-DD HH:mm:ss' */
+    EndTime?: string;
+    /** 统计的截止时间，格式 'YYYY-MM-DD HH:mm:ss' */
+    DataAsOfTime?: string;
+    /** 是否还有下一页数据 */
+    HasMore?: boolean;
+    /** 下一条数据的 offset 值 */
+    NextAfterRank?: number;
+    /** 总数量 */
+    TotalCount?: number;
+    /** 资源点精度 */
+    CreditsScale?: number;
+    /** 排行快照版本 */
+    SnapshotId?: string;
+    /** 环境排行列表 */
+    Items?: EnvCreditsRank[];
+    /** 唯一请求 ID */
+    RequestId: string;
+}
+/**
+ * DestroyPlatformEnv 请求参数
+ */
+export interface DestroyPlatformEnvParams {
+    /** 环境id */
+    EnvId: string;
+}
+/**
+ * DestroyPlatformEnv 返回结果
+ */
+export interface DestroyPlatformEnvRes {
+    /** 唯一请求 ID */
+    RequestId: string;
+}
+/**
+ * CreatePlatformEnv 请求参数
+ */
+export interface CreatePlatformEnvParams {
+    /** 环境别名 */
+    Alias: string;
+    /** 套餐池标识 */
+    PlatformId: string;
+    /** 幂等键 */
+    ReqKey: string;
+}
+/**
+ * CreatePlatformEnv 返回结果
+ */
+export interface CreatePlatformEnvRes {
+    /** 环境id */
+    EnvId?: string;
+    /** 唯一请求 ID */
+    RequestId: string;
+}
+/**
+ * ModifyPlatformHTTPServiceRoute 请求参数
+ */
+export interface ModifyPlatformHTTPServiceRouteParams {
+    /** 平台id */
+    PlatformId: string;
+    /** 域名路由信息（增量修改，对应字段不传则不修改） */
+    Domain: HTTPServiceDomainParam;
+}
+/**
+ * ModifyPlatformHTTPServiceRoute 返回结果
+ */
+export interface ModifyPlatformHTTPServiceRouteRes {
+    /** 唯一请求 ID */
+    RequestId: string;
+}
+/**
+ * CreatePlatformHTTPServiceRoute 请求参数
+ */
+export interface CreatePlatformHTTPServiceRouteParams {
+    /** 平台id */
+    PlatformId: string;
+    /** 域名路由信息。不传 Domain.Routes 时仅创建域名信息 */
+    Domain: HTTPServiceDomainParam;
+}
+/**
+ * CreatePlatformHTTPServiceRoute 返回结果
+ */
+export interface CreatePlatformHTTPServiceRouteRes {
+    /** 归属权校验不通过时返回的验证指引，按指引配置 DNS 或文件验证后，
+     * 可调用 verifyPlatformHttpServiceRoute 验证归属权是否通过 */
+    OwnershipVerification?: OwnershipVerificationInfo;
+    /** 唯一请求 ID */
+    RequestId: string;
+}
+/**
+ * VerifyPlatformHTTPServiceRoute 请求参数
+ */
+export interface VerifyPlatformHTTPServiceRouteParams {
+    /** 平台id */
+    PlatformId: string;
+    /** 域名路由信息 */
+    Domain: HTTPServiceDomainParam;
+}
+/**
+ * VerifyPlatformHTTPServiceRoute 返回结果
+ */
+export interface VerifyPlatformHTTPServiceRouteRes {
+    /** 前置校验总开关。所有启用的检查项均为 PASS 或 SKIPPED 时为 true，
+     * 任一检查项为 FAIL 时为 false */
+    Passed?: boolean;
+    /** 域名归属权校验结果 */
+    Ownership?: VerifyHttpServiceRouteCheckItem;
+    /** 证书校验结果；CertId 为空时 Status=SKIPPED */
+    Cert?: VerifyHttpServiceRouteCheckItem;
+    /** 域名/路径数量配额校验结果 */
+    Quota?: VerifyHttpServiceRouteCheckItem;
+    /** 同域名下路由路径冲突校验结果 */
+    RouteConflict?: VerifyHttpServiceRouteCheckItem;
+    /** 域名被其他环境占用校验结果 */
+    DomainConflict?: VerifyHttpServiceRouteCheckItem;
+    /** 内部域名且非内部账号校验结果 */
+    InternalAccount?: VerifyHttpServiceRouteCheckItem;
+    /** 域名黑名单校验结果 */
+    Blacklist?: VerifyHttpServiceRouteCheckItem;
+    /** AccessType=CDN 时 CDN 资源存在性/状态校验结果（含 ICP 未备案提示） */
+    CDNResource?: VerifyHttpServiceRouteCheckItem;
+    /** AccessType=EO 时的 EdgeOne 预检结果（域名冲突/备案/归属权） */
+    EO?: VerifyHttpServiceRouteCheckItem;
+    /** 唯一请求 ID */
+    RequestId: string;
+}
+/**
+ * DeletePlatformHTTPServiceRoute 请求参数
+ */
+export interface DeletePlatformHTTPServiceRouteParams {
+    /** 平台id */
+    PlatformId: string;
+    /** 域名 */
+    Domain: string;
+    /** 路径列表。为空则表示删除此域名及所有路由；不为空则仅删除对应的 path 路由 */
+    Paths?: string[];
+}
+/**
+ * DeletePlatformHTTPServiceRoute 返回结果
+ */
+export interface DeletePlatformHTTPServiceRouteRes {
+    /** 唯一请求 ID */
+    RequestId: string;
+}
+/**
+ * DescribePlatformHTTPServiceRoute 请求参数
+ */
+export interface DescribePlatformHTTPServiceRouteParams {
+    /** 平台id */
+    PlatformId: string;
+    /** 过滤条件。可过滤: Domain、Path、DomainType、UpstreamResourceType。
+     * 过滤条件数量限制为 10，Values 单条不超过 100 */
+    Filters?: HTTPServiceRouteFilter[];
+    /** 分页偏移量，默认 0 */
+    Offset?: number;
+    /** 分页限制，默认 20，最大值 1000 */
+    Limit?: number;
+}
+/**
+ * DescribePlatformHTTPServiceRoute 返回结果
+ */
+export interface DescribePlatformHTTPServiceRouteRes {
+    /** 域名路由信息列表 */
+    Domains?: HTTPServiceDomain[];
+    /** 自定义接入的源站域名（HTTPService接入层域名） */
+    OriginDomain: string;
+    /** 域名总数，分页查询使用总数判断是否已经拉取到所有数据 */
+    TotalCount: number;
+    /** 唯一请求 ID */
+    RequestId: string;
+}

package/types/storage/index.d.ts

@@ -201,6 +201,22 @@ export interface ISearchResult {
 type OnProgress = (progressData: IProgressData) => void;
 type OnFileFinish = (error: Error, res: any, fileData: any) => void;
 export { md5File } from './helper';
+export interface IBatchDeleteFailure {
+    fileId: string;
+    cloudPath: string | undefined;
+    code: string;
+}
+/**
+ * 整理 storage.batchDeleteFile 的逐文件删除结果，取出失败项并回填对应的 cloudPath
+ *
+ * 该接口逐文件返回 code，未失败的文件已经删除成功。把结果汇总成一条错误消息会丢掉逐项信息，
+ * 调用方无法区分「删掉了哪些」和「哪些本来就不存在」，因此保留结构化失败列表。
+ * 接口未保证 delete_list 与入参同序，这里按 fileID 反查。
+ */
+export declare function collectBatchDeleteFailures(deleteList: {
+    fileID: string;
+    code: string;
+}[], fileIdList: string[], cloudPathList: string[]): IBatchDeleteFailure[];
 export declare class StorageService {
     private environment;
     private tcbService;