启用Supabase的沙箱和边缘函数能力，调用该接口前请仔细阅读接口说明。
接口说明
启用沙箱和边缘函数能力会产生计费，计费项包括域名数量、域名解析请求量、沙箱和边缘函数个数。请确保在使用该接口前，已充分了解沙箱和边缘函数能力的收费方式和价格。
使用须知
- 使用该功能之前需要进行服务关联角色授权： AliyunServiceRoleForRDSAISupabase ；
- 使用该功能之前需要开通云解析 privatezone 服务；
- 使用该功能会在 Supabase 实例所在的 VPC 创建一个用于沙箱管控服务的内网权威域名以及添加相应的解析记录，创建内网权威域名会产生计费，具体计费规则请参考云解析 privatezone 的计费文档；
- 该功能目前处于白名单开放中，需要使用请提工单；
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：
- 操作：是指具体的权限点。
- 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
- 资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用
全部资源表示。
- 条件关键字：是指云产品自身定义的条件关键字。
- 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
| 操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
|---|---|---|---|---|
| rdsai:EnableAgentRuntime | update | *全部资源 * |
| 无 |
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| RegionId | string | 否 | 实例所在地域 ID。 | cn-beijing |
| InstanceName | string | 是 | AI 应用的实例 ID。 | ra-supabase-8moov5lxba**** |
| VSwitchId | string | 否 | 虚拟交换机 ID，用户创建终端节点，没有传入的情况下默认使用 Supabase 实例的交换机。 注意 终端节点只会创建一次。当同一个 VPC 下，第一个 Supabase 实例启用沙箱和边缘函数能力时，系统会自动创建终端节点。后续该 VPC 下的其他 Supabase 实例再启用此能力时，直接复用已有的终端节点，不会重复创建。 | vsw-9dp2hkpm22gxscfgy**** |
| SecurityGroupId | string | 否 | 安全组 ID，用于创建终端节点。 不填写时：系统会自动在实例所在 VPC 下创建一个名为 sg-aliyun-rds-created-supabase-sandbox 的安全组，无需手动操作。 手动填写时：需确保所填安全组已放行 Supabase 实例所在 VPC 的网段（入方向和出方向均需放行），否则可能导致网络不通。 注意 终端节点只会创建一次。当同一个 VPC 下，第一个 Supabase 实例启用沙箱和边缘函数能力时，系统会自动创建终端节点。后续该 VPC 下的其他 Supabase 实例再启用此能力时，直接复用已有的终端节点，不会重复创建。 | sg-bp179qkbvlj8ym***** |
| ClientToken | string | 否 | 幂等参数 | 0c593ea1-3bea-11e9-b96b-88e9fe637760 |
返回参数
示例
正常返回示例
JSON格式
{
"RequestId": "FE9C65D7-930F-57A5-A207-8C396329****",
"InstanceName": "ra-supabase-8moov5lxba****"
}错误码
| HTTP status code | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | IdempotentParameterMismatch | The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical. | - |
| 400 | IncorrectInstanceState | Current instance status does not support this operation. | 当前实例状态不支持该操作 |
| 400 | InvalidGroupName | Specified group name is not valid. | 分组名称无效 |
| 400 | InvalidParameter | The provided parameter is invalid. | 无效的参数。 |
| 404 | UserNotFound | User does not exist. | 用户不存在。 |
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 |
|---|---|---|
| 2026-04-16 | 新增 OpenAPI | 查看变更详情 |