Assigns a role to a member of a DataWorks workspace. Before you call this operation, you must add your account to a DataWorks workspace as a member.
Operation description
-
Add the target account as a member of the DataWorks workspace. For more information, see Add members to a DataWorks workspace.
-
When you add a user to a preset role in a DataWorks workspace, the user is also added as a project role member in the MaxCompute project of the development environment of the workspace. For more information, see Mappings between workspace-level preset roles and MaxCompute engine permissions.
Try it now
Test
RAM authorization
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| ProjectId |
integer |
Yes |
The DataWorks workspace ID. You can call the ListProjects operation to query the ID. |
27 |
| UserId |
string |
Yes |
The Alibaba Cloud account ID. You can log on to the DataWorks console and move the pointer over the profile picture in the upper-right corner to view the ID. |
1234 |
| RoleCode |
string |
Yes |
The code of the role that you want to assign to a member of the DataWorks workspace. You can call the ListProjectRoles operation to query the codes of all roles in a DataWorks workspace. |
role_project_guest |
| ClientToken |
string |
No |
The client token that is used to ensure the idempotence of the request. We recommend that you set this parameter to a UUID. This parameter is used to uniquely identify the API operation call. |
1AFAE64E-D1BE-432B-A9***** |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
The response parameters. |
||
| RequestId |
string |
The request ID. |
1AFAE64E-D1BE-432B-A9**** |
Examples
Success response
JSON format
{
"RequestId": "1AFAE64E-D1BE-432B-A9****"
}Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | Invalid.Tenant.ConnectionNotExists | The connection does not exist. | The connection does not exist. |
| 400 | Invalid.Tenant.ProjectNotExists | The project does not exist. | The project does not exist. |
| 400 | Invalid.Tenant.UserNotInProject | The user is not in the project. | The user is not in the project. |
| 403 | Invalid.Tenant.UserIsNotProjectOwnerOrAdmin | The user is not a project administrator or owner. | The user is not a project administrator or owner. |
| 403 | Invalid.Tenant.UserNotInTenant | The user is not in tenant. | The user is not in tenant. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.