Hosted Service、Environment、Slot、Endpoint 与数据库

面向后端开发者解释托管服务运行资源与托管 PostgreSQL 产品之间的关系、归属和计费边界。

平台把“服务是什么”“服务部署到哪里”“使用哪份计算资源”“从哪里访问”“使用哪份数据”拆成不同资源。理解这些边界后，开发、测试和生产环境可以独立组合，而不需要复制服务或把配置写进制品。

五个核心概念

Hosted Service：托管服务

Hosted Service 是一个后端服务的逻辑身份，保存服务名称、来源项目、制品与部署历史。它不等于容器，也不直接代表一台机器。

一个 Hosted Service 可以拥有多个 Environment，例如 dev、test 和 prod。

Environment：服务环境

Environment 是 Hosted Service 的一套环境级配置和部署目标。它保存配置、密钥引用、可选的 Slot 引用、可选的逻辑数据库引用，以及当前部署。

Environment 本身不收费。创建 Environment 时可以暂不选择 Slot，也可以不绑定数据库；但真正部署运行前必须拥有可用的 Slot。

Slot 是工作区购买或领取的计算资源单元，提供 CPU、内存和运行副本。免费赠送规格与付费基础规格分开维护，付费基础规格同时只发布一个；需要更多资源时，为指定 Slot 购买 CPU 或内存扩容，不再选择另一套容量档位 SKU。SKU、固定价格、容量计量项和单价都来自已审核目录，平台不会把具体 SKU 或价格写入购买、扩容或部署逻辑。多个 Hosted Service Environment 可以共享工作区中的计算资源，同一项目的 dev、test 等不同 Environment 也可以绑定同一个 Slot；进程、配置、端口、健康检查和路由始终按 Environment 隔离。

Slot 按月独立使用工作区积分结算。续费沿用原规格；已有 Slot 还可单独购买 CPU、内存容量扩展。购买新 Slot 会创建新的资源身份，容量扩展只改变目标 Slot 的运行配额，两者是独立订单和权益。Slot 不包含数据库，也不拥有数据库。

工作区可以幂等领取一个基础赠送 Slot，也可以重复购买多个独立的付费 Slot。基础赠送与付费购买使用同一个 Slot 资源模型；acquisitionType 记录取得方式，slotTypeCode 只记录规格目录项。已经存在基础赠送 Slot 不会阻止购买第二个 Slot。

CLI 中，slot create（兼容别名 slot claim）只负责领取基础赠送 Slot。购买流程先读取当前目录及积分价格，再按返回的 SKU 从工作区共享积分余额中扣费：

baijimu hosted-service slot types <workspaceId>
baijimu hosted-service slot purchase <workspaceId> \
  --sku-code <publishedSkuCode>

baijimu hosted-service slot upgrade <workspaceId> \
  --slot-id <slotId> \
  --cpu-millicores 250 \
  --memory-mib 512 \
  --expected-points <当前报价积分>

slot purchase 会同步返回扣除的积分和扣费后的余额，不需要扫码支付。网络异常后重试时可以复用同一个 --idempotency-key <UUID>，避免重复扣积分。新购时不要传已有 Slot ID；只有续费已有付费 Slot 时才增加 --renew-slot-id <slotId>。扣费成功后，新购 Slot 自动激活并出现在 Slot 列表中。

slot upgrade 只增加指定 Slot 的 CPU 或内存，不创建新 Slot，也不接收支付渠道。扩容按独立容量商品的已发布 POINT 价格实时计价；命令必须传 --expected-points，如果实时价格与确认金额不同，订单不会创建、积分不会扣除。CPU 与内存可以只扩其中一项，数值为 0 的项目不计费。

Endpoint：服务端点

Endpoint 是某次环境部署对外或对内提供的稳定访问入口。端点把域名、路径、端口和当前运行版本连接起来。更换 Artifact 或重新部署时，Endpoint 可以保持稳定。

Database Instance 与 Logical Database

Database Instance 是工作区购买的托管 PostgreSQL 实例，也是使用工作区积分结算的收费资源。首版以阿里云 RDS PostgreSQL 15 为基线。

一个 Database Instance 可以创建多个 Logical Database（逻辑数据库）。逻辑数据库拥有独立的数据库名、账号凭据和 Profile 引用。创建逻辑数据库和把它绑定到 Environment 都不单独收费，费用由所属 Database Instance 的规格和周期决定。

资源关系

Workspace
- Hosted Service
  - Environment：dev，可选引用 Slot 和 Logical Database
  - Environment：prod，可选引用 Slot 和 Logical Database
- Database Instance（付费）
  - Logical Database A（免费创建）
  - Logical Database B（免费创建）

Environment 引用逻辑数据库，而不是直接引用数据库实例。多个逻辑数据库可以位于同一个实例中，因此开发者可以按隔离要求选择“共享实例、不同数据库”，也可以购买独立实例。

计费边界

资源	是否收费	说明
Hosted Service	否	服务逻辑身份
Environment	否	环境配置、部署和资源引用
Slot	是	计算规格，按周期收费
Endpoint	否	随环境部署管理，不作为独立商品
Database Instance	是	PostgreSQL 计算与存储规格，按周期收费
Logical Database	否	使用所属实例容量
Environment 数据库绑定	否	只保存逻辑数据库引用

平台商品统一从工作区共享积分余额扣费。Slot 新购、续期和容量扩展，以及 Database Instance 新购、续费和变配，都只接受已发布的 POINT 价格。支付宝、微信等人民币渠道仅用于给工作区充值积分，不直接创建商品订单；提现和第三方资金账户仍按其独立的人民币资金规则处理。

PostgreSQL 可购规格

平台只开放当前产品目录中已激活且已发布 POINT 价格的规格，不允许用户直接提交任意云厂商规格代码。规格、价格、可用地域和可用区都属于可变化的目录事实；购买前必须实时查询，不能从示例、历史订单或客户端内置列表推断。

规格的 CPU、内存、连接数和可用存储范围以阿里云 RDS PostgreSQL 主实例规格目录为基线；实例创建由平台通过阿里云 CreateDBInstance API完成。实际可购性还取决于平台当前目录和默认部署位置。

规格代码是不可变版本。实例支持按当前 SKU 续费，也支持目录允许的升配关系；续费或升配按目标 SKU 的已发布积分价格结算，扣费成功后由平台调用 RDS 变配能力。历史订单继续保存购买时的规格和价格快照。

积分售价不写死在数据库服务、客户端或模块方法中。管理员在 factory-list 的“计费中心 → 积分商品价格”创建调价草稿，提交后由另一位管理员审核发布。计量型容量价格也必须进入 POINT 价格簿。新价格按生效时间切换，历史价格和订单不会被覆盖。

数据库供应商和部署位置

用户购买 Database Instance 时不选择云厂商、地域、VPC、子网或可用区。平台管理员在数据库服务中维护可用的 Database Provider、Placement 和供应商规格映射，并指定当前默认 Placement。首版默认 Provider 是阿里云 RDS。

Placement 是 db-service 所属运行环境内的运维目录数据，包含地域、网络、子网、可选可用区以及云凭据引用；它不是 Hosted Service Environment 的属性，也不属于 Kubernetes 集群配置。云凭据明文保存在 db-service 的密钥配置中，数据库只保存非敏感的凭据引用。

订单预留时会冻结 Provider、Placement 和供应商规格快照。因此，管理员切换默认 Placement 后，只有新购实例使用新的部署位置；已有实例、待结算订单和历史订单不会被静默迁移。新增已支持 Provider 的地域、网络或规格映射只更新数据库目录，不要求重新发布平台。