文档首页> 数据治理中心 DataArts Studio> API参考> 数据安全API> 数据权限查询接口> 查询角色对一组库、表的可配置操作权限信息
更新时间:2024-05-27 GMT+08:00
分享

查询角色对一组库、表的可配置操作权限信息

功能介绍

查询角色对一组库、表的可配置操作权限信息。

调用方法

请参见如何调用API

URI

POST /v1/{project_id}/security/permission-sets/datasource/role/batch-actions

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID,获取方法请参见项目ID和账号ID

最小长度:1

最大长度:128

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

workspace

String

工作空间ID,获取方法请参见实例ID和工作空间ID

最小长度:1

最大长度:128

X-Auth-Token

String

IAM Token,通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)使用Token认证时必选。

最小长度:1

最大长度:10240

表3 请求Body参数

参数

是否必选

参数类型

描述

parent_permission_set_id

String

父权限集id。

最小长度:1

最大长度:128

cluster_id

String

集群id。

最小长度:1

最大长度:128

datasource_type

String

数据源类型, HIVE

database_names

Array of strings

目前批量授权只支持单库下的多表授权,或同一集群下个多库授权,区分这两类可通过 传参中tables是否为空来判断。

最小长度:1

最大长度:128

数组长度:0 - 100

schemas

Array of strings

dws权限涉及 schema,预留字段,在做DWS批量授权时应保持单schema下的批量授权,或者对单库下schema批量授权。

最小长度:1

最大长度:128

数组长度:0 - 100

table_names

Array of strings

数据表列表。

最小长度:1

最大长度:128

数组长度:0 - 100

column_names

Array of strings

数据字段列表。

最小长度:1

最大长度:128

数组长度:0 - 100

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

permission_actions

Array of strings

权限操作列表。

数组长度:0 - 100

表5 PermissionActions

参数

参数类型

描述

-

String

HIVE数据源支持权限操作类型:

  • ALL - 所有执行权限

  • SELECT - 查询权限

  • UPDATE - 更新权限

  • CREATE - 创建权限

  • DROP - drop操作权限

  • ALTER - alter操作权限

  • INDEX - 索引操作权限

  • READ - 可读权限

  • WRITE - 可写权限

DLI数据源支持权限操作类型:

  • SELECT - 查询权限

  • DROP - drop操作权限

  • ALTER - alter操作权限

  • INSERT - 插入数据权限

  • CREATE_TABLE - 创建表权限

DWS数据源支持权限操作类型:

  • ALL - 所有执行权限

  • SELECT - 查询权限

  • UPDATE - 更新权限

  • DROP - drop操作权限

  • ALTER - alter操作权限

  • INSERT - 插入数据权限

  • CREATE_TABLE - 创建表权限

  • DELETE - 删除数据权限

  • CREATE_SCHEMA - 创建schema权限

状态码: 400

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

最小长度:1

最大长度:128

error_msg

String

错误描述。

最小长度:1

最大长度:10240

请求示例

/v1/0833a5737480d53b2f25c010dc1a7b88/security/permission-sets/datasource/role/batch-actions

{
  "parent_permission_set_id" : "24dd53c92ddbb12fe762f9d9d42a031a",
  "cluster_id" : "dc425074-26b3-479c-9e2f-b103c0cdd90f",
  "datasource_type" : "HIVE",
  "database_names" : [ "default" ],
  "table_names" : [ "auto_test_qwaw" ],
  "column_names" : [ ]
}

响应示例

状态码: 200

OK

{
  "permission_actions" : [ "ALL", "SELECT", "UPDATE", "CREATE", "DROP", "ALTER", "INDEX", "READ", "WRITE" ]
}

SDK代码示例

SDK代码示例如下。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
package com.huaweicloud.sdk.test;

import com.huaweicloud.sdk.core.auth.ICredential;
import com.huaweicloud.sdk.core.auth.BasicCredentials;
import com.huaweicloud.sdk.core.exception.ConnectionException;
import com.huaweicloud.sdk.core.exception.RequestTimeoutException;
import com.huaweicloud.sdk.core.exception.ServiceResponseException;
import com.huaweicloud.sdk.dataartsstudio.v1.region.dataartsstudioRegion;
import com.huaweicloud.sdk.dataartsstudio.v1.*;
import com.huaweicloud.sdk.dataartsstudio.v1.model.*;

import java.util.List;
import java.util.ArrayList;

public class ListSecurityRoleActionsSolution {

