# 管理工作区

创建、认领、浏览和删除工作区。完成后可将工作区作为 AI Studio 资源操作的目标；Catalog、计算资源和数据分享由相邻任务页处理。

## 前提条件

- 准备 AI Studio API 所需的访问凭据。
- 调用已有工作区的认领或删除操作前，已从列表中取得目标工作区 ID。

有关认证，请先阅读[调用前准备](../../api-call-basics.md)。

## 调用顺序

1. 先[查看工作区列表](../../../../reference/api/ai-studio/workspaces/list-workspaces.md)，确认使用已有工作区还是创建新的工作区。
2. 需要新工作区时，先[提交创建工作区任务](../../../../reference/api/ai-studio/workspaces/create-workspace-creation.md)，再用[查看创建工作区任务](../../../../reference/api/ai-studio/workspaces/list-workspace-creations.md)确认任务已成功并得到工作区 ID。需要同步等待结果时，使用[创建工作区](../../../../reference/api/ai-studio/workspaces/create-workspace.md)。
3. 有待处理邀请时，使用[接受工作区邀请](../../../../reference/api/ai-studio/workspaces/accept-workspace-invitation.md)。需要将已具备成员关系的工作区认领到当前身份时，使用[认领工作区](../../../../reference/api/ai-studio/workspaces/claim-workspace.md)。
4. 创建、接受邀请或认领后，再次查看列表，确认目标工作区可访问；后续 AI Studio 请求使用该工作区作为操作目标。
5. 删除前先处理数据分享相关的清理要求；删除后重新查看列表，确认该工作区不再出现。

## API 操作

### 选择或创建工作区

| 要完成的事 | API 操作 | 何时使用 |
| --- | --- | --- |
| 查询可访问的工作区 | [查看工作区列表](../../../../reference/api/ai-studio/workspaces/list-workspaces.md) | 选择现有工作区、取得其 ID，或确认创建和认领结果时使用。 |
| 提交异步创建 | [提交创建工作区任务](../../../../reference/api/ai-studio/workspaces/create-workspace-creation.md) | 当前控制台创建工作区时使用。 |
| 跟踪创建任务 | [查看创建工作区任务](../../../../reference/api/ai-studio/workspaces/list-workspace-creations.md) | 需要确认异步创建是否已得到工作区 ID 时使用。 |
| 同步创建 | [创建工作区](../../../../reference/api/ai-studio/workspaces/create-workspace.md) | 需要等待同步结果时使用。 |
| 认领工作区 | [认领工作区](../../../../reference/api/ai-studio/workspaces/claim-workspace.md) | 需要将已具备成员关系的工作区认领到当前身份时使用。 |
| 接受邀请 | [接受工作区邀请](../../../../reference/api/ai-studio/workspaces/accept-workspace-invitation.md) | 当前身份有待处理的工作区邀请时使用。 |
| 更新名称 | [更新工作区](../../../../reference/api/ai-studio/workspaces/update-workspace.md) | 需要修改已有工作区名称时使用。 |

### 移除工作区

| 要完成的事 | API 操作 | 何时使用 |
| --- | --- | --- |
| 删除工作区 | [删除工作区](../../../../reference/api/ai-studio/workspaces/delete-workspace.md) | 已处理数据分享清理要求，并确认目标工作区不再需要时使用。 |

## 结果确认

异步创建只有任务成功并返回工作区 ID 后，才视为工作区已创建。同步创建后记录返回的工作区 ID，并通过[查看工作区列表](../../../../reference/api/ai-studio/workspaces/list-workspaces.md)确认其可访问。认领操作应以该动作页返回的是否实际认领为准。删除后同样通过列表确认目标工作区已不再出现。

## 限制和注意事项

- 删除工作区前必须先处理数据分享相关的清理要求。
- 成功提交删除请求后，仍应查询工作区列表确认结果。

## 下一步

- [管理目录、数据库和表](catalog-databases-tables.md)
- [管理计算实例和规格](compute-resources-specifications.md)
- [数据发布与订阅](data-publications-subscriptions.md)