跳到主要内容
Version: 1.0.0

PG Storage API

CloudBase PG 模式云存储 HTTP API,提供 Bucket 与 Object 的 CRUD、签名 URL、对象元信息、分片上传等能力。 适用环境:PG 模式环境。传统形态环境请使用 传统模式云存储 HTTP API权限模型:基于 PostgreSQL RLS(行级安全策略),三种角色:service_role(BYPASSRLS)、authenticated(受 RLS 约束)、anon(受 RLS 约束)。详见 PG 模式云存储 - 权限管理

Authentication

JWT Bearer Token,通过 Authorization: Bearer <token> 头传递。 Token 来源决定角色:

  • service_role:使用 service_role API Key 作为 token(服务端管理场景)
  • authenticated:使用用户登录后获取的 JWT(普通用户场景)
  • anon:不携带 Authorization 头或使用 anon key(匿名场景)

Security Scheme Type:

http

HTTP Authorization Scheme:

bearer

Bearer format:

JWT