@cloudbase/manager-node 4.11.0-alpha.8 → 5.0.0

package/types/cloudApp/index.d.ts

@@ -0,0 +1,73 @@
+import { Environment } from '../environment';
+import { ICreateCloudAppParams, ICreateCloudAppResult, IDescribeCloudAppListParams, IDescribeCloudAppListResult, IDescribeCloudAppInfoParams, IDescribeCloudAppInfoResult, IDeleteCloudAppParams, IDeleteCloudAppResult, IDescribeCloudAppVersionParams, IDescribeCloudAppVersionResult, IDescribeCloudAppVersionListParams, IDescribeCloudAppVersionListResult, IDeleteCloudAppVersionParams, IDeleteCloudAppVersionResult, IDescribeCloudAppCosInfoParams, IDescribeCloudAppCosInfoResult, IUploadCloudAppCodeParams, IUploadCloudAppCodeResult } from './types';
+export * from './types';
+/**
+ * CloudApp 统一部署服务
+ * 提供 Web 应用的创建、查询、删除、版本管理等功能
+ */
+export declare class CloudAppService {
+    private tcbService;
+    private environment;
+    constructor(environment: Environment);
+    /**
+     * 创建/更新 CloudApp 应用
+     * @param params 创建参数
+     */
+    createApp(params: ICreateCloudAppParams): Promise<ICreateCloudAppResult>;
+    /**
+     * 获取 CloudApp 应用列表
+     * @param params 查询参数
+     */
+    describeAppList(params: IDescribeCloudAppListParams): Promise<IDescribeCloudAppListResult>;
+    /**
+     * 获取 CloudApp 应用详情
+     * @param params 查询参数
+     */
+    describeAppInfo(params: IDescribeCloudAppInfoParams): Promise<IDescribeCloudAppInfoResult>;
+    /**
+     * 删除 CloudApp 应用
+     * @param params 删除参数
+     */
+    deleteApp(params: IDeleteCloudAppParams): Promise<IDeleteCloudAppResult>;
+    /**
+     * 获取 CloudApp 版本详情
+     * 不指定 versionName 或 buildId 时返回最新版本
+     * @param params 查询参数
+     */
+    describeAppVersion(params: IDescribeCloudAppVersionParams): Promise<IDescribeCloudAppVersionResult>;
+    /**
+     * 获取 CloudApp 版本列表
+     * @param params 查询参数
+     */
+    describeAppVersionList(params: IDescribeCloudAppVersionListParams): Promise<IDescribeCloudAppVersionListResult>;
+    /**
+     * 删除 CloudApp 版本
+     * @param params 删除参数
+     */
+    deleteAppVersion(params: IDeleteCloudAppVersionParams): Promise<IDeleteCloudAppVersionResult>;
+    /**
+     * 获取 CloudApp COS 上传信息（预签名 URL）
+     * @param params 查询参数
+     */
+    describeCosInfo(params: IDescribeCloudAppCosInfoParams): Promise<IDescribeCloudAppCosInfoResult>;
+    /**
+     * 上传本地代码到 COS
+     * 自动打包 ZIP 并上传到预签名 URL
+     *
+     * 注意：此方法不依赖应用是否已创建，可在创建应用前调用
+     * 返回的 cosTimestamp 用于 createApp 时传入 staticConfig.cosTimestamp
+     *
+     * @param params 上传参数
+     */
+    uploadCode(params: IUploadCloudAppCodeParams): Promise<IUploadCloudAppCodeResult>;
+    /**
+     * 获取环境信息
+     */
+    private getEnvInfo;
+    /**
+     * 校验必填参数
+     * @param params 参数对象
+     * @param fields 必填字段列表
+     */
+    private validateRequiredParams;
+}

package/types/cloudApp/types.d.ts

