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

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

功能介绍

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

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限,具体权限要求请参见权限和授权项

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

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

表3 请求Body参数

参数

是否必选

参数类型

描述

[数组元素]

Array of CooperateAuthorizationRuleDto objects

协同授权规则请求实体

表4 CooperateAuthorizationRuleDto

参数

是否必选

参数类型

描述

auth_id

String

参数解释:

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

取值范围:

不涉及

auth_level

String

参数解释:

授权主体级别。

取值范围:

  • user:用户级别

  • group:用户组级别

authority

String

参数解释:

权限点。

取值范围:

  • edit,export:编辑和导出权限

  • edit:编辑权限

  • export:导出权限

  • use:使用权限

  • read:查看权限

说明:
权限之间有依赖关系
  • 授予edit权限,自动关联授予use、read权限

  • 授予export权限,自动关联授予use、read权限

  • export、edit二者之前无依赖关系

resource_id

String

参数解释:

资源ID。

取值范围:

不涉及

resource_type

String

参数解释:

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

取值范围:

  • 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" : "de9cb4a863a94b0ba2887b80dc18d273",
  "auth_level" : "user",
  "authority" : "edit",
  "resource_id" : "d0d7919c-4e87-462e-bb32-da82bf8be44e",
  "resource_type" : "dashboard"
}, {
  "auth_id" : "de9cb4a863a94b0ba2887b80dc18d273",
  "auth_level" : "user",
  "authority" : "edit,export",
  "resource_id" : "d0d7919c-4e87-462e-bb32-da82bf8be44e",
  "resource_type" : "dashboard"
} ]

响应示例

状态码:200

成功则返回success。

{
  "message" : "success"
}

状态码

状态码

描述

200

成功则返回success。

错误码

请参见错误码

相关文档