Updated on 2025-08-15 GMT+08:00

Managing Custom Project Roles

If the built-in system roles of CodeArts do not meet your requirements, you can create custom ones with necessary permissions.

Constraints

You can create up to 500 custom roles for each project.

Prerequisites

You must have the DevUC > project-role > userconfig permission. For details, see How Do I Check and Obtain Required Project Permissions?

Creating a Role

  1. Go to the CodeArts homepage.

    1. Log in to the CodeArts console, click , and select a region where you have enabled CodeArts.
    2. Click Go to Workspace.

      If your account uses the old billing mode (see Old Billing Modes), click Access Service.

  2. Click the target project name.
  3. Choose Settings > Permissions from the navigation pane. The permissions management page is displayed.
  4. Click Create Role. In the displayed dialog box, configure the role information and click OK.

    Figure 1 Creating a role
    Table 1 Creating a role

    Parameter

    Description

    Role Name

    The name of the custom role. Do not use a system role name.

    Enter a maximum of 30 characters. Letters, digits, spaces, and the following special characters are supported: () [] - _ ~. & <> {}

    Copy Role

    Copy permissions from an existing role in a project of the same type.

    This parameter is optional. Enable it as needed. Once enabled, select a project and role from the drop-down lists.

    • Project: Select a project of the same type as your current project.
    • Role: Select any role in the project from which you want to copy permissions.

    Check the new role under Custom Role.

Managing Custom Roles

  1. Go to the CodeArts homepage.

    1. Log in to the CodeArts console, click , and select a region where you have enabled CodeArts.
    2. Click Go to Workspace.

      If your account uses the old billing mode (see Old Billing Modes), click Access Service.

  2. Click the target project name.
  3. Choose Settings > Permissions from the navigation pane. The permissions management page is displayed.
  4. Perform the operations listed in the table below as needed.

    Operation

    Description

    Editing a role's permissions

    1. Click a role name and service name. The role's permissions for the service are displayed.
    2. Click Edit, modify the permissions, and click Save.

      Check the updated permissions.

    Modifying a role name

    1. Click next to a role name and choose Modify Role Name.
    2. Enter a new name and click OK.

      The updated role name is displayed.

    Deleting a role

    WARNING:

    The deletion cannot be undone. Exercise caution when performing this operation.

    1. Click next to a role name and choose Delete Role.
    2. Enter YES and click OK.

      The role is no longer displayed on the page.