## 2025 年 12 月 |API |发布时间 |变更记录 |关联功能 | |---|---|---|---| |%%update%% [ListWorkspaceUsageTop](https://www.volcengine.com/docs/87275/2105879) |2025\-12\-02 |* 新增 `ServiceTimeSeconds` 参数，表示已使用服务时长，仅在使用 Supabase 引擎的 Workspace 中返回。|全局管理 |\ | | |* 新增 `StorageSizeUsedBytes` 参数，表示已使用存储服务数据大小，仅在使用 Supabase 引擎的 Workspace 中返回。 | | |%%update%% [CreateWorkspace](https://www.volcengine.com/docs/87275/2105881) |^^||Workspace 管理 |\ | | |### 新增内容| |\ | | || |\ | | |* `EngineVersion` 参数新增取值 `Supabase_1_24`，支持创建 Supabase 1.24 引擎版本的 Workspace。| |\ | | |* `EngineType` 参数新增取值 `Supabase`，支持 Supabase 引擎类型。| |\ | | |* `DefaultWorkspaceSettings` 新增参数 `DeletionProtection`，用于控制 Workspace 的删除保护功能状态，取值包括 `Enabled`（默认）和 `Disabled`。| |\ | | |* `DefaultNetworkSettings` 新增参数 `SharedPrivateNetwork`，用于控制是否共享私网 IP，取值包括 `true`（共享）和 `false`（默认不共享）。| |\ | | |* `Workspace` 返回参数新增 `DeletionProtectionStatus`，表示 Workspace 的删除保护功能状态。| |\ | | |* `WorkspaceUsage` 返回参数新增：。| |\ | | | * `ServiceTimeSeconds`：已使用服务时长（仅 Supabase 引擎返回）。| |\ | | | * `StorageSizeUsedBytes`：已使用存储服务数据大小（仅 Supabase 引擎返回）。| |\ | | || |\ | | || |\ | | |### 修改内容| |\ | | || |\ | | |* `NetworkSettings` 参数的必选条件扩展为：当 `EngineVersion` 取值为 `veDB_MySQL_8_0` 或 `Supabase_1_24` 时必选。| |\ | | |* `ComputeSettings` 参数的描述从"Workspace 的计算配置"修改为"Workspace 的初始计算配置"。| |\ | | |* `HistoryRetentionHours` 参数新增提示：作为请求参数时仅适用于 PostgreSQL 和 veDB MySQL 引擎的 Workspace。| |\ | | |* `Workspace` 返回参数的 `EngineType` 和 `EngineVersion` 新增 Supabase 相关取值。| |\ | | || |\ | | || |\ | | |### 注意事项| |\ | | || |\ | | |* 使用新增的 Supabase 引擎类型时需注意：| |\ | | | * 必须配置 `NetworkSettings` 参数。| |\ | | | * 返回的用量统计包含专有字段 `ServiceTimeSeconds` 和 `StorageSizeUsedBytes`。| |\ | | |* 删除保护功能默认开启，如需删除 Workspace 需先关闭该功能。 | | |%%update%% [DescribeWorkspaces](https://www.volcengine.com/docs/87275/2105882) |^^|* 新增 `DeletionProtectionStatus` 参数，用于表示 Workspace 的删除保护功能状态，取值包括 `AllowDeletion`（关闭）和 `DeletionProtectionEnable`（开启）。|^^|\ | | |* 在 `EngineType` 参数中新增 `Supabase` 引擎类型。| |\ | | |* 在 `EngineVersion` 参数中新增 `Supabase_1_24` 引擎版本。| |\ | | |* 新增 `DeletionProtection` 参数，用于表示 Workspace 的删除保护功能状态，取值包括 `Enabled`（开启）和 `Disabled`（关闭）。| |\ | | |* 在 `WorkspaceUsage` 中新增 `ServiceTimeSeconds` 和 `StorageSizeUsedBytes` 参数，分别表示已使用服务时长和已使用存储服务数据大小，仅在使用 Supabase 引擎的 Workspace 中返回。| |\ | | |* 在 `DefaultWorkspaceSettings` 的 `HistoryRetentionHours` 参数描述中新增提示，说明该参数仅能用于操作使用 PostgreSQL 引擎和 veDB MySQL 引擎的 Workspace。 | | |%%update%% [DescribeWorkspaceDetail](https://www.volcengine.com/docs/87275/2105883) |^^|* 新增 `DeletionProtectionStatus` 参数，用于表示 Workspace 的删除保护功能状态，取值包括 `AllowDeletion`（可删除）和 `DeletionProtectionEnable`（不可删除）。|^^|\ | | |* 在 `EngineType` 参数中新增 `Supabase` 引擎类型。| |\ | | |* 在 `EngineVersion` 参数中新增 `Supabase_1_24` 引擎版本。| |\ | | |* 在 `DefaultWorkspaceSettings` 中新增 `DeletionProtection` 参数，用于表示 Workspace 的删除保护功能状态，取值包括 `Enabled`（已开启）和 `Disabled`（已关闭）。| |\ | | |* 在 `WorkspaceUsage` 中新增 `ServiceTimeSeconds` 参数，表示已使用服务时长，仅在使用 Supabase 引擎的 Workspace 中返回。| |\ | | |* 在 `WorkspaceUsage` 中新增 `StorageSizeUsedBytes` 参数，表示已使用存储服务数据大小，仅在使用 Supabase 引擎的 Workspace 中返回。 | | |%%update%% [DescribeWorkspaceOverview](https://www.volcengine.com/docs/87275/2105884) |^^|* `EngineType` 参数新增取值 `Supabase`，支持查询 Supabase 引擎类型的 Workspace 概览信息。|^^|\ | | |* `ErrorTotal` 参数描述由“指定数据库引擎类型下异常状态 Workspace 总数”修改为“指定数据库引擎类型下处于‘创建失败’和‘异常’状态 Workspace 总数”，明确包含的状态类型。| |\ | | |* `UpdatingTotal` 参数描述由“指定数据库引擎类型下处于‘变更中’状态的 Workspace 总数”修改为“指定数据库引擎类型下处于‘变更中’和‘网络变更中’状态的 Workspace 总数”，扩展了包含的状态类型。 | | |%%update%% [ModifyComputeSettings](https://www.volcengine.com/docs/87275/2105885) |^^|* 在 `Workspace` 对象中新增了 `DeletionProtectionStatus` 参数，用于表示 Workspace 的删除保护功能状态。|^^|\ | | |* 在 `EngineType` 参数中新增了 `Supabase` 引擎类型选项。| |\ | | |* 在 `EngineVersion` 参数中新增了 `Supabase_1_24` 引擎版本选项。| |\ | | |* 在 `DefaultWorkspaceSettings` 对象中新增了 `DeletionProtection` 参数，用于设置 Workspace 的删除保护功能状态。| |\ | | |* 在 `DefaultWorkspaceSettings` 对象的 `HistoryRetentionHours` 参数描述中新增了提示信息，说明该参数仅适用于 PostgreSQL 和 veDB MySQL 引擎的 Workspace。| |\ | | |* 在 `WorkspaceUsage` 对象中新增了 `ServiceTimeSeconds` 和 `StorageSizeUsedBytes` 参数，用于记录使用 Supabase 引擎的 Workspace 的服务时长和存储服务数据使用量。 | | |%%update%% [ModifyWorkspaceSettings](https://www.volcengine.com/docs/87275/2105886) |^^|* 新增 `DeletionProtection` 参数，用于控制 Workspace 的删除保护功能状态，可选值为 `Enabled`（默认）和 `Disabled`。|^^|\ | | |* 在 `DefaultWorkspaceSettings` 中，为 `HistoryRetentionHours` 参数新增提示信息，说明该参数仅适用于 PostgreSQL 和 veDB MySQL 引擎的 Workspace。| |\ | | |* 在 `Workspace` 返回参数中新增 `DeletionProtectionStatus` 字段，用于返回 Workspace 的删除保护功能状态，取值包括 `AllowDeletion` 和 `DeletionProtectionEnable`。| |\ | | |* 在 `EngineType` 中新增 `Supabase` 引擎类型。| |\ | | |* 在 `EngineVersion` 中新增 `Supabase_1_24` 引擎版本。| |\ | | |* 在 `WorkspaceUsage` 中新增 `ServiceTimeSeconds` 和 `StorageSizeUsedBytes` 字段，用于记录使用 Supabase 引擎的 Workspace 的服务时长和存储服务数据大小，并添加相关提示信息。 | | |%%update%% [ModifyWorkspaceName](https://www.volcengine.com/docs/87275/2105887) |^^|* 新增 `DeletionProtectionStatus` 参数，用于表示 Workspace 的删除保护功能状态，取值包括 `AllowDeletion` 和 `DeletionProtectionEnable`。|^^|\ | | |* 在 `EngineType` 参数中新增 `Supabase` 引擎类型。| |\ | | |* 在 `EngineVersion` 参数中新增 `Supabase_1_24` 引擎版本。| |\ | | |* 在 `DefaultWorkspaceSettings` 中新增 `DeletionProtection` 参数，用于设置 Workspace 的删除保护功能状态，取值包括 `Enabled` 和 `Disabled`。| |\ | | |* 在 `WorkspaceUsage` 中新增 `ServiceTimeSeconds` 参数，表示已使用服务时长，仅在使用 Supabase 引擎的 Workspace 中返回。| |\ | | |* 在 `WorkspaceUsage` 中新增 `StorageSizeUsedBytes` 参数，表示已使用存储服务数据大小，仅在使用 Supabase 引擎的 Workspace 中返回。 | | |%%add%% [ModifyWorkspaceDeletionProtectionPolicy](https://www.volcengine.com/docs/87275/2105889) |^^|新增 `ModifyWorkspaceDeletionProtectionPolicy` 接口，用于为 Workspace（工作区）开启或关闭删除保护功能。 |^^| |%%update%% [UpdateBranch](https://www.volcengine.com/docs/87275/2105896) |^^|* `Name` 参数的描述中新增了限制说明：该参数仅能用于操作使用 PostgreSQL 引擎和 veDB MySQL 引擎的 Workspace（工作区）。|分支管理 |\ | | |* `Protected` 参数的描述中新增了限制说明：该参数仅能用于操作使用 PostgreSQL 引擎的 Workspace（工作区）。 | | |%%add%% [DescribeAPIKeys](https://www.volcengine.com/docs/87275/2105902) |^^|新增 `DescribeAPIKeys` 接口，用于查询 Workspace（工作区）的 API 密钥。 |^^| |%%update%% [DescribeWorkspaceEndpoint](https://www.volcengine.com/docs/87275/2105921) |^^|* 在请求参数中新增了 `BranchId` 参数，该参数为可选参数，表示分支 ID。|连接管理 |\ | | |* 修改了 `WorkspaceId` 参数的描述，从 "Workspace ID" 调整为 "Workspace 的 ID"。| |\ | | |* 返回参数中调整了字段顺序，将 `ComputeId` 移至首位，`WorkspaceId` 移至末尾。| |\ | | |* 在 `Address` 结构中新增了 `AddressPort` 参数，表示终端关联的 IPv4/IPv6 地址端口。 | | |%%update%% [ModifyVpcSettings](https://www.volcengine.com/docs/87275/2105922) |^^|* 接口描述中新增了对网络协议类型修改的说明，明确表示 `ModifyVpcSettings` 接口现在支持修改网络协议类型。|^^|\ | | |* 其他参数和描述保持不变，没有新增、修改或删除的参数。 | | |%%add%% [CreateEndpointPublicAddress](https://www.volcengine.com/docs/87275/2105924) |^^|新增 `CreateEndpointPublicAddress` 接口，用于为 Workspace（工作区）的指定终端开启公网访问。 |^^| |%%add%% [DeleteEndpointPublicAddress](https://www.volcengine.com/docs/87275/2105925) |^^|新增 `DeleteEndpointPublicAddress` 接口，用于为 Workspace（工作区）的指定终端关闭公网访问。 |^^| ## 2025 年 10 月 |API |发布时间 |变更记录 |关联功能 | |---|---|---|---| |%%update%% [DescribeWorkspaceEndpoint](https://www.volcengine.com/docs/87275/2105921) |2025\-10\-31 |\- Endpoint 新增参数 `Addresses`（结构体），移除参数 `AddressDomain` 和 `AddressType`（均移入 Addresses）。 |连接管理 | |%%update%% [DescribeWorkspaceEndpoint](https://www.volcengine.com/docs/87275/2105921) |^^|\- 移除请求参数 `EndpointId`，新增请求参数 `AddressId`。 |账号管理 | |%%update%% [DescribeWorkspaceEndpoint](https://www.volcengine.com/docs/87275/2105921) |^^|\- `BranchId` 参数由可选（否）变更为必选（是）。在创建算力时，必须提供分支 ID。 |算力管理 | |%%update%% [CreateCompute](https://www.volcengine.com/docs/87275/2105904) |^^|^^|^^| |%%update%% [CreateDatabase](https://www.volcengine.com/docs/87275/2105917) |2025\-10\-29 |\- 为参数 `DatabaseOwner` 补充可选性描述。 |数据库管理 | |%%update%% [CreateWorkspace](https://www.volcengine.com/docs/87275/2105881) |^^|\- 更新参数 `InternetProtocol` 的取值范围。 |Workspace 管理 | |%%update%% [DescribeWorkspaces](https://www.volcengine.com/docs/87275/2105882) |^^|^^|^^| |%%update%% [DescribeWorkspaceDetail](https://www.volcengine.com/docs/87275/2105883) |^^|^^|^^| |%%update%% [DescribeWorkspaceOverview](https://www.volcengine.com/docs/87275/2105884) |^^|^^|^^| |%%update%% [ModifyComputeSettings](https://www.volcengine.com/docs/87275/2105885) |^^|^^|^^| |%%update%% [ModifyWorkspaceName](https://www.volcengine.com/docs/87275/2105887) |^^|^^|^^| |%%update%% [ModifyVpcSettings](https://www.volcengine.com/docs/87275/2105922) |^^|^^|连接管理 | |%%update%% [CreateWorkspace](https://www.volcengine.com/docs/87275/2105881) |2025\-10\-27 |\- `DefaultComputeSettings` 中的 `AutoScalingLimitMaxCU` 和 `AutoScalingLimitMinCU` 参数描述更新，明确了取值范围和默认值。 |Workspace 管理 | |%%update%% [ModifyComputeSettings](https://www.volcengine.com/docs/87275/2105885) |^^|* `AutoScalingLimitMaxCU` 参数描述更新，新增取值范围和默认值说明，默认值从 32 调整为 2，并明确单位为 CU。|^^|\ | | |* `AutoScalingLimitMinCU` 参数描述更新，新增取值范围和默认值说明，默认值保持 0.25，并明确单位为 CU。 | | |%%update%% [CreateCompute](https://www.volcengine.com/docs/87275/2105904) |^^|* `ComputeSettings.AutoScalingLimitMaxCU` 描述新增了取值范围说明："取值为 [0.25, 0.5, 1~32] 范围内的整数值，默认值为 2，单位为 CU"。|算力管理 |\ | | |* `ComputeSettings.AutoScalingLimitMinCU` 描述新增了取值范围说明："取值为 [0.25, 0.5, 1~32] 范围内的整数值，默认值为 0.25，单位为 CU"。 | | |%%update%% [ModifyComputeSpec](https://www.volcengine.com/docs/87275/2105907) |^^|* `AutoScalingLimitMinCU` 参数描述新增取值范围说明：[0.25, 0.5,1~32] 范围内的整数值，默认值为 0.25，单位为 CU。|^^|\ | | |* `AutoScalingLimitMaxCU` 参数描述新增取值范围说明：[0.25, 0.5,1~32] 范围内的整数值，默认值为 2，单位为 CU。 | |

AI 原生 BaaS 平台 Supabase 版