列出上下文数据库工作空间
接口说明
列出上下文数据库工作空间
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
GET / HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| WorkspaceId |
string |
否 |
按该 ID 过滤，仅返回匹配的业务空间 |
ws-as1llqmkol**** |
| Status |
string |
否 |
按状态过滤（Active/Locked） |
Active |
| MaxResults |
integer |
否 |
单页最大条数 |
10 |
| NextToken |
string |
否 |
分页游标 |
(null) |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
查询成功 |
||
| RequestId |
string |
请求 ID |
FE9C65D7-930F-57A5-A207-8C396329**** |
| Workspaces |
array<object> |
工作空间列表 |
|
|
object |
|||
| WorkspaceId |
string |
工作空间 ID |
ws-as1llqmkol**** |
| WorkspaceName |
string |
工作空间名称 |
my-workspace |
| Type |
string |
工作空间类型 |
personal |
| Status |
string |
工作空间状态 |
Active |
| CreatedAt |
string |
创建时间（ISO-8601 格式） |
2026-05-28T17:59:55Z |
| MaxResults |
integer |
该字段为空 |
(null) |
| NextToken |
string |
该字段为空 |
(null) |
示例
正常返回示例
JSON格式
{
"RequestId": "FE9C65D7-930F-57A5-A207-8C396329****",
"Workspaces": [
{
"WorkspaceId": "ws-as1llqmkol****",
"WorkspaceName": "my-workspace",
"Type": "personal",
"Status": "Active",
"CreatedAt": "2026-05-28T17:59:55Z"
}
],
"MaxResults": 0,
"NextToken": "(null)"
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | InvalidParameter | Request parameter is invalid. | |
| 401 | Unauthorized | Unauthorized. | |
| 500 | InternalError | Internal server error. | |
| 403 | NoPermission | Permission denied. | |
| 502 | UpstreamError | Upstream service returned an error. | |
| 404 | ResourceNotFound | Resource not found. | |
| 409 | ResourceAlreadyExists | Resource state conflict. |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。