@@ -0,0 +1,325 @@
+/**
+ * CloudApp 统一部署服务类型定义
+ * 支持 static-hosting（静态托管）和 http-function（预留）两种部署类型
+ *
+ * 命名规范：
+ * - 入参接口（IXxxParams）：camelCase，通过 upperCaseObjKey 转换后透传给 API
+ * - 返回值接口（IXxxResult）：PascalCase，与 API 响应字段保持一致
+ */
+/**
+ * 部署类型
+ * - static-hosting: 静态托管部署
+ * - http-function: HTTP 云函数部署（预留）
+ */
+export type DeployType = 'static-hosting' | 'http-function';
+/**
+ * 构建类型
+ * - GIT: 从 Git 仓库构建
+ * - ZIP: 从 ZIP 包构建
+ * - TEMPLATE: 从模板构建
+ */
+export type BuildType = 'GIT' | 'ZIP' | 'TEMPLATE';
+/**
+ * 构建状态
+ */
+export type BuildStatus = 'BUILDING' | 'SUCCESS' | 'FAILED';
+/**
+ * 构建命令配置（入参）
+ */
+export interface IStaticCmd {
+    buildCmd?: string;
+    installCmd?: string;
+    deployCmd?: string;
+}
+/**
+ * 静态环境变量配置（入参）
+ */
+export interface IStaticEnv {
+    variables?: Array<{
+        key: string;
+        value: string;
+    }>;
+}
+/**
+ * 静态托管配置（入参）
+ */
+export interface IStaticConfig {
+    /** 框架类型：vue、react、nextjs 等 */
+    framework?: string;
+    /** Node.js 版本，默认 20 */
+    nodeJsVersion?: string;
+    /** 访问路径 */
+    appPath?: string;
+    /** 构建目录 */
+    buildPath?: string;
+    /** ZIP 文件地址（BuildType=ZIP/TEMPLATE 时使用） */
+    zipFileUrl?: string;
+    /** COS 时间戳（通过 uploadCode 上传后获取，BuildType=ZIP 时使用） */
+    cosTimestamp?: string;
+    /** COS 文件后缀 */
+    cosSuffix?: string;
+    /** 代码源平台：github、gitlab、gitee */
+    codeSource?: string;
+    /** 代码仓库 */
+    codeRepo?: string;
+    /** 代码分支 */
+    codeBranch?: string;
+    /** 构建命令配置 */
+    staticCmd?: IStaticCmd;
+    /** 构建环境变量 */
+    staticEnv?: IStaticEnv;
+}
+/**
+ * 静态托管构建命令配置（API 响应）
+ */
+export interface StaticCmd {
+    BuildCmd?: string;
+    InstallCmd?: string;
+    DeployCmd?: string;
+}
+/**
+ * 静态托管环境变量配置（API 响应，对应文档 StaticEnvironment）
+ */
+export interface StaticEnv {
+    /** 环境变量数组，可能为 null */
+    Variables?: Array<{
+        Key: string;
+        Value: string;
+    }> | null;
+}
+/**
+ * 静态托管配置（API 响应，对应文档 StaticConfig）
+ * 被 CreateCloudApp、DescribeCloudAppVersion、DescribeCloudAppVersionList 引用
+ * 注意：所有字段均可能返回 null
+ */
+export interface CloudAppStaticConfig {
+    /** 框架类型：vue、react、nextjs 等 */
+    Framework?: string | null;
+    /** Node.js 版本，默认 20 */
+    NodeJsVersion?: string | null;
+    /** 访问路径 */
+    AppPath?: string | null;
+    /** 构建目录 */
+    BuildPath?: string | null;
+    /** ZIP 文件地址（BuildType=ZIP/TEMPLATE 时使用） */
+    ZipFileUrl?: string | null;
+    /** COS 时间戳 */
+    CosTimestamp?: string | null;
+    /** COS 文件后缀 */
+    CosSuffix?: string | null;
+    /** 代码源平台：github、gitlab、gitee */
+    CodeSource?: string | null;
+    /** 代码仓库 */
+    CodeRepo?: string | null;
+    /** 代码分支 */
+    CodeBranch?: string | null;
+    /** 构建命令配置 */
+    StaticCmd?: StaticCmd | null;
+    /** 构建环境变量 */
+    StaticEnv?: StaticEnv | null;
+}
+/**
+ * 应用列表项（API 响应 CloudAppServiceItem）
+ */
+export interface CloudAppServiceItem {
+    ServiceName: string;
+    DeployType: string;
+    Framework?: string;
+    Domain?: string;
+    AppPath?: string;
+    CreateTime: string;
+    LatestVersionName?: string;
+    LatestStatus?: string;
+    LatestBuildTime?: string;
+}
+/** @deprecated 请使用 CloudAppServiceItem */
+export type CloudAppItem = CloudAppServiceItem;
+/**
+ * 版本信息（API 响应 CloudAppVersionItem）
+ */
+export interface CloudAppVersion {
+    VersionName: string;
+    BuildId: string;
+    BuildType?: string;
+    Status: string;
+    Framework?: string;
+    BuildTime?: string;
+    StaticConfig?: CloudAppStaticConfig;
+}
+export interface ICreateCloudAppParams {
+    /** 环境 ID（可选，默认从 Environment 获取） */
+    envId?: string;
+    /** 部署类型：static-hosting / http-function */
+    deployType: DeployType;
+    /** 服务名称 */
+    serviceName: string;
+    /** 构建类型：GIT / ZIP / TEMPLATE */
+    buildType?: BuildType;
+    /** 静态托管配置（deployType 为 static-hosting 时使用） */
+    staticConfig?: IStaticConfig;
+}
+export interface ICreateCloudAppResult {
+    ServiceName: string;
+    BuildId: string;
+    VersionName: string;
+    RequestId: string;
+}
+export interface IDescribeCloudAppListParams {
+    /** 环境 ID（可选） */
+    envId?: string;
+    /** 部署类型 */
+    deployType: DeployType;
+    /** 页码（从 1 开始） */
+    pageNo?: number;
+    /** 每页大小 */
+    pageSize?: number;
+    /** 搜索关键字，按应用名模糊搜索 */
+    searchKey?: string;
+}
+export interface IDescribeCloudAppListResult {
+    Total: number;
+    ServiceList: CloudAppServiceItem[];
+    RequestId: string;
+}
+export interface IDescribeCloudAppInfoParams {
+    /** 环境 ID（可选） */
+    envId?: string;
+    /** 部署类型 */
+    deployType: DeployType;
+    /** 服务名称 */
+    serviceName: string;
+}
+export interface IDescribeCloudAppInfoResult {
+    ServiceName: string;
+    DeployType: string;
+    Framework?: string;
+    Domain?: string;
+    AppPath?: string;
+    CreateTime: string;
+    LatestVersionName?: string;
+    LatestStatus?: string;
+    LatestBuildTime?: string;
+    RequestId: string;
+}
+export interface IDeleteCloudAppParams {
+    /** 环境 ID（可选） */
+    envId?: string;
+    /** 部署类型 */
+    deployType: DeployType;
+    /** 服务名称 */
+    serviceName: string;
+}
+export interface IDeleteCloudAppResult {
+    Result: boolean;
+    RequestId: string;
+}
+export interface IDescribeCloudAppVersionParams {
+    /** 环境 ID（可选） */
+    envId?: string;
+    /** 部署类型 */
+    deployType: DeployType;
+    /** 服务名称 */
+    serviceName: string;
+    /** 版本名称（与 buildId 二选一） */
+    versionName?: string;
+    /** 构建 ID（与 versionName 二选一） */
+    buildId?: string;
+}
+export interface IDescribeCloudAppVersionResult {
+    BuildType: string;
+    BuildId: string;
+    Status: BuildStatus;
+    Framework?: string;
+    StaticConfig?: CloudAppStaticConfig;
+    BuildTime?: string;
+    RequestId: string;
+}
+export interface IDescribeCloudAppVersionListParams {
+    /** 环境 ID（可选） */
+    envId?: string;
+    /** 部署类型 */
+    deployType: DeployType;
+    /** 服务名称 */
+    serviceName: string;
+    /** 页码（从 1 开始） */
+    pageNo?: number;
+    /** 每页大小 */
+    pageSize?: number;
+}
+export interface IDescribeCloudAppVersionListResult {
+    Total: number;
+    VersionList: CloudAppVersion[] | null;
+    RequestId: string;
+}
+export interface IDeleteCloudAppVersionParams {
+    /** 环境 ID（可选） */
+    envId?: string;
+    /** 部署类型 */
+    deployType: DeployType;
+    /** 服务名称 */
+    serviceName: string;
+    /** 版本名称 */
+    versionName: string;
+}
+export interface IDeleteCloudAppVersionResult {
+    Result: boolean;
+    RequestId: string;
+}
+export interface IDescribeCloudAppCosInfoParams {
+    /** 环境 ID（可选） */
+    envId?: string;
+    /** 部署类型 */
+    deployType: DeployType;
+    /** 服务名称 */
+    serviceName: string;
+    /** Unix 时间戳（用于指定文件路径，不传则自动生成） */
+    unixTimestamp?: string;
+    /** 文件后缀（默认 .zip） */
+    suffix?: string;
+    /** 是否需要下载 URL */
+    needDownload?: boolean;
+}
+export interface CosHeader {
+    Key: string;
+    Value: string;
+}
+export interface IDescribeCloudAppCosInfoResult {
+    UploadUrl: string;
+    UploadHeaders?: CosHeader[];
+    DownloadUrl?: string;
+    DownloadHeaders?: CosHeader[];
+    UnixTimestamp: string;
+    RequestId: string;
+}
+/**
+ * 上传进度信息
+ */
+export interface IProgressData {
+    loaded: number;
+    total: number;
+    percent: number;
+}
+/**
+ * 上传代码参数
+ */
+export interface IUploadCloudAppCodeParams {
+    /** 部署类型 */
+    deployType: DeployType;
+    /** 服务名称 */
+    serviceName: string;
+    /** 本地文件夹路径 */
+    localPath: string;
+    /** 忽略的文件/目录模式 */
+    ignore?: string[];
+    /** 进度回调 */
+    onProgress?: (progress: IProgressData) => void;
+}
+/**
+ * 上传代码结果
+ */
+export interface IUploadCloudAppCodeResult {
+    /** COS 时间戳（用于 createApp 时传入 staticConfig.cosTimestamp） */
+    cosTimestamp: string;
+    /** Unix 时间戳（与 cosTimestamp 相同） */
+    unixTimestamp: string;
+}

