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

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

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.