Updated on 2025-11-17 GMT+08:00

Submitting a Table Permission Application

Function

This API is used to submit a table permission application.

Calling Method

For details, see Calling APIs.

URI

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

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

approver

No

TableApprover object

Reviewer, which is returned by /v1/{project_id}/security/permission-application/table/approvers

table_info

No

ListSecurityTableApproversRequestBody object

Table information

proposers

No

Array of TableProposers objects

Applicants

reason

No

String

Request reason

Table 4 TableApprover

Parameter

Mandatory

Type

Description

id

No

String

Approver ID

name

No

String

Approver name

permission_set_id

No

String

Permission set ID

type

No

Integer

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

workspace_id

No

String

Workspace ID

table_approver_type

No

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).

Table 5 ListSecurityTableApproversRequestBody

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

Table 6 TableProposers

Parameter

Mandatory

Type

Description

id

No

String

Applicant ID and permission group ID

name

No

String

Applicant name

type

No

Integer

Approver type. Value 0 indicates a user and 1 indicates a user group.

Response Parameters

Status code: 200

Table 7 Response body parameters

Parameter

Type

Description

describe

String

Description

permission_center_url

String

Approval page URL

workspace_id

String

Workspace ID

Status code: 400

Table 8 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