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
- HTTP: Bearer Auth
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 |