All Products
Search
Document Center

Microservices Engine:SchedulerX authorization

Last Updated:Aug 20, 2026

SchedulerX supports setting permission policies for multiple users at once using Resource Access Management (RAM) users and user groups. RAM lets you avoid sharing your Alibaba Cloud account keys and assign minimum required permissions. This reduces security risks. This topic describes how to grant permissions to RAM users for specific operations.

Quick start configuration

RAM provides two ways to quickly grant SchedulerX permissions to RAM users. The two permission policies offer different levels of control. You can configure the policy that meets your needs. For more information about detailed custom permission configurations, see Custom policy configuration examples.

Create resources by granting permissions to a RAM user

By default, RAM users do not have permissions to create, view, or manage any SchedulerX resources. You can grant a RAM user permission to create resources. The RAM user will have read and write permissions on all resources they create.

Procedure:

  1. Log on to the RAM console.

  2. Create a custom policy. For more information, see Create a custom policy. You can use the following policy script to grant a RAM user permissions to create namespaces and application groups in all namespaces. The RAM user has permissions only on the application groups they create. To grant permissions on application groups and resources created by other RAM users, see the Custom policy configuration section in this topic.

    {
        "Version": "1",
        "Statement": [
            {
                "Action": ["edas:CreateSchedulerxNamespace*",
                           "edas:CreateSchedulerxAppGroup*"],
                "Effect": "Allow",
                "Resource": "acs:edas:*:*:*"
            }
        ]
    }
  3. (Optional) Create a user or user group. For more information, see Create a RAM user or Create a RAM user group. Skip this step if a user or user group already exists.

  4. Attach the permission policy configured in Step 2 to a single user. For more information, see Manage RAM user permissions.

  5. Attach the permission policy configured in Step 2 to a user group and add users to the user group.

    1. Attach the permission policy to the user group. For more information, see Grant permissions to a RAM user group. In the Actions column of the target user group, click Add Permissions to attach the policy. Click Add Group Members to add RAM users to the group.

    2. Add users to the user group that has the required permission policy. For more information, see Method 2: Add a RAM user to a RAM user group on the RAM user group page. In the Add Group Members dialog box, set User Group to schedulerx_admin. Select the target users from the user list on the left. Confirm that the selected users appear in the Selected area on the right, and then click OK.

Create resources as an administrator and then grant permissions to RAM users

In software project management, typically only O&M personnel can create resources. Developers usually have only read and operational permissions. You can create an administrator role for O&M personnel that grants them permissions to manage all resources on the Distributed Task Scheduling platform. The administrator can then create namespaces and application groups, and create permission policies to grant other RAM users access to these resources.

Procedure:

  1. Log on to the RAM console.

  2. Create a custom policy. For more information, see Create a custom policy. You can use the following policy script to grant a RAM user administrator permissions for SchedulerX. This gives the user management permissions for all SchedulerX resources under the Alibaba Cloud account.

    {
      "Statement": [
        {
          "Action": "edas:*Schedulerx*",
          "Effect": "Allow",
          "Resource": [
                    "acs:edas:*:*:*"
                ]
        }
      ],
      "Version": "1"
    }
  3. (Optional) Create a user or user group. For more information, see Create a RAM user or Create a RAM user group. Skip this step if a user or user group already exists.

  4. Attach the permission policy configured in Step 2 to a single user. For more information, see Manage RAM user permissions.

  5. Attach the permission policy configured in Step 2 to a user group and add users to the user group.

    1. Attach the permission policy to the user group. For more information, see Grant permissions to a RAM user group.

    2. Add users to the user group that has the required permission policy. For more information, see Method 2: Add a RAM user to a RAM user group on the RAM user group page.

SchedulerX permission details

An Alibaba Cloud account has management permissions for all resources under it by default. For subsequent permission control, use RAM access control to assign permission policies. SchedulerX uses RAM users and user groups to simplify setting permission policies in batches. You do not need to grant permissions to individual users one by one. SchedulerX permission policies support shared system permission policies.

System policy

Description

AliyunEDASFullAccess

Permissions to manage Enterprise Distributed Application Service (EDAS).

The following sections describe the details of custom permission policies for SchedulerX. In RAM, a permission policy mainly includes an Action and a Resource. You can create permission policies based on the rules defined by SchedulerX.

Custom policy structure

{
  "Statement": [
    { 
      "Action": "edas:*", // Action configuration item. For more information, see the next section, "Action".
      "Effect": "Allow",
      "Resource": "*"     // Resource configuration item. For more information, see the next section, "Resource".
    }
  ],
  "Version": "1",
}

Action

The structure of a SchedulerX Action is defined as follows:

edas:${type}Schedulerx*

