通用资源权限授权与解除

POST

/public-api/common-auth/control

接口简介

特别说明：
该接口目前仅支持以下资源类型：数据账户、仪表板文件夹、移动轻应用、桌面应用（6.3 版本开始支持）
该接口支持批量设置账号ID与资源ID，但数量不宜过多，一般建议少于100

请求参数

Body 参数application/json

token

string

应用Token

必需

在观远平台管理员设置-系统集成-统一账户集成中获得

domId

string

域ID

必需

operatorLoginId

string

操作者登录ID

必需

operations

array [object {7}]

权限策略

必需

enum<string>

权限操作类型

必需

枚举值:

RemoveAuthOpAddAuthOp

subjectTye

enum<string>

操作对象账号类型

必需

枚举值:

ExternalUserGroupsInternalUserGroupsLoginUsers内部用户ID

subjectIds

array[string]

操作对象账号列表

必需

resourceType

enum<string>

资源类型

必需

枚举值:

ACCOUNTDIRECTORYCUSTOM_APPWEB_PORTAL_APP

resourceIds

array[string]

资源ID列表

必需

aclType

enum<string>

权限类型

必需

枚举值:

RESOURCE_MANAGERRESOURCE_USERRESOURCE_EXPORTER

directoryType

enum<string>

文件夹类型

可选

当resourceType=DIRECTORY时，该参数必填

枚举值:

PAGE

示例值:

PAGE

示例

{
    "domId": "guanbi",
    "operatorLoginId": "a@abc.com",
    "operations": [
        {
            "op": "AddAuthOp",
            "subjectIds": [
                "b@abc.com",
                "c@abc.com",
                "d@abc.com"
            ],
            "subjectType": "LoginUsers",
            "aclType": "RESOURCE_MANAGER",
            "resourceIds": [
                "r1",
                "r2",
                "r3"
            ],
            "resourceType": "ACCOUNT"
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/public-api/common-auth/control' \
--header 'Content-Type: application/json' \
--data-raw '{
    "domId": "guanbi",
    "operatorLoginId": "a@abc.com",
    "operations": [
        {
            "op": "AddAuthOp",
            "subjectIds": [
                "b@abc.com",
                "c@abc.com",
                "d@abc.com"
            ],
            "subjectType": "LoginUsers",
            "aclType": "RESOURCE_MANAGER",
            "resourceIds": [
                "r1",
                "r2",
                "r3"
            ],
            "resourceType": "ACCOUNT"
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

res

array [object {2}]

结果

必需

返回体中包含一个数组，分别对应请求里不同处理要求的结果。

succeed

boolean

是否成功

可选

msg

string

异常信息

必需

示例

{
    "res": [
        {
            "succeed": true
        }
    ]
}

修改于 2025-02-28 08:01:15

修改指定用户组与各个数据集的访问及归属关系

将指定用户下辖有所有者权限的资源迁移至其他用户组或用户