All Products
Search
Document Center

DataWorks:GetProjectRole

Last Updated:Dec 10, 2024

Queries the information about a role in a DataWorks workspace.

Operation description

This API operation is available for all DataWorks editions.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
ProjectIdlongYes

The DataWorks workspace ID. You can log on to the DataWorks console and go to the Workspace page to query the ID.

10002
CodestringYes

The code of the role in the DataWorks workspace.

Valid values:

  • role_project_admin: workspace administrator
  • role_project_dev: developer
  • role_project_dg_admin: data governance administrator
  • role_project_guest: visitor
  • role_project_security: security administrator
  • role_project_deploy: deployer
  • role_project_owner: workspace owner
  • role_project_data_analyst: data analyst
  • role_project_pe: O&M engineer
  • role_project_erd: model designer
role_project_guest

Response parameters

ParameterTypeDescriptionExample
object

The response parameters.

RequestIdstring

The request ID.

82F28E60-CF48-5EDF-AB25-D806847B97D1
ProjectRoleobject

The role in the DataWorks workspace.

ProjectIdlong

The DataWorks workspace ID.

10002
Codestring

The code of the role in the DataWorks workspace.

Valid values:

  • role_project_admin: workspace administrator
  • role_project_dev: developer
  • role_project_dg_admin: data governance administrator
  • role_project_guest: visitor
  • role_project_security: security administrator
  • role_project_deploy: deployer
  • role_project_owner: workspace owner
  • role_project_data_analyst: data analyst
  • role_project_pe: O&M engineer
  • role_project_erd: model designer
role_project_guest
Namestring

The name of the role in the DataWorks workspace.

Typestring

The type of the role in the DataWorks workspace.

Valid values:

  • UserCustom: user-defined role
  • System: system role
System

Examples

Sample success responses

JSONformat

{
  "RequestId": "82F28E60-CF48-5EDF-AB25-D806847B97D1",
  "ProjectRole": {
    "ProjectId": 10002,
    "Code": "role_project_guest",
    "Name": "",
    "Type": "System"
  }
}

Error codes

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
No change history