文档首页/ 智能数据洞察 DataArts Insight/ API参考/ 协同授权/ 保存或修改资源属性值 - SaveOrUpdateAuthProperties
更新时间：2025-11-25 GMT+08:00
查看PDF
分享

保存或修改资源属性值 - SaveOrUpdateAuthProperties

功能介绍

保存或修改资源属性值。

授权信息

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

URI

POST /v1/{project_id}/authorization/cooperate-authorization/properties

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

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

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Workspace-Id

是

String

参数解释：

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

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及
表3 请求Body参数

参数

是否必选

参数类型

描述

auth_switch_config

否

Map<String,Boolean>

参数解释：

权限点规则编辑开关。取值为true或者false，用于区分对应开关是否打开。

取值范围：

  • edit：编辑权限

  • export：导出权限

  • read：查看权限

  • use：使用权限

说明：

  • 权限之间有依赖关系，授予edit权限，自动关联授予read和export或者use权限；授予了export权限，自动关联授予read权限。

  • 对仪表板和大屏来说，权限点开关有三个：edit, export, read。例如{"edit": false, "read": true, "export": true}， 表示打开了查看和导出的权限。

  • 对于数据源、数据集、智能分析助手来说，权限点开关有两个：edit，use，对应编辑和使用权限。例如{"use": true, "edit"：false}，表示仅打开使用权限。

  • 对于数据门户来说，权限点开关有两个：edit，read，对应编辑和查看权限。例如{"read": true, "edit": false} ，表示仅打开使用权限"。

resource_id

否

String

参数解释：

资源ID。

取值范围：

不涉及

resource_type

否

String

参数解释：

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

取值范围：

  • datasource：数据源

  • dataset：数据集

  • metric：指标

  • dashboard：仪表板

  • screen：大屏

  • embedAnalysis：嵌入分析

  • portal：数据门户

  • subject：智能分析助手

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

auth_switch_config

Map<String,Boolean>

参数解释：

权限点规则编辑开关。取值为true或者false，用于区分对应开关是否打开。

取值范围：

  • edit：编辑权限

  • export：导出权限

  • read：查看权限

  • use：使用权限

说明：

  • 权限之间有依赖关系，授予edit权限，自动关联授予read和export或者use权限；授予了export权限，自动关联授予read权限

  • 对仪表板和大屏来说，权限点开关有三个：edit, export, read。例如{"edit": false, "read": true, "export": true}， 表示打开了查看和导出的权限

  • 对于数据源、数据集、智能分析助手来说，权限点开关有两个：edit，use，对应编辑和使用权限。例如{"use": true, "edit"：false}，表示仅打开使用权限

  • 对于数据门户来说，权限点开关有两个：edit，read，对应编辑和查看权限。例如{"read": true, "edit": false} ，表示仅打开使用权限"

create_date

Long

参数解释：

资源创建时间。

取值范围：

不涉及

create_user

String

参数解释：

资源创建用户ID。

取值范围：

不涉及

create_user_name

String

参数解释：

资源创建人名称。

取值范围：

不涉及

id

String

参数解释：

资源协同授权属性记录表ID。

取值范围：

不涉及

owner

String

参数解释：

资源所有者ID。

取值范围：

不涉及

project_id

String

参数解释：

项目ID。

取值范围：

不涉及

resource_id

String

参数解释：

资源ID。

取值范围：

不涉及

resource_type

String

参数解释：

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

取值范围：

  • datasource：数据源

  • dataset：数据集

  • metric：指标

  • dashboard：仪表板

  • screen：大屏

  • embedAnalysis：嵌入分析

  • portal：数据门户

  • subject：智能分析助手

update_date

Long

参数解释：

修改时间。

取值范围：

不涉及

update_user

String

参数解释：

修改人ID。

取值范围：

不涉及

update_user_name

String

参数解释：

修改人姓名。

取值范围：

不涉及

workspace_id

String

参数解释：

工作空间ID。

取值范围：

不涉及

请求示例

保存或修改资源分享协作属性值。

POST https://{endpoint}/v1/xxxxx3ab4dac4055888643b331xxxxx/authorization/cooperate-authorization/properties

{
  "auth_switch_config" : "{read: true, edit: true, export: true}",
  "resource_id" : "d0d7919c-4e87-462e-bb32-da82bf8be44e",
  "resource_type" : "dashboard"
}

响应示例

状态码：200

OK。

{
  "auth_switch_config" : "{read: true, edit: true, export: true}",
  "create_date" : 1688022840899,
  "create_user" : "xxxxxxxba2887b80dc18d273",
  "create_user_name" : "ei_dlv_***_01",
  "id" : "xxxx-edbd-478b-bd6b-9cb7f0407598",
  "owner" : "xxxxxxxb0ba2887b80dc18d273",
  "project_id" : "xxxxxx43b331a0b227",
  "resource_id" : "xxxxxx-bb32-da82bf8be44e",
  "resource_type" : "dashboard",
  "update_date" : 1688023886860,
  "update_user" : "xxxxx3a94b0ba2887b80dc18d273",
  "update_user_name" : "ei_dlv_***_01",
  "workspace_id" : "xxxxxxxxxxx62ba09e6b6eeaa2146"
}

状态码

状态码

描述

200

OK。

错误码

请参见错误码。

父主题： 协同授权

相关文档