Skip to main content
workspace 可以将应用与其他 Square Cloud 用户共享,每个用户都拥有一个角色。c.Workspaces 管理 workspace,c.Workspaces.Members 管理其成员,c.Workspaces.Apps 管理共享的应用。 创建 workspace 需要 Standard、Pro 或 Enterprise 套餐。 下面的每个代码片段都可以在这个程序中单独运行:每次将一个片段粘贴到 main 中,然后运行 goimports(参见运行示例)。

Workspaces

Workspaces.List(ctx) 返回你拥有或所属的每个 workspace,字段相同:
以成员身份离开 workspace,或以所有者身份删除它:
所有者不能离开(400 CANNOT_LEAVE_OWNER):请改为删除该 workspace。

成员

添加成员需要一个邀请码,由该成员通过 Members.InviteCode(ctx) 生成。邀请码有效期为 5 分钟。
要更改成员的角色或移除成员,请传入 Workspaces.Get 返回的该成员的 ID:
角色(WorkspaceGroup):GroupView(view)、GroupManager(manager)、GroupMaintain(maintain)和 GroupAdmin(admin)。成员的 Group 是普通的 string,因为它也可能是 "owner"。调用你的角色不允许的方法会返回 403 PERMISSION_DENIED。

共享应用

一个 workspace 最多可容纳 100 个应用(400 APPLICATIONS_LIMIT_REACHED)。

操作共享应用

要操作与你共享的应用,请将组合 ID <appId>-<workspaceId> 传给任意 c.Apps 方法。Workspaces.Get 和 Workspaces.List 返回原始 ID,因此需要你自行构建:

错误

除 Get 外,workspace 路由将 ID 放在请求体中发送,因此在这些路由中空 ID 会由服务器返回 400 INVALID_ID(而不是本地错误)。Get 将 ID 放在路径中发送,因此空 ID 会在本地以 INVALID_ID(状态 0)失败。

后续步骤

AI

通过 AI Gateway 调用 chat completions。

Workspace API 参考

这些方法背后的 REST 端点。

用 CLI 管理 workspace

在终端中完成同样的操作。