All Products
Search
Document Center

DataWorks:CreatePermissionApplyOrder

Last Updated:Sep 16, 2025

Creates a permission request order.

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.

Authorization information

The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:

  • Operation: the value that you can use in the Action element to specify the operation on a resource.
  • Access level: the access level of each operation. The levels are read, write, and list.
  • Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
    • For mandatory resource types, indicate with a prefix of * .
    • If the permissions cannot be granted at the resource level, All Resources is used in the Resource type column of the operation.
  • Condition Key: the condition key that is defined by the cloud service.
  • Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.
OperationAccess levelResource typeCondition keyAssociated operation
dataworks:*create
*All Resources
*
    none
none

Request parameters

ParameterTypeRequiredDescriptionExample
ApplyUserIdsstringYes

The ID of the Alibaba Cloud account for which you want to request permissions. If you want to request permissions for multiple Alibaba Cloud accounts, separate the IDs of the accounts with commas (,).

267842600408993176,267842600408993177
DeadlinelongNo

The expiration time of the permissions that you request. This value is a UNIX timestamp. The default value is January 1, 2065. If LabelSecurity is disabled for the MaxCompute project in which you want to request permissions on the fields of a table, or the security level of the fields is 0 or is lower than or equal to the security level of the Alibaba Cloud account for which you want to request permissions, you can request only permanent permissions. You can go to the Workspace Management page in the DataWorks console, click MaxCompute Management in the left-side navigation pane, and then check whether column-level access control is enabled. You can go to your DataWorks workspace, view the security level of the fields in Data Map, and then view the security level of the Alibaba Cloud account on the User Management page.

1617115071885
ApplyReasonstringYes

The reason for your request. The administrator determines whether to approve the request based on the reason.

I need to use this table
MaxComputeProjectNamestringNo

The name of the MaxCompute project you request access to.

aMaxcomputeProjectName
WorkspaceIdintegerNo

The DataWorks workspace ID to which the MaxCompute project belongs for permission requests. You can check the workspace ID on the DataWorks workspace configuration page.

12345
OrderTypedeprecatedintegerNo

The request type. The only supported value is 1, which represents an object ACL permission request.

1
EngineTypedeprecatedstringNo

The type of compute engine for permission requests. Currently only supports ODPS, which means only MaxCompute compute engine permissions are supported.

Enumeration Value:
  • odps
odps
ApplyObjectarray<object>Yes

The list of requested objects.

objectYes

Response parameters.

ActionsstringNo

The type of permissions requested. Use commas (,) to separate multiple permission types in a single request. Currently only supports Select, Describe, Drop, Alter, Update, and Download permission types.

Select,Describe
ColumnMetaListarray<object>No

The list of column objects.

objectNo

Response parameters.

NamestringNo

Permissions for the target columns. Enter the column names here. If applying for permissions on the entire table, enter all column names of the table. Permissions for specific columns can only be requested if labelSecurity is enabled for the MaxCompute project. Otherwise, you can only apply for permissions on the entire table.

aColumnName
NamestringNo

The object you request access to. Currently, only permission requests for MaxCompute tables are supported. The name of the target table needs to be entered here.

aTableName

Response parameters

ParameterTypeDescriptionExample
object

The returned result.

RequestIdstring

The request ID.

0bc1ec92159376****
FlowIdarray

The request order ID.

FlowIdstring

The request order ID. If you request permissions on multiple objects but each object has a different request approver, one request order is generated for each object and is sent to the related approver. In this case, an array is returned.

ee276e6e-5d34-46d8-b848-bca7879ed233

Examples

Sample success responses

JSONformat

{ "RequestId": "0bc1ec92159376****", "FlowId": [ "ee276e6e-5d34-46d8-b848-bca7879ed233" ] }

Error codes

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

Change history

Change timeSummary of changesOperation
2025-03-27The request parameters of the API has changedView Change Details
2023-06-28The internal configuration of the API is changed, but the call is not affectedView Change Details