应用程序对象存储

可用性

托管对象存储是not available yet。当前的存储桶服务是控制平面预览。它创建一个桶形记录，生成一次性S3形凭证，并可以发布OF_S3_*环境变量，但其端点是stub-minio-platform.local:9000。不会创建 MinIO 存储桶，也不能在其中存储任何对象。

请勿将状态为 stub 的记录用于上传、备份或任何必须保留的数据。成功的调用仅证明控制平面合约已运行。

今天您可以测试什么

预览版运用了这些界限：

独特的存储桶名称生成；
MCP 包装器中的应用程序所有权检查；
一次性保密处理；
仅元数据列表响应；
OF_S3_ENDPOINT、OF_S3_BUCKET、OF_S3_ACCESS_KEY、OF_S3_SECRET_KEY 和 OF_S3_REGION 的发布；和
存储桶引用与应用程序的关联。

如果环境发布成功，这些值仍然是占位符。在部署需要实际存储的工作负载之前删除它们。

MCP 工具

工具	当前行为
`add_app_bucket(app_id)`	创建 `stub` 记录并可能发布占位符 `OF_S3_*` 值。
`list_app_buckets(app_id)`	列出元数据。它永远不会返回密钥。


add_app_bucket(app_id='550e8400-e29b-41d4-a716-446655440000')

使用前检查响应：


{
  "bucket_id": "buk-a7f3b2c1d9e4f",
  "endpoint_url": "http://stub-minio-platform.local:9000",
  "status": "stub",
  "env_published": false
}

当自动环境发布不可用时，响应可以包含密钥和 env_payload 一次。这不会将存根端点转变为存储。将响应视为敏感响应并且不记录它。

REST 合约

方法	路径	结果
`POST`	`/api/app-infra/buckets`	创建预览记录并返回一次性凭证形状的数据。
`GET`	`/api/app-infra/buckets/{bucket_id}`	返回没有密钥的元数据。
`GET`	`/api/app-infra/buckets?app_id={app_id}`	`/api/app-infra/buckets?app_id={app_id}`

正常使用时首选所有者范围内的 MCP 工具。平台路线是内部集成面。

计划申请合同

当启用真正的提供程序时，应用程序将根据五个 OF_S3_* 变量显式构造一个与 S3 兼容的客户端。不要依赖环境 AWS 凭证。现在，只要您通过应用程序环境变量提供实际值，就可以将相同的变量名称用于临时操作员管理的 S3 服务。

在托管存储可以调用ready之前

具有生产能力的版本需要以下证据：

已部署且可访问的对象存储主机；
每个应用程序访问隔离； 3.上传、下载、重新部署持久性测试；
轮换和安全取消；
容量、可用性和错误监控；和
适合规定的持久性目标的备份或复制行为。

在这些检查通过之前，使用运营商管理的 S3 兼容服务并直接测试其恢复路径。