You need to enable JavaScript to run this app.
Lake AI Service

Lake AI Service

Copy page
Download PDF
Dataset permissions
GrantDatasetPermissions - Batch grant dataset permissions to users
Copy page
Download PDF
GrantDatasetPermissions - Batch grant dataset permissions to users
Batch grant dataset permissions to users​
Debugging​
API Explorer
You can initiate calls online through API Explorer without paying attention to the signature generation process and quickly obtain the call results.
​
Request parameters​
The following lists only the request parameters specific to this API and some common parameters. For more information, see Common parameters.​
Action string required Example value: GrantDatasetPermissions​
Operation to be performed. Value: GrantDatasetPermissions.​
​
Version string required Example value: 2025-08-15​
API version. Value: 2025-08-15.​
​
ClientToken string Optional Example value: uuid-xxxxxx​
Client token​
​
DatasetName string required Example value: example_dataset_2025​
Dataset name​
​
UserPermissions object[] required Example value: ---​
Permission list​
Role string required Example value: Developer​
Role. Values: Admin (administrator), Developer (developer), Viewer (viewer)​
​
IdentityId long required Example value: 112233​
Identity ID. Valid when IdentityType is User or UserGroup​
​
IdentityType string required Example value: User​
Identity type. Values: User (user), UserGroup (user group)​
​
​
​
​
Response parameters​
This API does not have any specific response parameters. For more information, see Response structure.​
Request example​
​
POST /?Action=GrantDatasetPermissions&Version=2025-08-15 HTTP/1.1​
Host: open.volcengineapi.com​
Content-Type: application/json; charset=UTF-8​
X-Date: 20260121T121012Z​
X-Content-Sha256: 287e874e******d653b44d21e​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20260121/cn-beijing/las/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
{​
"ClientToken": "uuid-xxxxxx",​
"DatasetName": "example_dataset_2025",​
"UserPermissions": [​
{​
"Role": "Developer",​
"IdentityId": 112233,​
"IdentityType": "User"​
}​
]​
}​
​
Response example​
​
{​
"ResponseMetadata": {​
"RequestId": "20260121201015096063250168F07D94",​
"Action": "GrantDatasetPermissions",​
"Version": "2025-08-15",​
"Service": "las",​
"Region": "cn-beijing"​
},​
"Result": {}​
}​
​
Error codes​
The following table lists the error codes related to the business logic of this API. For common error codes, refer to the Common error codes documentation.​
​
Status code​
Error codes​
Error message​
Note​
400​
MissingParameter​
The required parameter {} is missing.​
The required parameter {} is missing.​
400​
InvalidParameter​
The specified parameter {} is invalid.​
The specified parameter {} is invalid.​
400​
InvalidRequestParam​
Invalid request param {}, cause {}​
Invalid request parameter {}, cause {}​
400​
DryRunOperation​
The request is validated by a dryrun operation.​
This request is validated by a dryrun operation.​
400​
IllegalArgument​
Invalid parameter​
Invalid parameter​
500​
InternalError​
The request has failed due to an unknown error.​
The request failed due to an unknown error.​
​
Last updated: 2026.08.03 10:44:00