设置用户组访问范围 - MemoryLake 中国站

curl -X PUT 'https://app.memorylake.cn/openapi/memorylake/admin/v1/access-groups/7013fb5c15cfb29411f040967354b8a3/access-scope' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "reason": "example",
    "scopes": [
      {
        "mode": "all",
        "resource_type": "example",
        "instances": [
          {
            "id": "185afe41ca6ac4566fdc7a9adeabf5a0",
            "actions": [],
            "via_permission_level": false,
            "workspace_id": "12404b77739317d2b08fc918a95f0be9"
          }
        ]
      }
    ]
  }'

{
  "success": true,
  "message": "Operation completed successfully",
  "data": {
    "group_id": "75bcd78140d9e42928db031f1fbb59a5",
    "scopes": [
      {
        "mode": "all",
        "resource_type": "example",
        "available_actions": [
          "example"
        ],
        "instances": [
          {
            "id": "bc572b050c9920425b5fd75681eccbb2",
            "actions": [],
            "effective_actions": [],
            "permission_level": "read",
            "shadowed_actions": [],
            "via_permission_level": false,
            "workspace_id": "0fa2d21dc175adc7a003e0b37f156cb1"
          }
        ]
      }
    ]
  }
}

curl -X PUT 'https://app.memorylake.cn/openapi/memorylake/admin/v1/access-groups/7013fb5c15cfb29411f040967354b8a3/access-scope' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "reason": "example",
    "scopes": [
      {
        "mode": "all",
        "resource_type": "example",
        "instances": [
          {
            "id": "185afe41ca6ac4566fdc7a9adeabf5a0",
            "actions": [],
            "via_permission_level": false,
            "workspace_id": "12404b77739317d2b08fc918a95f0be9"
          }
        ]
      }
    ]
  }'

{
  "success": true,
  "message": "Operation completed successfully",
  "data": {
    "group_id": "75bcd78140d9e42928db031f1fbb59a5",
    "scopes": [
      {
        "mode": "all",
        "resource_type": "example",
        "available_actions": [
          "example"
        ],
        "instances": [
          {
            "id": "bc572b050c9920425b5fd75681eccbb2",
            "actions": [],
            "effective_actions": [],
            "permission_level": "read",
            "shadowed_actions": [],
            "via_permission_level": false,
            "workspace_id": "0fa2d21dc175adc7a003e0b37f156cb1"
          }
        ]
      }
    ]
  }
}

PUT /openapi/memorylake/admin/v1/access-groups/{group_id}/access-scope

按所列资源类型，替换用户组为其成员提供访问的实例。用户组只增加访问权限：all 模式会从用户组中移除该类型的实例，且不限制任何人。项目实例需要提供其 workspace_id。响应为获取用户组访问范围返回的范围，因此还需要 view 权限。响应携带 ETag 头（与对该资源执行 GET 时返回的值相同）。将其放入 If-Match 回传即可使写入成为条件写入：若资源在此期间已被修改，写入将以 412 被拒绝，且不做任何更改。该校验能缩小但无法完全消除并发覆盖的窗口——两个在同一时刻通过校验的写入方都可能写入成功。

所需权限： access_group:manage 且 access_group:view

如果改动会让某人获得管理员角色，或会缩小管理员能访问的范围，还需要由团队所有者或管理员操作。

路径参数

string

required

标识符

请求头

string

可选。先前读取此资源时获得的 ETag。若资源此后已变更，写入将以 412 拒绝；省略则无条件覆盖。

请求体

string

required

变更原因；记录在审计日志中

array

required

所列每种资源类型的实例列表替换为给定列表；mode 为 all 时移除该类型的实例（用户组从不限制任何人）。未列出的类型保留当前列表。

Show Access Scope Entry 对象

string

required

all 表示所有实例；instances 表示仅列出的实例

string

required

资源类型，例如 memorylake:project

array

当 mode 为 instances 时必填

Show Access Scope Instance 对象

string

required

实例 ID

array

省略则为该成员角色允许的所有操作

boolean

只读行的回显。标记为 true 的实例在写入时会被跳过——权限级别在资源上设置，而非通过访问范围设置。

string

父工作空间——项目实例必填

curl -X PUT 'https://app.memorylake.cn/openapi/memorylake/admin/v1/access-groups/7013fb5c15cfb29411f040967354b8a3/access-scope' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "reason": "example",
    "scopes": [
      {
        "mode": "all",
        "resource_type": "example",
        "instances": [
          {
            "id": "185afe41ca6ac4566fdc7a9adeabf5a0",
            "actions": [],
            "via_permission_level": false,
            "workspace_id": "12404b77739317d2b08fc918a95f0be9"
          }
        ]
      }
    ]
  }'

响应

object

Show Access Group Access Scope 对象

string

用户组

array

每个可设范围的资源类型一项；用户组只会增加访问权限

Show Access Scope Entry 对象

string

all 表示所有实例；instances 表示仅列出的实例

string

资源类型，例如 memorylake:project（参见 GET /permission-catalog）

array

只读。成员角色对该类型授予的实例级操作——即范围条目最多可允许的操作。

array

mode 为 instances 时的实例列表

Show Access Scope Instance 对象

string

实例 ID，与数据 API 返回的一致

array

该实例上允许的操作。省略则为该成员角色允许的全部操作。

array

只读。成员当前角色仍授予的操作子集。

string

只读。当 via_permission_level 为 true 时的权限级别。可选值：read、write、manage。

array

只读。此处存储但成员当前角色已不再授予的操作。

boolean

只读。成员通过在此实例上授予的权限级别访问该实例，而非通过此范围。写入时可原样回传；此类实例会被跳过。

string

项目实例的父工作空间。写入项目实例时必填。

{
  "success": true,
  "message": "Operation completed successfully",
  "data": {
    "group_id": "75bcd78140d9e42928db031f1fbb59a5",
    "scopes": [
      {
        "mode": "all",
        "resource_type": "example",
        "available_actions": [
          "example"
        ],
        "instances": [
          {
            "id": "bc572b050c9920425b5fd75681eccbb2",
            "actions": [],
            "effective_actions": [],
            "permission_level": "read",
            "shadowed_actions": [],
            "via_permission_level": false,
            "workspace_id": "0fa2d21dc175adc7a003e0b37f156cb1"
          }
        ]
      }
    ]
  }
}

​路径参数

​请求头

​请求体

​响应

路径参数

请求头

请求体

响应