共享工作区资源

POST

/v1/workspace/resources/:resource_id/share

向用户、群组或工作区（服务账户）API 密钥授予工作区资源角色（‘admin’、‘editor’、‘commenter’ 或 ‘viewer’）。这会覆盖目标在该资源上的现有角色。若目标是用户或服务账户，只需传入用户邮箱；该用户必须属于工作区。若目标是群组，只需传入群组 id。若目标是工作区（服务账户）API 密钥，请传入 api key id；资源将共享给与该密钥关联的服务账户。必须拥有资源的 admin 权限才能共享资源。

向用户、群组或工作区（服务账户）API 密钥授予工作区资源角色（'admin'、'editor'、'commenter' 或 'viewer'）。这会覆盖目标在该资源上的现有角色。若目标是用户或服务账户，只需传入用户邮箱；该用户必须属于工作区。若目标是群组，只需传入群组 id。若目标是工作区（服务账户）API 密钥，请传入 api key id；资源将共享给与该密钥关联的服务账户。必须拥有资源的 admin 权限才能共享资源。

路径参数

resource_idstring必需

目标资源的 ID。

请求

This endpoint expects an object.

roleenum必需

授予目标的角色：‘admin’、‘editor’、‘commenter’ 或 ‘viewer’ 之一。

允许的值:

resource_typeenum必需

目标资源的资源类型。

user_emailstring or null可选

用户或服务账户的邮箱。

group_idstring or null可选

目标组的 ID。使用 ‘default’ 设置资源的基准角色——除非通过直接授予用户、组成员身份或工作区（服务账号）API 密钥获得更高角色，否则每位工作区成员都会获得此角色。

workspace_api_key_idstring or null可选

目标工作区（服务账号）API 密钥的 ID。这不是在请求标头中传入以进行身份验证的 API 密钥字符串本身，而是该密钥的 ID；工作区管理员可在“开发者 → 服务账号”下找到。

响应

成功响应

错误

422

Unprocessable Entity Error

路径参数

请求头

请求

响应

错误