SuperAPI AI 工具集

cloud-serverless

编程与开发

查看项目

更新于 10-16 07:27

技能介绍

用途:通过 Redpanda Cloud 公共控制平面 API(https://api.redpanda.com)开通和管理 Serverless 集群。不覆盖 BYOC 集群(见 cloud-byoc 技能),CLI 等价方式见 rpk-cloud 技能。

主要能力:使用 OAuth2 客户端凭证获取 bearer token(令牌端点 https://auth.prd.cloud.redpanda.com/oauth/token,audience 为 cloudv2-production.redpanda.cloud);创建 ResourceGroup(计费与组织容器,名称 3–253 位字母数字和连字符);查询 ServerlessRegion(cloud_provider 支持 AWS、GCP、AZURE);创建 ServerlessCluster(必填 name、resource_group_id、serverless_region,可选 tags、networking_config);通过 GET /v1/operations/{id} 轮询异步 Operation,STATE_COMPLETED 后集群达到 STATE_READY,dataplane_api.url 可用于 Kafka 与数据平面 REST API。

使用方式:先获取 token,再列出区域、创建资源组、调用 POST /v1/serverless/clusters 创建集群,轮询 Operation 直至完成,从 Operation 的 resource_id 读取集群 ID,再获取集群详情与 dataplane_api.url,最后用该 URL 调用 /v1/topics 等接口。控制平面与数据平面共用同一 bearer token,数据平面基础路径为 /v1,URL 必须从 API 响应读取,不要手工拼接。

适用场景:需要以 API 自动化方式创建、查询、更新、删除 Serverless 集群,并管理 Topic、ACL、User、Secret、Pipeline、RBAC 角色、Quota、KafkaConnect 连接器等资源。

限制:集群级企业功能(分层存储内部、FIPS、审计日志、跨集群 DR 等)由 Redpanda 管理,租户不可配置;Iceberg Topics、Schema ID 校验、Leadership Pinning、RBAC 通过 Topic 配置键和角色接口设置。Update 返回 Operation,但 Operation.Type 枚举中没有 TYPE_UPDATE_SERVERLESS_CLUSTER。具体收费与价格资料暂未提供。