package/types/cloudrun/index.d.ts

@@ -135,8 +135,6 @@ export declare class CloudRunService {
      * @returns {Promise<ITemplate[]>} 返回模板数组
      */
     getTemplates(): Promise<ITemplate[]>;
-    private _checkFunctionExist;
-    private _upsertFunction;
     /**
      * 获取部署记录列表，按部署时间倒序（最新在前）
      */
@@ -150,6 +148,8 @@ export declare class CloudRunService {
     getProcessLog(params: {
         RunId: string;
     }): Promise<IProcessLogResponse>;
+    private _checkFunctionExist;
+    private _upsertFunction;
 }
 export declare function codeToZip(cwd: string, options?: {
     installDependency?: boolean;

package/types/cloudrun/type.d.ts

@@ -38,10 +38,12 @@ export interface ICloudrunServerBaseInfo {
      */
     CustomDomainName: string;
     /**
-     * 服务状态
-     * @example "running" | "deploying" | "deploy_failed"
+     * 服务状态（来自 DescribeCloudRunServers）
+     * 常见值："creating" | "create_failed" | "freezing" | "freeze_fail" | "froze" |
+     * "unfreezing" | "unfreeze_fail" | "normal" | "deleting" | "delete_failed" | "abnormal"
+     * @example "normal"
      */
-    Status: 'running' | 'deploying' | 'deploy_failed';
+    Status: 'creating' | 'create_failed' | 'freezing' | 'freeze_fail' | 'froze' | 'unfreezing' | 'unfreeze_fail' | 'normal' | 'deleting' | 'delete_failed' | 'abnormal';
     /**
      * 更新时间
      * @example "2022-03-09 14:00:00"

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 } from './type';
+import { CalculatePackageCreatePriceParams, CalculatePackageRenewPriceParams, CalculatePackageModifyPriceParams, DescribeHttpServiceRouteParams, DescribeHttpServiceRouteRes, CreateHttpServiceRouteParams, CreateHttpServiceRouteRes, ModifyHttpServiceRouteParams, ModifyHttpServiceRouteRes, DeleteHttpServiceRouteParams, DeleteHttpServiceRouteRes, BindCustomDomainParams, BindCustomDomainRes, DeleteCustomDomainParams, DeleteCustomDomainRes } from './type';
 import { CreateBillingDealParams, CreateEnvParams, BaasPackageInfo, DescribeBaasPackageListParams, ModifyEnvPlanParams, RenewEnvParams, DestroyEnvParams, DescribeEnvsParams, DescribeEnvAccountCircleParams, DescribeEnvAccountCircleRes, DescribeCreditsUsageDetailParams, EnvPkgCreditsUsage } from '../interfaces/tcb.interface';
 type SOURCE = 'miniapp' | 'qcloud';
 interface IDeleteDomainRes {
@@ -264,6 +264,44 @@ export declare class EnvService {
         Usages: EnvPkgCreditsUsage[];
         RequestId: string;
     }>;
+    /**
+     * 查询HTTP访问服务域名路由信息
+     * @param {DescribeHttpServiceRouteParams} params 查询参数
+     * @returns {Promise<DescribeHttpServiceRouteRes>}
+     */
+    describeHttpServiceRoute(params: DescribeHttpServiceRouteParams): Promise<DescribeHttpServiceRouteRes>;
+    /**
+     * 创建HTTP访问服务域名路由
+     * @param {CreateHttpServiceRouteParams} params 创建参数
+     * @returns {Promise<CreateHttpServiceRouteRes>}
+     */
+    createHttpServiceRoute(params: CreateHttpServiceRouteParams): Promise<CreateHttpServiceRouteRes>;
+    /**
+     * 修改HTTP访问服务域名路由
+     * @param {ModifyHttpServiceRouteParams} params 修改参数
+     * @returns {Promise<ModifyHttpServiceRouteRes>}
+     */
+    modifyHttpServiceRoute(params: ModifyHttpServiceRouteParams): Promise<ModifyHttpServiceRouteRes>;
+    /**
+     * 删除HTTP访问服务域名路由
+     * @param {DeleteHttpServiceRouteParams} params 删除参数
+     * @returns {Promise<DeleteHttpServiceRouteRes>}
+     */
+    deleteHttpServiceRoute(params: DeleteHttpServiceRouteParams): Promise<DeleteHttpServiceRouteRes>;
+    /**
+     * 绑定自定义域名到HTTP访问服务
+     * 底层调用 CreateHTTPServiceRoute API，专用于域名绑定场景
+     * @param {BindCustomDomainParams} params 绑定参数
+     * @returns {Promise<BindCustomDomainRes>}
+     */
+    bindCustomDomain(params: BindCustomDomainParams): Promise<BindCustomDomainRes>;
+    /**
+     * 删除自定义域名
+     * 仅当域名下无路由绑定时可删除，否则抛出错误
+     * @param {DeleteCustomDomainParams} params 删除参数
+     * @returns {Promise<DeleteCustomDomainRes>}
+     */
+    deleteCustomDomain(params: DeleteCustomDomainParams): Promise<DeleteCustomDomainRes>;
     private getCOSDomains;
     private modifyCosCorsDomain;
     private getCos;

package/types/env/type.d.ts

@@ -14,3 +14,190 @@ export interface CalculatePackageModifyPriceParams {
     envId: string;
     currency?: 'CNY' | 'USD';
 }
+/**
+ * 客户端限频配置
+ */
+export interface HTTPServiceQPSPerClient {
+    LimitBy?: 'UserID' | 'ClientIP';
+    LimitValue?: number;
+}
+/**
+ * QPS限频策略
+ */
+export interface HTTPServiceRouteQPSPolicy {
+    QPSTotal?: number;
+    QPSPerClient?: HTTPServiceQPSPerClient;
+}
+/**
+ * 路径重写
+ */
+export interface HTTPServicePathRewrite {
+    StaticStorePrefix?: string;
+    Prefix?: string;
+}
+/**
+ * HTTP访问服务路由信息
+ */
+export interface HTTPServiceRoute {
+    Path: string;
+    PathRewrite?: HTTPServicePathRewrite;
+    UpstreamResourceType: 'SCF' | 'CBR' | 'STATIC_STORE' | 'WEB_SCF' | 'LH';
+    UpstreamResourceName: string;
+    EnableSafeDomain: boolean;
+    EnableAuth: boolean;
+    EnablePathTransmission: boolean;
+    QPSPolicy?: HTTPServiceRouteQPSPolicy;
+    Enable: boolean;
+    CreateTime: string;
+    UpdateTime: string;
+}
+/**
+ * 域名路由信息
+ */
+export interface HTTPServiceDomain {
+    Domain: string;
+    DomainType: 'HTTPSERVICE' | 'CBR' | 'ANYSERVICE' | 'AI_AGENT' | 'VM' | 'INTEGRATION_CALLBACK';
+    AccessType: 'DIRECT' | 'CDN' | 'CUSTOM';
+    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';
+    Routes?: HTTPServiceRoute[];
+    CreateTime: string;
+    UpdateTime: string;
+}
+/**
+ * 过滤条件
+ */
+export interface HTTPServiceRouteFilter {
+    Name?: 'Domain' | 'Path' | 'DomainType' | 'UpstreamResourceType';
+    Values?: string[];
+}
+/**
+ * DescribeHTTPServiceRoute 请求参数
+ */
+export interface DescribeHttpServiceRouteParams {
+    EnvId: string;
+    Filters?: HTTPServiceRouteFilter[];
+    Offset?: number;
+    Limit?: number;
+}
+/**
+ * DescribeHTTPServiceRoute 返回结果
+ */
+export interface DescribeHttpServiceRouteRes {
+    Domains?: HTTPServiceDomain[];
+    OriginDomain: string;
+    TotalCount: number;
+    RequestId: string;
+}
+/**
+ * HTTP访问服务路由参数（创建/修改）
+ */
+export interface HTTPServiceRouteParam {
+    Path: string;
+    UpstreamResourceType?: 'SCF' | 'CBR' | 'STATIC_STORE' | 'WEB_SCF' | 'LH';
+    UpstreamResourceName?: string;
+    PathRewrite?: HTTPServicePathRewrite;
+    EnableSafeDomain?: boolean;
+    EnableAuth?: boolean;
+    EnablePathTransmission?: boolean;
+    QPSPolicy?: HTTPServiceRouteQPSPolicy;
+    Enable?: boolean;
+}
+/**
+ * HTTP访问服务域名参数（创建/修改）
+ */
+export interface HTTPServiceDomainParam {
+    Domain: string;
+    AccessType?: 'DIRECT' | 'CDN' | 'CUSTOM';
+    CertId?: string;
+    Protocol?: 'HTTP_AND_HTTPS' | 'HTTP_TO_HTTPS' | 'HTTPS_TO_HTTP';
+    CustomCname?: string;
+    Enable?: boolean;
+    Routes?: HTTPServiceRouteParam[];
+}
+/**
+ * CreateHTTPServiceRoute 请求参数
+ */
+export interface CreateHttpServiceRouteParams {
+    EnvId: string;
+    Domain: HTTPServiceDomainParam;
+}
+/**
+ * CreateHTTPServiceRoute 返回结果
+ */
+export interface CreateHttpServiceRouteRes {
+    RequestId: string;
+}
+/**
+ * ModifyHTTPServiceRoute 请求参数
+ */
+export interface ModifyHttpServiceRouteParams {
+    EnvId: string;
+    Domain: HTTPServiceDomainParam;
+}
+/**
+ * ModifyHTTPServiceRoute 返回结果
+ */
+export interface ModifyHttpServiceRouteRes {
+    RequestId: string;
+}
+/**
+ * DeleteHTTPServiceRoute 请求参数
+ */
+export interface DeleteHttpServiceRouteParams {
+    EnvId: string;
+    Domain: string;
+    Paths?: string[];
+}
+/**
+ * DeleteHTTPServiceRoute 返回结果
+ */
+export interface DeleteHttpServiceRouteRes {
+    RequestId: string;
+}
+/**
+ * 绑定自定义域名的域名参数
+ * 与 HTTPServiceDomainParam 类似，但不包含 Routes（绑定域名场景）
+ */
+export interface BindCustomDomainDomainParam {
+    Domain: string;
+    CertId: string;
+    AccessType?: 'DIRECT' | 'CDN' | 'CUSTOM';
+    Protocol?: 'HTTP_AND_HTTPS' | 'HTTP_TO_HTTPS' | 'HTTPS_TO_HTTP';
+    Enable?: boolean;
+    CustomCname?: string;
+}
+/**
+ * BindCustomDomain 请求参数
+ * 用于绑定自定义域名到 HTTP 访问服务
+ * 底层调用 CreateHTTPServiceRoute API，但参数配置不同
+ */
+export interface BindCustomDomainParams {
+    EnvId: string;
+    Domain: BindCustomDomainDomainParam;
+}
+/**
+ * BindCustomDomain 返回结果
+ */
+export interface BindCustomDomainRes {
+    RequestId: string;
+}
+/**
+ * DeleteCustomDomain 请求参数
+ * 用于删除自定义域名（仅当域名下无路由绑定时可删除）
+ */
+export interface DeleteCustomDomainParams {
+    EnvId: string;
+    Domain: string;
+}
+/**
+ * DeleteCustomDomain 返回结果
+ */
+export interface DeleteCustomDomainRes {
+    RequestId: string;
+}

package/types/environment.d.ts

@@ -13,6 +13,7 @@ import { AccessService } from './access';
 import { UserService } from './user';
 import { CloudBaseRunService } from './cloudBaseRun';
 import { MysqlService } from './mysql';
+import { CloudAppService } from './cloudApp';
 import { EnvInfo } from './interfaces';
 import { PermissionService } from './permission';
 export declare class Environment {
@@ -35,6 +36,7 @@ export declare class Environment {
     private cloudBaseRunService;
     private mysqlService;
     private permissionService;
+    private cloudAppService;
     constructor(context: CloudBaseContext, envId: string);
     lazyInit(): Promise<any>;
     getEnvId(): string;
@@ -52,6 +54,7 @@ export declare class Environment {
     getUserService(): UserService;
     getCloudBaseRunService(): CloudBaseRunService;
     getMysqlService(): MysqlService;
+    getCloudAppService(): CloudAppService;
     getPermissionService(): PermissionService;
     getCommonService(serviceType: string, serviceVersion: any): CommonService;
     getServicesEnvInfo(): Promise<any>;