ListPermissionApplyOrders - DataWorks - Alibaba Cloud Documentation Center

Queries a list of permission requests.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Debug

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

Parameter	Type	Required	Description	Example
FlowStatus	integer	No	The status of the permission request. Valid values: 1: Pending approval 2: Approved and authorization succeeded 3: Approved but authorization failed 4: Rejected 5: Withdrawn Valid values: 0 1 2 3 4 5	1
WorkspaceId	integer	No	The ID of the workspace to which the permission request belongs. If you do not specify this parameter, permission requests from all workspaces are returned. To obtain the workspace ID, log on to the DataWorks console and navigate to the workspace configuration page.	12345
OrderType	integer	No	This parameter is deprecated and does not take effect. Valid values: 1 0	1
MaxComputeProjectName	string	No	The name of the MaxCompute project with which the permission request order is associated. If you do not specify the parameter, the permission request orders of all MaxCompute projects are returned.	aMaxComputeProject
TableName	string	No	The name of the table with which the permission request order is associated. If you do not specify the parameter, the permission request orders of all tables are returned.	aTableName
StartTime	long	No	The beginning of the time range to query. You can query all the permissions request orders that have been submitted after the time. The parameter value is a UNIX timestamp. If you do not specify the parameter, all permission request orders are queried.	1616200471885
EndTime	long	No	The end of the time range to query. You can query all the permissions request orders that have been submitted before the time. The parameter value is a UNIX timestamp. If you do not specify the parameter, all permission request orders that are submitted before the current time are queried.	1617200471885
EngineType	string	No	This parameter is deprecated and does not take effect. Valid values: odps	odps
PageNum	integer	No	The page number for pagination. The value must be a positive integer greater than or equal to 1. Default value: 1.	1
PageSize	integer	No	The number of entries per page. Default value: 10. Maximum value: 100.	100
QueryType	integer	Yes	The query type for permission requests. Valid values: 0: Permission requests submitted by me 1: Permission requests pending my approval 2: All permission requests	1
ApplyType	string	No	The type of permission request. Valid values: MaxComputeTable: Permission request for MaxCompute tables MaxComputeFunction: Permission request for MaxCompute functions MaxComputeResource: Permission request for MaxCompute resources DLFSchema: Permission request for DLF 1.0 schemas DLFTable: Permission request for DLF 1.0 tables DLFColumn: Permission request for DLF 1.0 columns DsApiDeploy: Permission request for publishing data services	MaxComputeTable
CatalogName	string	No	The name of the data catalog to query.	hive

Response parameters

Parameter	Type	Description	Example
	object	The response.
RequestId	string	The request ID.	0bc1ec92159376****
ApplyOrders	object	The paginated query results of permission requests.
PageSize	integer	The number of entries per page.	10
PageNumber	integer	The page number.	1
TotalCount	integer	The total number of permission requests returned.	150
ApplyOrder	array<object>	The list of permission requests.
Orders	object	The response.
ApplyBaseId	string	The Alibaba Cloud account ID of the user who submitted the permission request.	267842600408993176
ApplyTimestamp	long	The time when the permission request was submitted, in Unix timestamp format.	1615284086000
FlowId	string	The permission request ID.	ad8da78d-8135-455e-9486-27cf213fc140
FlowStatus	integer	The status of the permission request. Valid values: 1: Pending approval 2: Approved and authorization succeeded 3: Approved but authorization failed 4: Rejected	2
ApproveContent	object	The content of the permission request.
ApplyReason	string	The reason for the permission request, which is used by administrators for evaluation and approval.	I need to use this table
OrderType	integer	The type of permission request. Only the value 1 is supported, which indicates an ACL permission request for objects.	1
ProjectMeta	object	The content of the requested object.
WorkspaceName	string	The name of the DataWorks workspace that contains the MaxCompute project for which permissions are requested.	aWorkspaceName
ObjectMetaList	array<object>	The information about the requested object.
ObjectMetaList	object	The response.
ObjectName	string	The name of the requested table.	aTableName
Actions	array	The operation type.
Actions	string	The permission types requested. Separate multiple permission types with commas (,). Valid values: Select, Describe, Drop, Alter, Update, and Download.	Select,Describe
FinishApprovalTimestamp	long	The final approval timestamp. Displayed as a Unix timestamp.	1757496687000
FinishApprovalComment	string	The final approval comment.	agree

Examples

Sample success responses

JSONformat

{
  "RequestId": "0bc1ec92159376****",
  "ApplyOrders": {
    "PageSize": 10,
    "PageNumber": 1,
    "TotalCount": 150,
    "ApplyOrder": [
      {
        "ApplyBaseId": 267842600408993180,
        "ApplyTimestamp": 1615284086000,
        "FlowId": "ad8da78d-8135-455e-9486-27cf213fc140",
        "FlowStatus": 2,
        "ApproveContent": {
          "ApplyReason": "I need to use this table",
          "OrderType": 1,
          "ProjectMeta": {
            "WorkspaceName": "aWorkspaceName",
            "ObjectMetaList": [
              {
                "ObjectName": "aTableName",
                "Actions": [
                  "Select,Describe"
                ]
              }
            ]
          }
        },
        "FinishApprovalTimestamp": 1757496687000,
        "FinishApprovalComment": "agree"
      }
    ]
  }
}

Error codes

For a list of error codes, visit the Service error codes.

Change history

Change time	Summary of changes	Operation
2025-03-27	The request parameters of the API has changed	View Change Details