Help Center/ DataArts Studio/ API Reference/ DataArts Security APIs/ Permission Approval/ Obtaining the List of Table Permission Approvers
Updated on 2025-11-17 GMT+08:00

Obtaining the List of Table Permission Approvers

Function

This API is used to obtain the list of table permission approvers.

Calling Method

For details, see Calling APIs.

URI

POST /v1/{project_id}/security/permission-application/table/approvers

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID. For details about how to obtain the project ID, see Project ID and Account ID.

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

IAM token, which is obtained by calling the IAM API for obtaining a user token (value of X-Subject-Token in the response header). This parameter is mandatory for token authentication.

Table 3 Request body parameters

Parameter

Mandatory

Type

Description

instance_id

No

String

Instance ID

datasource_type

No

String

Data source type. The value can be hive, dli, or dws.

cluster_id

No

String

Cluster ID. Pass DLI for DLI and the corresponding cluster ID for GaussDB(DWS) and MRS Hive.

schema_name

No

String

Schema name. This field is required for GaussDB(DWS).

database_name

No

String

Database name

table_name

No

String

Table name

expire_time

No

Long

Permission expiration timestamp, accurate to millisecond

Response Parameters

Status code: 200

Table 4 Response body parameters

Parameter

Type

Description

approvers

Array of TableApprover objects

Approvers

has_table_rule

Boolean

Whether permissions have been granted

Table 5 TableApprover

Parameter

Type

Description

id

String

Approver ID

name

String

Approver name

permission_set_id

String

Permission set ID

type

Integer

Approver type, which can be 0 (user), 1 (user group), or 2 (workspace administrator)

workspace_id

String

Workspace ID

table_approver_type

String

Approver type. The value can be SECURITY_MANAGER (security manager), WORKSPACE_PERMISSION_SET_MANAGER (workspace permission set administrator), or PERMISSION_SET_MANAGER (permission set administrator).

Status code: 400

Table 6 Response body parameters

Parameter

Type

Description

error_code

String

Error code.

error_msg

String

Error message.

Example Requests

None

Example Responses

None

Status Codes

Status Code

Description

200

ok

400

Bad Request