文档首页/ 智能数据洞察 DataArts Insight/ API参考/ 协同授权/ 批量保存、修改、删除协同授权
更新时间:2025-03-10 GMT+08:00
分享

批量保存、修改、删除协同授权

功能介绍

批量保存、修改、删除指定自研的协同授权规则。

URI

POST /v1/{project_id}/authorization/cooperate-authorization/rules/batch-save

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID。获取方法请参见获取项目ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Workspace-Id

String

工作空间ID。获取方法请参见获取工作空间ID

X-Auth-Token

String

用户Token。

通过调用IAM服务获取IAM用户Token接口,接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见Token认证

表3 请求Body参数

参数

是否必选

参数类型

描述

[数组元素]

Array of CooperateAuthorizationRuleDto objects

协同授权规则信息。

表4 CooperateAuthorizationRuleDto

参数

是否必选

参数类型

描述

auth_id

String

授权主体的用户或用户组ID。

auth_level

String

授权主体级别。

  • user:用户
  • group:用户组

authority

String

权限点,枚举值:

  • edit、export:编辑和导出权限
  • edit:编辑权限
  • export:导出权限
  • read:查看权限
  • use:使用权限
    说明:

    权限之间有依赖关系,

    • 授予edit权限,自动关联授予use、read权限;
    • 授予了export权限,自动关联授予use、read权限。
    • export、edit二者之前无依赖关系。

resource_id

String

资源ID。

resource_type

String

参数解释:

资源类型枚举值,用于指定授权对象的类型。

示例:datasource,指定授权对象类型为数据源。

约束限制:

不涉及

取值范围:

以下枚举值:

  • datasource:数据源;
  • dataset:数据集;
  • metric:指标;
  • dashboard:仪表板;
  • screen:大屏;
  • embedAnalysis:嵌入分析;
  • portal:数据门户;
  • subject:智能分析助手。

默认取值:

不涉及

响应参数

状态码:200

表5 响应Body参数

参数

参数类型

描述

message

String

通用Message结构体的消息内容

请求示例

批量保存、修改、删除指定自研的协同授权规则。

POST https://{endpoint}/v1/xxxx3ab4dac4055888643b331axxxx/authorization/cooperate-authorization/rules/batch-save
[ {
  "auth_id" : "de9cb4xxxx4b0ba2887b80dc18d273",
  "auth_level" : "user",
  "authority" : "edit",
  "resource_id" : "d0d7919c-xxxx-462e-xxxx-da82bf8be44e",
  "resource_type" : "dashboard"
}, {
  "auth_id" : "de9cb4axxxxa2887b80dc18d273",
  "auth_level" : "user",
  "authority" : "edit,export",
  "resource_id" : "d0d7919c-4e87-xxxx-xxxx-da82bf8be44e",
  "resource_type" : "dashboard"
} ]

响应示例

成功则返回success。

{
  "message" : "success"
}

状态码

状态码

描述

200

成功则返回success。

错误码

请参见错误码

相关文档