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.
For more information, see Manage members and roles.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
Action | String | Yes | AddProjectMemberToRole | The operation that you want to perform. Set the value to AddProjectMemberToRole. |
ProjectId | Long | Yes | 27 | The DataWorks workspace ID. You can call the ListProjects operation to obtain the ID. |
UserId | String | Yes | 1234 | 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. |
RoleCode | String | Yes | role_project_guest | 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. |
ClientToken | String | No | 1AFAE64E-D1BE-432B-A9***** | 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. |
Response parameters
Parameter | Type | Example | Description |
RequestId | String | 1AFAE64E-D1BE-432B-A9**** | The request ID. You can locate logs and troubleshoot issues based on the ID. |
Examples
Sample requests
http(s)://[Endpoint]/?Action=AddProjectMemberToRole
&ProjectId=27
&UserId=1234
&RoleCode=role_project_guest
&ClientToken=1AFAE64E-D1BE-432B-A9*****
&<Common request parameters>Sample success responses
XML format
HTTP/1.1 200 OK
Content-Type:application/xml
<AddProjectMemberToRoleResponse>
<RequestId>1AFAE64E-D1BE-432B-A9****</RequestId>
</AddProjectMemberToRoleResponse>JSON format
HTTP/1.1 200 OK
Content-Type:application/json
{
"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 specified data source does not exist. |
400 | Invalid.Tenant.ProjectNotExists | The project does not exist. | The specified workspace does not exist. |
400 | Invalid.Tenant.UserNotInProject | The user is not in the project. | The user is not added to the workspace. |
403 | Invalid.Tenant.UserIsNotProjectOwnerOrAdmin | The user is not a project administrator or owner. | The user is not the workspace owner or administrator. |
403 | Invalid.Tenant.UserNotInTenant | The user is not in tenant. | The user does not belong to the tenant. |
For a list of error codes, see Service error codes.