Skip to main content

页面权限

页面有 4 种常规的 CRUD 权限: "创建"、"读取"、"更新 "和 "删除"。

目前只能修改 读取权限。

获取页面权限​

任何用户都可以获取特定页面的权限:

在软件目录中，选择要查看权限的页面，然后单击 "权限":

只能申请软件目录页面的页面权限。 例如，不能更改 "生成器 "页面和 "审计日志 "页面的权限。

更新页面权限​

只有具有 "admin "角色的用户才能更新目录页面的权限:

在软件目录中，选择要编辑权限的页面，然后点击 "权限"。 选择要授予权限的用户或团队，然后点击 "完成"。

示例​

让我们介绍一组页面权限，然后探讨不同的 PATCH 请求体如何改变页面的有效权限。

给定页面的权限如下:

{
  "read": {
    "roles": ["Admin", "Member"],
    "users": [],
    "teams": []
  }
}

为角色添加权限​

发送包含以下正文的 HTTP PATCH 请求，将赋予 Services-Moderator 角色查看页面的权限(不会删除任何现有角色的权限):

{
  "read": {
    "roles": ["Admin", "Member", "Services-Moderator"]
  }
}

删除角色权限​

发送包含以下正文的 HTTP PATCH 请求，将移除 Member 角色查看页面的权限:

{
  "read": {
    "roles": ["Admin"]
  }
}

为用户添加权限​

使用以下正文发出 HTTP PATCH 请求，将赋予指定用户查看页面的权限(不改变现有角色的权限):

{
  "read": {
    "users": ["[email protected]", "[email protected]"]
  }
}

为团队添加权限​

发送包含以下正文的 HTTP PATCH 请求，将赋予指定团队查看页面的权限(无需更改现有 "角色 "的权限):

{
  "read": {
    "teams": ["Team 1", "Team 2"]
  }
}
可以在单个PATCH请求中更新多个权限键(角色、团队和/或用户)，但请注意，任何未指定的角色、团队或用户，如果之前拥有页面权限，则将失去这些权限。

锁定页面​

锁定页面会影响具有过滤和/或隐藏功能的部件。

有关锁定页面的不同方法，请参阅下面的章节:

要锁定页面，请向以下 URL 发送 HTTP PATCH 请求: https://api.getport.io/v1/pages/{page_identifier}。

正文如下

{
  "locked": true
}
锁定的页面标题旁边会有 "锁定 "图标。

Locked Page