文档中心

AI 原生 BaaS 平台 Supabase 版

连接管理

DescribeWorkspaceEndpointList

调用 DescribeWorkspaceEndpointList 接口查询批量 Workspace（工作区）的终端信息。

请求类型

同步请求。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

请求参数

参数	类型	是否必选	示例值	描述
WorkspaceIds	Array of String	是	["noble-heath-3a48**","stoic-chili-ab80**"]	Workspace ID 列表。说明最多可传入 20 个 Workspace ID。
Offset	Integer	否	1	分页查询起始，可取大于等于 0 的整数值，默认值为 0。
Limit	Integer	否	20	分页查询数量，可取大于等于 1 的整数值，默认值为 10。

返回参数

WorkspaceEndpoint

参数	类型	示例值	描述
WorkspaceId	String	noble-heath-3a48****	Workspace 的 ID。
WorkspaceName	String	测试Workspace	Workspace 的名称。
WorkspaceDetailEndpoint	Array of WorkspaceDetailEndpoint	请参见返回示例。	Workspace 的终端的详细信息。

WorkspaceDetailEndpoint

参数	类型	示例值	描述
BranchId	String	br-dear-tern-753b****	分支的 ID。说明该字段仅在使用 Supabase 引擎的 Workspace 中返回。
ComputeId	String	cp-cute-foam-f92a****	算力的 ID。说明该字段仅在使用 PostgreSQL 引擎和 veDB MySQL 引擎的 Workspace 中返回。
Endpoints	Array of Endpoint	请参见返回示例。	Endpoint 列表
WorkspaceId	String	noble-heath-3a48****	Workspace 的 ID。

Endpoint

参数	类型	示例值	描述
Addresses	Array of Address	请参见返回示例。	终端的连接信息。
EndpointId	String	ep-15d73b055d662534****	连接终端的 ID。
EndpointName	String	ep-15d73b055d662534****	连接终端的名称。
EndpointType	String	Proxy	终端类型。取值： Proxy：共享终端。 Dashboard：独享终端。

Address

参数	类型	示例值	描述
AddressDomain	String	cp-fiery-tide-1958****.pg.aidap-global.cn-beijing.volces.com	终端关联的域名。
AddressId	String	addr-ffac9dc170a3c6fa****	地址的 ID。
AddressPort	Integer	80	终端关联的 IPv4/IPv6 地址端口。
AddressType	String	Public	终端关联的地址类型。取值： Public：公网地址。 Private：私网地址。
IPAddress	String	192.*.*.4	终端关联的私网 IPv4 地址。说明终端关联的地址类型为公网地址时，该字段返回为空。
IPv6Address	String	2406:**:::::**:b38c	终端关联的私网 IPv6 地址。

示例

请求示例

返回示例

错误码

更多详情，请参见错误码。

最近更新时间：2026.06.24 10:58:48

这个页面对您有帮助吗？

有用

无用