The ${type} can be one of four types: Read, Manage, Delete, or Create. These types include the following operations:

Type

Related operations

Create

Create namespaces, applications, jobs, and workflows.

Manage

  • Modify namespaces.

  • Import jobs, export jobs, modify jobs, enable jobs, disable jobs, manually run jobs, rerun jobs, and specify machines.

  • Stop job instances, rerun job instances, set job instances as successful, set workflow instances as successful, and rerun sub-jobs.

  • Modify workflows, import jobs to workflows, manually run workflows, rerun workflows, enable workflows, and disable workflows.

  • Modify application groups.

Delete

Delete namespaces, application groups, jobs, and workflows.

Read

Query application groups, jobs, job instances, workflows, and online instances.

Resource

The structure of a SchedulerX Resource is defined as follows:

acs:edas:${regionid}:${accountid}:namespace/${namespace_id}/${resourceType}/${resourceId}

Parameter

Description

${regionid}

The region. This parameter specifies access to resources in a specific region. You can set this to * by default.

${accountid}

The account. This parameter specifies access to resources of a specific account. You can set this to * by default.

${namespace_id}

The namespace ID. This parameter specifies a namespace.

  • For non-EDAS users:

    1. Log on to the MSE SchedulerX console.

    2. In the navigation pane on the left, click Namespaces. Hover over the right side of the target Namespace ID and click the image.png icon to copy the ID. Replace the ${namespace_id} parameter with the copied ID.

  • For EDAS users:

    1. Log on to the EDAS console.

    2. In the navigation pane on the left, choose Resource Management > Microservice space. On the Microservice space page, hover over the right side of the target Microservices Namespace Name/ID/namespace and click the image.png icon to copy the ID. Replace the ${namespace_id} parameter with the copied ID.

${resourceType}

The resource type. The value can be JobGroup, which represents an application group for jobs in SchedulerX.

${resourceId}

The specific ID of the ${resourceType}. If the resource type is JobGroup, this parameter is the GroupId in Application Management.

To obtain the ${resourceId}:

  1. Log on to the MSE SchedulerX console.

  2. In the navigation pane on the left, click Application Management. Hover over the right side of the Application ID and click the image.png icon to copy the ID. Replace the ${resourceId} parameter with the copied ID.

Custom policy configuration examples

Grant a RAM user management permissions for all resources

A policy that grants all management permissions for SchedulerX. It allows access to all operations and resources in SchedulerX.

{
    "Version": "1",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "edas:*Schedulerx*"
            ],
            "Resource": [
                "acs:edas:*:*:*"
            ]
        }
    ]
}

Grant a RAM user read-only permissions for all resources

A policy that grants read-only query permissions for all resources in SchedulerX. It allows viewing information about all resources in SchedulerX.

{
    "Version": "1",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "edas:ReadSchedulerx*"
            ],
            "Resource": [
                "acs:edas:*:*:*"
            ]
        }
    ]
}

Grant a RAM user permissions for all actions in a specific namespace

A policy that grants management permissions for all application and job resources in one or more specified namespaces. You must obtain the namespace IDs from the EDAS microservices namespace and configure them in the policy. The following example grants management permissions for resources in two namespaces (namespace-id-01 and namespace-id-02). You can also change the Action to limit operations on these resources. For example, if you set the Action to "edas:ReadSchedulerx*", the policy grants read-only query permissions for the two namespaces.

{
    "Version": "1",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "edas:*Schedulerx*"
            ],
            "Resource": [
                "acs:edas:*:*:namespace/namespace-id-01/*",
              	"acs:edas:*:*:namespace/namespace-id-02/*"
            ]
        }
    ]
}

In the navigation pane on the left of the SchedulerX console, click Namespace. In the Namespace ID column of the namespace list, obtain the ID of the target namespace. Replace namespace-id-01 and namespace-id-02 in the policy with the obtained ID.

Grant a RAM user permissions for all actions in a specific application

A policy that grants access management permissions for resources under specific applications in Distributed Task Scheduling. In the Resource element, specify the application IDs of the JobGroups in the corresponding namespaces to grant access permissions for those applications. You can also use a prefix with an asterisk (*) wildcard, such as "TestGroup*", to quickly grant permissions for all application groups that have the "TestGroup" prefix.

{
    "Version": "1",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "edas:*Schedulerx*"
            ],
            "Resource": [
                "acs:edas:*:*:namespace/namespace-id-01/JobGroup/TestGroup*",
              	"acs:edas:*:*:namespace/namespace-id-02/JobGroup/AppGroup"
            ]
        }
    ]
}

In the navigation pane on the left of the Distributed Task Scheduling console, click Application Management. In the Application ID/Application key column of the application list, obtain the application ID of the target application.