Assigns a role to a member of a DataWorks workspace. Before you call this operation, you must add your Alibaba Cloud account or a RAM user as a member of a DataWorks workspace.
For more information about how to add your Alibaba Cloud account or a RAM user as a member of a DataWorks workspace, see Add a member to a DataWorks workspace.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | AddProjectMemberToRole |
The operation that you want to perform. |
ProjectId | Long | Yes | 27 |
The ID of the DataWorks workspace. You can call the ListProjects operation to query the ID. |
RegionId | String | Yes | cn-shanghai |
The region of the workspace. For example, the ID of the China (Shanghai) region is cn-shanghai, and that of the China (Zhangjiakou) region is cn-zhangjiakou. The system automatically determines the value of this parameter based on the endpoint used to call the operation. |
RoleCode | String | Yes | role_project_guest |
The code of the role that you want to assign to a member of a DataWorks workspace. You can call the ListProjectRoles operation to query the code of all roles in a DataWorks workspace. |
UserId | String | Yes | 1234 |
The ID of your Alibaba Cloud account. To view the ID, log on to the DataWorks console and move the pointer over the profile picture in the upper-right corner. |
ClientToken | String | No | 1AFAE64E-D1BE-432B-A9***** |
The client token. It is a field with the idempotence property. We recommend that you use a universally unique identifier (UUID). This parameter is used to uniquely identify the API operation call. |
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
RequestId | String | 1AFAE64E-D1BE-432B-A9**** |
The ID of the request. You can use the ID to search for logs and troubleshoot issues based on the logs. |
Examples
Sample requests
http(s)://[Endpoint]/?Action=AddProjectMemberToRole
&ProjectId=27
&RegionId=cn-shanghai
&RoleCode=role_project_guest
&UserId=1234
&<Common request parameters>
Sample success responses
XML
format
<RequestId>1AFAE64E-D1BE-432B-A9****</RequestId>
JSON
format
{
"RequestId": "1AFAE64E-D1BE-432B-A9****"
}
Error codes
HttpCode | Error code | Error message | Description |
---|---|---|---|
400 | Invalid.Tenant.ConnectionNotExists | The connection does not exist. | The error message returned because the specified data source does not exist. |
400 | Invalid.Tenant.ProjectNotExists | The project does not exist. | The error message returned because the specified workspace does not exist. |
403 | Invalid.Tenant.UserIsNotProjectOwnerOrAdmin | The user is not a project administrator or owner. | The error message returned because the member is not the workspace owner or the workspace administrator. |
400 | Invalid.Tenant.UserNotInProject | The user is not in the project. | The error message returned because the member is not added to the workspace. |
403 | Invalid.Tenant.UserNotInTenant | The user is not in tenant. | The error message returned because the member does not belong to the tenant. |
For a list of error codes, visit the API Error Center.