    public static void main(String[] args) {
        // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
        // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
        String ak = System.getenv("CLOUD_SDK_AK");
        String sk = System.getenv("CLOUD_SDK_SK");
        String projectId = "{project_id}";

        ICredential auth = new BasicCredentials()
                .withProjectId(projectId)
                .withAk(ak)
                .withSk(sk);

        dataartsstudioClient client = dataartsstudioClient.newBuilder()
                .withCredential(auth)
                .withRegion(dataartsstudioRegion.valueOf("<YOUR REGION>"))
                .build();
        ListSecurityRoleActionsRequest request = new ListSecurityRoleActionsRequest();
        RoleActionQueryDTO body = new RoleActionQueryDTO();
        List<String> listbodyTableNames = new ArrayList<>();
        listbodyTableNames.add("auto_test_qwaw");
        List<String> listbodyDatabaseNames = new ArrayList<>();
        listbodyDatabaseNames.add("default");
        body.withTableNames(listbodyTableNames);
        body.withDatabaseNames(listbodyDatabaseNames);
        body.withDatasourceType(RoleActionQueryDTO.DatasourceTypeEnum.fromValue("HIVE"));
        body.withClusterId("dc425074-26b3-479c-9e2f-b103c0cdd90f");
        body.withParentPermissionSetId("24dd53c92ddbb12fe762f9d9d42a031a");
        request.withBody(body);
        try {
            ListSecurityRoleActionsResponse response = client.listSecurityRoleActions(request);
            System.out.println(response.toString());
        } catch (ConnectionException e) {
            e.printStackTrace();
        } catch (RequestTimeoutException e) {
            e.printStackTrace();
        } catch (ServiceResponseException e) {
            e.printStackTrace();
            System.out.println(e.getHttpStatusCode());
            System.out.println(e.getRequestId());
            System.out.println(e.getErrorCode());
            System.out.println(e.getErrorMsg());
        }
    }
}
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
# coding: utf-8

from huaweicloudsdkcore.auth.credentials import BasicCredentials
from huaweicloudsdkdataartsstudio.v1.region.dataartsstudio_region import dataartsstudioRegion
from huaweicloudsdkcore.exceptions import exceptions
from huaweicloudsdkdataartsstudio.v1 import *

if __name__ == "__main__":
    # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak = __import__('os').getenv("CLOUD_SDK_AK")
    sk = __import__('os').getenv("CLOUD_SDK_SK")
    projectId = "{project_id}"

    credentials = BasicCredentials(ak, sk, projectId) \

    client = dataartsstudioClient.new_builder() \
        .with_credentials(credentials) \
        .with_region(dataartsstudioRegion.value_of("<YOUR REGION>")) \
        .build()

    try:
        request = ListSecurityRoleActionsRequest()
        listTableNamesbody = [
            "auto_test_qwaw"
        ]
        listDatabaseNamesbody = [
            "default"
        ]
        request.body = RoleActionQueryDTO(
            table_names=listTableNamesbody,
            database_names=listDatabaseNamesbody,
            datasource_type="HIVE",
            cluster_id="dc425074-26b3-479c-9e2f-b103c0cdd90f",
            parent_permission_set_id="24dd53c92ddbb12fe762f9d9d42a031a"
        )
        response = client.list_security_role_actions(request)
        print(response)
    except exceptions.ClientRequestException as e:
        print(e.status_code)
        print(e.request_id)
        print(e.error_code)
        print(e.error_msg)
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
package main

import (
	"fmt"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic"
    dataartsstudio "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/dataartsstudio/v1"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/services/dataartsstudio/v1/model"
    region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/dataartsstudio/v1/region"
)

func main() {
    // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak := os.Getenv("CLOUD_SDK_AK")
    sk := os.Getenv("CLOUD_SDK_SK")
    projectId := "{project_id}"

    auth := basic.NewCredentialsBuilder().
        WithAk(ak).
        WithSk(sk).
        WithProjectId(projectId).
        Build()

    client := dataartsstudio.NewdataartsstudioClient(
        dataartsstudio.dataartsstudioClientBuilder().
            WithRegion(region.ValueOf("<YOUR REGION>")).
            WithCredential(auth).
            Build())

    request := &model.ListSecurityRoleActionsRequest{}
	var listTableNamesbody = []string{
        "auto_test_qwaw",
    }
	var listDatabaseNamesbody = []string{
        "default",
    }
	request.Body = &model.RoleActionQueryDto{
		TableNames: &listTableNamesbody,
		DatabaseNames: listDatabaseNamesbody,
		DatasourceType: model.GetRoleActionQueryDtoDatasourceTypeEnum().HIVE,
		ClusterId: "dc425074-26b3-479c-9e2f-b103c0cdd90f",
		ParentPermissionSetId: "24dd53c92ddbb12fe762f9d9d42a031a",
	}
	response, err := client.ListSecurityRoleActions(request)
	if err == nil {
        fmt.Printf("%+v\n", response)
    } else {
        fmt.Println(err)
    }
}

更多编程语言的SDK代码示例,请参见API Explorer的代码示例页签,可生成自动对应的SDK代码示例。

状态码

状态码

描述

200

OK

400

Bad Request

分享:

    相关文档

    相关产品