管理工作区

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

前提条件

  • 准备 AI Studio API 所需的访问凭据。

  • 调用已有工作区的认领或删除操作前,已从列表中取得目标工作区 ID。

有关认证,请先阅读调用前准备

调用顺序

  1. 查看工作区列表,确认使用已有工作区还是创建新的工作区。

  2. 需要新工作区时,先提交创建工作区任务,再用查看创建工作区任务确认任务已成功并得到工作区 ID。需要同步等待结果时,使用创建工作区

  3. 有待处理邀请时,使用接受工作区邀请。需要将已具备成员关系的工作区认领到当前身份时,使用认领工作区

  4. 创建、接受邀请或认领后,再次查看列表,确认目标工作区可访问;后续 AI Studio 请求使用该工作区作为操作目标。

  5. 删除前先处理数据分享相关的清理要求;删除后重新查看列表,确认该工作区不再出现。

API 操作

选择或创建工作区

要完成的事

API 操作

何时使用

查询可访问的工作区

查看工作区列表

选择现有工作区、取得其 ID,或确认创建和认领结果时使用。

提交异步创建

提交创建工作区任务

当前控制台创建工作区时使用。

跟踪创建任务

查看创建工作区任务

需要确认异步创建是否已得到工作区 ID 时使用。

同步创建

创建工作区

需要等待同步结果时使用。

认领工作区

认领工作区

需要将已具备成员关系的工作区认领到当前身份时使用。

接受邀请

接受工作区邀请

当前身份有待处理的工作区邀请时使用。

更新名称

更新工作区

需要修改已有工作区名称时使用。

移除工作区

要完成的事

API 操作

何时使用

删除工作区

删除工作区

已处理数据分享清理要求,并确认目标工作区不再需要时使用。

结果确认

异步创建只有任务成功并返回工作区 ID 后,才视为工作区已创建。同步创建后记录返回的工作区 ID,并通过查看工作区列表确认其可访问。认领操作应以该动作页返回的是否实际认领为准。删除后同样通过列表确认目标工作区已不再出现。

限制和注意事项

  • 删除工作区前必须先处理数据分享相关的清理要求。

  • 成功提交删除请求后,仍应查询工作区列表确认结果。

下一步

最后更新于